把 n8n 智能体接入产品时，应先冻结输入和输出契约，再连接模型。否则产品端会直接依赖节点临时字段，工作流稍改就会报错。 示例只演示服务端到服务端的 JSON 调用，未在你的网络和身份系统中实测；不要把长期凭证放到浏览器前端，也不要让未认证的公网请求直接触发付费模型。
本篇验收要点：Webhook 节点使用 POST，只接收 request_id、message 和 user_id 三个业务字段。 Respond to Webhook 节点固定返回 request_id、answer、status 和 error，避免直接暴露模型节点的内部结构。
先写清最小请求契约
推荐由产品后端发送请求，前端只调用自己的后端。示例请求如下；request_id 用于幂等和排错，user_id 应由已认证后端生成，不能信任浏览器随意传入的身份。
{
"request_id": "req_20261001_001",
"user_id": "u_42",
"message": "请把这段售后记录归纳为三点"
}
配置 Webhook、校验和智能体
- Webhook 选 POST，并启用 Header Auth 或由网关完成身份验证。
- 用 If 或 Code 节点检查三项字段、长度和允许的内容类型。
- 查询 request_id 是否已经处理；存在则返回既有结果。
- 调用智能体，只把必要文本交给模型，并设置超时与最大输出。
测试阶段用 Test URL；激活后产品后端必须改用 Production URL。
固定响应，不泄漏内部错误
Respond to Webhook 选择 JSON 响应。成功时返回 status=completed；模型超时或工具失败时返回 status=failed 和面向产品的错误代码，详细堆栈保留在 n8n 执行记录。不要在响应中返回 API 密钥、节点参数或完整提示词。
{
"request_id": "req_20261001_001",
"status": "completed",
"answer": "……",
"error": null
}
读者下一步是先用固定假回答跑通 Webhook 与产品后端，再把中间节点替换为已经单独验收的智能体。
验证标准是合法请求得到 2xx 和约定 JSON，缺字段得到可识别的 4xx，重复 request_id 不会重复执行付费动作，n8n 执行记录能按请求 ID 回查。
常见问题
可以让浏览器直接请求 Webhook 吗？
技术上可以，但长期密钥、跨域、滥用和身份伪造风险更难控制。面向正式产品时优先通过自己的后端或 API 网关。
智能体运行时间超过 HTTP 超时怎么办？
改成受理后返回任务 ID，再由产品轮询或接收回调；不要把长任务硬塞进一次同步请求。
官方资料与适用边界
Ai菜鸟网。发布者：AI小管家，转载请注明出处：https://www.alyyhw.com/31122.html
