Skip to main content
袋袋不做知识库托管，做的是连接器：你的文档留在原平台，专家通过官方 API 直接访问。不需要导入，不需要搬家。 在此之上可以为某条连接开启 RAG 索引——把文档同步一份到本地切块做向量检索，替代平台自带的搜索。索引带来更好的召回，但也带来「索引什么时候更新」这个新问题，下面会讲清楚。

​
支持的平台与凭证

凭证加密存储，不会出现在任何 API 响应里。所有平台调用统一 30 秒超时。
用权限范围最小的凭证。飞书和钉钉走的是应用级 token（tenant / app access token），它能看到的范围就是这个应用被授权的范围——授权越宽，专家能读到的越多。

​
三步启用

1

绑定连接器

设置 → 连接器，选平台填凭证。保存即生效。
2

勾选 Knowledge 插件

Knowledge 是 user_selectable 插件，必须在插件面板里勾上。光有连接、不勾插件，专家拿不到知识库工具。
3

直接问

可以指定平台（「在飞书文档里搜 OKR」），也可以不指定——不指定时专家会跨所有已连接平台搜。

​
五类操作与平台差异

专家通过一个 knowledge 工具按 action 分发。不是每个平台都支持全部操作：
钉钉目前只读。 让专家「把结论写进钉钉文档」会得到明确拒绝：Platform 'dingtalk' does not support document creation. 这不是权限问题，是适配器还没实现写操作。只有 IMA 支持 list_documents（按知识库列目录）。其它平台要定位文档得靠 search。
read 的行为值得单说：它把文档下载到沙盒的 .knowledge/ 目录，再由沙盒的读文件工具解析。所以读一篇文档之后，它就是工作区里的一个普通文件，可以被后续的处理工具接着用。 写操作要求专家传完整正文而不是摘要——这是工具契约里明确写死的。

​
引用是怎么标的

搜索和读取的结果都带 citation_index，专家在段落末尾以 [1]、[2] 形式标注，连续引用合并成 [1][2]。专家不会在正文里写文档标题——标题由界面自动渲染成可点击的引用卡片。 同一篇文档在一次对话里始终是同一个编号：read 会复用 search 已经分配过的编号，不会出现「同一份材料两个号」。

​
上下文预算

检索结果进上下文之前会被截断：
  • 单条结果上限约 3000 字符
  • 一次调用的结果总量上限约 12000 字符
超出的部分不会进对话。这是为了防止一次搜索就把上下文预算吃光——需要完整内容时用 read 单独读那一篇。

​
RAG 索引：能用，但不会自动更新

这是这一页最需要注意的一条。 建立连接时会自动触发一次全量索引（ragEnabled 默认开），之后：
  • 周期性自动重新索引在所有部署环境里都是关闭的（KNOWLEDGE_SYNC_ENABLED 未配置，默认 false）
  • 所以新上传到平台的文档不会自己进索引
  • 想让索引跟上，必须去 设置 → 知识库 手动点同步
专家意识到这一点：连续两次搜索没结果时，它会主动提示你去手动同步，而不是断言「你的知识库里没有这份文档」。
索引的技术参数：文档切块 1500 字符、重叠 100 字符，向量维度 1024。检索是混合检索——向量召回与关键词召回各取一路，用 RRF（倒数排名融合，k=60）合并，默认取前 10 条，上限 30 条。 一次同步卡在 syncing 超过 30 分钟会被判定为超时并标记为错误状态，可以重新触发。同步进行中再点同步返回 409 Sync already in progress（除非已经超时）。同步进度每 5 秒回写一次。 嵌入服务降级时（超过 80% 的分块拿不到向量）同步会显式报错，而不是留下一个「索引看起来建好了、其实检索不到」的半成品。
未开启 RAG 的连接走平台原生搜索 API，没有索引新鲜度问题——平台上刚建的文档，平台搜得到，专家就搜得到。用不用 RAG 是在「召回质量」和「新鲜度」之间做取舍。

​
失败与对策

工具永远返回结构化错误，不抛异常打断对话。常见几类： IMA 对读不到的条目有一层 5 分钟的负缓存：同一篇文档反复读不会反复打 API，直接返回降级结果。所以刚修好权限时可能还要等几分钟才生效。

​
计费

连接、列目录、刷新凭证都不扣积分。 唯一产生消耗的地方：检索到的内容作为 token 进入对话上下文，按 token_split 计费。成本与实际读进来的文档体积成正比，与知识库总大小无关——连一个几十万字的知识库不花钱，让专家读其中五千字才花钱。
控成本最有效的一招是缩小检索范围：指定平台、指定 source_id，比让专家跨全平台搜省得多。
模型费率是运营数据，以模型选择器为准；算法固定，见计费公式。

​
继续阅读

知识库 RAG 管线

索引与混合检索的实现细节

个性化设置

连接器与其它账号级设置

飞书工具

飞书的另一条路：文档与多维表格工具

插件全表

Knowledge 插件的激活条件