uip agenthub MCP-tools et remote-a2a-agent

Syntaxe et options de `uip agenthub MCP-tools`, qui gère les outils associés à un serveur MCP AgentHub, et `uip agenthub Remote-a2a-agent`, qui gère les enregistrements d'agent à distance.

Fait partie de la famille de commandes uip agenthub . Cette page couvre mcp-tools (les outils associés à un serveur MCP de type uipathou platform) et remote-a2a-agent (enregistrements d'agent à agent, sans rapport avec les serveurs MCP). Voir uip agenthub pour les concepts partagés — types de serveur, étendue du dossier, modes d'entrée.

Synthèse

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>

Outils MCP uip agenthub

Gérer les outils liés aux serveurs MCP AgentHub. Chaque verbe requiert --mcp <slug> pour identifier le serveur parent. Deux chemins de création d'outils existent: create-resource (résolvez un processus/agent/workflow d'API Orchestrator existant dans un outil via le service de catalogue de ressources) et create-raw (une charge utile JSON manuscrite) — les deux fonctionnent uniquement avec un { Serveur parent de type uipath. enable/disable sont un mécanisme distinct spécifique aux serveurs de type platform, qui activent l'appartenance à la liste selectedToolNames de ce serveur plutôt que de créer une ressource d'outil distincte.

Liste des outils MCP uip agenthub

Options

Long	Valeur (Value)	Description
--mcp <slug>	string	Requis. Champ de données dynamique du serveur MCP parent.
--name <substr>	string	Filtrez par sous-chaîne de nom.
--limit <number> / --offset <number>	Integer	Pagination.

Exemple

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

Format des données (--sortie json)

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

Outils MCP uip agenthub - Obtenir

Obtenez un outil par ID ou par --name recherche.

Arguments

Nom	Requis	Objectif
[id]	non	ID d’outil. Omettez lorsque vous utilisez --name.

Options

Long	Valeur (Value)	Description
--mcp <slug>	string	Requis. Champ de données dynamique du serveur MCP parent.
--name <name>	string	Recherche par nom de sous-chaîne. Échoue s'il correspond à autre qu'exactement un outil, à moins que --allow-multiple ne soit transmis.
--allow-multiple	Drapeau	Renvoyez chaque correspondance de nom au lieu d’échouer en cas d’ambiguïté.

La transmission de <id> et de --name échoue avec un indice NextCommand pointant vers mcp-tools list.

Exemple

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

Format des données (--sortie json)

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

uip agenthub outils MCP create-resource/Create-raw

Ajoutez un outil à un serveur MCP de type uipath. Nécessite que le parent soit réellement de type uipath- échoue avec une suggestion NextCommand (pointant vers refresh-tools ou mcp-tools enable, selon le type réel) dans le cas contraire.

Options

Long	Valeur (Value)	ApplicableÀ	Description
--mcp <slug>	string	Tous les deux	Requis. Champ de données dynamique du serveur MCP parent (doit résoudre en un serveur de type uipath).
--name <name>	string	Tous les deux	Nom de l’outil.
--description <text>	string	Tous les deux	Description de l’outil.
--target-name <name>	string	create-resource	Résolvez la cible par nom d'affichage via le service de catalogue de ressources. Nécessite --category. Recherche AmbiguousName (avec une liste candidates) si plusieurs correspondances sont renvoyées, UnknownTarget si aucune.
--target-identifier <guid>	GUID	create-resource	Identifiant de cible explicite — ignore la résolution du nom RCS. Gagnée sur --target-name si les deux sont données.
--category <category>	automation|agent|agentic-process|api-workflow	create-resource	Correspond à une paire de filtres de type d'entité/sous-type RCS (automation→ Processus, agent→ Agent, agentic-process→ Orchestration de processus, api-workflow→ Api). Requis avec --target-name.
--target-folder-key <key> / --target-folder-path <path>	GUID/chaîne	Tous les deux	Dossier de la ressource cible, lorsqu'il diffère du propre dossier du serveur MCP. Une valeur explicite l' toujours plus sur une valeur résolue à partir d'un candidat RCS ou d'un champ de charge utile.
--input-schema <json> / --output-schema <json> / --metadata <json>	JSON	Tous les deux	Schéma/métadonnées de l’outil. Validé en tant que chaînes JSON analysables avant l'appel.
--continue-on-error (par défaut) / --fail-fast	Drapeau	Tous les deux	Comportement d’échec par lots (enregistré mais non entraîné par un outil de création d’outil unique).
--file <path> / --body <json>	chemin d'accès/JSON	create-raw (requis — aucun mode scalaire)	Charge utile brute de l'outil. create-raw n’a pas de mode d’entrée scaler-indicateur équivalent; --file/--body est le seul moyen de fournir du contenu.
--dry-run	Drapeau	Tous les deux	imprimez le plan de évolution sans appeler l'API.

Exemples

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

Format des données (--sortie json)

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

Mise à jour des outils MCP uip agenthub

Mettez à jour un ou plusieurs outils (via --allow-multiple avec une correspondance --name) sur un serveur de type uipath.

Arguments

Nom	Requis	Objectif
[id]	non	ID d’outil. Omettez lorsque vous utilisez --name.

Options

Long	Valeur (Value)	Description
--mcp <slug>	string	Requis. Champ de données dynamique du serveur MCP parent.
--name <substr>	string	Indicateur de recherche (sélectionne l'outil à mettre à jour) — pas un changement de nom. Utilisez --rename pour cela.
--allow-multiple	Drapeau	Appliquez la mise à jour à chaque --name correspondance au lieu d’échouer en raison de l’ambiguïté.
--rename <name>	string	Nouveau nom d’outil.
--description <text> / --target-identifier <guid> / --target-folder-key <key> / --target-folder-path <path> / --input-schema <json> / --output-schema <json> / --metadata <json>	—	Mêmes sémantiques que les champs create-resource/create-raw ci-dessus.

Exemples

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

Format des données (--sortie json)

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

Une mise à jour à identifiant unique renvoie un objet; une mise à jour --allow-multiple renvoie un tableau.

uip agenthub - suppression des outils MCP

Arguments

Nom	Requis	Objectif
[ids...]	non	ID d’outil. Omettez lorsque vous utilisez --name.

Options

Long	Description
--mcp <slug>	Requis. Champ de données dynamique du serveur MCP parent.
--name <substr>	Recherche par sous-chaîne de nom au lieu d’un ou plusieurs identifiants.
--allow-multiple	Supprimez chaque correspondance de nom au lieu d'échouer en cas d'ambiguïté.
-y, --yes	Requis pour confirmer. La CLI ne s’affiche jamais.
--dry-run	imprimez le plan de évolution sans le supprimer.

Exemple

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

Format des données (--sortie json)

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

Modèle d’outils MCP uip agenthub

Émettez un squelette JSON d’outil de ressource. Aucune option de dossier.

Arguments

Nom	Requis	Objectif
<kind>	oui	resource ou raw.

Exemple

uip agenthub mcp-tools template resource

Format des données (--sortie json)

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

Candidats outils MCP uip agenthub

Répertoriez les entités du service de catalogue de ressources éligibles à la résolution create-resource --target-name/--target-identifier, pour une seule catégorie.

Options

Long	Valeur (Value)	Requis	Description
--category <category>	automation|agent|agentic-process|api-workflow	oui	Catégorie source du candidat. Les valeurs manquantes ou non valides échouent côté client dans la liste de l’ensemble autorisé.
--name <substr>	string	non	Filtrer le nom du candidat.
--limit <number> / --offset <number>	Integer	non	Pagination.

Nécessite l'étendue RCS.Search - une erreur 401/invalid-Scope inclut une instruction pour réexécuter uip login et réessayer.

Exemple

uip agenthub mcp-tools candidates --category automation

Format des données (--sortie json)

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

Activation/désactivation des outils MCP uip agenthub

Activez l’adhésion à l’outil sur la liste selectedToolNames d’un serveur MCP de type platform. Échoue si le serveur parent n'est pas de type platform.

Options

Long	Valeur (Value)	Description
--mcp <slug>	string	Requis. Champ de données dynamique du serveur MCP parent (doit être de type platform).
--name <name>	chaîne, répétable	Nom(s) de l’outil à activer/désactiver. Vous pouvez également transmettre --file/--body avec une matrice JSON ou un nom unique.
--dry-run	Drapeau	imprimez le plan de évolution sans appeler l'API.

Exemples

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

Format des données (--sortie json)

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

L'équivalent de disable Code est AgentHubMcpToolsDisable; la réponse reflète selectedToolNames après la suppression.

uip agenthub remote-a2a-agent

Gérer les enregistrements d’agent à distance — décrit dans la source comme « Avancé - non exposé dans l’interface utilisateur d’Orchestrator». Non lié aux serveurs MCP; Il transporte ses propres métadonnées de carte d'agent (nom, description, URL de carte ou JSON de carte brute), des en-têtes statiques facultatifs, un ID de connexion Integration Service et un indicateur d'activation. Étendue du dossier comme le reste d'AgentHub.

uip agenthub remote-a2a-agent - liste

Options

Long	Valeur (Value)	Description
--name <substr>	string	Filtrer par sous-chaîne de nom (paramètre search côté serveur).
--limit <number> / --offset <number>	Integer	Pagination (top/skip sur le fil).

Exemple

uip agenthub remote-a2a-agent list

Format des données (--sortie json)

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

uip agenthub Remote-a2a-agent obtenir

Arguments

Nom	Requis	Objectif
<slug>	oui	Champ de données dynamique de l’agent.

Exemple

uip agenthub remote-a2a-agent get remote-agent

Format des données (--sortie json)

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

uip agenthub création d'un agent distant

Options

Long	Valeur (Value)	Description
--slug <slug> / --name <name> / --description <text>	string	Champs d’identité de l’agent.
--agent-card-url <url>	url	URL de la carte d’agent.
--agent-card-json <json>	JSON	Carte d'agent brute JSON, comme alternative à une URL.
--header <key=value>	chaîne, répétable	En-tête de requête statique. Chaîne JSON convertie en headers sur la charge utile.
--connection-id <id>	string	ID de connexion Integration Service.
--use-relay	Drapeau	Acheminer les demandes via le relais UiPath.
--file <path> / --body <json>	chemin d'accès/JSON	Alternative aux indicateurs scalaires — même règle de mode d'entrée mutuellement exclusive que mcp create.
--dry-run	Drapeau	imprimez le plan de évolution sans appeler l'API.

Exemple

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

Format des données (--sortie json)

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

uip agenthub remote-a2a-agent update

Mêmes champs que create (moins --slug, qui est l'argument de position), plus:

Long	Valeur (Value)	Description
--is-active <boolean>	true|false	État d'activation. Rejete toute autre valeur littérale avec une erreur d'analyse d'argument.

Arguments

Nom	Requis	Objectif
<slug>	oui	Champ de données dynamique de l’agent.

Exemple

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

Format des données (--sortie json)

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

uip agenthub - suppression d’agent

Arguments

Nom	Requis	Objectif
<slug>	oui	Champ de données dynamique de l’agent.

Options

Long	Description
-y, --yes	Requis pour confirmer. La CLI ne s’affiche jamais.
--dry-run	imprimez le plan de évolution sans le supprimer.

Exemple

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

Format des données (--sortie json)

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

uip agenthub remote-a2a-agent refresh-map

Récupérer et actualiser les métadonnées de la carte d'un agent distant.

Arguments

Nom	Requis	Objectif
<slug>	oui	Champ de données dynamique de l’agent.

Options

Long	Description
--dry-run	imprimez le plan de migration sans actualiser.

Exemple

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

Format des données (--sortie json)

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

Associé

• uip agenthub — concepts et mcp (inscriptions de serveur).

Voir également

• Options globales
• Codes de sortie