WhatsApp AI 助手与知识库配置教程：上传 PDF/网页资料、设定回复范围与转人工规则

概览

AI 训练与知识库（AI Training）用于创建聊天助手 — 基于文本的 AI 角色 — 并用你自己的内容训练它们。训练好的助手可以为网站上的网站聊天组件提供回答；同一套人设与知识库也可用于团队收件箱、自动回复与流程中的 AI 节点。你可以在 More → AI Training 下管理它们。

聊天助手由两部分组成：人设与模型设置（开场语、角色说明、语气、语言、提供商、模型、回复长度、创造力、兜底话术与转人工规则），以及一组知识来源（网页链接、文件、纯文本与问答对）。当有人聊天时，助手会依据你的材料作答 — 见 助手的使用场景。

用五步 Smart Agent Builder 构建聊天助手：Identity、Persona、Brain、Safety 与 Knowledge。

前提 — 确认当前入口的模型与密钥。先确认当前工作区已有可用模型与授权；有相应权限的工作区也可使用自有密钥。缺少模型或权限时，请联系负责配置的成员核对。以当前助手入口的供应商列表和密钥来源为准，不把某一入口的预配置方式当作所有 AI 功能的共同条件。

受套餐限制。AI 训练与知识库需要 AI Chat Assistant 套餐功能 — 也就是网站聊天组件所依赖的同一功能 — 因此未包含它的工作区无法创建助手。

创建聊天助手

1. 打开构建器，从 AI Training 列表进入（或打开现有助手进行编辑）。
2. 完成下面的五个步骤。可随时点击 Save draft；人设与模型设置会一起保存。
3. 在第 5 步添加知识来源。每个来源都会立即检查，并进入 ready（或 failed）状态。
4. 把状态设为 Live（第 1 步），助手才能被网站聊天组件选择 — 只有 Live 状态的助手会出现在组件选择器中。
5. 关联助手到一个网站聊天组件，让它开始工作。

全新助手带有合理的默认值（友好的开场语、简洁的 "helpful website assistant" 角色说明、OpenAI gpt-4o-mini、400 token 回复、创造力 0.7、转人工开启）。首次保存前你可以修改其中任何一项。

第 1 步 · 身份

语气选项

所选语气会与语言一起，塑造助手每次回复的写作风格。

第 2 步 · 人设与开场语

安全规则写在角色说明里。角色说明是放置护栏的正确位置 — 例如 "never quote prices above $500 (escalate to a human instead)" 或 "politely refuse to discuss competitors."。你在这里写的内容会逐字提供给助手，因此会影响每一次回复。

第 3 步 · 模型与回复控制

选择已启用的模型供应商与模型，再调整回复方式。AI 智能体支持 OpenAI、Anthropic、Gemini、Mistral 原生协议及兼容端点；工作区自有密钥与平台密钥按权限和启用配置使用。不同助手入口的可选模型以该入口的列表为准，下方常见模型示例不是供应商总目录。

模型参考

构建器为每个提供商建议的示例模型名称：

第 4 步 · 兜底与转人工

第 5 步 · 训练助手（知识）

添加助手用于作答的材料。每个来源都会即时处理，并显示为 ready（或 failed）状态，附带大致的大小估算。共有四种来源：

来源可以只适用于一个助手，也可以适用于整个工作区。来源可随时删除，删除来源时上传的文件也会一并移除。来源列表会逐行显示类型、标签、状态与大小估算。

文件格式。接受的文件类型为 TXT、Markdown（.md / .markdown）、纯文本、CSV、LOG、HTML（.html / .htm）、PDF 与 DOCX。PDF 与 DOCX 会自动提取文本。其它文件类型会返回明确的错误。

URL 安全与限制。URL 读取器只打开公开网页（http / https），拒绝其它协议，并阻止任何指向私有、内部或本地网络的地址 — 因此你添加的链接无法用于访问内部系统。它最多等待 20 秒，每页最多读取约 80,000 个字符。

助手的使用场景

处于 Live（已启用）状态的聊天助手会成为网站聊天组件的对话大脑。访客发送消息时，组件会：

1. 把访客的消息保存到会话中。
2. 如果组件运行了助手，则生成回复并保存，然后展示给访客。
3. 如果出现任何问题，显示助手的兜底消息，而不是报错。

回复由你的角色说明、语气、语言和转人工短语，加上你的知识来源共同构建。它会按顺序使用适用于该助手或整个工作区的每个 ready 来源，总量上限为 12,000 个字符。近期的对话历史（大约最近 20 轮）也会包含在内，让回复保持切题。

其它使用场景。除网站聊天组件外，同一套人设与知识库还可为团队收件箱中的 AI 接管、自动回复与流程中的 AI 节点提供回答依据。WhatsApp 侧通过协议连接接入 Business App 或个人版账号，按会话与账号范围核对助手指派、功能权限和启用状态；网站聊天由已启用的网站助手接待，与 WhatsApp 会话分别管理。

管理助手

• 复制（Duplicate）助手 — 把它的人设、模型设置与全部训练来源复制为一个新的 paused "(copy)" 助手。适合派生人设，例如把 "Pricing concierge" 克隆成西班牙语版本。
• 删除（Delete）助手 — 从列表中移除它，同时保留底层数据。
• 列表会显示总计 — 全部助手、启用中的助手、知识条目总数以及其中 ready 的数量 — 以及每行的提供商、知识数量、语气和最后更新时间，并支持按名称搜索。

费用注意事项

仅使用适用范围内、已就绪且被上下文预算容纳的来源。参与上下文的内容越多，通常会带来更高的模型用量；应在 12,000 字符预算内优先保留相关资料。

• 保持来源精简且相关；一条好的 FAQ 问答往往比整站内容更有用。
• 对最重要的答案优先使用问答对 — 它们紧凑且无歧义。
• 高流量的组件建议使用更小的模型（例如 gpt-4o-mini 或 gemini-2.5-flash-lite），并设置合理的回复长度。
• 区分工作区 AI 用量记录、套餐额度与模型供应商账单。是否阻止新回复、何时恢复，按当前入口启用的额度策略处理；用量报表本身不代表所有 AI 入口采用相同的拦截规则。

故障排查