钉钉消息渠道配置¶
钉钉消息渠道用于将 Agent 接入钉钉群聊或私聊会话。配置完成后，团队可以在钉钉中直接 @ Agent 提问、发起协作，或接收 Agent 推送的任务结果。
接入方式¶
Agent Teams 使用钉钉机器人的 Stream 模式建立长连接，接收消息并发送回复。配置时需要以下凭证：
| 凭证 | 说明 |
|---|---|
Client ID |
钉钉应用的唯一标识，也称 AppKey。 |
Client Secret |
钉钉应用的密钥，也称 AppSecret。 |
配置钉钉应用¶
进入 钉钉开发者平台中需要接入的企业内部应用，完成以下设置：
- 在应用能力中确认已添加机器人能力；
- 进入机器人配置，将消息接收模式设置为 Stream 模式；
- 进入权限管理，分别搜索并开通下表中的权限；
- 在凭证与基础信息中复制
Client ID和Client Secret； - 进入目标 Agent 的消息渠道页面，点击新建消息渠道并选择钉钉，填写
Client ID和Client Secret后保存并启用； - 发布应用版本。
| 权限 | 用途 |
|---|---|
Card.Streaming.Write |
发送流式卡片内容。 |
Card.Instance.Write |
创建和更新卡片实例。 |
qyapi_robot_sendmsg |
以机器人身份发送消息。 |
验证连接¶
- 返回 Agent 工作台确认钉钉消息渠道的连接状态；
- 在钉钉群中添加机器人并
@机器人发送一条消息，或在私聊中直接向机器人发送消息； - 确认 Agent 能够接收消息并返回回复。
完成连接后，还需要在希望接收推送的群聊中 @ 机器人发送一条消息，或向机器人发送一条私聊消息，系统才会建立该对话对应的消息渠道会话。只有已建立的会话，才会出现在自动化或任务接入的消息渠道投递选择列表中。更多说明请参考准备用于结果投递的消息渠道会话。
注意
在钉钉群中使用 Agent 时，通常需要 @ 机器人后再发送消息。请确认机器人消息接收模式为 Stream 模式。Client ID 和 Client Secret 保存后不能直接编辑；如需更换，请重新接入钉钉并按页面提示更新当前连接。
常见问题¶
长连接未建立¶
请确认消息渠道已启用，机器人消息接收模式为 Stream 模式，并检查 Client ID 和 Client Secret 是否填写正确。
机器人没有回复¶
请确认应用已发布、机器人能力已启用，并已开通 Card.Streaming.Write、Card.Instance.Write 和 qyapi_robot_sendmsg 权限。群聊中需要 @ 机器人后再发送消息。