uip agenthub MCP-tools 和 Remote-a2a-agent

“uip agenthub mCP-tools”（用于管理附加到 AgentHub MCP 服务器的工具）和“uip agenthub Remote-a2a-agent”（用于管理远程智能体到智能体注册）的语法和选项。

是uip agenthub命令系列的一部分。本页介绍 mcp-tools（附加到 uipath 或 platform 类型的 MCP 服务器的工具）和 remote-a2a-agent（智能体到智能体注册，与 MCP 服务器无关）。请参阅uip agenthub了解共享概念 — 服务器类型、文件夹范围、输入模式。

大纲

uip agenthub mcp-tools list --mcp <slug> [--name <substr>] [--limit <n>] [--offset <n>]
uip agenthub mcp-tools get --mcp <slug> [<id>] [--name <name>] [--allow-multiple]
uip agenthub mcp-tools create-resource --mcp <slug> --category <category> (--target-name <name> | --target-identifier <guid>) [options...]
uip agenthub mcp-tools create-raw --mcp <slug> --file <path> | --body <json> [options...]
uip agenthub mcp-tools update [<id>] --mcp <slug> [--name <substr>] [--rename <name>] [options...]
uip agenthub mcp-tools delete [<ids...>] --mcp <slug> [--name <substr>] -y
uip agenthub mcp-tools template <resource|raw>
uip agenthub mcp-tools candidates --category <category> [--name <substr>] [--limit <n>] [--offset <n>]
uip agenthub mcp-tools enable --mcp <slug> [--name <name>]...
uip agenthub mcp-tools disable --mcp <slug> [--name <name>]...

uip agenthub remote-a2a-agent list [--name <substr>] [--limit <n>] [--offset <n>]
uip agenthub remote-a2a-agent get <slug>
uip agenthub remote-a2a-agent create --name <name> --slug <slug> [options...]
uip agenthub remote-a2a-agent update <slug> [options...]
uip agenthub remote-a2a-agent delete <slug> -y
uip agenthub remote-a2a-agent refresh-card <slug>

uip agenthub MCP 工具

管理附加到 AgentHub MCP 服务器的工具。每个动词都需要 --mcp <slug> 来识别父服务器。存在两条工具创作路径：create-resource（通过资源目录服务将现有 Orchestrator 流程/智能体/API 工作流解析为工具）和 create-raw（手写的 JSON 有效负载）— 两者都只适用于 uipath 类型父服务器。enable/disable 是特定于 platform 类型服务器的单独机制，用于切换该服务器的 selectedToolNames 列表中的成员身份，而不是创建不同的工具资源。

uip agenthub MCP 工具列表

选项

长	值	描述
--mcp <slug>	字符串	必需。父级 MCP 服务器缩略名。
--name <substr>	字符串	按名称子字符串筛选。
--limit <number> / --offset <number>	整数	分页。

示例

uip agenthub mcp-tools list --mcp invoice-mcp

数据形状（--输出 json）

{ "Code": "AgentHubMcpToolsList", "Data": { "items": [], "total": 0, "count": 0 } }

uip agenthub MCP 工具获取

按 ID 或通过 --name 查找获取一个工具。

参数

名称	必填	用途
[id]	否	工具 ID。使用 --name 时省略。

选项

长	值	描述
--mcp <slug>	字符串	必需。父级 MCP 服务器缩略名。
--name <name>	字符串	按名称子字符串查找。如果它不匹配一个工具，则失败，除非传递了 --allow-multiple。
--allow-multiple	标记	返回每个名称匹配项，而不是在出现歧义时失败。

传递 <id> 和 --name 均不会失败，并显示指向 NextCommand 的 mcp-tools list 提示。

示例

uip agenthub mcp-tools get --mcp invoice-mcp tool-1

数据形状（--输出 json）

{ "Code": "AgentHubMcpToolsGet", "Data": { "id": "tool-1", "name": "CreateInvoice" } }

uip agenthub MCP 工具创建资源/创建原始文件

向 uipath 类型的 MCP 服务器添加工具。要求父项实际上为 uipath 类型 — 否则失败，并显示 NextCommand 提示（指向 refresh-tools 或 mcp-tools enable，具体取决于实数类型）。

选项

长	值	应用对象	描述
--mcp <slug>	字符串	同时添加	必需。父级 MCP 服务器缩略名（必须解析为 uipath 类型服务器）。
--name <name>	字符串	同时添加	工具名称。
--description <text>	字符串	同时添加	工具描述。
--target-name <name>	字符串	create-resource	借助资源目录服务按显示名称解析目标。需要 --category。如果多个匹配项，则作为 AmbiguousName（使用 candidates 列表）失败；如果没有，则作为 UnknownTarget 失败。
--target-identifier <guid>	GUID	create-resource	显式目标标识符 — 跳过 RCS 名称解析。如果两者都提供，则赢得超过 --target-name。
--category <category>	automation|agent|agentic-process|api-workflow	create-resource	映射到 RCS 实体类型/子类型筛选器对（automation→流程，agent→智能体，agentic-process→流程编排，api-workflow→API）。对于 --target-name 是必需的。
--target-folder-key <key> / --target-folder-path <path>	GUID/字符串	同时添加	目标资源的文件夹（当目标资源与 MCP 服务器自己的文件夹不同时）。此处的显式值始终优于从 RCS 候选对象或有效负载字段解析的值。
--input-schema <json> / --output-schema <json> / --metadata <json>	JSON	同时添加	工具架构/元数据。在调用之前验证为可解析的 JSON 字符串。
--continue-on-error （默认）/ --fail-fast	标记	同时添加	批量失败行为（已注册，但未由单个工具创建执行）。
--file <path> / --body <json>	路径/JSON	create-raw （必需 — 无标量模式）	原始工具有效负载。create-raw 没有等效的标量标志输入模式； --file/--body 是提供内容的唯一方式。
--dry-run	标记	同时添加	打印变更计划，而不调用 API。

示例

uip agenthub mcp-tools create-resource --mcp invoice-mcp --category automation \
  --target-name InvoiceProcess --folder-key f1f2f3f4-0000-0000-0000-000000000001

uip agenthub mcp-tools create-raw --mcp invoice-mcp --file ./tool.json \
  --folder-key f1f2f3f4-0000-0000-0000-000000000001

数据形状（--输出 json）

{ "Code": "AgentHubMcpToolsCreate", "Data": { "id": "tool-1", "name": "InvoiceProcess" } }

uip agenthub MCP 工具更新

在 --allow-multiple 类型服务器上更新一个或多个工具（通过 --name 与 uipath 匹配项）。

参数

名称	必填	用途
[id]	否	工具 ID。使用 --name 时省略。

选项

长	值	描述
--mcp <slug>	字符串	必需。父级 MCP 服务器缩略名。
--name <substr>	字符串	查找标志（选择要更新的工具）—非重命名。为此，使用 --rename。
--allow-multiple	标记	将更新应用于每个 --name 匹配项，而不是因模糊而失败。
--rename <name>	字符串	新工具名称。
--description <text> / --target-identifier <guid> / --target-folder-key <key> / --target-folder-path <path> / --input-schema <json> / --output-schema <json> / --metadata <json>	—	与上述 create-resource/create-raw 字段语义相同。

示例

uip agenthub mcp-tools update tool-1 --mcp invoice-mcp --rename CreateInvoice
uip agenthub mcp-tools update --mcp invoice-mcp --name LegacyTool --rename NewTool

数据形状（--输出 json）

{ "Code": "AgentHubMcpToolsUpdate", "Data": { "id": "tool-1", "name": "NewTool" } }

单 ID 更新返回一个对象； --allow-multiple 更新返回一个数组。

uip agenthub MCP 工具删除

参数

名称	必填	用途
[ids...]	否	工具 ID。使用 --name 时省略。

选项

长	描述
--mcp <slug>	必需。父级 MCP 服务器缩略名。
--name <substr>	按名称子字符串查找，而非按 ID 查找。
--allow-multiple	删除每个名称匹配项，而不是在模糊性时失败。
-y, --yes	需要确认。CLI 从不提示。
--dry-run	打印变异计划，不删除。

示例

uip agenthub mcp-tools delete --mcp invoice-mcp tool-1 -y

数据形状（--输出 json）

{ "Code": "AgentHubMcpToolsDelete", "Data": { "ids": ["tool-1"], "deleted": true } }

uip agenthub MCP 工具模板

发出资源工具 JSON 框架。无文件夹选项。

参数

名称	必填	用途
<kind>	是	resource 或 raw。

示例

uip agenthub mcp-tools template resource

数据形状（--输出 json）

{ "Code": "AgentHubMcpToolsTemplate", "Data": { "type": 0, "name": "resource-tool", "processType": "automation", "targetIdentifier": "resource-id", "targetFolderKey": "folder-guid" } }

uip agenthub MCP 工具候选对象

列出有资格获得一个类别的 create-resource --target-name/--target-identifier 解决的资源目录服务实体。

选项

长	值	必填	描述
--category <category>	automation|agent|agentic-process|api-workflow	是	候选对象来源类别。值缺失/无效而未通过客户端列出允许集。
--name <substr>	字符串	否	筛选候选对象名称。
--limit <number> / --offset <number>	整数	否	分页。

需要 RCS.Search 作用域 — 401/无效作用域错误包含重新运行 uip login 并重试的说明。

示例

uip agenthub mcp-tools candidates --category automation

数据形状（--输出 json）

{ "Code": "AgentHubMcpToolsCandidates", "Data": { "items": [], "total": 0, "count": 0, "category": "automation" } }

uip agenthub MCP 工具启用/禁用

在 platform 类型 MCP 服务器的 selectedToolNames 列表中切换工具成员身份。如果父服务器不是 platform 类型，则失败。

选项

长	值	描述
--mcp <slug>	字符串	必需。父 MCP 服务器缩略名（必须为 platform 类型）。
--name <name>	可重复的字符串	要启用/禁用的工具名称。或者传递使用 JSON 数组或单个名称的 --file/--body。
--dry-run	标记	打印变更计划，而不调用 API。

示例

uip agenthub mcp-tools enable --mcp orch-mcp --name CreateAsset
uip agenthub mcp-tools disable --mcp orch-mcp --name CreateAsset

数据形状（--输出 json）

{ "Code": "AgentHubMcpToolsEnable", "Data": { "slug": "orch-mcp", "selectedToolNames": ["CreateAsset"] } }

disable 的等效 Code 为 AgentHubMcpToolsDisable；响应将在删除后反映 selectedToolNames。

uip agenthub 远程 a2a 代理

管理远程智能体到智能体 (A2A) 注册 — 在来源中描述为“高级 - 未在 Orchestrator 用户界面中公开”。与 MCP 服务器无关；包含自己的智能体卡元数据（名称、描述、卡 URL 或原始卡 JSON）、可选静态标头、Integration Service 连接 ID 和激活标志。与 AgentHub 的其他部分一样，其作用域为文件夹。

uip agenthub 远程 a2a 智能体列表

选项

长	值	描述
--name <substr>	字符串	按名称子字符串（服务器端 search 参数）筛选。
--limit <number> / --offset <number>	整数	分页（top/skip 正在传输中）。

示例

uip agenthub remote-a2a-agent list

数据形状（--输出 json）

{ "Code": "AgentHubRemoteA2aAgentList", "Data": { "items": [] } }

uip agenthub 远程-a2a-代理获取

参数

名称	必填	用途
<slug>	是	智能体 Slug。

示例

uip agenthub remote-a2a-agent get remote-agent

数据形状（--输出 json）

{ "Code": "AgentHubRemoteA2aAgentGet", "Data": { "slug": "remote-agent" } }

uip agenthub 远程 a2a 代理创建

选项

长	值	描述
--slug <slug> / --name <name> / --description <text>	字符串	智能体身份字段。
--agent-card-url <url>	url	智能体卡片 URL。
--agent-card-json <json>	JSON	原始智能体卡 JSON，作为 URL 的替代。
--header <key=value>	可重复的字符串	静态请求标头。生成的字符串 JSON 字符串转换为有效负载上的 headers。
--connection-id <id>	字符串	Integration Service 连接 ID。
--use-relay	标记	通过 UiPath Relay 路由请求。
--file <path> / --body <json>	路径/JSON	标量标志的替代方案 — 与 mcp create 相同的互斥输入模式规则。
--dry-run	标记	打印变更计划，而不调用 API。

示例

uip agenthub remote-a2a-agent create --name RemoteAgent --slug remote-agent

数据形状（--输出 json）

{ "Code": "AgentHubRemoteA2aAgentCreate", "Data": { "slug": "remote-agent" } }

uip agenthub Remote-a2a-agent 更新

与 create 相同的字段（减去位置参数 --slug），并增加：

长	值	描述
--is-active <boolean>	true|false	激活状态。拒绝任何其他会出现参数解析错误的文本值。

参数

名称	必填	用途
<slug>	是	智能体 Slug。

示例

uip agenthub remote-a2a-agent update remote-agent --name RemoteAgent

数据形状（--输出 json）

{ "Code": "AgentHubRemoteA2aAgentUpdate", "Data": { "slug": "remote-agent" } }

uip agenthub 远程 a2a 代理删除

参数

名称	必填	用途
<slug>	是	智能体 Slug。

选项

长	描述
-y, --yes	需要确认。CLI 从不提示。
--dry-run	打印变异计划，不删除。

示例

uip agenthub remote-a2a-agent delete remote-agent -y

数据形状（--输出 json）

{ "Code": "AgentHubRemoteA2aAgentDelete", "Data": { "slug": "remote-agent", "deleted": true } }

uip agenthub 远程-a2a 代理刷新卡

重新获取并刷新远程智能体的卡元数据。

参数

名称	必填	用途
<slug>	是	智能体 Slug。

选项

长	描述
--dry-run	打印变异计划而不刷新。

示例

uip agenthub remote-a2a-agent refresh-card remote-agent

数据形状（--输出 json）

{ "Code": "AgentHubRemoteA2aAgentRefreshCard", "Data": { "slug": "remote-agent" } }

相关内容

• uip agenthub — 概念和mcp （服务器注册）。

另请参阅

• 全局选项
• 退出代码