Agent集成飞书 AgentRun对接飞书机器人-函数计算(FC)-阿里云帮助中心

前提条件

已开通函数计算服务并创建 AgentRun Agent。具体操作，可参见快速创建Agent（无代码）。
拥有飞书企业管理员权限，可登录飞书开放平台。

步骤一：创建飞书应用

1. 创建应用并获取凭证

登录飞书开放平台。
单击创建企业自建应用，填写应用名称和描述，选择应用图标，单击创建。
在左侧导航栏单击凭证与基础信息，复制 App ID 和 App Secret。

App Secret 仅在创建时显示一次，请妥善保存。如果遗失，需要重新生成。

2. 导入所需权限

在左侧导航栏单击权限管理。

单击批量导入/导出权限按钮，粘贴以下 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"
    ]
  }
}

单击下一步，确认新增权限，单击申请开通。

以上 JSON 包含 22 项 tenant 范围权限和 3 项 user 范围权限，涵盖即时消息、文件读写、文档读取、电子表格、知识库等能力。请确保所有权限均已成功开通，否则 Agent 部分功能可能无法正常使用。

3. 启用机器人能力

在左侧导航栏单击添加应用能力。
选择按能力添加页签，找到机器人卡片，单击配置。

步骤二：在 AgentRun 配置飞书集成

登录AgentRun 控制台。
单击目标 Agent 名称，进入 Agent 详情页。
单击集成与发布页签，单击IM集成，单击添加IM机器人。

在添加IM机器人面板中，机器人模式选择标准机器人，选择平台选择飞书机器人，并填写以下信息：

参数	说明
机器人名称	输入机器人的展示名称，最多 128 个字符。
描述	（可选）输入机器人的描述信息，最多 256 个字符。
机器人模式	选择标准机器人，使用 Agent Endpoint 进行消息处理。
选择 Endpoint	选择已发布的 Agent Endpoint，机器人将通过该 Endpoint 处理消息。
选择协议规范	选择消息处理的协议规范。如尚未创建，可单击添加协议新建，或单击刷新协议列表更新。
飞书 App ID	在步骤一中获取的飞书应用 App ID。可在飞书开放平台的应用管理 - 应用详情 - 凭证页面获取。
飞书 App Secret	在步骤一中获取的飞书应用 App Secret。
创建后立即启用	默认勾选。创建成功后机器人立即运行并响应 IM 消息；若取消勾选，创建后机器人为停用状态，可在列表中手动启用。

单击创建机器人，完成飞书集成配置。

说明
机器人配置后将自动在企业账号下部署 IM 服务函数（一个主账号复用同一个函数），并预留 1 个实例（规格 1C/1G、可按需手动扩缩容），用于与机器人保持长连接通信，函数预留涉及计费，详见计费概述。

配置飞书事件订阅

完成 AgentRun 侧配置后，返回飞书开放平台配置事件订阅，使机器人能够接收用户消息。

在飞书开放平台左侧导航栏单击事件与回调。
在事件配置页签中单击订阅方式，选择使用长连接接收事件，单击保存。
在事件配置页面，单击添加事件，搜索事件 im.message.receive_v1（接收消息），单击确认添加。

发布飞书应用

在飞书开放平台左侧导航栏单击版本管理与发布。
单击创建版本，填写应用版本号和更新说明，单击保存。
提交审核并发布应用。

应用发布后，在可见范围内的飞书用户才能使用该机器人。

步骤三：在飞书中使用 Agent

完成配置后，您可以在飞书群聊或私聊中与 Agent 进行对话。

群聊中使用

在飞书中创建群聊或打开已有群聊。
在群设置中添加您在步骤一中创建的机器人。
在群聊中 @机器人名称并输入问题，即可与 Agent 对话。

私聊中使用

在飞书搜索栏中搜索机器人名称，打开机器人对话窗口，直接发送消息即可与 Agent 进行私聊对话。