钉钉消息渠道配置¶
钉钉消息渠道用于将 Agent 接入钉钉群聊或私聊会话。配置完成后,团队可以在钉钉中直接 @ Agent 提问、发起协作,或接收 Agent 推送的任务结果。
配置流程¶
以钉钉渠道为例,您可以按以下流程准备应用和机器人配置:
- 前往 钉钉开发者平台,创建企业内部应用,并为应用添加机器人能力;
- 进入应用配置,打开机器人配置,消息接收模式选择 Stream 模式;
- 在应用的基础信息中复制
Client ID和Client Secret,并填写到 Agent 的消息渠道配置中; - 在权限管理中确认应用已开通机器人发送消息所需权限,例如
qyapi_robot_sendmsg; - 发布应用版本,并确认应用可见范围包含需要使用该 Agent 的账号或群成员;
- 在钉钉群中添加机器人并
@机器人,或私聊机器人创建会话。
完成连接后,还需要在希望接收推送的群聊中 @ 机器人发送一条消息,或向机器人发送一条私聊消息,系统才会建立该对话对应的消息渠道会话。只有已建立的会话,才会出现在自动化或任务接入的消息渠道投递选择列表中。更多说明请参考准备用于结果投递的消息渠道会话。
注意
在钉钉群中使用 Agent 时,通常需要 @ 机器人后再发送消息。若使用钉钉配置接入,请确认机器人消息接收模式为 Stream 模式。