调用 n8n 工作流

n8n 是一个工作流自动化平台。ConsoleX 可以把 n8n 工作流当作工具来调用，让 AI 在对话或任务中触发你搭好的工作流。n8n 工作流可以运行在 n8n Cloud 上，也可以自托管。

2026 年 10 月的变化

ConsoleX 的工具表单在 2026 年 10 月有所调整：HTTP API 表单中不再有 n8n 接口类型。请使用内置的 n8n 工具，或按下文把工作流添加为调用其 Webhook 的自定义 HTTP API 工具。

方式一：使用内置的 n8n 工具

能力库的 工具 标签中，办公与协作 分组下有一张 n8n 卡片：「触发和管理你的 n8n 工作流。」

1. 点击左侧导航栏的 …（更多），再点击 能力库。
2. 在 n8n 卡片上点击 填写 key，按弹窗要求填写信息并保存。
3. 在对话中（输入框下方的 工具），或在任务、智能体中（添加能力）开启 n8n 工具。

方式二：把工作流的 Webhook 添加为自定义工具

基本流程

1. 在 n8n 中创建一个以 Webhook 触发、以 Respond to Webhook 结束并返回 JSON 的工作流。
2. 在 ConsoleX 中添加一个调用该 Webhook URL 的自定义 HTTP API 工具。
3. 在对话、任务或智能体中开启这个工具，AI 就能在需要时调用它。

在 n8n 中设置触发方式和参数

工作流以 Webhook 触发节点开始，以 Respond to Webhook 结束。返回内容建议设置为 JSON 格式，因为响应体就是 ConsoleX 交给模型的工具结果。

在 n8n 中设置认证（可选）

如果需要 token 认证，在 Webhook 触发节点中设置 Header Auth，并创建一个凭证：

• Name：Authorization
• Value：Bearer <your_auth_token>

其中 <your_auth_token> 是你自己指定的工作流 token。

使用正确的 Webhook URL

开发阶段可以用 Test URL 测试，但它只能单次调用。工作流发布之后，使用可以反复调用的 Production URL。

在 ConsoleX 中创建工具

1. 在 能力库 的 工具 标签中，点击 添加自定义工具，选择 HTTP API。
2. 在工具定义的 JSON Schema 中，描述工作流需要的输入参数。可以用 Generate by AI 生成草稿。
3. 在调用方式中，根据 Webhook 触发节点接收参数的方式选择 GET 或 POST。
4. 按表单要求填写接口信息，使用 n8n 中的 Webhook URL。如果工作流设置了 token 认证，在表单要求填写 API Key 的地方填入这个 token。
5. 保存后，在需要的地方开启这个工具。

JSON Schema 和调用方式的详细说明，参见添加自定义工具。

如果你的 n8n 可以把工作流以 MCP 服务器的形式提供，也可以通过添加 MCP 服务器来连接。

示例工作流

以下是一个天气预报的 n8n 示例工作流，可以保存到本地后导入 n8n 参考：

天气预报工作流

注意事项

1. 工具的 JSON Schema 需要与工作流的输入参数一致，否则模型可能无法正确调用。可以在 n8n 的执行记录中查看调用详情。
2. 在定时任务中使用前，先在一个简短的对话里测试一下。