核心概念

了解组织、AI 运行核心、知识库、Widget 和会话之间的关系

Bubblo 由少量核心对象组成。先理解它们各自的作用域，后续使用控制台会更直观。

组织

组织是资源归属、权限、计费和数据隔离的边界。组织成员共享一套知识库和 Actions、一个收件箱、组织级 AI 供应商配置，以及一个 Widget 渠道。

Starter 和 Pro 组织可以保存多个 OpenAI 兼容供应商，每个供应商可以保存多个候选聊天模型并选择一个当前模型。组织同时最多启用一个供应商，也可以全部停用。切换由所有者手工完成：启用新供应商时会停用原供应商；已启用配置需要先停用才能编辑。Bubblo 不会在其他已保存供应商之间自动设置优先级、路由或故障转移。

组织还会选择 AI 回复方式。先使用 Bubblo AI 会先消耗当前用量周期的托管回复额度，额度用完后才改用当前启用的自定义供应商；仅使用当前供应商 则从第一轮起就使用它。托管 AI 或当前供应商无法回复时，系统不会自动改用另一个已保存供应商，而会让对话进入待人工。文档和检索的向量嵌入始终由 Bubblo 托管。详见 AI 供应商。

如果你加入了多个组织，可以在控制台侧栏切换。互不共享数据的不同业务或网站，应分别使用不同组织。

无状态 AI 核心

Bubblo 在所有组织间使用同一套无状态 AI 运行核心。每轮对话都会按当前组织装配资源。运行核心不是控制台中的资源，不能单独创建、配置或切换。

运行核心会组合当前组织的知识库、已启用 Actions、有效的 AI 回复方式、Widget 渠道配置与会话上下文生成回答。请求结束后不会保留组织状态或独立、长期存在的 AI 身份。

Widget 渠道与 cid

Widget 是安装在网站上的聊天界面。每个组织当前只有一个 Widget 渠道，它保存客服名称、头像、外观和访客可见文案。渠道不与某个网站域名绑定。

安装代码中的 cid（渠道 ID）告诉 Bubblo 请求来自哪个 Widget 渠道，并由此确定所属组织：

<script src="https://cdn.bubblo.ai/widget.js" cid="YOUR_CHANNEL_ID"></script>

这段代码是公开的 Widget 配置，不能用来证明访客身份。

知识来源

知识来源是组织拥有、可供 AI 回答问题时使用的内容，可以是手动文本、网页、从站点发现的 URL，或上传的文件。

添加来源后，它不会立刻变成可检索内容，而会经历下面的状态：

unindexed -> indexing -> indexed
                      \-> failed

只有已索引的内容才可供检索。编辑或重新抓取后，来源会回到 unindexed，需要再次索引。详见知识库。

会话

Widget 中的访客会话会出现在组织的收件箱。当前状态表示会话是否打开，以及人工接管是否已暂停 AI：

待人工原因、接管、回复、会话总结、解决和重新打开的行为详见收件箱。