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

前提條件

登入DingTalk開放平台。
在左側導覽列選擇應用開發，單擊建立應用。
選擇企業內部應用 > DingTalk應用，單擊頁面右上方的建立應用按鈕。
配置應用程式名稱和表徵圖等資訊，單擊儲存。
在左側導覽列單擊憑證與基礎資訊，複製 Client ID 和 Client Secret。

Client Secret 僅在建立時顯示一次，請妥善儲存。如果遺失，需要重建。

在應用管理頁面，單擊左側導覽列的許可權管理。
搜尋並開通以下三項許可權：
- 互動卡片執行個體寫入權限
- AI卡片流式更新許可權
- 企業內機器人發送訊息許可權
以上三項許可權缺一不可，否則 Agent 將無法在DingTalk中正常發送訊息。

在左側導覽列選擇應用能力 > 添加應用能力，添加機器人能力。
在機器人配置頁面，開啟機器人配置開關。
填寫機器人名稱和描述資訊。
將訊息接收模式設定為 Stream 模式。

訊息接收模式必須選擇 Stream 模式，AgentRun 的DingTalk整合僅支援該模式。請勿選擇 HTTP 模式。
單擊發布，儲存機器人配置。

在添加IM机器人面板中，机器人模式選擇标准机器人，选择平台選擇钉钉机器人，並填寫以下資訊：

參數	說明
机器人名称	輸入機器人的展示名稱，最多 128 個字元。
描述	（可選）輸入機器人的描述資訊，最多 256 個字元。
机器人模式	選擇标准机器人，使用 Agent Endpoint 進行訊息處理。
选择 Endpoint	選擇發行的 Agent Endpoint，機器人將通過該 Endpoint 處理訊息。
选择协议规范	選擇訊息處理的協議規範。如尚未建立，可單擊添加协议建立，或單擊刷新协议列表更新。
钉钉 Client ID	在步驟一中擷取的DingTalk應用 Client ID。可在钉钉开发者平台的应用 - 应用凭证頁面擷取。
钉钉 Client Secret	在步驟一中擷取的DingTalk應用 Client Secret。
创建后立即启用	預設勾選。建立成功後機器人立即運行並響應 IM 訊息；若取消勾選，建立後機器人為停用狀態，可在列表中手動啟用。

單擊创建机器人，完成DingTalk整合配置。

說明
啟用後，AgentRun 將與DingTalk開放平台建立長串連，預留 1 個執行個體用於長串連通訊。該執行個體會產生費用，請關注計費概述。

完成配置後，您可以在DingTalk群聊或私聊中與 Agent 進行對話。

在DingTalk搜尋欄中搜尋機器人名稱，開啟機器人交談視窗，直接發送訊息即可與 Agent 進行私聊對話。

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

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

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