AgentTeams 钉钉渠道配置指南
通过配置钉钉渠道，可将 AgentTeams 的 Worker 接入钉钉机器人。配置完成后，用户通过钉钉单聊或群聊向机器人发送消息，机器人将消息转发给对应的 Worker，并将 Worker 的回复返回到当前会话。配置流程包含以下五个步骤：
在钉钉开发者平台创建应用。
为应用添加机器人并完成基础配置。
（可选）配置流式输出卡片，实现回复逐步展示。
在 AgentTeams 控制台启用钉钉渠道并填写配置信息。
通过钉钉发起对话，验证配置是否成功。
适用范围
开始配置前，确保满足以下条件：
拥有钉钉开发者平台账号，且具备企业管理员权限。
已创建目标 Worker（参见管理 Worker 和 Worker 团队）。
拥有 AgentTeams 控制台的访问权限。
创建钉钉应用
登录钉钉开发者平台，进入开发者后台。
创建一个企业内部应用，用于接入 AgentTeams Worker。
添加和配置机器人
为已创建的钉钉应用添加机器人能力，并完成以下基础配置：
申请添加机器人。申请成功后，进入 ，获取
app_key和app_secret，后续需在 AgentTeams 控制台填写。进入 ，选择 Stream 模式。
进入 ，设置允许访问机器人的部门范围。
进入 ，搜索并添加以下权限：
互动卡片实例写权限
AI 卡片流式更新权限
进入 ，添加服务器出口 IP。
说明可通过其他已配置的渠道与 Worker 对话（发送"告诉我你的公网 IP"），获取服务器出口 IP。
配置流式输出卡片（可选）
如果希望 Worker 的回复通过钉钉以流式方式逐步展示，需要额外完成流式输出卡片配置。不需要流式输出时，可跳过此步骤，直接进入 AgentTeams 控制台配置。
打开钉钉开发者平台，进入 。
卡片类型选择 AI 卡片。
进入编辑界面后，单击 保存，再单击 发布。
发布完成后，从卡片列表获取
TemplateId，后续需作为卡片 ID 填入 AgentTeams 控制台。
在 AgentTeams 控制台启用钉钉渠道
完成钉钉侧的应用和机器人配置后，通过 AgentTeams 控制台为目标 Worker 启用钉钉渠道。
登录 AgentTeams 控制台。
在左侧导航栏单击 Worker 管理，找到目标 Worker 并进入其详情页。
进入 Worker 访问设置，找到钉钉渠道配置区域，填写以下配置项。
参数
说明
app_key钉钉应用的 App Key。从钉钉开发者平台的 获取。
app_secret钉钉应用的 App Secret。从钉钉开发者平台的 获取。
Robot Code钉钉机器人标识，值与
app_key相同。TemplateId钉钉 AI 卡片模板 ID。仅在启用流式输出时需要填写，值为上一步骤获取的卡片 ID。
配置完成后，单击 保存。
验证配置
配置保存后，通过以下方式验证钉钉渠道是否配置成功：
单聊：打开钉钉，搜索已配置的机器人名称，直接发起对话。
群聊：打开目标群聊，进入 > 添加机器人，搜索并添加机器人后发起对话。
发送任意消息后，机器人应将 Worker 的回复返回到当前会话。如果未收到回复，检查以下配置：
IP 白名单是否已添加正确的服务器出口 IP。
app_key和app_secret是否填写正确。是否已添加 互动卡片实例写权限 和 AI 卡片流式更新权限。
安全注意事项
app_secret是应用密钥，仅通过 AgentTeams 控制台配置页填写，请勿写入文档、代码仓库或聊天记录。群聊场景下，机器人被加入群后，群内所有成员均可能触发 Worker。建议仅向可信群开放机器人。
建议将机器人的可见范围设置为最小化，避免无关人员搜索到机器人。