uiip agenthub mcp-tools e Remote-a2a-agent

Sintaxe e opções para "uip agenthub mcp-tools", que gerencia as ferramentas anexadas a um servidor AgentHub MCP, e "uip agenthub Remote-a2a-agent", que gerencia registros remotos de agente para agente.

Parte da família de comando uip agenthub . Esta página abrange mcp-tools (as ferramentas anexadas a um servidor MCP do tipo uipathou platform) e remote-a2a-agent (registros de agente a agente, não relacionados aos servidores MCP). Consulte uip agenthub para conceitos compartilhados — tipos de servidor, escopo de pasta, modos de entrada.

Resumo

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>

mcp-ferramentas do uip agenthub

Gerenciar ferramentas anexadas aos servidores MCP do AgentHub. Cada verbo requer --mcp <slug> para identificar o servidor pai. Existem dois caminhos de criação de ferramentas: create-resource (resolver um processo/agente/fluxo de trabalho de API do Orchestrator existente em uma ferramenta por meio do serviço Catálogo de recursos) e create-raw (uma carga útil do JSON escrita à mão) — ambos funcionam apenas com um { Servidor pai do tipo uipath. enable/disable são um mecanismo separado específico para servidores do tipo platform, alternando a associação à lista selectedToolNames desse servidor em vez de criar um recurso de ferramenta distinto.

lista de mcp-ferramentas do uip agenthub

Opções

Long	Valor	Description
--mcp <slug>	String	Obrigatório. Campo de dados dinâmico do servidor MCP pai.
--name <substr>	String	Filtra por substring de nome.
--limit <number> / --offset <number>	Número inteiro	Paginação.

Exemplo

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

Formato dos dados (--output json)

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

uip agenthub mcp-ferramentas obter

Obtenha uma ferramenta por ID ou --name pesquisa.

Argumentos

Name	Required	Finalidade
[id]	não	ID da ferramenta. Omita ao usar --name.

Opções

Long	Valor	Description
--mcp <slug>	String	Obrigatório. Campo de dados dinâmico do servidor MCP pai.
--name <name>	String	Pesquise por substring de nome. Falha se corresponder a outra ferramenta que não uma ferramenta, a menos que --allow-multiple seja passado.
--allow-multiple	Bandeira	Retorne todas as correspondências de nome em vez de falhar na ambiguidade.

Não passar <id> nem --name falha com uma dica NextCommand apontando para mcp-tools list.

Exemplo

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

Formato dos dados (--output json)

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

uiip agenthub mcp-tools criar-recurso / criar-raw

Adicione uma ferramenta a um servidor MCP do tipo uipath. Requer que o pai seja realmente do tipo uipath— falha com uma dica NextCommand (apontando para refresh-tools ou mcp-tools enable, dependendo do tipo real). Caso contrário, ele falha com uma dica .

Opções

Long	Valor	AplicávelA	Description
--mcp <slug>	String	Ambos	Obrigatório. Campo de dados dinâmico do servidor MCP pai (deve resolver para um servidor do tipo uipath).
--name <name>	String	Ambos	Nome da ferramenta.
--description <text>	String	Ambos	Descrição da ferramenta.
--target-name <name>	String	create-resource	Resolva o destino pelo nome de exibição por meio do serviço Catálogo de recursos. Requer --category. Falha como AmbiguousName (com uma lista candidates) se houver mais de uma correspondência, e UnknownTarget se não houver nenhuma.
--target-identifier <guid>	GUID	create-resource	Identificador explícito de destino — ignora a resolução de nomes do RCS. Win sobre --target-name se ambos forem dados.
--category <category>	automation|agent|agentic-process|api-workflow	create-resource	Mapeia para um par de filtros de tipo/subtipo de entidade RCS (automation→Processo, agent→Agente, agentic-process→ProcessOrchestration, api-workflow→Api). Necessário com --target-name.
--target-folder-key <key> / --target-folder-path <path>	GUID/string	Ambos	Pasta do recurso de destino, quando ela difere da própria pasta do servidor MCP. Um valor explícito aqui sempre prevalece sobre um resolvido de um candidato a RCS ou de um campo de carga.
--input-schema <json> / --output-schema <json> / --metadata <json>	JSON	Ambos	Esquema/metadados de ferramenta. Validadas como strings JSON analisáveis antes da chamada.
--continue-on-error (Padrão) / --fail-fast	Bandeira	Ambos	Comportamento de falha em lote (registrado, mas não exercerdo por uma criação de ferramenta única).
--file <path> / --body <json>	caminho/JSON	create-raw (obrigatório — sem modo escalar)	Carga de ferramenta bruta. create-raw não tem um modo de entrada de sinalizador escalar equivalente; --file/--body é a única maneira de fornecer conteúdo.
--dry-run	Bandeira	Ambos	Imprimir o plano de transformação sem chamar a API.

Exemplos

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

Formato dos dados (--output json)

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

Atualização do UIP AgentHub MCP-Tools

Atualize uma ou mais ferramentas (por meio de --allow-multiple com uma correspondência --name) em um servidor do tipo uipath.

Argumentos

Name	Required	Finalidade
[id]	não	ID da ferramenta. Omita ao usar --name.

Opções

Long	Valor	Description
--mcp <slug>	String	Obrigatório. Campo de dados dinâmico do servidor MCP pai.
--name <substr>	String	Sinalizador de pesquisa (seleciona qual ferramenta atualizar) — não uma renomeação. Use --rename para isso.
--allow-multiple	Bandeira	Aplique a atualização a cada correspondência --name em vez de falhar na ambiguidade.
--rename <name>	String	Novo nome da ferramenta.
--description <text> / --target-identifier <guid> / --target-folder-key <key> / --target-folder-path <path> / --input-schema <json> / --output-schema <json> / --metadata <json>	—	Mesma semântica dos campos create-resource/create-raw acima.

Exemplos

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

Formato dos dados (--output json)

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

Uma atualização de ID único retorna um objeto; uma atualização --allow-multiple retorna uma matriz.

Exclusão de mcp-ferramentas do uiip agenthub

Argumentos

Name	Required	Finalidade
[ids...]	não	ID(s) da ferramenta. Omita ao usar --name.

Opções

Long	Description
--mcp <slug>	Obrigatório. Campo de dados dinâmico do servidor MCP pai.
--name <substr>	Pesquise por substring de nome em vez de id(s).
--allow-multiple	Excluir cada correspondência de nome em vez de falhar na ambiguidade.
-y, --yes	Necessário confirmar. A CLI nunca solicita.
--dry-run	Imprimir o plano de transformação sem excluir.

Exemplo

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

Formato dos dados (--output json)

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

modelo de mcp-ferramentas do uip agenthub

Emita um esqueleto JSON de ferramenta de recurso. Sem opções de pasta.

Argumentos

Name	Required	Finalidade
<kind>	sim	resource ou raw.

Exemplo

uip agenthub mcp-tools template resource

Formato dos dados (--output json)

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

candidatos a uip agenthub mcp-tools

Lista as entidades do Serviço Catálogo de Recursos elegíveis para a resolução create-resource --target-name/--target-identifier, para uma categoria.

Opções

Long	Valor	Required	Description
--category <category>	automation|agent|agentic-process|api-workflow	sim	Categoria de origem candidata. Valores ausentes/inválidos falham no lado do cliente listando o conjunto permitido.
--name <substr>	String	não	Filtrar nome do candidato.
--limit <number> / --offset <number>	Número inteiro	não	Paginação.

Requer o escopo RCS.Search — um erro 401/invalid-scope inclui uma instrução para executar uip login novamente e tentar novamente.

Exemplo

uip agenthub mcp-tools candidates --category automation

Formato dos dados (--output json)

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

uiip agenthub mcp-tools habilitar / desabilitar

Alternar a associação da ferramenta na lista selectedToolNames de um servidor MCP do tipo platform. Falha se o servidor pai não for do tipo platform.

Opções

Long	Valor	Description
--mcp <slug>	String	Obrigatório. Campo de dados dinâmico do servidor MCP pai (deve ser digitado no platform).
--name <name>	string, repetível	Nomes das ferramentas para habilitar/desabilitar. Alternativamente, passe --file/--body com uma matriz JSON ou um nome único.
--dry-run	Bandeira	Imprimir o plano de transformação sem chamar a API.

Exemplos

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

Formato dos dados (--output json)

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

disableo equivalente Code de AgentHubMcpToolsDisable é; a resposta reflete selectedToolNames após a remoção.

UIP AgentHub Remote-a2a-Agent

Gerenciar registros remotos de agente a agente (A2A) — descrito na origem como "Avançado - não exposto na interface gráfica do Orchestrator". Não relacionado a servidores MCP; carrega seus próprios metadados de cartão de agente (nome, descrição, um URL do cartão ou JSON do cartão bruto), cabeçalhos estáticos opcionais, um ID de conexão do Integration Service e um sinalizador de ativação. Com escopo de pasta como o restante do AgentHub.

lista de agentes uip Remote-a2a-agent

Opções

Long	Valor	Description
--name <substr>	String	Filtra por substring de nome (parâmetro search do lado do servidor).
--limit <number> / --offset <number>	Número inteiro	Paginando (top/skip na conexão).

Exemplo

uip agenthub remote-a2a-agent list

Formato dos dados (--output json)

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

uip Agenthub Remote-a2a-Agent Get

Argumentos

Name	Required	Finalidade
<slug>	sim	Campo de dados dinâmico do agente.

Exemplo

uip agenthub remote-a2a-agent get remote-agent

Formato dos dados (--output json)

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

criação do uip agenthub Remote-a2a-agent

Opções

Long	Valor	Description
--slug <slug> / --name <name> / --description <text>	String	Campos de identidade do agente.
--agent-card-url <url>	url	URL do cartão do agente.
--agent-card-json <json>	JSON	Cartão de agente bruto JSON, como alternativa a um URL.
--header <key=value>	string, repetível	Cabeçalho de solicitação estático. String de JSON em headers na carga.
--connection-id <id>	String	ID de conexão do Integration Service.
--use-relay	Bandeira	Encaminhar solicitações por meio do UiPath Relay.
--file <path> / --body <json>	caminho/JSON	Alternativa aos sinalizadores escalares — a mesma regra de modo de entrada mutuamente exclusiva de mcp create.
--dry-run	Bandeira	Imprimir o plano de transformação sem chamar a API.

Exemplo

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

Formato dos dados (--output json)

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

Atualização do uip agenthub Remote-a2a-agent

Os mesmos campos que create (menos --slug, que é o argumento posicional), mais:

Long	Valor	Description
--is-active <boolean>	true|false	Estado de ativação. Rejeita qualquer outro valor literal com um erro de análise de argumento.

Argumentos

Name	Required	Finalidade
<slug>	sim	Campo de dados dinâmico do agente.

Exemplo

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

Formato dos dados (--output json)

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

Exclusão do agente uip Remote-a2a-agent

Argumentos

Name	Required	Finalidade
<slug>	sim	Campo de dados dinâmico do agente.

Opções

Long	Description
-y, --yes	Necessário confirmar. A CLI nunca solicita.
--dry-run	Imprimir o plano de transformação sem excluir.

Exemplo

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

Formato dos dados (--output json)

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

cartão de atualização do agente uip Remote-a2a-agent

Buscar novamente e atualizar os metadados do cartão de um agente remoto.

Argumentos

Name	Required	Finalidade
<slug>	sim	Campo de dados dinâmico do agente.

Opções

Long	Description
--dry-run	Imprimir o plano de transformação sem atualizar.

Exemplo

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

Formato dos dados (--output json)

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

Relacionado

• uip agenthub — conceitos e mcp (registros de servidor).

Veja também

• Opções globais
• Códigos de saída