uip agenthub mcp-tools y remoto-a2a-agente

Sintaxis y opciones para `uip agenthub mcp-tools`, que gestiona las herramientas adjuntas a un servidor MCP de AgentHub, y `uip agenthub remoto-a2a-agente`, que gestiona los registros remotos de agente a agente.

Parte de la familia de comandos uip agenthub . Esta página cubre mcp-tools (las herramientas adjuntas a un servidor MCP de tipo uipatho platform) y remote-a2a-agent (registros de agente a agente, no relacionados con servidores MCP). Consulta uip agenthub para conceptos compartidos: tipos de servidor, ámbito de carpeta, modos de entrada.

Sinopsis

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-tools

Gestiona las herramientas adjuntas a los servidores MCP de AgentHub. Cada verbo requiere --mcp <slug> para identificar el servidor principal. Existen dos rutas de creación de herramientas: create-resource (resuelve un proceso/agente/flujo de trabajo de API existente de Orchestrator en una herramienta a través del Servicio de catálogo de recursos) y create-raw (una carga útil JSON escrita a mano): ambas solo funcionan contra un { servidor principal de tipo uipath. enable/disable son un mecanismo independiente específico de los servidores de tipo platform, que alterna la pertenencia a la lista selectedToolNames de ese servidor en lugar de crear un recurso de herramienta distinto.

lista de mcp-tools de uip agenthub

Opciones

Largo	Valor	Descripción
--mcp <slug>	String	Obligatorio. Slug del servidor MCP principal.
--name <substr>	String	Filtrar por subcadena de nombre.
--limit <number> / --offset <number>	Entero	Paginación.

Ejemplo

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

Forma de datos (--json de salida)

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

uip agenthub mcp-tools get

Obtener una herramienta por id o por búsqueda --name.

Argumentos

Nombre	Obligatorio	Propósito
[id]	No	ID de la herramienta. Omitir al utilizar --name.

Opciones

Largo	Valor	Descripción
--mcp <slug>	String	Obligatorio. Slug del servidor MCP principal.
--name <name>	String	Búsqueda por subcadena de nombre. Falla si coincide con otra herramienta que no sea exactamente una, a menos que se pase --allow-multiple.
--allow-multiple	Marca	Devuelve cada coincidencia de nombre en lugar de fallar por ambigüedad.

No pasar <id> ni --name falla con una sugerencia NextCommand que apunta a mcp-tools list.

Ejemplo

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

Forma de datos (--json de salida)

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

uip agenthub mcp-tools create-resource / create-raw

Añade una herramienta a un servidor MCP de tipo uipath. Requiere que el elemento principal sea realmente de tipo uipath: de lo contrario, falla con una sugerencia NextCommand (que apunta a refresh-tools o mcp-tools enable, dependiendo del tipo real).

Opciones

Largo	Valor	SeAplicaA	Descripción
--mcp <slug>	String	Ambos	Obligatorio. Slug del servidor MCP principal (debe resolverse en un servidor de tipo uipath).
--name <name>	String	Ambos	Nombre de la herramienta.
--description <text>	String	Ambos	Descripción de la herramienta.
--target-name <name>	String	create-resource	Resuelve el destino por nombre para mostrar a través del Servicio de catálogo de recursos. Requiere --category. Falla como AmbiguousName (con una lista candidates) si hay más de una coincidencia, UnknownTarget si no hay ninguna.
--target-identifier <guid>	GUID	create-resource	Identificador de destino explícito: omite la resolución de nombres de RCS. Gana sobre --target-name si se dan ambos.
--category <category>	automation|agent|agentic-process|api-workflow	create-resource	Se asigna a un par de filtros de tipo de entidad/subtipo de RCS (automation→Proceso, agent→Agente, agentic-process→ProcessOrchestration, api-workflow→Api). Obligatorio con --target-name.
--target-folder-key <key> / --target-folder-path <path>	GUID/cadena	Ambos	Carpeta del recurso de destino, cuando difiere de la propia carpeta del servidor MCP. Un valor explícito aquí siempre gana a uno resuelto a partir de un candidato RCS o un campo de carga útil.
--input-schema <json> / --output-schema <json> / --metadata <json>	JSON	Ambos	Esquema/metadatos de la herramienta. Validado como cadenas JSON analizables antes de la llamada.
--continue-on-error (predeterminado) / --fail-fast	Marca	Ambos	Comportamiento de fallo por lotes (registrado pero no ejercido por una creación de herramienta única).
--file <path> / --body <json>	ruta/JSON	create-raw (obligatorio: sin modo escalar)	Carga útil de herramienta sin procesar. create-raw no tiene un modo de entrada de indicador escalar equivalente; --file/--body es la única forma de proporcionar contenido.
--dry-run	Marca	Ambos	Imprime el plan de mutación sin llamar a la API.

Ejemplos

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

Forma de datos (--json de salida)

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

Actualización de mcp-tools de uip agenthub

Actualizar una o más herramientas (a través de --allow-multiple con una coincidencia --name) en un servidor de tipo uipath.

Argumentos

Nombre	Obligatorio	Propósito
[id]	No	ID de la herramienta. Omitir al utilizar --name.

Opciones

Largo	Valor	Descripción
--mcp <slug>	String	Obligatorio. Slug del servidor MCP principal.
--name <substr>	String	Marca de búsqueda (selecciona qué herramienta actualizar), no un cambio de nombre. Usa --rename para eso.
--allow-multiple	Marca	Aplica la actualización a cada coincidencia --name en lugar de fallar por ambigüedad.
--rename <name>	String	Nuevo nombre de herramienta.
--description <text> / --target-identifier <guid> / --target-folder-key <key> / --target-folder-path <path> / --input-schema <json> / --output-schema <json> / --metadata <json>	—	La misma semántica que los campos create-resource/create-raw anteriores.

Ejemplos

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

Forma de datos (--json de salida)

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

Una actualización de ID único devuelve un objeto; una actualización --allow-multiple devuelve una matriz.

uip agenthub mcp-tools eliminar

Argumentos

Nombre	Obligatorio	Propósito
[ids...]	No	ID de herramienta. Omitir al utilizar --name.

Opciones

Largo	Descripción
--mcp <slug>	Obligatorio. Slug del servidor MCP principal.
--name <substr>	Búsqueda por subcadena de nombre en lugar de id(s).
--allow-multiple	Eliminar cada coincidencia de nombre en lugar de fallar por ambigüedad.
-y, --yes	Obligatorio para confirmar. La CLI nunca solicita.
--dry-run	Imprime el plan de mutación sin eliminarlo.

Ejemplo

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

Forma de datos (--json de salida)

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

Plantilla UIP Agenthub MCP-Tools

Emite un esqueleto JSON de herramienta de recursos. No hay opciones de carpeta.

Argumentos

Nombre	Obligatorio	Propósito
<kind>	Sí	resource o raw.

Ejemplo

uip agenthub mcp-tools template resource

Forma de datos (--json de salida)

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

Candidatos a mcp-tools de uip agenthub

Enumerar las entidades del servicio de catálogo de recursos aptas para la resolución create-resource --target-name/--target-identifier, para una categoría.

Opciones

Largo	Valor	Obligatorio	Descripción
--category <category>	automation|agent|agentic-process|api-workflow	Sí	Categoría de origen del candidato. Los valores faltantes/no válidos fallan en el lado del cliente al enumerar el conjunto permitido.
--name <substr>	String	No	Filtrar nombre del candidato.
--limit <number> / --offset <number>	Entero	No	Paginación.

Requiere el ámbito RCS.Search: un error 401/invalid-scope incluye una instrucción para volver a ejecutar uip login y reintentar.

Ejemplo

uip agenthub mcp-tools candidates --category automation

Forma de datos (--json de salida)

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

habilitación/deshabilitación de mcp-tools de uip agenthub

Alternar la pertenencia a la platformherramienta en la selectedToolNames lista de un servidor MCP de tipo. Falla si el servidor principal no es de tipo platform.

Opciones

Largo	Valor	Descripción
--mcp <slug>	String	Obligatorio. Slug del servidor MCP principal (debe ser de tipo platform).
--name <name>	cadena, repetible	Nombres de herramientas para habilitar/deshabilitar. Alternativamente, pasa --file/--body con una matriz JSON o un solo nombre.
--dry-run	Marca	Imprime el plan de mutación sin llamar a la API.

Ejemplos

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

Forma de datos (--json de salida)

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

el equivalente de disable Code es AgentHubMcpToolsDisable; la respuesta refleja selectedToolNames después de la eliminación.

agente-a2a-remoto de uip agenthub

Gestionar registros remotos de agente a agente (A2A): descrito en el origen como "Avanzado: no expuesto en la IU de Orchestrator" No relacionado con servidores MCP; lleva sus propios metadatos de tarjeta de agente (nombre, descripción, una URL de tarjeta o JSON de tarjeta sin procesar), encabezados estáticos opcionales, un ID de conexión de Integration Service y un marcador de activación. Ámbito de carpeta como el resto de AgentHub.

uip agenthub lista-a2a-agente-remoto

Opciones

Largo	Valor	Descripción
--name <substr>	String	Filtrar por subcadena de nombre (parámetro search del lado del servidor).
--limit <number> / --offset <number>	Entero	Paginación (top/skip en la conexión).

Ejemplo

uip agenthub remote-a2a-agent list

Forma de datos (--json de salida)

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

uip agenthub remoto-a2a-agente obtener

Argumentos

Nombre	Obligatorio	Propósito
<slug>	Sí	Slug de agente.

Ejemplo

uip agenthub remote-a2a-agent get remote-agent

Forma de datos (--json de salida)

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

uip agenthub remoto-a2a-agente crear

Opciones

Largo	Valor	Descripción
--slug <slug> / --name <name> / --description <text>	String	Campos de identidad del agente.
--agent-card-url <url>	url	URL de la tarjeta de agente.
--agent-card-json <json>	JSON	JSON de tarjeta de agente sin procesar, como alternativa a una URL.
--header <key=value>	cadena, repetible	Encabezado de solicitud estático. Cadena JSON en headers en la carga útil.
--connection-id <id>	String	ID de conexión de Integration Service.
--use-relay	Marca	Enrutar las solicitudes a través de UiPath Relay.
--file <path> / --body <json>	ruta/JSON	Alternativa a los marcadores escalares: la misma regla de modo de entrada mutuamente excluyente que mcp create.
--dry-run	Marca	Imprime el plan de mutación sin llamar a la API.

Ejemplo

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

Forma de datos (--json de salida)

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

actualización de agente remoto-a2a de uip agenthub

Los mismos campos que create (menos --slug, que es el argumento posicional), más:

Largo	Valor	Descripción
--is-active <boolean>	true|false	Estado de activación. Rechaza cualquier otro valor literal con un error de análisis de argumentos.

Argumentos

Nombre	Obligatorio	Propósito
<slug>	Sí	Slug de agente.

Ejemplo

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

Forma de datos (--json de salida)

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

uip agenthub remoto-a2a-agente eliminar

Argumentos

Nombre	Obligatorio	Propósito
<slug>	Sí	Slug de agente.

Opciones

Largo	Descripción
-y, --yes	Obligatorio para confirmar. La CLI nunca solicita.
--dry-run	Imprime el plan de mutación sin eliminarlo.

Ejemplo

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

Forma de datos (--json de salida)

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

UIP Agenthub Remote-a2a-agent actualizar tarjeta

Vuelva a obtener y actualice los metadatos de la tarjeta de un agente remoto.

Argumentos

Nombre	Obligatorio	Propósito
<slug>	Sí	Slug de agente.

Opciones

Largo	Descripción
--dry-run	Imprime el plan de mutación sin actualizar.

Ejemplo

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

Forma de datos (--json de salida)

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

Relacionado

• uip agenthub : conceptos y mcp (registros del servidor).

Ver también

• Opciones globales
• Códigos de salida