飞书通道配置指南

本文档介绍如何在飞书开放平台中完成机器人应用准备，并将所需认证信息配置到 SuperMap AgentX Server 的飞书通道中。

功能概述

飞书通道用于将 AgentX 智能体接入飞书消息环境，实现通过飞书与智能体进行交互。完成本文档中的配置后，管理员可在 AgentX 后台新增飞书通道，并将其分配给目标智能体使用。

前置条件

已具备可登录飞书开放平台的飞书账号。
账号具备创建企业自建应用的权限；若使用企业账号，后续可能需要管理员审核。
已能够访问 SuperMap AgentX Server 后台管理页面。

注意：

创建应用时请使用飞书开放平台中的“企业自建应用”，不要误创建为商店应用或使用 Lark 入口登录，否则后续权限导入可能失败。

获取步骤

1. 创建企业自建应用

登录飞书开放平台后，点击创建企业自建应用，根据提示填写应用名称、描述等基础信息并完成创建。创建成功后，系统会自动跳转到应用详情页。

图：创建企业自建应用

2. 添加机器人能力

在应用详情页的添加应用能力区域中找到机器人卡片，点击添加，为应用启用机器人能力。

图：添加机器人能力

3. 打开权限管理

在应用详情页左侧菜单中点击权限管理，然后选择批量导入 / 导出权限。该入口用于一次性导入飞书机器人运行所需的权限项。

图：打开权限管理

4. 导入并申请开通权限

在弹出的批量导入窗口中，清空输入框中的原有内容，将以下JSON代码复制进去，依次点击下一步，确定新增权限和申请开通。页面提示权限添加成功后，点击确认完成导入。

{
"scopes": {
"tenant": [
"aily:file:read",
"aily:file:write",
"application:application.app_message_stats.overview:readonly",
"application:application:self_manage",
"application:bot.menu:write",
"cardkit:card:write",
"contact:user.employee_id:readonly",
"corehr:file:download",
"docs:document.content:read",
"event:ip_list",
"im:chat",
"im:chat.access_event.bot_p2p_chat:read",
"im:chat.members:bot_access",
"im:message",
"im:message.group_at_msg:readonly",
"im:message.group_msg",
"im:message.p2p_msg:readonly",
"im:message:readonly",
"im:message:send_as_bot",
"im:resource",
"sheets:spreadsheet",
"wiki:wiki:readonly"
],
"user": [
"aily:file:read",
"aily:file:write",
"im:chat.access_event.bot_p2p_chat:read"
]
}
}