计算巢AppFlow现在提供自动化流程,通过定时触发的方式帮助您以不同频率自动同步飞书文档到百炼知识库中做RAG检索,节省大量人工维护知识库成本。
下面是详细操作手册。
步骤一:创建飞书应用
飞书应用是开发者向内部或外部用户提供服务的载体,通常表现为机器人、网页、小程序等形态,也是开发者调用飞书所提供的开放能力的载体。开发者在入驻飞书开放平台后,需要通过创建应用和开通相关权限的方式获取各种能力,通过接口调用或嵌入 SDK 的方式来进行定制开发,接入丰富的飞书开放能力。详情参考 应用概述。
创建并配置应用
应用是开发者调用飞书所提供的开放能力的载体。你需在飞书开发者后台,创建与配置应用,包括为应用开通权限、能力、添加事件与回调等。
添加应用能力
为了方便后续文档权限配置,建议添加 机器人 能力。
开通应用权限
选择 应用身份权限:
- [wiki:wiki, wiki:wiki:readonly, wiki:node:retrieve]三者任选其一
- [drive:export:readonly, docs:document:export]二者任选其一
- bitable:app:readonly
应用发布
在开发自建应用的过程中,当应用的 基本信息、权限范围、应用功能 和 事件订阅 等信息发生变更时,都需要发布新的应用版本,并且通过企业管理员的审核后才能生效。以下为发布应用的具体步骤。
- 在 开发者后台 进入需要发布的应用详情页。
- 在左侧导航栏,选择 应用发布 > 版本管理与发布,并点击 创建版本。
- 在 版本详情 页面,配置以下应用信息,并点击 保存。
- 应用版本号:对用户展示的自定义版本号信息。首次发布应用时可设置例如 1.0.0 的版本号。后续迭代的版本号需要高于上一个版本号。
- 更新说明:本次应用更新的详情,将展示在应用的更新日志中。
- 应用能力、权限变更:查看并确保变更配置符合预期。
- 可用范围:应用的可用范围,点击 编辑 可以手动调整该范围。
- 在弹出的对话框中,点击 申请线上发布。
文档或知识库权限设置指南
- (推荐设置)如果需要同步整个知识库,需要在知识库设置——成员设置——管理员——添加管理员,搜索并添加一个包含有这个机器人的群聊(一定要先把机器人添加到群,再到知识库添加群)
- 如果同步指定的某些文档,打开文档,点右上角“..."——更多——添加文档应用,搜索上面的应用添加。如果已经添加了管理员,可以不用再添加文档应用。
步骤二:创建自动同步流程
访问AppFlow模版中心,找到 定时同步飞书文档到百炼应用数据 模版,点击使用。
- 点击触发事件 - 下一步,填写需要同步的频率。例如 每天早上6点更新同步。
- 点击飞书应用 —— 连接凭证 —— 添加新凭证,登录飞书开放平台-选择自建应用-凭证与基础信息-查看App ID和App Secret
- 入参配置 —— 可以选择同步整个知识库、某个目录 或 指定的多个文档。
- 知识库Token获取方式
飞书知识库首页,选择目标知识库,点击‘知识库设置’,在页面URL中的最后长串数字部分即为知识库Token。AppFlow将获取您指定的整个知识库文档。
- 文档Token获取方式
打开文档页面,飞书文档URL ‘wiki/’ 后面的部分,不包含&、?后面的部分。例如飞书文档URL为https://xxx.feishu.cn/wiki/faketoken?from=xxx,则此处填写‘faketoken’部分。AppFlow将获取您指定的文档。
- 目录Token
飞书目录同时也是一个文档,获取目录Token方法与文档Token相同。AppFlow将获取您指定的目录下的文档。
- 点击 百炼知识库 节点 —— 添加新凭证,按照页面指引选择已有角色或新建角色即可。
- 访问百炼 权限管理,选择新增用户 —— RAM角色,选择刚刚在AppFlow创建凭证选择或新建的角色。
- 回到AppFlow点击下一步,填写百炼业务空间ID和需要同步文档应用数据目录ID。
业务空间ID获取方式如图:
应用数据目录ID获取方式如图:
- 完成上述配置后,点击保存并发布即可。
步骤三:创建知识库
- 在百炼控制台创建一个新的知识库。
- 数据来源选择类目。
- 开启自动同步知识索引。
- 选择刚才配置自动同步的类目即可。