连接器飞书
官方参考资料
按接入步骤查找飞书官方文档，并了解哪些配置适用于 EasyXAI。
优先按本指南完成 EasyXAI 接入；需要了解飞书后台的权限、审核规则或接口限制时，再查阅对应的官方资料。
飞书后台配置
| 要解决的问题 | 官方资料 | 阅读重点 |
|---|---|---|
| 从哪里创建企业自建应用？ | 飞书开发者后台 | 登录目标企业，切换「企业自建应用」，进入创建表单 |
| 如何取得应用凭证并配置授权？ | 飞书官方网页应用授权示例 | 「准备工作」中的 App ID、App Secret、重定向 URL 和版本发布位置 |
| 重定向 URL 应配在哪里？ | 配置重定向 URL | 安全设置中的白名单配置；EasyXAI 的地址使用当前部署提供的完整值 |
| 如何申请权限？ | 申请 API 权限 | 区分应用身份和用户身份，检查开通与审核状态 |
| 应用如何发布、谁来审批？ | 自建应用审核与发布说明 | 企业审核规则、版本发布与使用范围 |
官方网页应用示例用于解释飞书侧的配置位置。接入 EasyXAI 时不需要部署其中的 Python 示例服务，也不要复制示例中的 localhost 回调地址。
文档访问和授权机制
| 主题 | 官方资料 | 与本项目的关系 |
|---|---|---|
| 用户授权凭据 | 获取 user_access_token | EasyXAI 在授权回调后管理凭据，普通使用者不需要手动交换或粘贴 Token |
| 知识库可见范围 | 获取知识空间列表 | 帮助理解为什么某个账号能看到的知识库有限 |
| 文档与知识库读取权限 | 飞书知识库导出说明 | 可参考其中的文档、Wiki、Drive 权限标识；其机器人访问方式与 EasyXAI 的成员授权方式不同 |
| 飞书 MCP 能力 | 飞书官方 OpenAPI MCP | 了解工具能力及其授权要求；EasyXAI 用户以平台已提供的应用能力为准 |
对照资料时注意
- OAuth 重定向 URL与事件订阅回调属于不同配置。本指南的地址填在「安全设置 → 重定向 URL」。
- 只使用本指南的资源库读取流程时，按用户身份权限清单配置即可，无需照搬聊天机器人教程中的消息、群聊和事件订阅配置。
- 飞书和 Lark 使用不同的平台区域。界面中的区域选择必须与授权应用、账号相匹配。
- 在飞书中开通权限后，还需检查 EasyXAI 请求的权限清单；更新已发布应用的权限后，成员可能需要重新授权。
回到操作指南
| 当前进度 | 下一步 |
|---|---|
| 尚未配置飞书应用 | 配置自建应用 |
| 已授权，准备在平台使用 | 在 EasyXAI 中使用 |
| 准备整理知识库或云盘资料 | 资源库同步 |
| 配置后仍有异常 | 常见问题 |