> ## Documentation Index
> Fetch the complete documentation index at: https://docs.profy.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 飞书

> 在飞书中接入和使用专家

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

## 接入方式

飞书提供两种接入方式：

<AccordionGroup>
  <Accordion title="扫码快速接入（推荐）">
    最快的接入方式，几分钟即可完成：

    1. 在专家 Studio 的「渠道接入」中选择飞书
    2. 点击「扫码接入」
    3. 使用飞书管理员账号扫描二维码
    4. 确认授权，自动完成所有配置
    5. 在飞书中找到机器人开始测试

    扫码方式会自动创建飞书应用并配置必要的权限和回调地址。
  </Accordion>

  <Accordion title="手动配置">
    如果你需要更精细的权限控制，可以选择手动配置：

    1. 登录[飞书开放平台](https://open.feishu.cn)，创建企业自建应用
    2. 在「机器人」能力中启用机器人
    3. 配置事件订阅回调地址（在袋袋接入面板中获取）
    4. 添加所需权限（消息收发、通讯录读取等）
    5. 将 App ID 和 App Secret 填入袋袋的接入配置面板
    6. 发布应用版本并审核通过

    手动配置适合需要限定特定权限范围、或已有飞书应用希望复用的场景。
  </Accordion>
</AccordionGroup>

## 消息格式

飞书渠道采用「多气泡」消息风格：

* 专家的文本回复作为独立消息气泡发送
* 工具调用时发送状态通知（如「🔍 正在搜索...」）
* 工具完成后发送最终回复
* 支持 Markdown 格式渲染

<Note>
  飞书消息有长度限制。超长回复会被自动分段发送。
</Note>

## 对话场景

### 单聊

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

### 群聊

在群组中 @机器人 后发送消息，专家会在群内回复。适合团队协作场景，其他成员可以看到对话过程。

<Tip>
  群聊中专家只响应 @它的消息，不会对群内所有消息做出回应。
</Tip>

## 用户 OAuth 授权

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

### 授权流程

<Steps>
  <Step title="发送授权命令">
    在与专家的飞书对话中发送 `/auth`。
  </Step>

  <Step title="点击授权链接">
    专家会回复一条包含授权链接的消息，点击该链接。
  </Step>

  <Step title="确认授权">
    在飞书 OAuth 页面确认授权范围（文档读取、多维表格访问等），点击同意。
  </Step>

  <Step title="授权生效">
    授权成功后，专家即可代你访问飞书文档和多维表格。
  </Step>
</Steps>

### 授权后的能力

完成 OAuth 授权后，专家获得以下额外能力：

| 能力         | 说明              |
| ---------- | --------------- |
| **文档读取**   | 读取你有权限的飞书文档内容   |
| **多维表格操作** | 查询和修改你的多维表格数据   |
| **知识库搜索**  | 在你有权限的知识空间中检索信息 |

<Warning>
  OAuth Token 有有效期。过期后专家会提示你重新执行 `/auth` 命令。Token 刷新失败时会自动回退到基础能力（不访问你的个人资源），不影响正常对话。
</Warning>

## 常见问题

<AccordionGroup>
  <Accordion title="机器人不回复消息">
    检查以下几项：

    * 确认应用已发布并通过审核
    * 确认事件回调地址配置正确
    * 确认专家的袋袋服务正常运行
    * 如果是群聊，确认已 @机器人
  </Accordion>

  <Accordion title="回复很慢">
    IM 渠道的响应速度取决于 AI 模型的推理时间和工具调用耗时。如果使用了搜索或文件处理等工具，回复时间会相应增加。这与网页端一致。
  </Accordion>

  <Accordion title="/auth 命令无效">
    确认你使用的专家已由创作者配置了飞书 OAuth 能力。并非所有专家都支持此功能。
  </Accordion>
</AccordionGroup>

## 相关页面

<CardGroup cols={2}>
  <Card title="渠道总览" icon="layer-group" href="/zh/documentation/channels/overview">
    了解所有支持的 IM 平台
  </Card>

  <Card title="钉钉接入" icon="message" href="/zh/documentation/channels/dingtalk">
    钉钉渠道配置指南
  </Card>
</CardGroup>