AI
如何使用 OpenAI Agents SDK 构建 WhatsApp 智能体
OpenAI Agents SDK 为您提供智能体、工具、交接和护栏。本文介绍如何把它变成客户真正可以信赖的 WhatsApp 智能体，而无需自己搭建 WhatsApp 对接、收件箱或转人工机制。
MonoChat 团队 更新于: 2 分钟阅读
本页内容
OpenAI Agents SDK 是 OpenAI 用于构建智能体的开源框架：一个带有指令的模型、它可以调用的工具、向其他智能体的交接，以及围绕其输入和输出的护栏，全部在一个循环中运行，直到任务完成。它是构建智能体的绝佳方式。但它本身并不会为您提供 WhatsApp 号码、团队收件箱、模板消息，或让真人接手的方式。借助 MonoChat 的 Agent Harness，您选择 OpenAI Agents SDK 作为 AI Harness，在流程中放置一个 AI 智能体节点，连接 WhatsApp 并测试，其余的交给 MonoChat。
本指南涵盖该 SDK 为您提供的能力、在 MonoChat 中使用 OpenAI 智能体的三种方式、分步设置，以及决定客户是否信任智能体的 WhatsApp 专属细节。
OpenAI Agents SDK 为您提供什么
该 SDK 围绕一小组理念构建：
- 智能体： 一个模型加上描述其工作的指令。
- 工具： 智能体可以调用的函数，例如“查询订单”或“检查时段”，以及 MCP 服务器。
- 交接（Handoff）： 一个智能体把任务交给专精于此的另一个智能体，例如从通用客服智能体交给退货智能体。
- 护栏（Guardrail）： 与智能体并行运行的检查，用于阻止您不希望出现的输入或输出。
- 会话与追踪： 跨轮次的记忆，以及对智能体每一步操作的记录。
这些合在一起就是智能体 Harness：让模型能够行动、检查自己的工作并继续，而不是只回答一次的循环。对于客户消息场景，这就是“解释退货政策”和“真正创建退货”之间的区别。
WhatsApp 为这个问题增加了什么
构建智能体只是工作的一半。要让它在 WhatsApp 上面对客户，还需要处理：
- WhatsApp Business Platform。 官方 API 连接、已验证的企业和已获批准的号码。
- 24 小时窗口。 在客户最后一条消息后的 24 小时内允许自由回复；之后需要已获批准的模板。
- 政策。 自 2026 年 1 月 15 日起，WhatsApp 禁止通用 AI 助手出现在该平台上。服务于您自己客户的智能体是允许的，并且在回复为自动化时，要求提供一条通往真人的清晰路径。
- 人员。 有些会话必须转给真人，并且在您团队已在使用的工具中保留完整历史记录。
- 其他渠道。 在 Instagram、Messenger 或您的网站上留言的客户，期望得到相同的答复。
MonoChat 围绕智能体处理这些事项，让您的工作集中在智能体本身。
在 MonoChat 中使用 OpenAI 智能体的三种方式
| 选项 | 运行位置 | 您需要准备 |
|---|---|---|
| OpenAI Agents SDK | MonoChat 内部 | 无需额外准备；使用您的 AI 模型 |
| OpenAI Agents API（由 OpenAI 托管） | OpenAI 云 | 您的 OpenAI API 密钥 |
| 自定义（您自己的 Agents SDK 服务） | 您自己的服务器 | 一个端点 URL 和一个共享密钥 |
如果您想要 OpenAI 风格的智能体而无需部署任何东西，请从 OpenAI Agents SDK Harness 开始。 如果您的智能体已经在 OpenAI 的托管平台上，请选择 OpenAI Agents API。 如果您的开发人员已用该 SDK 编写了自己的智能体，包含自己的工具、交接和测试，并希望继续运行这些代码，请选择“自定义”；请参阅如何将您自己的 AI 智能体连接到 WhatsApp。
分步操作：WhatsApp 上的 OpenAI Agents SDK 智能体
1. 添加 AI Harness
在 MonoChat 中添加 AI Harness，并选择 OpenAI Agents SDK 作为提供方。它在 MonoChat 内部运行，并使用您已设置好的 AI 模型，因此这一步无需额外的密钥或服务器。
2. 在流程中添加 AI 智能体节点
在接收您 WhatsApp 会话的流程中，添加一个 AI 智能体节点并选择该 Harness。编写智能体的指令：它服务于谁、能做什么、绝不能做什么，以及何时转人工。
3. 选择主模型、备用模型和快速模型
每个 AI 智能体节点都有三种模型角色：
- 主模型负责推理并撰写回复。
- 备用模型在达到软限制或失败后接手。
- 快速模型处理后台工作。
添加每次运行的预算限制，避免一场不寻常的会话产生巨额账单。不确定如何选择备用模型？请阅读面向客户的 AI 智能体为什么需要备用模型。
4. 连接您的工具
为智能体提供与您最常见请求相匹配的工具：
三个好工具胜过十五个半成品。看到真实会话之后再添加更多。
5. 连接 WhatsApp（以及其他一切）
通过 MonoChat（官方 Meta Business Partner）连接您的 WhatsApp Business 号码。同一个流程可以在 Instagram、Messenger、TikTok、Telegram、网页聊天、短信和语音上运行，因此一个智能体就能覆盖所有渠道。
6. 用真实消息测试
把上个月的会话作为测试集。要包含那些棘手的：愤怒的客户、含糊的问题、一条消息里有多个请求、一上来就要求找真人的客户。检查工具调用、语气和转人工。然后上线。
在 WhatsApp 上效果良好的做法
每条消息一个问题。 为网页聊天构建的智能体往往用很长的列表作答。在手机上，简短的消息和一次一个清晰的问题，能让客户给出更好的回应。
在不可逆操作之前先确认。 在取消、退款或更改预订之前，让智能体提出方案，由客户确认。
专家通过交接，真人通过收件箱。 SDK 的交接非常适合在智能体之间路由（销售、客服、退货）。转交给真人则应放在 MonoChat 的共享团队收件箱中，会话会带着完整历史记录抵达那里。
指令中写明限制。 “退款在 €50 以内您可以批准；超过则转交给账务团队。”明确的数字胜过含糊的规则。
始终围绕您的业务。 帮助您客户的智能体在 WhatsApp 上是允许的。什么都能回答的智能体则有违反 WhatsApp 2026 年规则的风险；我们的 WhatsApp AI 聊天机器人政策指南解释了界线在哪里。
成本
三项费用叠加：您的 MonoChat 套餐、AI 模型用量和 Meta 的 WhatsApp 消息费用。自 2026 年 10 月 1 日起，Meta 对每个企业号码每月前 1,000 条之后的服务回复收费；请参阅我们的 WhatsApp API 价格指南。
在 AI 方面，当您使用自己的提供方密钥时，MonoChat 不加价。每次运行的预算、用于后台工作的较便宜的快速模型以及可靠的备用模型，可以让账单保持可预期。
不被锁定
Agent Harness 让您选择的是框架，而不只是模型。如果您之后想试用 Claude Agent SDK、Pi、Claude Managed Agents 或您自己的框架，只需添加另一个 AI Harness，并让 AI 智能体节点指向它。您的渠道、工具和转人工机制保持不变。请在 Agent Harness 页面比较所有提供方。
用 MonoChat 付诸实践