n8n · AI Agent
n8n AI Agent 接入 Tikway：OpenAI Chat Model 与工具配置
更新日期：
n8n 的 AI Agent 需要连接聊天模型和工具。Tikway 在这里提供模型 API，n8n 负责工作流执行与工具调用。先检查 OpenAI Chat Model 的地址和 Key，再连接一个简单工具，可以让初次接入更容易定位问题。
1. 选择模型与接入地址
从模型目录复制同时支持 OpenAI 协议、Chat Completions 和 Function Calling 的文本模型 ID。不同模型的工具能力、上下文和价格不同，不要仅凭普通聊天成功判断 Agent 可用。
在控制台创建 Tikway Key。基础地址使用 https://api.tikway.ai/v1，模型聊天请求应发送到 /v1/chat/completions。
本文提供按官方节点能力编写的配置与自检步骤，尚未使用你的 n8n 实例、账号和模型完成端到端运行。执行节点或工作流会调用模型并产生适用的 API 费用。
2. 配置 OpenAI Chat Model
创建测试工作流，添加 Chat Trigger 和 AI Agent，将触发器的主输出连接到 AI Agent。在 AI Agent 的 Chat Model 连接点添加 OpenAI Chat Model 子节点。
在 OpenAI Chat Model 中建立或编辑 OpenAI 类型凭据，API Key 填你的 Tikway Key。在凭据的 Base URL 字段，将默认的 https://api.openai.com/v1 改为 https://api.tikway.ai/v1，保存凭据。不要将 /chat/completions 写进 Base URL。旧节点版本也可能在 Options 中提供该字段，优先检查当前版本的凭据界面。
| 设置 | 配置方式 |
|---|---|
| API Key | Tikway 控制台创建的 Key |
| 凭据中的 Base URL | https://api.tikway.ai/v1 |
| Model | Tikway 的完整模型 ID；列表无法列出时，使用当前界面的手动 ID 输入方式 |
| Use Responses API | 关闭，本文使用 Chat Completions |
| 输出限制、超时 | 按所选模型与任务配置，不沿用无关模型参数 |
如果界面只能使用固定官方地址或固定官方模型列表，不能完成上述配置，就先停止并核对节点版本，避免把请求发到错误服务。这里的配置针对 OpenAI Chat Model 子节点，不要直接照搬到普通 OpenAI 动作节点。
3. 添加一个简单工具并限制轮次
在 AI Agent 的 Tool 连接点添加 Calculator 工具。它只做数学运算，适合验证首条工具流程。先不接入具有发送、删除或修改业务数据行为的工作流工具。
如果 Agent 的提示来源为 Chat Trigger，保留对 chatInput 的读取；若采用手动提示，明确填写测试问题。可用的系统指令示例是：
你是一个数学助手。当用户要求计算时，使用 Calculator 工具。
根据工具返回值回答；工具报错时说明错误，不编造工具执行结果。
在 AI Agent 选项里把 Max Iterations 先设为 3，打开 Return Intermediate Steps，以便检查工具执行过程。不同节点版本的选项位置可能不同。
通过 Chat Trigger 测试：
请使用 Calculator 工具计算 17 + 25，然后告诉我结果。
4. 检查运行详情，而不是只看最终回答
一次可核对的最小测试应该包含：模型请求成功、Calculator 工具调用记录、表达式或参数、工具返回值 42，以及读取结果后的最终回答。在执行详情和中间步骤中查看这些信息，再对照同一时间的 Tikway 调用记录。
如果只得到“42”，但没有 Calculator 执行记录，本次只验证了文本答案。连接线绘制成功或凭据保存成功，都不是工具调用验证。
初次接入先不加入 Memory。基础流程验证后再连接 Simple Memory 等子节点，并测试多轮输入。历史消息和工具结果会影响后续 Token 用量；检查工作流重试、Agent 迭代和模型节点重试，避免多层重试一起放大请求次数。
5. n8n Agent 常见报错
| 现象 | 建议检查 |
|---|---|
| 凭据测试失败 | 自定义端点是否生效；凭据检查可能请求模型列表，分别核对列表请求和聊天请求 |
| 401 | 是否用了 Tikway Key，是否有空格，节点引用的凭据是否是刚保存的；参考 401 排查 |
| 404 或 HTML | 实际域名和路径，是否重复 /v1 或误填官网业务 /api |
tools / 工具字段被拒绝 |
型号是否支持 Function Calling，当前模型节点和 Agent 策略是否匹配 |
| Agent 没调用 Calculator | 检查 Tool 连接、工具说明、提示词和中间步骤，不能仅用最终答案判断 |
| 达到最大迭代次数 | 检查工具返回格式、参数错误、消息回传和模型重复请求，先缩小任务 |
| Responses 相关错误 | 确认关闭 Use Responses API，实际请求使用 Chat Completions |
关闭 Responses 模式后，不要预期 OpenAI 内置网页搜索、文件搜索或代码解释器自动可用。n8n 自己连接的工具、上游模型内置工具和 MCP 是不同层次，需要分别验证。
6. 预算和后续扩展
工具本身可能免费，但 Agent 调用模型会计费，外部工具还可能有自己的费用。先用Token 费用计算器估算文本请求，再按实际模型轮次、上下文增长和调用记录计算任务成本。
需要扩展到 HTTP Request、工作流工具或 MCP 时，每次只增加一个工具，并保留参数校验和迭代限制。Tikway 能提供模型接入，不代表每个第三方工具或 n8n 节点组合都已经通过验证。
继续阅读：Agent API 接入与选型 · LangChain 接入教程 · Dify 接入教程 · 模型目录
参考：n8n OpenAI Chat Model · n8n Tools Agent · OpenAI 凭据字段源码。按当前版本确认开关和字段位置后，再用最小任务自检。