本文介绍如何将函数计算 AgentRun 中的 Agent 接入钉钉，实现在钉钉群聊或私聊中通过 @机器人 与 Agent 进行对话交互。
前提条件
已开通函数计算服务并创建 AgentRun Agent。具体操作，可参见快速创建Agent（无代码）。
拥有钉钉企业管理员权限，可登录钉钉开放平台。
步骤一：创建钉钉应用
1. 创建应用并获取凭证
登录钉钉开放平台。
在左侧导航栏选择应用开发，单击创建应用。
选择企业内部应用 > 钉钉应用，单击页面右上角的创建应用按钮。
配置应用名称和图标等信息，单击保存。
在左侧导航栏单击凭证与基础信息，复制 Client ID 和 Client Secret。
Client Secret 仅在创建时显示一次，请妥善保存。如果遗失，需要重新生成。
2. 开通所需权限
在应用管理页面，单击左侧导航栏的权限管理。
搜索并开通以下三项权限：
互动卡片实例写权限
AI卡片流式更新权限
企业内机器人发送消息权限
以上三项权限缺一不可，否则 Agent 将无法在钉钉中正常发送消息。
3. 配置钉钉机器人
在左侧导航栏选择应用能力 > 添加应用能力，添加机器人能力。
在机器人配置页面，打开机器人配置开关。
填写机器人名称和描述信息。
将消息接收模式设置为 Stream 模式。
消息接收模式必须选择 Stream 模式，AgentRun 的钉钉集成仅支持该模式。请勿选择 HTTP 模式。
单击发布，保存机器人配置。
4. 发布应用
在左侧导航栏选择应用发布 > 版本管理与发布，单击创建新版本。
配置应用版本号和可见范围等信息，单击保存并确认发布。
应用发布后，在可见范围内的钉钉用户才能使用该机器人。
步骤二：在 AgentRun 控制台配置钉钉集成
登录 AgentRun 控制台。
单击目标 Agent 名称，进入 Agent 详情页。
单击集成与发布页签，单击 IM集成，单击添加机器人。
在添加IM机器人弹窗中，机器人模式选择标准机器人，机器人类型选择钉钉机器人，并填写以下信息：
参数
说明
机器人名称
输入机器人的展示名称。
机器人模式
选择标准机器人，使用 Agent Endpoint 进行消息处理。
选择 Endpoint
选择已发布的 Agent Endpoint，机器人将通过该 Endpoint 处理消息。
选择协议规范
选择消息处理的协议规范。如尚未创建，单击右侧 + 按钮新建。
钉钉 Client ID
在步骤一中获取的钉钉应用 Client ID。
钉钉 Client Secret
在步骤一中获取的钉钉应用 Client Secret。
单击创建机器人，完成钉钉集成配置。
说明启用后，AgentRun 将与钉钉开放平台建立长连接，预留 1 个实例用于长连接通信。该实例会产生费用，请关注计费概述。
步骤三：在钉钉中使用 Agent
完成配置后，您可以在钉钉群聊或私聊中与 Agent 进行对话。
群聊中使用
在钉钉中创建群聊或打开已有群聊。
在群设置中，单击机器人 > 添加机器人，搜索并添加您在步骤一中创建的机器人。
在群聊中 @机器人名称并输入问题，即可与 Agent 对话。
私聊中使用
在钉钉搜索栏中搜索机器人名称，打开机器人对话窗口，直接发送消息即可与 Agent 进行私聊对话。