DingTalk Bot Setup Guide Chinese
本指南介绍如何创建和配置钉钉机器人，以便与 AionUi 连接，实现通过钉钉与 AI 助手对话。
AionUi 支持钉钉机器人集成，允许你直接通过钉钉与 AI 助手对话。本指南将带你完成：
- 在钉钉开放平台创建机器人应用
- 在 AionUi 中配置凭证
- 授权用户并开始对话
- 拥有开发者权限的钉钉账号
- 已安装 AionUi 应用程序
- 对机器人应用有基本了解
-
访问钉钉开放平台
- 打开 钉钉开放平台
- 使用钉钉账号登录
-
创建应用
- 登录后进入 应用开发 → 企业内部开发
- 点击"创建应用"
- 选择 机器人 类型
-
获取凭证
- 在应用详情页找到 开发信息 或 凭证 部分
- 复制你的 AppKey（这就是 Client ID）
- 复制你的 AppSecret（这就是 Client Secret）
⚠️ 重要：请妥善保管这些凭证，不要公开分享
-
配置消息接收模式
- 在应用配置中找到"消息接收模式"或"连接方式"
- 选择 Stream 模式（流式连接）
- 这将启用实时消息流式传输，支持 AI 卡片流式响应
-
发布钉钉机器人
- 完成配置后，点击 发布 按钮发布机器人
⚠️ 注意：非管理员用户需要管理员审批才能开通权限
在应用详情页的"权限管理"或"接口权限"部分，逐个搜索并开通以下权限：
- Card.Streaming.Write - AI 卡片流式写入权限
- Card.Instance.Write - AI 卡片实例写入权限
- qyapi_robot_sendmsg - 机器人发送消息权限
这些权限是机器人正常工作的必要条件。
-
配置可见范围
- 在应用详情页找到"可见范围"或"使用范围"设置
- 确认可见范围设置为"仅自己"（测试阶段）或选择需要使用的用户/部门
-
启用机器人
- 确保机器人功能已启用
- 检查机器人名称、头像等基本信息
-
发布应用
- 点击 发布 按钮
- 确认发布信息无误
- 等待发布完成
💡 提示：发布后，机器人才能被用户搜索和使用。如果只是测试，可以先设置为"仅自己可见"。
-
**打开 AionUi 设置 **
- 启动 AionUi 应用程序
- 进入 设置（设置）
- 导航到 WebUI（Channel）部分
- 找到"钉钉"频道卡片
- 展开钉钉配置
-
输入凭证
- 在钉钉配置表单中：
- Client ID：粘贴步骤 1 中获取的 AppKey
- Client Secret：粘贴步骤 1 中获取的 AppSecret
- 点击 "测试并连接" 以验证连接
- 在钉钉配置表单中：
-
配置Agent和模型
- 选择要用于钉钉对话的 Agent
- 为所选代理选择 模型
- 这些设置决定了哪个 AI 助手将响应钉钉消息
成功连接后，你需要授权可以与机器人交互的用户：
-
在钉钉中找到你的机器人
- 打开钉钉应用程序
- 按名称搜索你的机器人
- 开始与机器人对话
-
发送测试消息
- 向机器人发送任何消息（例如："你好"）
- 这将触发配对请求
-
批准配对请求
- 在 AionUi 中，返回设置 → 频道 → 钉钉
- 你应该看到"待处理配对"部分
- 点击 "批准" 以授权用户
- 用户现在可以通过钉钉与 AI 助手聊天
-
开始聊天
- 批准后，用户可以向机器人发送消息
- AI 助手将使用钉钉的 AI 卡片流式传输功能实时响应
问题：无法连接到钉钉 API
-
解决方案：
- 验证你的 Client ID 和 Client Secret 是否正确
- 检查你的网络连接
- 确保机器人应用在钉钉开放平台上正确配置
问题：用户无法向机器人发送消息
-
解决方案：
- 确保用户已在 AionUi 设置中批准
- 验证机器人是否在 AionUi 中启用
- 检查机器人应用是否在钉钉开放平台上发布/激活
问题：机器人不响应消息
-
解决方案：
- 检查 AionUi 设置中的连接状态
- 验证代理和模型是否正确配置
- 确保机器人在钉钉开放平台上具有必要的权限（特别是步骤 2 中提到的三个权限）
- 确认机器人应用已成功发布（步骤 3）