系统内置MCP Tool-机器人流程自动化(RPA)-阿里云帮助中心

概述

RPA服务端内置了一部分系统用途的MCP Tool，便于被Agent集成。RPA场景中更多关于MCP Tool，详见发布和管理MCP Tool。

本文重点对系统内置的MCP Tool进行介绍。

系统内置Tool

workersys_get_task_status

用途

根据任务ID查询任务状态和任务结果。

系统将会根据TaskId自动判别使用的机器人类型并返回相关数据，同时支持本地型机器人和服务型机器人。

输入

TaskId:字符串格式，必填

输出

{
    "requestId": "f507d191-***************",
    "success": true,
    "code": 0,
    "msg": "调用成功",
    "msgCode": "result.success",
    "data": {
        "TaskId": "150b05ea-***************",
        "TaskStatus": "complete",
        "TaskPriority": 50,
        "TaskDescription": null,
        "RobotId": "55E7E02B***************",
        "AppId": "a307c6ec-***************.",
        "AppParams": [
            {
                "Name": "cityname",
                "Value": "武汉"
            },
            {
                "Name": "weathertype",
                "Value": "temperature"
            }
        ],
        "TaskResult": "22",
        "CallbackConfig": null,
        "TaskCreateTime": 1760499398000,
        "TaskBeginTime": 1760499398000,
        "TaskEndTime": 1760499416000
    },
    "pager": null,
    "instanceId": null
}

TaskStatus：任务状态，如下所示
- waiting: 任务等待运行
- running: 任务正在运行
- complete: 任务正常结束
- terminated: 任务异常结束
TaskResult
- 自动化流程中需要上报task_result（编码模式详见task_result，可视化模式详见记录流程结果）

workersys_stop_task

用途

停止指定任务ID的任务

执行效果等同于terminalTask或StopTasks

输入

TaskId：字符串格式，必填

输出

{
  "requestId": "e8323daa-***************",
  "success": true,
  "code": 0,
  "msg": "调用成功",
  "msgCode": "result.success",
  "data": true,
  "pager": null,
  "instanceId": null
}

workersys_auto_assign_robot

用途

获取一个当前可用的机器人

警告

仅适用于POC过程使用
生产过程请勿使用本接口

输入

无

输出

{
  "requestId": "54894cb8-***************",
  "success": true,
  "code": 0,
  "msg": "调用成功",
  "msgCode": "result.success",
  "data": {
    "RobotId": "AEA8F9010***************",
    "RobotName": "9FG274***************",
    "RobotType": "express"
  },
  "pager": null,
  "instanceId": null
}

workersys_get_robot_runtime_url

用途

获取一个能够访问机器人的URL，可通过浏览器访问

警告

仅支持服务型机器人

URL有效期为15分钟，且仅能使用一次。访问后，需要重新生成新URL才能再次使用。
浏览器中的操作窗口
- 默认不可以操作鼠标键盘，可通过右上角开关开启
- 默认关闭本机与远程环境之间的系统剪贴板互通，可通过右上角开关开启。
  重要
  使用剪贴板互通的注意事项详见机器人运行环境标准化。

输入

RobotId：字符串格式，必填

输出

{
  "requestId": "cd3d6078-***************",
  "success": true,
  "code": 0,
  "msg": "调用成功",
  "msgCode": "result.success",
  "data": {
    "Url": "https://console***************"
  },
  "pager": null,
  "instanceId": null
}

workersys_get_robot_web_sdk_auth_code

用途

根据机器人ID查询WebSDK登录所需的认证信息

警告

仅支持服务型机器人

输入

RobotId，字符串格式，必填

输出

{
    "requestId": "931d9030-***************",
    "success": true,
    "code": 0,
    "msg": "调用成功",
    "msgCode": "result.success",
    "data": {
        "DesktopId": "ecd-bzhh***************",
        "RegionId": "cn-beijing",
        "SessionStatus": "notConnected",
        "CurrentEndUserId": null,
        "TargetEndUserId": "***************",
        "AuthCode": "***************"
    },
    "pager": null,
    "instanceId": null
}