AI 助理
文档备案控制台
官方文档
首页

管理频道

更新时间：
复制 MD 格式
我的收藏

频道（Channel）是DataBridge Agent提供的消息通道功能，支持将即时通讯平台（如钉钉与飞书）的用户消息接入DataBridge Agent，并将AI处理后的回复推送回对应平台，实现双向交互。本文介绍如何创建、启用、禁用和删除频道，以及配置钉钉和飞书机器人。

功能简介

DataBridge Agent支持通过频道连接即时通讯（IM）平台，实现用户与Al Agent之间的双向消息交互。您可以在频道管理页面创建、启用、禁用或删除频道，并根据业务需要选择开放模式或配对模式。目前支持钉钉与飞书IM平台。

说明

操作前请确保已创建DataBridge Agent实例，并在对应IM平台完成机器人的创建和配置。

频道列表

在频道管理页面，您可以查看已创建的所有频道。频道列表包含以下信息，您可以通过频道名称或App ID搜索目标频道。

列名

说明

频道名称

频道的名称，由创建时输入的接入名称或系统自动生成。

状态

频道的当前状态，包括启用和禁用。

App ID

频道关联的IM平台机器人的App ID。

配对模式

频道使用的配对模式，包括开放和配对模式。

创建频道

  1. 登录AI原生数据库服务控制台，在左侧导航栏，单击数据采集进入管理页面。

  2. 单击左侧导航栏中的频道。

  3. 选择一个目标DataBridge Agent实例，并单击新建频道。

  4. 在创建频道面板中，配置以下参数：

    配置项

    说明

    平台

    选择IM平台。支持钉钉与飞书。

    App ID

    输入IM平台机器人的App ID。您可以在对应IM平台的开放平台中获取该信息。

    App Secret

    输入IM平台机器人的App Secret。您可以在对应IM平台的开放平台中获取该信息。

    机器人名称

    （可选）输入频道的接入名称，用于在频道列表中展示。如不填写，系统将自动生成名称。

    配对模式

    选择频道的配对模式。支持开放和配对模式。详细说明，请参见配对模式说明。

    说明

    • 钉钉平台仅支持开放模式。

    • 频道创建后，配对模式不可更改。请根据业务需要谨慎选择。

  5. 单击创建。

启用或禁用频道

您可以通过启用或禁用频道来控制数据推送。禁用后，频道将停止向对应的IM平台推送数据。重新启用后，频道恢复数据推送。

警告

启用或禁用频道会触发通道重启，请在业务低峰期操作。

  1. 在数据采集管理页面中，单击左侧导航栏中的频道。

  2. 单击目标频道的状态开关即可启用或禁用频道。

配对操作（仅配对模式）

当频道使用配对模式时，您需要完成以下配对操作才能接收数据推送。

  1. 在飞书开发者小助手中，向频道关联的机器人发送任意私信消息。

  2. 机器人会触发未授权错误提示，从错误信息中获取8位配对码。

  3. 返回在数据采集管理页面，在频道页面中，单击目标频道的配对按钮，并输入提供的8位配对码等待匹配即可。

删除频道

警告

删除操作不可撤销。频道删除后，相关配置将从DataBridge Agent实例中移除，且无法恢复。

  1. 在数据采集管理页面中，单击左侧导航栏中的频道。

  2. 单击目标频道的删除图标并确认，即可删除当前频道。

附录

配对模式说明

频道支持以下两种配对模式：

模式

说明

适用场景

开放

任何用户均可直接向机器人发送消息并接收数据推送，无需验证。

适用于团队内部共享的场景，对数据接收人无严格限制。

配对

用户需要输入8位配对码，并经管理员审批后才能接收数据推送。每个频道仅能与一位用户完成配对。

适用于需要严格控制数据接收人的场景。

即时通讯（IM）平台创建机器人参考说明

钉钉机器人

  1. 创建钉钉应用与机器人

    （推荐）一键创建

    1. 访问钉钉开放平台，单击上方导航栏应用开发。

    2. 在应用开发的左侧导航栏中，单击企业内部应用 > 钉钉应用。

    3. 您可在一键自动创建OpenClaw机器人应用，开启智能协作之旅条幅上单击立即创建，一键即可完成钉钉应用与机器人的创建。

    自定义创建

    1. 创建钉钉应用：

      1. 访问钉钉开放平台，单击上方导航栏应用开发。

      2. 在应用开发的左侧导航栏中，单击企业内部应用 > 钉钉应用，在页面右上角单击创建应用。

      3. 在创建应用面板，依次填入应用名称、应用描述与应用图标（可选），单击保存完成创建。

    2. 配置钉钉机器人：

      1. 单击左侧导航栏中的应用能力 > 添加应用能力，找到机器人卡片，单击添加。

      2. 在机器人配置页面，打开机器人配置开关，可以参考页面提示完成配置。消息接收模式请选择Stream模式，然后单击发布。

        说明

        机器人消息预览图用于在群内添加机器人时，向钉钉用户展示机器人发送消息时的预览效果。首次创建测试时可按照图片格式和文件大小要求上传任意图片，后续使用再进行更改。

    3. 添加相关权限：在开发配置 > 权限管理中申请以下权限。

      • qyapi_robot_sendmsg

      • Card.Instance.Write

      • Card.Streaming.Write

    4. 发布钉钉应用：应用创建完成后，如果需要将应用供企业内其他用户使用，需要发布一个版本。

      1. 单击左侧导航栏中的应用发布 > 版本管理与发布，单击创建新版本。

      2. 进入版本详情页面，输入应用版本号和版本描述信息，选择合适的应用可见范围，完成后单击保存。并在弹窗中单击确认发布。

  2. （可选）开启流式输出

    如果需要机器人以流式方式逐步输出回答内容（类似打字效果），需要完成以下额外配置：

    在钉钉开放平台的开放能力 > 模板管理中新建一个AI卡片模板，并关联至您创建的钉钉应用中，用于展示流式输出内容。

    说明

    配置AI卡片时，您可以分别配置处理中、输出中与完成三个阶段的展示样式。

  3. 添加并验证机器人

    您可以创建群聊或在已有群聊中添加机器人，并与机器人对话，查看效果。

    1. 进入钉钉群群设置页面，单击机器人卡片区域，在机器人管理页面，单击添加机器人。在添加机器人的搜索文本框中输入目标机器人名称，并选中要添加的机器人。单击添加，完成后再单击完成添加。

    2. 在钉钉群中@机器人进行交流互动。也可以在钉钉的搜索栏中，输入机器人名称后，在功能页搜索到对应机器人，进行私聊互动。

飞书机器人

  1. 创建飞书应用

    1. 登录飞书开放平台，在右上角单击开发者后台。进入后台后单击创建企业自建应用，填入应用名称、应用描述与应用图标，单击创建。

    2. 进入应用管理后台，找到机器人能力，单击添加。

    3. 在左侧导航栏单击权限管理，进入页签后单击批量导入/导出权限，将以下JSON格式权限描述代码复制进导入页签中，单击下一步，确认新增权限，单击申请开通。

      {
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:read",
      "cardkit:card:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "event:ip_list",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
  }
}

    4. 进入凭证与信息页面，分别复制App ID和App Secret，后续需要在创建频道中配置。

  2. 配置事件回调

    1. 在左侧导航栏单击事件与回调。单击事件配置页签，订阅方式选择长连接，单击保存。

    2. 在事件配置页签的已添加事件中，添加接收消息（im.message.receive_v1）事件并确认。

    3. 在回调配置页签的订阅方式中，设置使用长连接接收回调，单击保存。

  3. 发布飞书应用

    完成上述配置后，需要发布应用使其生效。在左侧导航栏单击版本管理与发布，单击右上角创建新版本，填写版本号和更新说明等信息后，在页面底部单击保存并确认发布。

常见问题

  • Q1：创建频道后能否更改配对模式？

    不能。配对模式在创建频道时确定，创建后不可修改。如果需要更改配对模式，请删除当前频道并重新创建。

  • 禁用频道和删除频道有什么区别？

    禁用频道后，频道配置仍保留在实例中，您可以随时重新启用。删除频道后，频道配置将从实例中永久移除，无法恢复。

  • 一个频道能否配对多个用户？

    不能。使用配对模式的频道仅能与一位用户完成配对。如果需要多个用户接收数据，请创建多个频道或使用开放模式。

  • 为什么钉钉不支持配对模式？

    由于钉钉开放平台的API限制，当前钉钉平台仅支持开放模式。飞书平台支持开放模式和配对模式。

创建频道

  1. 登录AI原生数据库服务控制台。

  2. 在左侧导航栏单击数据采集。

  3. 单击左侧导航栏中的频道。

  4. 选择目标DataBridge Agent实例，单击新建频道。

  5. 在创建频道对话框中，配置以下参数：

    配置项

    说明

    平台

    选择IM平台。支持钉钉与飞书。

    App ID

    输入IM平台机器人的App ID。您可以在对应IM平台的开放平台中获取该信息。

    App Secret

    输入IM平台机器人的App Secret。您可以在对应IM平台的开放平台中获取该信息。

    机器人名称

    （可选）输入频道的接入名称，用于在频道列表中展示。如不填写，系统将自动生成名称。

    配对模式

    选择频道的配对模式。支持开放模式和配对模式。详细说明请参见配对模式说明。

    说明

    • 钉钉平台仅支持开放模式。

    • 频道创建后，配对模式不可更改。请根据业务需要谨慎选择。

  6. 单击创建。

启用或禁用频道

您可以通过启用或禁用频道来控制消息推送。禁用后，频道将停止向对应的IM平台推送消息。重新启用后，频道恢复消息推送。

警告

启用或禁用频道会触发通道重启，请在业务低峰期操作。

  1. 在DataBridge Agent管理页面中，单击左侧导航栏中的频道管理。

  2. 单击目标频道的状态开关即可启用或禁用频道。

配对操作（仅配对模式）

当频道使用配对模式时，您需要完成以下配对操作才能接收消息推送。

  1. 在飞书中，向频道关联的机器人发送任意私信消息。

  2. 机器人会触发未授权错误提示，从错误信息中获取8位配对码。

  3. 返回DataBridge Agent管理页面，在频道管理页面中，单击目标频道的配对按钮，输入8位配对码等待匹配即可。

删除频道

警告

删除操作不可撤销。频道删除后，相关配置将从DataBridge Agent实例中移除，且无法恢复。

  1. 在DataBridge Agent管理页面中，单击左侧导航栏中的频道管理。

  2. 单击目标频道的删除图标并确认，即可删除当前频道。

附录

配对模式说明

频道支持以下两种配对模式：

模式

说明

适用场景

开放模式

任何用户均可直接向机器人发送消息并接收回复，无需验证。

适用于团队内部共享的场景，对消息接收人无严格限制。

配对模式

用户需要输入8位配对码，并经管理员审批后才能接收消息推送。每个频道仅能与一位用户完成配对。

适用于需要严格控制消息接收人的场景。

IM平台机器人配置参考

钉钉机器人

  1. 创建钉钉应用与机器人

    1. 访问钉钉开放平台，单击上方导航栏应用开发。

    2. 在应用开发的左侧导航栏中，单击企业内部应用 > 钉钉应用，在页面右上角单击创建应用。

    3. 在创建应用面板中，填入应用名称、应用描述与应用图标（可选），单击保存完成创建。

    4. 单击左侧导航栏中的应用能力 > 添加应用能力，找到机器人卡片，单击添加。

    5. 在机器人配置页面，打开机器人配置开关，消息接收模式选择Stream模式，然后单击发布。

  2. 添加相关权限

    在开发配置 > 权限管理中申请以下权限：

    • qyapi_robot_sendmsg

    • Card.Instance.Write

    • Card.Streaming.Write

  3. 发布钉钉应用

    1. 单击左侧导航栏中的应用发布 > 版本管理与发布，单击创建新版本。

    2. 输入应用版本号和版本描述，选择合适的应用可见范围，单击保存并在弹窗中单击确认发布。

  4. （可选）开启流式输出

    如果需要机器人以流式方式逐步输出回答内容（类似打字效果），请在钉钉开放平台的开放能力 > 模板管理中新建一个AI卡片模板，并关联至您创建的钉钉应用。

  5. 添加并验证机器人

    进入钉钉群设置页面，单击机器人卡片区域，在机器人管理页面单击添加机器人。搜索并选中目标机器人，单击添加，完成后单击完成添加。在钉钉群中@机器人即可进行交流互动。

飞书机器人

  1. 创建飞书应用

    1. 登录飞书开放平台，在右上角单击开发者后台。进入后台后单击创建企业自建应用，填入应用名称、应用描述与应用图标，单击创建。

    2. 进入应用管理后台，找到机器人能力，单击添加。

    3. 在左侧导航栏单击权限管理，进入页签后单击批量导入/导出权限，将以下JSON格式权限描述代码复制进导入页签中，单击下一步，确认新增权限，单击申请开通。

      {
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:read",
      "cardkit:card:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "event:ip_list",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
  }
}

    4. 进入凭证与信息页面，分别复制App ID和App Secret，后续需要在创建频道中配置。

  2. 配置事件回调

    1. 在左侧导航栏单击事件与回调。单击事件配置页签，订阅方式选择长连接，单击保存。

    2. 在事件配置页签的已添加事件中，添加接收消息（im.message.receive_v1）事件并确认。

    3. 在回调配置页签的订阅方式中，设置使用长连接接收回调，单击保存。

  3. 发布飞书应用

    完成上述配置后，在左侧导航栏单击版本管理与发布，单击右上角创建新版本，填写版本号和更新说明后，在页面底部单击保存并确认发布。

常见问题

  • Q1：创建频道后能否更改配对模式？

    不能。配对模式在创建频道时确定，创建后不可修改。如果需要更改配对模式，请删除当前频道并重新创建。

  • Q2：禁用频道和删除频道有什么区别？

    禁用频道后，频道配置仍保留在实例中，您可以随时重新启用。删除频道后，频道配置将从实例中永久移除，无法恢复。

  • Q3：一个频道能否配对多个用户？

    不能。使用配对模式的频道仅能与一位用户完成配对。如果需要多个用户接收数据，请创建多个频道或使用开放模式。

  • Q4：为什么钉钉不支持配对模式？

    由于钉钉开放平台的API限制，当前钉钉平台仅支持开放模式。飞书平台支持开放模式和配对模式。

上一篇：DataBridge Agent快速入门下一篇：Agent开发平台