展开本页目录
开始前准备什么
- 记录 n8n 版本和节点 typeVersion；已有 Credential 管理权限。
- 在 n8n 服务的运行环境核对网络；apizt token 分组支持 glm-5.3 的 Chat 工具调用。
- 使用 Manual Trigger 和固定演示订单，不连接真实订单、邮件或支付系统。
- 填服务端凭据
- 选择 Chat 模型
- 建立只读工具
- 运行三条查询
- 检查实际执行
按当前版本手动建立；非自动导入工作流。
两条只读订单，无真实业务信息。
主工作流和模型工具连接分别建立
| 节点 | 连接 | 作用 |
|---|---|---|
| Manual Trigger → Edit Fields → AI Agent | main | 传入一次固定 prompt |
| OpenAI Chat Model → AI Agent | Chat Model | 发起模型请求 |
| Call n8n Workflow Tool → AI Agent | Tool | 执行独立只读子工作流 |
| Memory（本任务不用） | Memory | 若后续添加，需要单独验证历史和费用 |
- 节点
- Manual Trigger → Edit Fields → AI Agent
- 连接
- main
- 作用
- 传入一次固定 prompt
- 节点
- OpenAI Chat Model → AI Agent
- 连接
- Chat Model
- 作用
- 发起模型请求
- 节点
- Call n8n Workflow Tool → AI Agent
- 连接
- Tool
- 作用
- 执行独立只读子工作流
- 节点
- Memory（本任务不用）
- 连接
- Memory
- 作用
- 若后续添加，需要单独验证历史和费用
当前凭据与 Chat Model 字段
当前源码在 OpenAI credential 提供 Base URL；旧 Chat Model 版本也可能显示 Options > Base URL。先核对自己的节点版本与实际生效字段，避免两处设置冲突。此任务使用 Chat，Responses 与内置 OpenAI 工具另行验收。
n8n 字段核对
OpenAI credential
API Key: 在凭据库填写自己的 apizt Key
Base URL: https://api.apizt.com/v1
Organization ID: 留空，除非服务明确要求
OpenAI Chat Model
Model: By ID → glm-5.3
Use Responses API: 关闭
AI Agent
Max Iterations: 6
System Message: 状态必须通过 lookup_demo_order 查询，不执行变更
本站绘制的内容说明图：对应此页 Chat Agent 的保守设置；官方连接图只作子节点端口参照，不等同本页订单工具运行。
子工作流只查固定订单
从 When Executed by Another Workflow 接收 string 类型 order_id，用 Code 节点读取固定表并输出 status、shipped 与 source。主工作流的 Call n8n Workflow Tool 指向它，让 order_id 可由模型传入。下载的说明按字段重建，不是可跨版本自动导入的 workflow。
Code 节点 · Run Once for Each Item
const orders = {
"DEMO-1001": { status: "paid", shipped: false },
"DEMO-1002": { status: "cancelled", shipped: false }
};
const orderId = String($json.order_id ?? "");
const order = orders[orderId];
return { json: { order_id: orderId, ...order, status: order?.status ?? "unknown", source: "demo-fixture" } };
本站绘制的内容说明图：示例订单是只读本地数据，不是实际客户订单；模型调用工具不能触发退款、发货或改写数据库。
小任务：两条已知订单，加一条未知订单
prompt：“查询 DEMO-1001、DEMO-1002、DEMO-404 的付款及发货状态，不执行任何变更”。执行可能产生多次在线模型请求；本页未运行付费验收。
- 查看三次工具执行：1001 为 paid/false，1002 为 cancelled/false，404 为 unknown。
- 核对每次工具 input 有对应 order_id，output 来源为 demo-fixture；Agent 最终答复不新增物流单号。
- 独立检查没有其他子工作流或外部写入运行；如果只输出猜测答案，没有工具记录，判为未通过。
- 保留主执行与子执行 ID、全部模型回合、usage 和实际账单；一次主工作流不等于一次模型扣费。
自定义端点不能代替所有 OpenAI 节点能力
- 官方 Chat Model 源码明确提醒：非 OpenAI 模型可能不支持 tools 或 JSON format，必须实际验证。
- 不要用 OpenAI Assistants、内置 web search 或 Responses 的配置套入 Chat 示例。
- 模型列表校验使用 /models，只证明目录请求；任务还要验证实际 Chat 和工具往返。
- n8n 在服务端运行时，本机 export 的变量或 localhost 不是服务器的凭据和网络。
- 从只读工具升级为写操作时，另行加入参数验证、权限与业务幂等，重试前检查是否已执行。
怎样确认已经完成
- 三条订单均有子工作流 input/output，未知订单不编造。
- Chat 与 Responses 开关、credential 和实际 URL 对应。
- 执行记录含所有回合，测试没有真实业务写入。
常见问题
为什么模型列表能加载但 AI Agent 失败？
/models 和工具调用是不同请求。检查准确 ID、Chat tools schema、节点版本、工具连接和原始错误；有些模型只能回答文字。
把 Base URL 改了，所有 OpenAI 节点都会兼容吗？
不能。Chat、Responses、Assistants、Images 和内置工具的接口契约不同，需要逐节点验收。
工具执行会直接消耗模型 tokens 吗？
本地固定表查询本身不调用模型，但工具参数、返回结果和后续模型回合会增加任务用量。以全部请求与账单核对。