SuperAPI AI 工具集

ai-actions-skill

通用与其它

查看项目

更新于 10-15 21:47

技能介绍

用途:该技能面向 Freshworks Platform 3.0 市场应用开发,指导创建 AI Actions——即在 actions.json 中声明的函数目录,每个动作包含唯一函数名、输入 JSON Schema、响应 JSON Schema,以及同名后端回调(SMI 函数)。支持 Freshdesk、Freshchat、Freshworks CRM、Freshcaller。

主要能力:编写 actions.json 动作定义;实现 server.js 中的 SMI 函数;通过 config/requests.json 定义外部 API 请求模板并在 manifest.json 中声明;在 server/test_data/ 放置测试载荷;用 fdk validate 校验、fdk run 启动测试服务器,在 https://localhost:10001/web/test 选择 actions 模拟调用。

关键约束:请求模式必须扁平,禁止嵌套对象、数组及 object/array 类型,仅支持 string、number、boolean、integer;嵌套结构须在 server.js 中构造。响应模式可嵌套、可含数组,但只保留必要字段,字段默认可选,仅 ID 标记必填。函数名大小写敏感,须在 actions.json 与 server.js 中完全一致,仅含字母数字和下划线,长度 2 到 40,不能以数字开头或含空格、连字符。renderData(error, data) 成功时首参传 null,失败传含 status 与 message 的对象。

第三方 API:必须先获取并核对官方 API 文档,不得假设端点、路径、方法、认证、请求体或响应结构;未提供文档时应向用户索取。

限制:资料未提供具体收费、价格、平台兼容版本或效果数据。