> ## Documentation Index
> Fetch the complete documentation index at: https://docs.profy.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 知识库连接

> 连接飞书、钉钉、IMA、语雀等外部知识库，让专家访问你的团队知识

袋袋的知识库能力是一个外部知识库**连接器**。默认模式下，你的文档留在原来的平台，专家通过 API 直接访问，无需导入、无需向量化。

如果你希望获得更高精度的搜索质量，可以为任意连接开启 **RAG 索引**——系统会定期同步文档到本地，分块建立向量索引，用混合检索替代平台原生搜索。详见[知识库 RAG 管线](/zh/documentation/how-it-works/knowledge-rag)。

<Warning>
  使用前必须先在 **设置 → 连接器** 中绑定你的知识平台凭证。未绑定的平台，专家无法访问。
</Warning>

## 支持的平台

<CardGroup cols={2}>
  <Card title="飞书 / Lark" icon="feather">
    连接飞书云文档和知识库。支持 Token 自动刷新，凭证过期系统自动续期。
  </Card>

  <Card title="钉钉" icon="link">
    连接钉钉文档。同样支持 Token 自动刷新，无需手动维护凭证有效性。
  </Card>

  <Card title="IMA" icon="database">
    连接 IMA 知识库平台。使用 Client ID + API Key 认证，无过期问题。
  </Card>

  <Card title="语雀" icon="book">
    连接语雀知识空间。使用个人访问令牌（Personal Token）认证。
  </Card>
</CardGroup>

## 三步启用

<Steps>
  <Step title="绑定连接器">
    进入 **设置 → 连接器**，选择目标平台，填写对应凭证：

    | 平台        | 所需凭证                 | 认证模式       |
    | --------- | -------------------- | ---------- |
    | 飞书 / Lark | App ID + App Secret  | Token 自动刷新 |
    | 钉钉        | App Key + App Secret | Token 自动刷新 |
    | IMA       | Client ID + API Key  | 静态密钥       |
    | 语雀        | 个人访问令牌               | 静态令牌       |

    凭证会加密存储，不会在任何 API 响应中暴露。
  </Step>

  <Step title="启用 Knowledge 插件">
    Knowledge 是一个**手动启用**的插件。在对话界面点击 "+" 菜单，勾选 **Knowledge** 插件。不启用插件，专家即使有连接也无法访问知识库。
  </Step>

  <Step title="开始对话">
    启用后，直接在对话中向专家提问。你可以指定平台（"在飞书文档里搜索 OKR 相关内容"），也可以不指定——专家会跨所有已连接平台搜索。
  </Step>
</Steps>

## 专家能做什么

连接建立后，专家在对话中可以执行五类操作：

<AccordionGroup>
  <Accordion title="搜索知识">
    根据你的问题在已连接平台中检索相关文档。不指定平台时跨所有平台搜索。
  </Accordion>

  <Accordion title="浏览目录">
    列出知识库的文档目录结构，帮你定位内容。
  </Accordion>

  <Accordion title="阅读文档">
    读取具体文档内容并在对话中引用和分析。
  </Accordion>

  <Accordion title="创建文档">
    在知识库中创建新文档。例如"把刚才的讨论整理成一篇飞书文档"。
  </Accordion>

  <Accordion title="追加内容">
    向已有文档追加新内容，适合持续更新的文档（会议纪要、项目日志）。
  </Accordion>
</AccordionGroup>

<Note>
  写操作（创建、追加）是否可用取决于具体平台的 API 支持和你提供的凭证权限。只读凭证只能搜索和阅读。
</Note>

## 适用场景

<CardGroup cols={2}>
  <Card title="企业知识问答" icon="comments">
    新员工想了解公司规章？让专家搜索内部知识库，用自然语言直接回答。
  </Card>

  <Card title="跨平台知识整合" icon="layer-group">
    团队在飞书和语雀上都有文档？专家同时搜索多个平台，综合回答。
  </Card>

  <Card title="知识沉淀" icon="floppy-disk">
    讨论完方案后，直接让专家把结论写入飞书或语雀，避免信息散落在聊天记录里。
  </Card>

  <Card title="文档生成" icon="file-lines">
    基于知识库中的现有内容，生成综述报告、对比分析、FAQ 汇总。
  </Card>
</CardGroup>

## 获取平台凭证

<AccordionGroup>
  <Accordion title="飞书 / Lark">
    1. 访问[飞书开放平台](https://open.feishu.cn)，创建自建应用
    2. 申请文档相关的 API 权限
    3. 获取 App ID 和 App Secret，填入袋袋连接器
  </Accordion>

  <Accordion title="钉钉">
    1. 访问[钉钉开放平台](https://open.dingtalk.com)，创建企业内部应用
    2. 授权知识库相关接口权限
    3. 获取 App Key 和 App Secret，填入袋袋连接器
  </Accordion>

  <Accordion title="IMA">
    1. 在 IMA 平台的开发者设置中创建 API 凭证
    2. 获取 Client ID 和 API Key，填入袋袋连接器
  </Accordion>

  <Accordion title="语雀">
    1. 登录语雀，进入 个人设置 → Token 管理
    2. 创建个人访问令牌，填入袋袋连接器
  </Accordion>
</AccordionGroup>

<Warning>
  * 请使用**具有适当权限范围**的凭证，避免全权限管理员凭证
  * 凭证过期或被平台端撤销后，需要在设置中更新
  * 不同平台的 API 调用受平台自身频率限制
</Warning>

## 计费说明

知识库连接本身不收费。对话中使用知识库内容的积分消耗来自模型的 Token 使用——专家读取和分析文档的内容会计入对话 Token，具体消耗以产品内实时显示为准。