┌──────────────────────────────────────────────────────────────────────┐ │ Brain 数据源版图 — 演进 │ ├──────────────────────────────────────────────────────────────────────┤ │ Phase 1（v10.8.0）：5 个 native source │ │ ┌────────┬──────────┬────────┬────────┬────────────┐ │ │ │ Notion │ GDrive │ Slack │ GitHub │ Confluence │ │ │ └────────┴──────────┴────────┴────────┴────────────┘ │ │ │ │ Phase 2（v10.11.0）：+1 native source（首个客服域） │ │ ┌──────────┐ Zendesk（Help Center + 工单 comment thread） │ │ └──────────┘ │ │ │ │ Phase 3（v10.13.0）⭐：任意 connector 皆可作源（platform 化） │ │ ┌──────────────────────────────────────────────────────┐ │ │ │ Gmail · Linear · Intercom · HubSpot · Jira · │ │ │ │ SharePoint · … connector library 100+ app │ │ │ │ （AI setup chat 自动探查 + 审批 → 变 Brain 源） │ │ │ └──────────────────────────────────────────────────────┘ │ │ │ │ 例外（不可作 BYO 源）：已有 native source 的 5 app / action-only 抓取类 │ │ / raw database / warehouse（需 write 权限） │ │ │ │ + File uploads（用户上传文件） │ └──────────────────────────────────────────────────────────────────────┘
| 模式 | 覆盖率增长 | 瓶颈 |
|---|---|---|
| native source（Phase 1-2） | 线性——每个源需官方工程团队专门适配 | 受限于官方工程投入 |
| Any Connector（Phase 3）⭐ | 指数级——跟 connector 生态（100+ app）自动扩展 | 仅受限于 connector library 覆盖面 |
| 步骤 | 动作 |
|---|---|
| ① Pick the app | 「Add a source」搜 app，无 native source 的出现在 Build your own 区 |
| ② Connect account + 可选描述 | 选读取账户；可选写"our support emails"，留空则 setup chat 给合理默认 |
| ③ Approve proposed plan | AI 探查 app + 提议同步计划。Looks good 进选择屏 / Request changes 调整 |
| ④ Choose what to sync | 基于计划的选择屏细选，用 app 自己的概念（labels/folders/channels），Add source |
┌──────────────────────────────────────────────────────────────────────┐ │ AI setup chat — 4 个能力 │ ├──────────────────────────────────────────────────────────────────────┤ │ ① Inspects the app 学习内容怎么组织、哪些部分值得做可搜索 │ │ ② Proposes a plan 自然语言摘要"你将得到什么"，而非设置清单 │ │ ③ May ask a question 当选择真属于用户时（workspace/username）， │ │ 总是给选项让用户选，不开放填空 │ │ ④ You approve/change Looks good → 选择屏 / Request changes → 重做计划 │ │ │ │ 🔴 read-only 铁律：只读连接的账户来规划和同步， │ │ 绝不 create/edit/delete 用户 app 里的任何东西 │ │ │ │ 💡 Tip：connect 步骤给提示可得更定制计划，如 │ │ "just our #announcements channel"——提到的内容带到选择屏，不必重填 │ └──────────────────────────────────────────────────────────────────────┘
AI setup chat 把"理解 app 数据模型"这个最重的认知负担从用户转给 AI——产品用 AI 降低自己的使用门槛，而非让用户填一堆配置表单。这是 agent 智能用在产品 onboarding 环节本身的范式创新。
| 控件 | 作用 |
|---|---|
| Sync by | app 多维组织时选同步维度（如 Gmail Labels vs 搜索查询） |
| Sync everything | 索引整个源，含后续新增内容 |
| Select what to sync | 手选勾选的容器（特定 labels/folders/channels） |
| What to include | toggle 哪些内容流被索引（正文 vs 评论）；核心默认开 |
| Search box / queries | 对只能按标识符/查询触达的内容，输入值拉取 |
审批 + 细选后，BYO 源行为与其他源一致：Preparing → Active；进入 sources 列表 / knowledge graph / agent citations；自动持续同步（connector 类默认约每小时）；上游删除 → 下次成功同步时移除；可 re-sync / pause / edit / delete；scope 继承（Personal/Team/Organization）。attach 到 agent 后，agent 自动获得 Search Company Brain（混合搜索）+ Read document（取全文）两个内置工具，自主决定何时搜索。
┌──────────────────────────────────────────────────────────────────────┐ │ 不能作 BYO 源的 4 类 │ ├──────────────────────────────────────────────────────────────────────┤ │ ❌ 已有 native source 的 app：Notion / GDrive / Slack / GitHub / │ │ Confluence——用专用 setup，不出现 Build your own 区 │ │ │ │ ❌ action-only / 抓取类平台：web-scraping、enrichment——无内容库，隐藏 │ │ │ │ ❌ raw database / warehouse：安全同步需 write 权限，Brain 永远不用 │ │ │ │ ⚠️ Empty accounts / missing permissions：setup chat 告知而非创建空源， │ │ setup 无法完成（含 credits 耗尽）显示 Setup failed + 简短原因 │ └──────────────────────────────────────────────────────────────────────┘
Brain 永远只用读权限，任何需 write 权限才能安全同步的系统（数仓的细粒度权限模型）都被排除。这就是 v10.13.0 同版 "Key-Pair Auth for Snowflake" 让 agent 直连数仓但不作为 Brain 源的原因：数仓走 connector（on-demand 查询），不进 Brain（全量索引）。清晰的"知识索引 vs 数据查询"边界。
Indexing：内容处理时计费（首次添加 + 内容变更）。BYO 源内容量取决于 app，大邮箱/大项目库首次索引成本较高。Searching：按查询计费，计入 agent run。
| ID | 触发场景 | 系统行为 | 优先级 |
|---|---|---|---|
| A1 | 搜索无 native source 的 app | 出现在 Build your own 区 | P0 |
| A2 | 选 app | 进 connect account 步骤 | P0 |
| A3 | 连接账户 + 可选描述 | 启动 AI setup chat，可携用户提示 | P0 |
| A4 | setup chat 探查 | AI 读 app 内容组织，提议同步计划 | P0 |
| A5 | 计划需用户决策 | AI 问选择题，给选项 | P1 |
| A6 | 用户审批 | Looks good 进选择屏 / Request changes 重做 | P0 |
| ID | 触发场景 | 系统行为 | 优先级 |
|---|---|---|---|
| B1 | 进选择屏 | 基于审批计划构建控件（随 app 变） | P0 |
| B2 | Sync by 切换 | app 多维组织时切维度 | P1 |
| B3 | Sync everything / Select | 全量或手选容器 | P0 |
| B4 | What to include toggle | 选内容流，核心默认开 | P1 |
| B6 | Add source | Gumloop 接管爬取、索引、同步 | P0 |
| ID | 触发场景 | 系统行为 | 优先级 |
|---|---|---|---|
| C1 | 启动 setup chat | inspect app 内容组织 | P0 |
| C2 | 探查完成 | propose 同步计划（自然语言摘要） | P0 |
| C4 | 全程 | 严格 read-only，绝不 create/edit/delete | P0 |
| C5 | 账户空/权限缺 | 告知而非创建空源，提示换账户 | P1 |
| C6 | setup 无法完成 | 源显示 Setup failed + 简短原因 | P1 |
| ID | 触发场景 | 系统行为 | 优先级 |
|---|---|---|---|
| D1-D4 | 首次添加/内容变更/上游删除/源管理 | 索引 + 约每小时同步 + 移除 + re-sync/pause/edit/delete（同 native） | P0 |
| E1-E3 | attach / agent 判断 / agent 回答 | 获 Search+Read 工具 / 自主搜索 / 引用来源 | P0 |
| F1 | app 有 native source | 不出现 Build your own，走专用 setup | P0 |
| F2 | action-only/抓取类 | 隐藏（无内容库） | P0 |
| F3 | raw database/warehouse | 不开放（需 write 权限，Brain 不用） | P0 |
作为客户成功负责人，我希望把 support Gmail 接进 Brain——不用填配置，让 AI 帮我搞清怎么同步，agent 就能基于历史邮件回答客户问题。
画像：林运营，31 岁，SaaS 公司客户成功负责人。团队用 Gmail 处理 support 邮件，历史邮件沉淀大量"客户怎么问、我们怎么答"的记录，但 Brain 此前接不进 Gmail。
验收标准：
作为 tech lead，我希望把 Linear 项目数据灌进 Brain，让工程 agent 能语义搜索"这个 epic 涉及哪些 ticket、各自状态"，而非一个个 ticket 调 connector 查。
画像：陈工，33 岁，工程团队 tech lead。团队用 Linear 管 epic/ticket，agent 此前只能通过 connector 逐个查 ticket（慢且无法跨 ticket 语义搜索）。
验收标准：
| 竞品 | 任意 connector 作知识源 | 优势 | 劣势 |
|---|---|---|---|
| Glean | 可索引大量企业 app | 企业搜索覆盖广，权限成熟 | 非 agent 平台；无行动能力；固定表单配置 |
| Guru | 可接多源知识 | 知识管理专精 | 非 agent 平台；无 AI setup chat |
| ChatGPT/Claude（GPTs/Skills） | 仅文件上传/少量连接器 | — | 无法同步企业 SaaS；无 connector 生态 |
| Zendesk AI / Intercom Fin | 自家客服系统 | 客服场景专精 | 绑死自家系统；非通用知识层 |
| Gumloop Brain（v10.13.0 后） | 任意 connector（100+ app） | agent 平台 + AI setup chat 零配置 + 既有 connector 生态复用 + read-only 安全 | 单 connector 层面可抄；BYO 源无 Document access |
| 漏斗阶段 | 事件名称 | 指标/KPI | 优先级 |
|---|---|---|---|
| 采用 | brain_byo_source_added | BYO 源连接数（按 app 分布） | P0 |
| 采用 | brain_byo_setup_chat_approved | 审批通过率（vs Request changes） | P0 |
| 采用 | brain_byo_source_attached | attach 率 | P0 |
| 执行 | brain_byo_search | BYO 源查询数/日 | P0 |
| 影响 | brain_byo_coverage_apps | 组织 Brain 覆盖系统数提升 | P0 |
| 风险 | brain_byo_setup_failed | 失败率（按原因：credits/权限/空账户） | P1 |
| 阶段 | 时间线 | 里程碑 | 状态 |
|---|---|---|---|
| Phase 1 — Any Connector 作源 | v10.13.0 | AI setup chat + 选择屏 + 100+ connector 可作源 | 已发布 |
| Phase 2 — Document access 扩展到 BYO 源 | v10.x+ | BYO 源支持文档级权限继承（目前仅 GDrive） | 推断/规划 |
| Phase 3 — 跨源联合检索 | v11.x | native + BYO 源混检，Brain 成"企业单一知识入口" | 探索 |
| Phase 4 — AI setup chat 进一步自动化 | 远期 | 主动建议"该同步这个 app"、跨 app 知识图谱自动建模 | 探索 |
docs.gumloop.com/core-concepts/brain（Build your own sources / The setup chat / Choosing what to sync / What you can't add this way 章节，完整验证）
父规格：Gumloop Brain（公司知识库） — 10/13 · 关联：Zendesk 源（v10.11.0，前一个源扩张）