更新时间:2026-07-30 GMT+08:00
分享

钉钉机器人集成

码道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. 发布已创建的钉钉应用。
  1. 获取应用凭据。

2

码道Agent Space

步骤二:码道Agent Space配置

在码道Agent Space中,注册钉钉机器人用以接收和回复消息。

3

钉钉客户端

码道Agent Space

步骤三:钉钉远程控制

通过钉钉机器人对码道Agent Space下发任务。

步骤一:准备工作

  1. 创建钉钉应用。

    登录钉钉开发者后台,参考创建应用中操作,创建一个钉钉企业内部应用。

  2. 添加机器人能力,并完成配置和发布。

    1. 参考添加应用能力中操作,为已创建的应用添加机器人能力。
    2. 参考配置企业机器人中操作,完成机器人的配置并发布。

      配置机器人时,请务必将“消息接收模式”设置为“Stream模式”

  3. 发布已创建的钉钉应用。

    参考发布应用中操作,完成应用的发布。

  4. 获取应用凭据。

    参考Client ID/Client Secret中操作,获取钉钉企业内部应用的身份凭证对(Client ID、Client Secret)。后续在码道Agent Space中,连接钉钉机器人时需要使用该凭证。

步骤二:码道Agent Space配置

  1. 参考开启码道Agent Space操作,进入码道Agent Space。
  2. 在码道Agent Space对话面板中,单击“选择项目文件夹”,选择“打开项目”,打开一个文件夹。

    图1 打开一个文件夹

  3. 在码道Agent Space页面右上角,单击设置图标 ,进入码道Agent Space设置页面。
  4. 选择“IM集成”,单击钉钉机器人集成后的配置,进入“注册钉钉通道”页面。
  5. 输入4中获取的钉钉机器人凭证(Client ID/Client Secret),单击“注册”

    图2 钉钉机器人凭证完成注册

    等待注册完成,当状态由“连接中”变为“已连接”时,说明钉钉机器人注册成功。

步骤三:钉钉远程控制

  1. 登录钉钉客户端,找到已加入的组织。
  2. 在钉钉客户端最上方的搜索框中,搜索2中创建的机器人,单击搜索到的结果,即可进入对应的机器人。
  3. 在钉钉机器人中输入想要执行的任务内容,单击“发送”提交任务。

    机器人将自动接收到来自码道Agent Space的反馈信息。此外,在钉钉客户端还支持使用斜杠命令来触发相应功能,操作更加便捷。

    在钉钉客户端单聊场景中,用户可上传文件供码道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消息 > 钉钉消息”中,您可以实时查看任务执行过程及结果。单击会话聊天界面右上方的产物面板图标 ,即可在任务产物列表中查看生成的交付件。

在钉钉客户端支持的斜杠命令

表3 支持的斜杠命令

命令

说明

/stop

在停止当前会话。

/help

查看可用命令。

/new

创建新会话。

新建会话时,码道Agent Space会自动保存原会话至历史列表。此后您将进入全新的对话环境,无法再返回之前的会话状态。

/models

查看和切换模型。

仅支持查看与切换码道Agent Space内置模型。

相关文档