智能分析Agent（以下称为 智能体 ）支持与飞书进行功能联动，通过相关能力，用户可以在飞书的工作台直接访问智能体的移动端应用、连接飞书数据源，或者接智能体推送日/周/月报至飞书个人或群组等，实现飞书联动、协同办公的效果。
想要实现一系列效果，一方面需要用户在飞书开放平台进行自建应用、权限配置等操作；另一方面，用户需要在智能体中进行订阅配置、预警配置等操作。本文将为您介绍必选的基础配置。
说明：飞书开放平台的相关配置界面会不定期迭代，特此提醒您，请以最新的配置界面为准。

1.1 名词解释

1.2 操作流程概览

如上图所示，整体操作逻辑是，由贵公司的智能体的系统管理员，通常也是飞书开放平台的应用创建者与管理员，在飞书开放平台中创建一个智能体的应用，开启应用相关的权限，并且经过飞书的组织管理员进行审核通过，最终才能完成整体的应用配置与上线。具体配置方式后文将会分模块展开介绍，如您有更多关于飞书应用相关的疑问，也可以前往飞书开发平台的帮助中心查看文档介绍。

想要实现飞书联动的效果，必须进行以下基础配置，请您将下方的配置操作全部完成。

2.1 创建飞书应用

（1）打开企业飞书开放平台，点击右上角头像，选择确认推送应用的企业。

（2）点击「创建应用」- 「创建企业自建应用」，按提示填写必要的「应用名称」、「应用描述」、「应用图标」。



（3）创建成功之后，点击「应用名称」打开应用，点击「凭证与基础信息」切换页面，可以获取后续流程会用到的 「App ID」 和 「App Secret 」值。（建议提前记录应用凭证信息，后续步骤会用到。）

2.2 权限管理配置

在飞书开放平台的开发者后台中，「权限管理」模块，点击「去开通权限」，开始对该应用配置权限。

2.2.1 基础权限配置

需要开通身份权限和用户身份权限。
在应用身份权限，需要勾选以下基础的权限内容，多选后，「批量开通」这些权限。

• 更新通讯录
• 获取通讯录基本信息
• 获取部门基础信息
• 获取通讯录部门组织架构信息
• 获取用户基本信息
• 获取用户组织架构信息
• 获取用户 user ID
• 获取用户手机号
• 获取企业信息
• 以应用的身份发消息（仅私有化版本需要勾选开通，SaaS无需)
• 给多个用户批量发消息（仅私有化版本需要勾选开通，SaaS无需)

在用户身份权限，勾选以下基础的权限内容，多选后，「批量开通」这些权限。

• 查看、编辑和管理知识库
• 查看知识库
• 查看、评论、编辑和管理电子表格
• 查看、评论、编辑和管理多维表格
• 查看、评论和导出多维表格

注意：数据权限中的通讯录可见范围默认跟随应用可用范围。如果通讯录范围不够大，会导致无法绑定通讯录范围外的用户ID；建议您参考下图，将通讯录权限范围设置为「全部成员」。

2.2.2 使用表格与多维表格相关权限开通

如需使用知识库里的表格/多维表格的数据作为数据源，以及实现「以飞书表格的格式下载数据」，需要以下相关权限。
（1）在权限管理界面，搜索「知识库」，选择「查看、编辑和管理知识库、查看知识库」，勾选之后「批量开通」。

（2）在权限管理界面，点击「开通权限」，在用户身份权限模块，勾选以下基础的权限内容，多选后，「批量开通」这些权限。

• 查看、评论、编辑和管理云空间中所有文件
• 查看、评论、编辑和管理多维表格
• 查看、评论和导出多维表格
• 查看、评论、编辑和管理电子表格
• 查看、评论和导出电子表格

说明：飞书开放平台的权限配置界面可能会不定期迭代，此处提醒您，请以最新的权限配置界面为准，建议您勾选全部云文档相关的权限。

2.2.3 飞书部门相关权限开通

如需将飞书的部门添加到 DataAgent中直接使用，需要 在DataAgent 中额外增加如下权限开通。

（1）请您在飞书开放平台的开发者后台-权限管理中，勾选：以应用身份读取通讯录、获取部门组织架构信息、获取用户邮箱信息、获取用户手机号、获取用户 user ID、获取部门基础信息、获取用户基本信息。多选后，「批量开通」这些权限。

（2）搜索「获取企业」，选择「获取企业信息」，然后点击「批量开通」。

请在飞书开放平台的开发者后台-权限管理中，搜索「获取与更新」，选择「获取与更新群组信息」，然后「批量开通」。

说明：飞书开放平台的权限配置界面可能会不定期迭代，此处提醒您，请以最新的权限配置界面为准，建议您勾选全部相关的权限。

2.2.4 权限审批与飞书审批流联动相关权限开通（建议开启）

DataAgent的私有化版本产品支持审批流与飞书审批流打通。如需开通权限审批与飞书审批流联动的功能，需要开通：「查看、创建、更新、删除审批应用相关信息；查询审批列表；访问审批应用；获取用户 user ID」。多选后，「批量开通」这些权限。
说明：飞书开放平台的权限配置界面可能会不定期迭代，此处提醒您，请以最新的权限配置界面为准，您可以给此处相关的权限全部都勾选上。

2.2.5 飞书消息发送相关权限开通

如需向用户获取与发送单聊、群组消息，需要开通「获取与发送单聊、群组消息」权限。 搜索「获取与发送单聊、群组消息」，选择该权限并开通。该权限能够向应用可用性范围内的用户发送单聊消息；向机器人所在的群聊发送群消息；接收用户发送给机器人的所有单聊消息。

联系飞书组织管理员，登录到飞书管理后台 进行如下操作：
注意：第一步和第二步的前提是应用已经发布，若应用未发布，请发布后完成这两个步骤。
（1）点击企业管理->应用管理->找到该应用。

（2）选择可用成员，配置选择为全部成员。


（3）在飞书企业组织管理员完成配置之后，应用管理员返回至飞书开放平台。 点击「安全设置」，在「重定向 URL」输入框中添加如下 URL 信息。

• SaaS 增加

https://console.volcengine.com/bi/datawind/#
https://console.volcengine.com/bi/datawind#/dataManage
https://console.volcengine.com/bi/datawind/auth#/dataManage
https://console.volcengine.com/bi/datawind#/dataPrep
https://console.volcengine.com/bi/datawind/auth#/dataPrep
https://console.volcengine.com/bi/datawind/#/prep/dataLink/authCallback/lark_sheet https://console.volcengine.com/bi/datawind/#/prep/dataLink/authCallback/lark_bitable

• 独立部署增加

如下，把 $HOST 替换为产品的部署域名，不包含任何路径：
$HOST/bi
$HOST/bi#
$HOST/bi#/dataManage
$HOST/bi/auth#/dataManage
$HOST/bi#/dataPrep
$HOST/bi/auth#/dataPrep
$HOST/bi/#/prep/dataLink/authCallback/lark_sheet
$HOST/bi/#/prep/dataLink/authCallback/lark_bitable
选择添加保存。

2.3 总览与应用发布

（1）在「总览」模块，来到「应用发布」-「版本管理与发布」，点击「创建版本」，填写「版本号」、「可用性状态」等内容，点击「保存」，完成版本创建。

如下图所示，有提醒发布的时候，点击「申请线上发布」，完成应用发布。

注意：仅可用性范围内的用户能够成功搜索、打开并正常使用网页应用。应用管理员申请发布之后，企业组织管理员会收到开放平台应用审核的消息通知，需要审核之后才可继续后续配置动作。
（2）完成上述配置之后，在「凭证与基础信息」模块内复制 APP ID 和 APP Secret。

（3）返回到智能体，以系统管理员身份登录，填写至企业域管理->办公平台集成中，点击提交开启飞书集成。

如果您使用的是 Lark ，那么可能会遇到 Lark 开放平台与飞书开放平台在功能上部分差异，如果您希望与Lark进行联动集成配置，请您在官网右下角联系售后进行处理。