AI功能服务器模块

该模块展示了如何为FirstSpirit AI实现自定义功能服务器,扩展AI能力以访问外部数据源和执行业务逻辑。

  • by Crownpeak
  • Java
  • 本地部署
  • 更新于
在 GitHub 查看 Crownpeak/hello-world-mcp-plugin

使用说明

FirstSpirit函数服务器示例模块|基本示例

此项目演示了如何为实现自定义Function Server FirstSpirit AI. Function Server通过注册AI在提示执行期间可以自主调用的自定义函数来扩展FirstSpirit AI的功能。 这使AI能够访问外部数据源、执行业务逻辑或将复杂的计算委托给自己的代码。 在处理用户请求时,AI会分析可用功能,并根据其定义和请求的上下文自动选择和调用适当的功能。

此示例模块说明了 GenerativeAIFunctionServerPlugin API 它包括几个示例函数,演示函数注册、参数处理、类型映射和结果格式化。 每个示例函数都用内联文档进行注释,解释关键概念和最佳实践。 使用此模块作为开发自己的自定义Function Server实现的起点。

参考文献

需求

  • 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-<version>.fsm
  • 在 FirstSpirit AI配置,定义新提示。
  • 在提示符的配置对话框中,只需添加插件即可调用此模块中的函数 BasicExamplesFunctionServerPlugin 到允许的功能列表。
  • 在FirstSpirit ContentAssistant中执行提示操作以查看结果。 如果函数适合当前请求,FirstSpirit AI将自动调用该函数。