调用 Coze 工作流

Coze 是一个用来搭建工作流和 AI 应用的平台。ConsoleX 可以把 Coze 工作流当作工具来调用，让 AI 在对话或任务中运行你搭好的工作流。

2026 年 10 月的变化

ConsoleX 的工具表单在 2026 年 10 月有所调整：HTTP API 表单中不再有 Coze 接口类型。请把工作流添加为调用 Coze 工作流 API 的自定义 HTTP API 工具；如果你的 Coze 提供 MCP 服务器，也可以通过 MCP 连接。

基本步骤

1. 在 Coze 中创建并发布工作流。 工作流以 Start 节点开始、以 End 节点结束。把 End 节点设置为返回文本（response text），并组装一个 JSON 对象，其中的字段会作为工具结果返回。
2. 准备 API 信息。 Coze 通过工作流 API 运行工作流，并用工作流 ID 区分不同的工作流。国际版和中国版使用不同的 API 地址：
   • 国际版：https://api.coze.com
   • 中国版：https://api.coze.cn
3. 在 ConsoleX 中添加自定义工具。 点击左侧导航栏的 …（更多），再点击 能力库。在 工具 标签中点击 添加自定义工具，选择 HTTP API。
4. 描述输入参数。 在工具定义的 JSON Schema 中，写明 Coze 工作流需要的输入参数，格式与 OpenAI 标准工具描述一致。可以用 Generate by AI 生成草稿。
5. 设置调用方式。 在调用方式中选择 POST，按表单要求用 Coze 工作流 API 填写接口信息，并在要求填写 API Key 的地方填入 Coze 的 token，然后保存。
6. 开始使用。 在对话中（输入框下方的 工具），或在任务、智能体中（添加能力）开启这个工具。模型会根据工具的描述和输入参数调用工作流。

由于表单中不再有专门的 Coze 选项，请确认工具发出的请求符合 Coze 工作流 API 的要求，包括工作流 ID。先在一个简短的对话里测试，再用于任务。参见添加自定义工具和添加 MCP 服务器。

注意事项

1. 工具的 JSON Schema 需要与 Coze 工作流的输入参数一致，否则模型无法正确调用。可以在 Coze 的运行历史中查看调试信息。
2. Coze 工作流需要发布后才能被调用。

常见问题：auth token

Coze 的工作流统一使用 token 认证。在 Coze 的 Authorization 中创建 token，并设置好所需权限。Coze 的 token 有有效期，创建时留意过期时间，并在过期前更新 ConsoleX 工具中使用的 token。