FirstSpirit函数服务器示例模块|基本示例
此项目演示了如何为实现自定义Function Server FirstSpirit AI. Function Server通过注册AI在提示执行期间可以自主调用的自定义函数来扩展FirstSpirit AI的功能。 这使AI能够访问外部数据源、执行业务逻辑或将复杂的计算委托给自己的代码。 在处理用户请求时，AI会分析可用功能，并根据其定义和请求的上下文自动选择和调用适当的功能。
此示例模块说明了 GenerativeAIFunctionServerPlugin API 它包括几个示例函数，演示函数注册、参数处理、类型映射和结果格式化。 每个示例函数都用内联文档进行注释，解释关键概念和最佳实践。 使用此模块作为开发自己的自定义Function Server实现的起点。
参考文献
- GenerativeAIFunctionServer （FirstSpirit API文档）
- 生成AI代理 （FirstSpirit API文档）
需求
- FirstSpirit 2025.11或更新版本
- Java 17
- Gradle 8.11或更新版本
必须设置以下Gradle属性才能构建模块。 确保将它们添加到文件中 ~/.gradle/gradle.properties 在您的本地主目录中：
artifactory_hosting_username=CLOUD_USERNAME
artifactory_hosting_password=CLOUD_ENCRYPTED_PASSWORD加密的云密码可以通过以下方式检索 工件REST API调用 （需要经过身份验证的会话）。
用法
- 使用以下命令构建模块
./gradlew build并将其安装到您的FirstSpirit服务器中
- 您可以在以下位置找到FSM文件 build/fsm/fs-ai-function-server-example-basic-examples-.fsm
- 在 FirstSpirit AI配置，定义新提示。
- 在提示符的配置对话框中，只需添加插件即可调用此模块中的函数
BasicExamplesFunctionServerPlugin 到允许的功能列表。
- 在FirstSpirit ContentAssistant中执行提示操作以查看结果。
如果函数适合当前请求，FirstSpirit AI将自动调用该函数。