# 钉钉机器人集成
码道Agent Space具备多端IM接入能力，支持将码道Agent Space的Agent能力复用于多个IM平台，并提供统一的配置管理。
本章节将详细介绍如何将码道Agent Space接入钉钉，助您快速实现功能集成与流程协同。
#### 约束限制
表1约束与限制 
| 限制类别 | 具体限制                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|:---|:---|
| 功能限制 | 一个钉钉机器人仅支持对接一个码道Agent Space。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 操作系统 | - Windows操作系统：**推荐使用** **Windows 11 (x64)**；如果使用Windows 10 (x64)，系统版本需为2019年及以上，建议升级至最新稳定版本。  - macOS操作系统：macOS 11及以上版本，兼容ARM64（Apple Silicon）架构。  - Linux操作系统：Linux（ARM64）架构，glibc版本 ≥ 2.31，glibcxx版本 ≥ 3.4.26。   |
   
#### 操作流程
表2码道Agent Space接入钉钉操作流程 
| 序号 | 操作平台                                                      | 步骤                                                                  | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
|:---|:---|:---|:---|
| 1  | 钉钉开发者后台                                                   | [步骤一：准备工作]             | 在码道Agent Space对接钉钉机器人时，请提前完成如下操作： 1. 创建钉钉应用。  2. 添加机器人能力，并完成配置和发布。  3. 发布已创建的钉钉应用。    4. 获取应用凭据。   |
| 2  | 码道Agent Space                                             | [步骤二：码道Agent Space配置] | 在码道Agent Space中，注册钉钉机器人用以接收和回复消息。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 3  | 钉钉客户端 码道Agent Space | [步骤三：钉钉远程控制]            | 通过钉钉机器人对码道Agent Space下发任务。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
   
 #### 步骤一：准备工作
1. 创建钉钉应用。 
   登录[钉钉开发者后台](https://open-dev.dingtalk.com/)，参考[创建应用](https://open.dingtalk.com/document/dingstart/create-application#76ba742756c61)中操作，创建一个钉钉企业内部应用。
   
   
2. 添加机器人能力，并完成配置和发布。
   
   1. 参考[添加应用能力](https://open.dingtalk.com/document/dingstart/create-application#2009fdc27dt04)中操作，为已创建的应用添加机器人能力。
   
   2. 参考[配置企业机器人](https://open.dingtalk.com/document/dingstart/configure-the-robot-application)中操作，完成机器人的配置并发布。
      ![](https://support.huaweicloud.com/usermanual-codeartsagent/public_sys-resources/caution_3.0-zh-cn.png)
      配置机器人时，请务必将"消息接收模式"设置为"Stream模式"。
      
   
   
   
   
3. 发布已创建的钉钉应用。 
   参考[发布应用](https://open.dingtalk.com/document/dingstart/publish-dingtalk-application)中操作，完成应用的发布。
   
   
4. 获取应用凭据。
   
   参考[Client ID/Client Secret](https://open.dingtalk.com/document/dingstart/basic-concepts-beta#0c921e272057g)中操作，获取钉钉企业内部应用的身份凭证对（Client ID、Client Secret）。后续在码道Agent Space中，连接钉钉机器人时需要使用该凭证。
   
   
 
 #### 步骤二：码道Agent Space配置
1. 参考[开启Space模式](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0006.html#codeartsagent_ug_0006__section183281754460)操作，进入码道Agent Space。
2. 在码道Agent Space对话面板中，单击"选择项目文件夹"，选择"打开项目"，打开一个文件夹。 
   图1打开一个文件夹   
   ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002714384888.png "点击放大")
   
   
3. 在码道Agent Space页面右上角，单击设置图标 ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002694233904.png)，进入码道Agent Space设置页面。
4. 选择"IM集成"，单击钉钉机器人集成后的配置，进入"注册钉钉通道"页面。
5. 输入[4]中获取的钉钉机器人凭证（Client ID/Client Secret），单击"注册"。
   
   图2钉钉机器人凭证完成注册   
   ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002694393788.png)
   等待注册完成，当状态由"连接中"变为"已连接"时，说明钉钉机器人注册成功。
   
   
 
 #### 步骤三：钉钉远程控制
1. 登录钉钉客户端，找到已加入的组织。
2. 在钉钉客户端最上方的搜索框中，搜索[2]中创建的机器人，单击搜索到的结果，即可进入对应的机器人。
3. 在钉钉机器人中输入想要执行的任务内容，单击"发送"提交任务。 
   机器人将自动接收到来自码道Agent Space的反馈信息。此外，在钉钉客户端还支持使用[斜杠命令]来触发相应功能，操作更加便捷。
   ![](https://support.huaweicloud.com/usermanual-codeartsagent/public_sys-resources/note_3.0-zh-cn.png)
   在钉钉客户端**单聊**场景中，用户可上传文件供码道Agent Space进行智能解析、文本提取及语义分析等操作。为确保处理效果，上传文件需满足以下要求：
   - **文件大小与数量** **限制**：单个文件大小不超过5MB，单次最多允许上传5个文件。
   
   - **支持的文件类型** ：表格类（.**xlsx** 、.**xls** 、**.csv** ）、文档类（**.pptx、.pdf、.doc、.docx、.md、.txt** ）和图片类（**.jpg、.png**）。
   
   - **数据规模限制**（仅针对表格类文件）：每个工作簿包含的工作表数量不得超过20个；每个工作表的有效数据行数不能超过20000行，列数不能超过200列。
    
   
   
4. 根据反馈消息确认任务需求及关键信息，完成任务的创建。
5. 查看任务执行结果。 
   - **在钉钉机器人端**：钉钉机器人接收到来自码道Agent Space的完成反馈，提示任务执行结束并附带产物位置。
   
   - **在码道Agent Space侧** ：在码道Agent Space界面的"IM消息 \> 钉钉消息"中，您可以实时查看任务执行过程及结果。单击会话聊天界面右上方的产物面板图标 ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002723873313.png)，即可在任务产物列表中查看生成的交付件。
   
   
   
   
 
 #### 在钉钉客户端支持的斜杠命令
表3支持的斜杠命令 
| 命令      | 说明                                                                                                         |
|:---|:---|
| /stop   | 在停止当前会话。                                                                                                   |
| /help   | 查看可用命令。                                                                                                    |
| /new    | 创建新会话。 新建会话时，码道Agent Space会自动保存原会话至历史列表。此后您将进入全新的对话环境，无法再返回之前的会话状态。 |
| /models | 查看和切换模型。 仅支持查看与切换码道Agent Space内置模型。                              |