接入 AI 客服不应该从一项庞大的知识库工程开始。对独立开发者和小团队来说，第一个有价值的目标更简单：让已有内容承担重复问答，同时让特殊问题仍然能被人看到和处理。
下面是一条完整但克制的 Bubblo 上线路径。它不假设网站里的所有内容都已经整理完毕，也不把每一段对话都交给自动化。
Bubblo 以组织作为这套配置的范围。知识库、Actions、收件箱对话和唯一的 Widget Channel 都属于组织，无状态 AI Runtime 会在每轮对话中加载这些组织级资源；不需要另外创建或选择 Agent 资源。
1. 从一份聚焦的知识内容开始
先选择这个网站所属的组织，再打开Harness → 知识库。从一类用户经常询问、而且答案相对稳定的内容开始，例如定价、退换政策、安装方法或账号访问。聚焦的内容比一次导入整站更容易校对，也能为首次测试提供明确的问题清单。
Bubblo 目前支持三类知识来源：
- 公共网页：提交完整页面 URL 后，该页面会被抓取并保存为草稿。
- 网站根地址：Bubblo 可以从 sitemap 中发现最多 200 个 URL，之后由你选择并逐页抓取。
- 文件或手动内容：支持不超过 20 MB 的 PDF、DOCX、Markdown 和纯文本文件，也可以直接在控制台编写内容。
新增内容首先是草稿。请检查提取后的文字，修正不清楚或已经过期的部分，再点击索引。只有状态变为已索引后，组织的 AI 才会使用这份内容回答问题。这个检查步骤不能省略：客服自动化是否可信，首先取决于背后的信息是否可信。
完整操作可以参考知识库指南。
2. 用一段脚本安装到网站
打开 Integrations → Widget，复制页面顶部生成的安装代码。格式如下：
<script src="https://cdn.bubblo.ai/widget.js" cid="YOUR_CHANNEL_ID"></script>把它放在网站公共布局中、结束 </body> 标签之前，然后重新发布。脚本只需加载一次。公开的 cid 用于标识当前组织唯一的 Widget Channel，因此应当从控制台复制 Widget CID，而不是手动编造；同一个 Channel 可以安装在同一网站的多个页面中。
目前正式支持的安装方式就是这段脚本。挂件安装指南中还包含验证方法和故障排查入口。
3. 认真设计第一次对话
在邀请真实访客使用前，请使用 Integrations → Widget 安装代码下方的外观表单。你可以选择挂件颜色和显示位置，并为每个已启用语言设置助手名称、欢迎语、建议问题和输入框提示。
建议先放两到三个能够被现有知识可靠回答的问题。它们既能帮助访客理解挂件可以做什么，也能成为团队每次发布前重复执行的测试用例。预览会即时变化，但线上挂件只有保存配置后才会更新。
4. 测试完整的客服闭环
看到聊天按钮并不等于完成上线，还应当同时验证访客端和客服端：
- 询问一个已经写进知识来源的问题。
- 确认对话出现在同一组织的收件箱中。
- 开启人工接管并发送一条人工回复。
- 关闭接管，确认对话可以重新交给 AI 处理。
- 对话结束后将它标记为已解决。
人工接管是一项明确的控制：团队成员处理对话时，它会暂停 AI 回复；它并不代表任何时刻都一定有人工在线。收件箱指南解释了三种会话状态和接管方式。
一次小而可信的首次上线
在把真实流量交给挂件之前，请确认：
- 高频问题都有最新且已经索引的知识来源。
- 建议问题与组织的 AI 当前真正能回答的范围一致。
- 至少一名团队成员知道在哪里查看待人工对话。
- 挂件在移动端可用，并且不会遮挡网站的重要操作。
- 网站隐私说明覆盖了客服流程中收集的访客信息。
第一版的目标不是自动解决所有边界情况，而是减少重复劳动、让常见答案能够及时到达，并让剩余问题有一条清晰的人工处理路径。