用途:该技能面向 Freshworks Platform 3.0 的 AI Actions 与集成开发,适用于创建 actions.json、SMI 函数、请求模板、集成与范围界定,以及校验和测试。不适用于仅做 Freshworks 应用 UI 的工作,那应使用 fw-app-dev 技能。
主要能力与规则:不得假设 API 端点,需先确认第三方 API 文档;请求参数必须保持扁平,不允许嵌套对象,可用基本类型数组,不允许对象数组;响应 schema 可以嵌套,但只保留必要字段;actions.json 与 server.js 中的函数名必须大小写完全一致;嵌套结构在 server.js 中构造,而非请求 schema;外部 HTTP 使用 $request.invokeTemplate 请求模板;凭据不得硬编码,使用 iparams(secure: true)或 OAuth;最终前用 fdk validate 和 FDK 测试服务器校验。
目录结构:AI actions 应用不需要 app 文件夹,使用 ai-actions-app/ 下的 actions.json、server/server.js、server/test_data/actionName.json、config/requests.json、config/iparams.json、manifest.json。manifest 声明 common(requests、functions)及支持的产品模块为空对象,不要删除模块键;引擎默认 "node": "24.11.0"、"fdk": "10.0.0",除非项目另有指定。
使用方式:先查官方 API 文档,再设计扁平参数与务实响应;在 server.js 中用 renderData、$request.invokeTemplate 将扁平参数映射为 API 载荷;配置 requests.json、iparams.json、manifest;在 server/test_data/ 放置真实载荷且不含密钥;参考规则与指南处理失败、端点错误、集成与范围流程。交付物按 app-root/ 布局,含 actions.json、manifest.json、server/server.js、server/test_data/<functionName>.json、config/requests.json、config/iparams.json,需要时加 README.md。处理器导出键与 actions.json 键一致,成功用 renderData(null, data),错误用 renderData({ status, message }, null),并对用户可见错误做清理。
限制:资料未提供具体收费、价格、平台支持范围或效果数据;模块列表若项目未提供,需按产品类别推断并与用户确认。