You need to enable JavaScript to run this app.
导航
数据智能体
  • 文档首页
    • /数据智能体/开放与集成/智能分析Agent/办公软件集成/飞书联动集成
飞书联动集成
最近更新时间：2025.08.04 16:11:43首次发布时间：2025.06.09 18:25:53
复制全文
我的收藏
有用
有用
无用
无用

智能分析 Agent（以下称为智能体）支持与飞书进行功能联动，通过相关能力，用户可以在飞书的工作台直接访问智能体的移动端应用、连接飞书数据源，或者接收智能体推送日/周/月报至飞书个人或群组等，实现飞书联动、协同办公的效果。本文将为您介绍飞书联动集成基础配置操作。

功能概述

飞书联动集成基础配置一方面需要用户在飞书端进行自建应用、权限配置等操作；另一方面，需要用户在智能体端进行办公平台集成等操作。配置完成后，可以实现飞书联动、协同办公的效果。

注意

本文以飞书 SaaS 标品为例，介绍飞书端的配置操作流程。需要注意的是，飞书开放平台的配置界面会因用户部署环境及版本的不同而存在差异，具体可参考企业自建应用开发流程。

名词解释

相关名词

说明

使用场景

飞书开放平台

用于增加新应用的后台，所有开发者都可以操作

在和智能体联动场景中，用于增加应用的后台

飞书管理后台

飞书组织管理后台，只有飞书组织管理员可以操作

审批应用上线，开放相关权限给到该应用

应用管理员

对应到智能体的用户角色是系统管理员

为智能体平台完成对接集成飞书的工作

企业组织管理员

对应到飞书的用户角色是飞书组织管理员

在飞书管理平台中负责开放权限、审批应用上线

操作流程概览

整体操作步骤是：

  1. 飞书端：创建应用 -> 配置权限 - > 发布应用
    Image
    1. 创建飞书应用：由智能体的系统管理员，通常也是飞书开放平台的应用创建者与管理员，在飞书开放平台中创建一个智能体的应用；
    2. 配置权限管理：由智能体的系统管理员在飞书开放平台开启应用相关的权限；
    3. 发布飞书应用：由智能体的系统管理员在飞书开放平台创建并申请发布应用新版本，并且经过飞书的组织管理员审核通过，完成整体的应用配置与上线。
  2. 智能体端：办公平台集成。

具体配置方式后文将会分模块展开介绍，如您有更多关于飞书应用相关的疑问，也可以前往飞书开发平台的帮助中心查看文档介绍。

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

飞书端配置

创建飞书应用

  1. 打开企业飞书开放平台，点击右上角头像，选择确认推送应用的企业。
    Image
  2. 点击「创建应用」，进入飞书开放平台的开发者后台。
    Image
  3. 点击「创建企业自建应用」，按提示填写必要的「应用名称」、「应用描述」、「应用图标」。
    Image

配置权限管理

调用飞书开放接口之前，需要为应用开通 智能体 所需的权限。在飞书开放平台的开发者后台中，点击「权限管理」，开始对该应用配置权限。
Image
根据智能体中和飞书联动的使用场景，本文将权限分为以下五个模块。用户可根据自己想要在 智能体 中实现的联动效果选择权限模块，并按照步骤为应用开通智能体所需的飞书权限。其中，「基础权限」为智能体和飞书联动的基础，为必选项：

智能体中和飞书联动的使用场景

权限模块

是否必选

  • 智能体和飞书联动基础

基础权限

必选

  • 在数据准备模块，使用飞书「知识库」中的表格/多维表格的数据作为智能体数据源，具体可参考飞书表格、飞书多维表格。

表格/多维表格相关权限

可选

  • 在权限模块，将飞书的部门添加到智能体中作为部门级用户组使用，具体可参考用户组管理。

飞书部门相关权限

可选

  • 支持审批流与飞书审批流打通，具体可参考权限审批与飞书打通。

    注意

    目前该功能仅智能体私有化版本支持。

权限审批与飞书打通

可选

  • 向应用可用范围内的飞书用户发送单聊消息
  • 向飞书机器人所在的群聊发送群消息
  • 接收用户发送给飞书机器人的所有单聊消息

飞书消息发送相关权限

可选

权限类型介绍：

权限类型

介绍

应用身份权限

  • 应用在用户未登录情况下自动化运行
  • 应用身份所能操作的资源范围

用户身份权限

  • 应用必须以登录用户身份执行操作
  • 登录用户所能操作的资源范围

基础权限

权限类型

配置说明

应用身份权限

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

用户身份权限

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

注意

数据权限中的通讯录可见范围默认跟随应用可用范围。如果通讯录范围不够大，会导致无法绑定通讯录范围外的用户ID，建议您参考下图，在「版本管理与发布」中将可用范围设置为「所有员工」。
Image

表格/多维表格相关权限

权限类型

配置说明

用户身份权限

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

飞书部门相关权限

权限类型

配置说明

应用身份权限

  • 以应用身份读取通讯录
  • 获取部门组织架构信息
  • 获取用户邮箱信息
  • 获取用户手机号
  • 获取用户 user ID
  • 获取部门基础信息
  • 获取用户基本信息
  • 获取企业信息
  • 获取与更新群组信息
  • 查看群信息

权限审批与飞书打通

权限类型

配置说明

应用身份权限

  • 查看、创建、更新、删除审批应用相关信息
  • 查询审批列表
  • 访问审批应用
  • 获取用户 user ID

飞书消息发送相关权限

  1. 搜索开通下述权限。

    权限类型

    配置说明

    应用身份权限

    • 获取与发送单聊、群组消息
    • 查看群信息

  2. 联系飞书组织管理员，登录到飞书管理后台进行如下操作：

    注意

    这一步的前提是应用已经发布，若应用未发布，请参考发布飞书应用完成发布操作后再完成此步骤。

    1. 进入飞书管理后台，点击「工作台」-「应用管理」，找到已发布的应用。
      Image
    2. 选择可用成员，配置可用成员为全部成员。
      Image

  3. 在飞书组织管理员完成配置之后，DataAgent 系统管理员返回至飞书开放平台，点击「安全设置」。
    Image
    在「重定向 URL」输入框中添加如下 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
    https://console.volcengine.com/bi/datawind/data-agent/analytics-agent
    https://console.volcengine.com/bi/datawind/data-agent/analytics-agent/

    私有化

    如下，把 $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

发布飞书应用

  1. 创建新版本。在飞书开放平台的开发者后台中，点击「版本管理与发布」，点击「创建版本」，填写「应用版本号」、「更新说明」等内容，点击「保存」，完成版本创建。
    Image
  2. 发布新版本。创建新版本完成后，点击「确认发布」。
    Image

    注意

    • 仅可用范围内的用户能够成功搜索、打开并正常使用网页应用。
    • 应用管理员申请发布之后，企业组织管理员会收到开放平台应用审核的消息通知，需要审核之后才可继续后续配置动作。
  3. 完成新版本创建发布步骤后，点击「凭证与基础信息」，复制 APP ID 和 APP Secret。
    Image

智能体端配置

以系统管理员身份登录智能体，点击「系统管理」点击「办公平台集成」-「飞书」，填入飞书端配置中获取的 APP ID 和 APP Secret，选择「开启」，点击「提交」完成飞书联动集成基础配置。
Image