Skip to main content
将你的 AI 专家接入飞书(Lark),让团队成员在日常办公的飞书消息中直接与专家对话。飞书渠道支持完整的对话能力,并额外提供用户级 OAuth 授权,允许专家访问用户的个人文档和多维表格。

接入方式

飞书提供两种接入方式:
最快的接入方式,几分钟即可完成:
  1. 在专家 Studio 的「渠道接入」中选择飞书
  2. 点击「扫码接入」
  3. 使用飞书管理员账号扫描二维码
  4. 确认授权,自动完成所有配置
  5. 在飞书中找到机器人开始测试
扫码方式会自动创建飞书应用并配置必要的权限和回调地址。
如果你需要更精细的权限控制,可以选择手动配置:
  1. 登录飞书开放平台,创建企业自建应用
  2. 在「机器人」能力中启用机器人
  3. 配置事件订阅回调地址(在袋袋接入面板中获取)
  4. 添加所需权限(消息收发、通讯录读取等)
  5. 将 App ID 和 App Secret 填入袋袋的接入配置面板
  6. 发布应用版本并审核通过
手动配置适合需要限定特定权限范围、或已有飞书应用希望复用的场景。

消息格式

飞书渠道采用「多气泡」风格:文本回复作为独立气泡发送,工具调用前先发状态提示(如「🔍 正在搜索…」,最多 3 条),工具完成后正式回复作为新气泡发出。
因为分段阈值提到了 8,000,在企微会分成四条的回复,在飞书通常是一条。想要过程可见时,明确要求专家分阶段汇报。

对话场景

单聊

直接给机器人发送消息即可开始一对一对话,适合个人使用场景。

群聊

在群组中 @机器人 后发送消息,专家会在群内回复。适合团队协作场景,其他成员可以看到对话过程。
群聊中专家只响应 @它的消息,不会对群内所有消息做出回应。

用户 OAuth 授权

飞书渠道的独特功能——通过 /auth 命令完成用户级 OAuth 授权后,专家可以访问你的个人飞书资源。

授权流程

1

发送授权命令

在与专家的飞书对话中发送 /auth
2

点击授权链接

专家会回复一条包含授权链接的消息,点击该链接。
3

确认授权

在飞书 OAuth 页面确认授权范围(文档读取、多维表格访问等),点击同意。
4

授权生效

授权成功后,专家即可代你访问飞书文档和多维表格。

授权后的能力

完成 OAuth 授权后,专家获得以下额外能力:
OAuth Token 有有效期。过期后专家会提示你重新执行 /auth 命令。Token 刷新失败时会自动回退到基础能力(不访问你的个人资源),不影响正常对话。

可用命令

命令在消息抵达专家之前就被拦截,因此不消耗积分、不消耗试用次数

关键数值

失败与对策

相关页面

渠道总览

了解所有支持的 IM 平台

钉钉接入

钉钉渠道配置指南