n8n智能体搭建教程：用 Chat Trigger、AI Agent 和计算工具跑通首次对话

在 n8n 中搭建第一个智能体，可以从“接收一句话 → 判断是否需要计算 → 调用计算工具 → 回复结果”开始。你要创建的不是单纯的提示词窗口，而是由 Chat Trigger、AI Agent、聊天模型和 Calculator 组成的可检查工作流。

本文面向已经能进入 n8n 工作流编辑器的新手，按 2026 年 10 月 1 日读取的官方节点文档整理。示例输入和预期结果用于演示，未在真实 n8n 实例中执行；模型响应、界面名称和可用模型以你的节点版本、账户权限为准。

先准备什么，以及最终会得到什么

• 一个可以新建工作流的 n8n Cloud 或自托管实例。本文从编辑器开始，不涵盖服务器安装。
• 一个能调用工具的聊天模型及其有效凭证。下面用 OpenAI Chat Model 示范，在节点中创建或选择凭证，选择自己账户实际可用、支持工具调用的模型。
• 确认模型调用额度与预算。网页聊天会员和 API 凭证不是同一个配置项；本教程不承诺免费。n8n Cloud 若提供 Gateway credits，可按该节点的凭证选项配置，是否可用看账户。

目标输入是“单价 129 元，买 3 件，另加运费 12 元，一共多少？”；计算依据为 129 * 3 + 12，核对值为 399 元。你不仅要看到 399，还要在执行信息中找到 Calculator 的调用证据。

1. 建立触发器与主节点

1. 在工作流列表新建一个空工作流，命名为“首次计算助手”。添加 Chat Trigger，部分界面在画布上显示为 When chat message received。
2. 保持 Make Chat Publicly Available 关闭，先在编辑器的聊天测试面板验证。
3. 从触发器的主输出连接一个 AI Agent 节点。这条实线负责把本次聊天输入送到 Agent。
4. 在 AI Agent 的 Prompt 中选择 Take from previous node automatically。官方说明这个选项期待上游字段 chatInput；先查看 Chat Trigger 输出是否真的包含它。

不要把聊天模型连到主流程实线上。模型和工具是 AI Agent 的子节点，应分别连到它下方的 Chat Model 和 Tool 接口。

2. 接入模型与 Calculator

1. 点击 AI Agent 的 Chat Model 接口，添加 OpenAI Chat Model，选择有效凭证与可用模型。若选中的模型不能处理工具调用，换成账户内支持该能力的模型，不能靠修改提示词补出这项能力。
2. 点击 Tool 接口，添加 Calculator。它承担数学计算，通常不需要另外申请外部服务凭证。
3. 在 AI Agent 的 Options 中添加 System Message，粘贴下方指令；测试时开启 Return Intermediate Steps，便于检查工具调用。
4. 若聊天采用 When Last Node Finishes 返回模式，关闭 Agent 的 Enable Streaming，先用一次完整响应验证。等基本流程通过后，再同时配置支持流式返回的触发器与节点。

你是一个金额计算助手。
涉及加减乘除、数量或费用合计时，必须调用 Calculator，再解释计算过程。
不要补充用户没有提供的税费、折扣和运费。
缺少计算所需数字时，先询问；不把猜测当作金额。
只返回计算表达式、结果及一句说明。
与金额无关的问题，简要说明本助手的用途。

AI Agent 官方说明要求至少连接一个工具。较新节点已统一使用 Tools Agent，不必寻找旧教程里的 Agent Type 下拉菜单。Calculator 的职责见计算工具文档。

3. 发出第一次消息，并检查整条链路

保存工作流，打开编辑器中的聊天测试面板，发送前面的 129 元计算题。先看最后的聊天回复，再点开这次执行的 AI Agent 输出与中间步骤。

再发送“买 3 件，一共多少？”作为缺失输入测试。合格行为是询问单价及相关费用，不能沿用你并未确认的数字。此时没有配置记忆，后续消息不保证知道上一轮单价；请每次在输入中写齐条件。

回答正确但没有调用工具，怎么办？

最终答案正确仍不足以验证本题工作流。先确认 Calculator 挂在 Tool 接口；然后确认已开启 Return Intermediate Steps；再检查系统指令有没有要求金额计算必须调用工具。若模型一直不调用，检查模型支持情况与节点报错，换一个明确支持工具调用的模型后重试同一输入。

其他常见问题可以按错误位置处理：

• 提示输入为空：检查 Prompt 的自动输入模式以及触发器的 chatInput 字段。若改用 Define below，Prompt (User Message) 可设为 {{ $json.chatInput }}，先在表达式预览里确认有值。
• 401 或凭证错误：重新选择模型节点凭证；不要把密钥写进 System Message。
• 429 或额度不足：查看模型服务的额度、速率限制和账单，再重试，不能把“无限重试”当解决方案。
• 聊天显示完整 JSON：确认最终节点输出包含 text 或 output；初次流程让 AI Agent 保持为主流程最后一个节点。

跑通后再增加什么

先保存一份正常样本和一份缺失信息样本，再考虑记忆、其他工具或正式聊天入口。一次增加一种能力，仍用原来的 399 元算例复测。Calculator 不负责库存、折扣政策或订单授权；要读取业务数据，应额外连接有明确输入和权限边界的查询工具。

配置项与返回规则可查Tools Agent 文档、Chat Trigger 文档及OpenAI Chat Model 文档。首次验证的完成标准是输入、工具调用、工具结果和最终回复四处都能对应，而不只是聊天窗口出现一段话。