运行机器人

客户端手动执行

您可在客户端上直接选择需要运行的应用，点击执行。点击左侧箭头，可填写应用所需的入参。

定时执行

• 首先，需要设置机器人客户端“允许被调度”。提供两种设置方式：

  • 方式1：客户端上直接配置，如下图所示。

    

  • 方式2：在机器人监控中，设置是否可调度，详见 机器人监控。

• 其次，在控制台-计划任务管理-定时任务 菜单中可配置定时任务。

  

  定时任务的填写要点如下：

  配置项	说明
  选择机器人	选择计划在哪些机器人上运行。
  执行配置	调度失败是否排队：调度失败是指应用未能按计划时间点执行；若选择是，当排队时间超过24小时，则判定本次执行失败，且不触发重试；任务实际运行时，若机器人处于不可调度状态（如未连接、未启用被调度），则当前执行的任务不进入队列。 失败重试：启用后，当应用执行失败时，机器人会立即重试，允许最多执行三次。 任务优先级：当同一个机器人在同一时间内有多个下发任务时，优先执行优先级权重高的任务。
  定时	支持立刻执行、定时执行一次、每隔一段时间执行、每日重复执行、每周重复执行、每月重复执行等定时方式。

接口触发执行

• 首先需要设置机器人客户端“允许被调度”，配置过程同上。

• 接口调用

  • 主要使用的相关接口

    • 使用 createServiceTask接口可触发执行，调用示例可参考API调用示例。

    • 使用 queryTaskStatus接口可查询指定taskId的任务状态，使用queryServiceResult可获取指定taskId的task_result。

  • 调用接口所需的AccessKeyId和AccessSecret。进入 “系统设置-个人信息”菜单中 ，可查看到当前账号的AK信息，如下图所示。

    

    重要

    接口调用方式仍然需要满足账号的应用使用权限要求，即AK所需的账号，如果没有指定应用的使用权限，接口调用会校验失败。

  • 调用接口所需的机器人ID。两种方式可查询到机器人ID。

    • 方式1：控制台的“本地型机器人-机器人监控”菜单中，可查看到机器人ID，如下图所示。此页面需要登录控制台的账号具有该菜单的操作权限。

      

    • 方式2：打开本地型机器人客户端，在“设置-关于”界面中可查看到机器人ID，如下图所示。

      

• 查看接口触发任务。可在“计划任务管理-接口触发任务”页面中查看到相关任务信息。

  

MCP Tool调用执行

• 首先，需要设置机器人客户端“允许被调度”，配置过程同上。

• 详见 发布和管理MCP Tool。

使用方式：被集成

以调用OpenAPI为例（MCP Tool调用同理），假设需要调用5个本地型机器人。

1. 准备5个本地型机器人。

   1. 管理员：创建5个子账号，专门用于登录本地型机器人，详见 管理子账号。

   2. 管理员：为这5个账号分配机器人授权许可，详见 分配本地型机器人授权许可。

   3. 在5台windows主机上安装本地型机器人客户端，并分别使用这5个账号登录本地型机器人客户端。

   4. 在控制台-机器人监控页面中，可查看到本地型机器人已经接入。

2. 准备1个子账号，用于接口调用。

   1. 管理员：创建1个子账号，专门用于通过AKSK调用本地型机器人。

      重要

      用于调用OpenAPI的账号：

      • 可不用为此账号分配机器人授权许可

      • 此账号的“可使用本地型机器人范围”配置，需要是“全部”或“指定范围中包含了需要调用的机器人”，详见 设置账号可使用的本地型机器人。

   2. 管理员：为此账号分配需要运行的应用，详见 管理账号的应用使用范围。

   3. 使用此账号登录控制台，获得AKSK，完成OpenAPI调用。

使用方式：按团队分配使用

假设需要分给3个团队使用：每个团队使用1个本地型机器人；团队中的人员采用远程登录到Windows手动运行或控制台的定时任务两种方式使用。

1. 管理员为第一个团队准备本地型机器人

   1. 管理员：创建1个子账号，详见 管理子账号。

   2. 管理员：为这个账号分配机器人授权许可，详见 分配本地型机器人授权许可。

   3. 管理员：安装本地型机器人并在客户端上完成登录。

   4. 管理员：设置此账号的“本地型机器人范围”为“指定范围”，确保这个账号只能使用一定范围内的机器人，详见 设置账号可使用的本地型机器人。

2. 管理员将该账号移交给相关团队。

3. 团队人员申请应用的使用权限，管理员完成审批。

如上依次完成分配工作。