FastGPTFastGPT
知识库

钉钉知识库

FastGPT 钉钉知识库功能介绍和使用方式

alt textalt text

FastGPT 支持通过钉钉企业内部应用接入钉钉知识库。创建时只需要填写 App KeyApp SecretUser ID,创建完成后进入知识库详情页点击添加文件,再选择要导入的钉钉知识库、在线文档或文件夹。

当前仅支持钉钉在线文档文本,不支持 PDF、Word、Excel、PPT 等二进制文件。

1. 创建钉钉应用

创建钉钉应用

打开 钉钉开发者后台应用详情,选择目标企业下的企业内部应用。

如果还没有应用,先进入应用开发创建一个企业内部应用。

2. 获取 FastGPT 要填写的参数

获取 App Key 和 App Secret

FastGPT 字段钉钉里去哪里拿
App Key应用详情页左侧进入凭证与基础信息,复制Client ID(原 AppKey 和 SuiteKey)
App Secret同一页面复制Client Secret(原 AppSecret 和 SuiteSecret)
User ID由企业通讯录管理员进入钉钉管理后台查看。路径:oa.dingtalk.com -> 通讯录 -> 成员管理 -> 找到作为操作人的成员 -> 点击成员详情,复制该成员的 User ID

注意:

  • App Secret 是密钥,不要公开发送。
  • User ID 不是手机号、姓名,也不是 unionId
  • 如果成员详情页没有展示 User ID,让通讯录管理员在通讯录里导出成员列表,导出的表格中通常包含成员 User ID
  • 建议使用一个专门的钉钉成员作为 FastGPT 同步账号,并给它目标知识库的只读权限。
  • 该成员没有权限访问的钉钉知识库,不会出现在 FastGPT 的添加文件列表里。

3. 配置钉钉应用权限

配置钉钉应用权限

在钉钉应用详情页左侧进入权限管理,搜索并开通以下权限:

权限标识用途
qyapi_get_member通过 User ID 获取接口需要的操作人 ID。
Wiki.Workspace.Read获取当前操作人可访问的钉钉知识库列表。
Wiki.Node.Read获取知识库下的文件夹和文档列表。
Storage.File.Read读取钉钉在线文档正文。

权限配置完成后,保存并发布应用配置。若接口报错中出现 requiredScopes,按提示补开对应权限。

4. 在 FastGPT 中创建钉钉知识库

  1. 进入 FastGPT 知识库列表,点击新建
  2. 选择第三方知识库下的钉钉知识库
  3. 填写:
    • App Key
    • App Secret
    • User ID
  4. 点击确认创建。

5. 添加文件和同步

创建完成后:

  1. 进入该知识库详情页。
  2. 右上角点击添加文件
  3. 选择目标钉钉知识库。
  4. 选择要导入的在线文档或文件夹。
  5. 确认导入。

选择文件夹时,FastGPT 会递归导入该文件夹下支持的在线文档。

钉钉文档内容更新后,可在已导入文件的更多菜单中点击同步,FastGPT 会重新读取最新正文并更新索引。