Agent整合飛書 AgentRun對接飛書機器人 - Function Compute

前提條件

已開通Function Compute服務並建立 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 console。
單擊目標 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 進行私聊對話。

系統預置指令

Agent 支援以下系統預置指令，您可以在對話中直接輸入使用：

指令	說明
`/help`	顯示協助資訊，查看可用指令列表。
`/clear`	清除目前的交談的記憶，開始全新對話。
`/reset`	重設對話上下文。
`/history`	查看歷史對話記錄。

調用子 Agent（僅限超級 Agent）

子 Agent 調用功能僅在 Agent 類型為超級 Agent 時可用。普通 Agent 不支援此功能。

如果您建立的是超級 Agent，在飛書對話中可以調用該超級 Agent 下綁定的子 Agent：

在對話中輸入 @子Agent名稱 加上具體問題即可觸發對應的子 Agent。例如：@資料分析Agent 幫我分析一下最近的銷售資料。
系統會自動識別超級 Agent 下綁定的所有子 Agent，並將請求路由到對應的子 Agent 進行處理。
支援調用 Agent 空間內的所有已綁定 Agent。