Actions

让组织 AI 在对话中调用已配置的 HTTPS 端点

Actions 会把 HTTPS 端点注册成组织级 AI 工具。在对话中，AI 会根据已启用 Action 的名称和描述判断它是否相关，发起调用，并把响应作为工具结果继续处理。

Actions 仅在 Starter 和 Pro 套餐中可用。Starter 最多同时启用 2 个 Actions，Pro 最多同时启用 10 个；Free 套餐不能创建或使用 Action。套餐详情见订阅与用量。

创建动作

打开 能力 → Actions，点击新建动作。当前表单包含以下设置：

字段	作用
名称	AI 看到的工具名称。以小写字母开头，只使用小写字母、数字和下划线，例如 `check_service_status`，最长 50 个字符。
描述	简短说明 AI 应该在什么情况下调用这个 Action，最长 200 个字符。
方法	对外发起 HTTP 请求的方法：`GET` 或 `POST`。
HTTPS URL 模板	公网目标 URL。可以用 `{order_id}` 这样的占位符把同名 Param 放入路径，其他 Params 会进入查询字符串。
鉴权	无鉴权、Bearer Token 或 API Key Header。保存的密钥会被加密，之后无法再次查看。
Params 与 JSON Body	AI 调用端点前收集的动态字符串、数字或布尔值。`POST` 可以配置 JSON Body 字段。

填写必需的名称和 URL 后点击保存草稿。新建或修改配置后，Action 会保持停用，直到这个配置版本通过测试。

选中已保存的 Action，为配置的输入参数填写测试值，然后点击运行测试。测试会真实发起请求，并写入经过脱敏的执行记录。测试成功后，再打开启用此动作。组织套餐会限制同时启用的 Actions 数量。

选中动作后，可以查看它的方法、URL 和描述，并在动作顶栏执行：

只有已启用、未被套餐锁定，并且当前配置版本测试成功的 Actions 才会提供给组织 AI。可用 Actions 列表最长缓存 60 秒，因此启用或修改配置后，新的 AI 对话轮次最长可能需要 60 秒才会使用新结果。

每次 Action 对外请求都有固定的 5 秒硬超时，最多接受 20 KB 响应数据，并且只有 HTTP 200 会视为成功。失败信息会作为工具结果返回给 AI，让对话可以继续，同时本次尝试会写入调用日志。

在选中的 Action 上打开调用日志，可以查看组织最近 50 次 Action 调用中属于该 Action 的记录。每条记录显示：

成功和失败的对外请求都会记录。

要按真实对话链路测试 Action，可以先安装聊天挂件，提出与动作描述相符的问题，再回到该动作查看日志。