Gumloop Brain（公司知识库）

背景：agent 能力的三块拼图

Gumloop 官方把 agent 的有用性拆解为三块，每块回答不同问题。Brain 之前，agent 遇到"我们退款政策是什么"这类问题只能靠模型预训练知识或幻觉——企业真实文档它看不到。Brain 补齐这块缺口。

┌──────────────────────────────────────────────────────────────────────┐
│                  Gumloop Agent 能力栈 — 三块拼图                       │
├──────────────────┬───────────────────┬───────────────────────────────┤
│  Connectors      │  Skills           │  Brain（v10.8.0 新）            │
│  （行动）         │  （流程）          │  （知识）                      │
├──────────────────┼───────────────────┼───────────────────────────────┤
│  实时操作能力      │  可复用任务指令     │  可搜索的知识                  │
│                  │                   │                               │
│  "发这条 Slack    │  "用我们的序列    │  "我们的退款政策               │
│   消息"           │   起草 outreach"   │   怎么说？"                    │
└──────────────────┴───────────────────┴───────────────────────────────┘

核心心智模型

Indexing a source makes knowledge available; attaching it to an agent makes that knowledge usable by that agent.

索引一个源 → 知识可用（available）；attach 到 agent → 该 agent 能用（usable）。这是两层解耦设计：知识先进入组织知识池（可被治理、可被多个 agent 复用），再按需 attach 给特定 agent。一个 Notion 知识库可以索引一次，被客服 agent、销售 agent、HR agent 分别 attach 使用。

目标

1. 让 agent 知道公司知道什么——基于真实内容回答，而非幻觉
2. 统一企业知识权限——scope 与 Composable Roles / Permission Groups 集成，而非孤立文件上传
3. 闭环工作→知识——agent 产出的 artifact 反向成为知识源，形成飞轮
4. 零运维索引——Gumloop 自动读取、索引、同步，用户不管理 sync

2.1 知识源与索引内容

Brain 连接企业已有知识存储（不要求重新上传），Gumloop 读取并索引文本内容：

源	索引内容
Notion	连接的页面和数据库的完整页面内容
Google Drive	所选 drive/folder 的文件内容，含 Docs/Sheets/Slides（转换后索引）。Folder 只组织结果，本身非文档
Slack	所选公开频道的消息，含 thread reply
GitHub	连接的 repo 的文件
Confluence	连接的 Confluence space 的页面
文件上传	PDF/Office（.docx/.pptx/.xlsx）/rtf/Markdown/JSON/XML/YAML/text，单文件约 400MB

2.2 三层 scope（知识权限）

每个源有一个 scope，决定谁能看和搜索。添加时选择，之后可用 Share 修改。关键差异化：scope 与 Composable Roles / Permission Groups 深度集成——知识权限 = 企业身份权限，而非孤立文件 ACL。不同角色看到不同知识池。

Scope	可见性
Personal（私有）	只有创建者可见可搜索
Team（团队共享）	一个团队/project 的成员可见
Organization（全公司）	整个组织可见可搜索

2.3 索引与同步（零运维）+ 状态

源添加后，Gumloop 全权接管同步，用户不管理。

状态	含义
Active	连接正常，同步中
Paused	同步暂停，直到恢复
Syncing	同步运行中
Indexed	单项已处理，可搜索
Failed	上次同步出错，需重试或检查账户
Partial	上次同步完成但部分项未索引

2.4 Knowledge Graph（3D 知识图谱）

每个 Brain 视图含交互式 3D 知识图谱——所有索引内容的可视化地图。每个点是一块知识，按源聚类着色（Slack 红、Drive 蓝、Confluence 绿...），可全屏拖拽探索。企业知识从"扁平列表"变成"可导航的空间"。

2.5 Agent 使用：两个内置工具

attach 源到 agent 后，agent 自动获得两个内置工具（无需配置）。agent 自主决定何时搜索——判断问题是关于内部内容时才调用 Brain，引用找到的内容，并在片段不足时打开完整文档。

┌─────────────────────────────────────────────────────────────────┐
│  用户问内部知识问题                                                │
│         │                                                        │
│         ▼                                                        │
│  ┌─────────────────────┐                                         │
│  │ Search Company Brain │ ── 混合搜索 attached 源                  │
│  │ （agent 自主触发）    │ ── 返回最相关片段                         │
│  │ chat: "Searching     │ ── 可并行多次搜索                         │
│  │  Company Brain"      │                                         │
│  └─────────────────────┘                                         │
│         │ 片段不够时                                               │
│         ▼                                                        │
│  ┌─────────────────────┐                                         │
│  │ Read document        │ ── 取特定文档全文                        │
│  │ chat: "Reading       │                                         │
│  │  document"           │                                         │
│  └─────────────────────┘                                         │
│         │                                                        │
│         ▼                                                        │
│  Agent 引用来源回答（citations）                                   │
└─────────────────────────────────────────────────────────────────┘

2.6 Artifact 索引（工作→知识飞轮）

除用户连接的源，Gumloop 还能索引 agent 产生的 artifacts（chat 中生成的文件），让 agent 搜索复用过往工作而非从零开始：

• Artifact 在 Personal（你的 artifact）或 Team（项目 artifact）级索引
• 每个 artifact 只索引最新版本，新版本产出时原地更新
• agent 用同样的 Search Company Brain / Read document 工具找到——"调出我们上周做的 deck" 像普通知识查询

这形成闭环：agent 工作（产出 artifact）→ 索引为知识 → 下次 agent 复用 → 更好的工作。

2.7 Credits 计费

• Indexing（索引）：内容处理时计费。大部分成本在首次添加源和内容变更时
• Searching（搜索）：按查询计费。agent 的 Brain 搜索计入该 agent 的 run

模块 A — 知识源管理

ID	触发场景	系统行为	优先级
A1	打开 Brain	左 sidebar 独立入口，All/Mine/Organization tabs + Source 添加	P0
A2	添加源	选源类型（Notion/Drive/Slack/GitHub/Confluence/文件上传），授权连接	P0
A3	添加时	选 scope（Personal/Team/Organization），之后可 Share 修改	P0
A4	文件上传	支持 PDF/Office/rtf/Markdown/JSON/XML/YAML/text，约 400MB	P0
A5	源添加后	Gumloop 自动接管同步，无需用户管理	P0

模块 B — 索引与同步

ID	触发场景	系统行为	优先级
B1	源内容首次添加	索引文本内容（按源类型索引页面/文件/消息）	P0
B2	源内容变更	持续同步，增量更新索引	P0
B3	同步出错	状态置 Failed/Partial，提示重试或检查账户	P0
B4	暂停/恢复	状态置 Paused，恢复后继续	P1
B5	源列表展示	Name/Docs/Activity/Access/Status 五列	P0

模块 C — Agent 知识 attach

ID	触发场景	系统行为	优先级
C1	attach 源到 agent	该 agent 获得 Search Company Brain + Read document 工具	P0
C2	agent 判断涉及内部知识	自主调用 Search Company Brain 混合搜索，返回片段	P0
C3	片段不足	agent 调用 Read document 取全文	P0
C4	agent 回答	引用来源（citations），可并行多次搜索	P0
C5	agent 产出 artifact	索引到 Personal/Team 级，仅最新版本	P1

模块 D — 可视化与治理

ID	触发场景	系统行为	优先级
D1	查看 Brain	3D 交互式 knowledge graph，按源聚类着色，可全屏拖拽	P1
D2	点击源	detail page：项列表+Overview+Search this source+Edit	P0
D3	scope 与角色集成	知识可见性遵循 Composable Roles / Permission Groups	P0