uip agenthub mcp-tools und remote-a2a-agent

Syntax und Optionen für „uip agenthub mcp-tools“, das die Tools verwaltet, die an einen AgentHub-MCP-Server angehängt sind, und „uip agenthub remote-a2a-agent“, der Remote-Registrierungen von Agent zu Agent verwaltet.

Teil der uip agenthub -Befehlsfamilie. Diese Seite behandelt mcp-tools (die Tools, die an einen MCP-Server vom Typ uipathoder platformangeschlossen sind) und remote-a2a-agent (Agent-zu-Agent-Registrierungen, die nicht mit MCP-Servern zusammenhängen). Siehe uip agenthub für gemeinsame Konzepte – Servertypen, Ordner-Scoping, Eingabemodi.

Zusammenfassung

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

Verwalten Sie Tools, die an AgentHub-MCP-Server angehängt sind. Jedes Verb erfordert --mcp <slug>, um den übergeordneten Server zu identifizieren. Es gibt zwei Tool-Erstellungspfade: create-resource (Auflösen eines vorhandenen Orchestrator-Prozesses/Agents/API-Workflows in einem Tool über den Ressourcenkatalogdienst) und create-raw (eine handgeschriebene JSON-Nutzlast) – beide funktionieren nur gegen eine { Übergeordneter Server vom Typ uipath. enable/disable sind ein separater Mechanismus, der für Server vom Typ platformspezifisch ist und die Mitgliedschaft in der selectedToolNames -Liste dieses Servers umschaltet, anstatt eine eindeutige Toolressource zu erstellen.

UIP AgentHub-mcp-tools-Liste

Optionen

Long	Wert	Beschreibung
--mcp <slug>	string	Erforderlich. Übergeordnete MCP-Server-Slug.
--name <substr>	string	Filtern nach Namens-Teilzeichenfolge.
--limit <number> / --offset <number>	Integer	Paginieren.

Beispiel

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

Datenform (--output json)

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

UIP AgentHub „mcp-tools abrufen“.

Rufen Sie ein Tool nach ID oder nach --name -Suche ab.

Argumente

Name	Erforderlich	Zweck
[id]	nein	Tool-ID. Auslassen, wenn --name verwendet wird.

Optionen

Long	Wert	Beschreibung
--mcp <slug>	string	Erforderlich. Übergeordnete MCP-Server-Slug.
--name <name>	string	Suche nach Teilzeichenfolge des Namens. Schlägt fehl, wenn sie mit anderen als genau einem Tool übereinstimmt, es sei denn, --allow-multiple wird übergeben.
--allow-multiple	Markieren	Jede Namensübereinstimmung zurückgeben, anstatt bei Mehrdeutigkeiten fehlzuschlagen.

Wenn weder <id> noch --name übergeben werden, schlägt dies mit einem NextCommand -Hinweis auf mcp-tools list fehl.

Beispiel

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

Datenform (--output json)

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

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

Fügen Sie ein Tool zu einem MCP-Server vom Typ uipathhinzu. Erfordert, dass das übergeordnete Element tatsächlich vom Typ uipathist – schlägt mit einem NextCommand -Hinweis fehl (zeigt auf refresh-tools oder mcp-tools enable, je nach echtem Typ), andernfalls.

Optionen

Long	Wert	GiltFür	Beschreibung
--mcp <slug>	string	Beides	Erforderlich. Übergeordnete MCP-Server-Slug (muss in einen Server vom Typ uipathaufgelöst werden).
--name <name>	string	Beides	Toolname.
--description <text>	string	Beides	Toolbeschreibung.
--target-name <name>	string	create-resource	Lösen Sie das Ziel nach dem Anzeigenamen über den Ressourcenkatalogdienst auf. Erfordert --category. Schlägt als AmbiguousName (mit einer candidates -Liste) fehl, wenn mehr als eine Übereinstimmung vorhanden ist, UnknownTarget wenn keine Übereinstimmung vorhanden ist.
--target-identifier <guid>	GUID	create-resource	Expliziter Zielbezeichner – überspringt die Auflösung des RCS-Namens. Siege über --target-name, wenn beide angegeben sind.
--category <category>	automation|agent|agentic-process|api-workflow	create-resource	Wird einem RCS-Entitätstyp/Untertyp-Filterpaar zugeordnet (automation→Prozess, agent→Agent, agentic-process→ProcessOrchestration, api-workflow→Api). Erforderlich mit --target-name.
--target-folder-key <key> / --target-folder-path <path>	GUID/Zeichenfolge	Beides	Ordner der Zielressource, wenn er sich vom eigenen Ordner des MCP-Servers unterscheidet. Ein expliziter Wert gewinnt hier immer einen Wert über einen, der von einem RCS-Kandidaten oder einem Nutzlastfeld aufgelöst wird.
--input-schema <json> / --output-schema <json> / --metadata <json>	JSON	Beides	Schema/Metadaten des Tools. Vor dem Aufruf als analysierbare JSON-Zeichenfolgen validiert.
--continue-on-error (Standard) / --fail-fast	Markieren	Beides	Batch-Fehlerverhalten (registriert, aber nicht durch eine Einzeltool-Erstellung ausgeführt).
--file <path> / --body <json>	Pfad/JSON	create-raw (erforderlich – kein skalar Modus)	Unformatierte Toolnutzlast. create-raw hat keinen gleichwertigen Eingabemodus für Skalar-Flags; --file/--body ist die einzige Möglichkeit, Inhalte bereitzustellen.
--dry-run	Markieren	Beides	Geben Sie den Generierungsplan aus, ohne die API aufzurufen.

Beispiele

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

Datenform (--output json)

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

Aktualisierung der UIP AgentHub-mcp-tools

Aktualisieren Sie ein oder mehrere Tools (über --allow-multiple mit einer --name -Übereinstimmung) auf einem Server vom Typ uipath.

Argumente

Name	Erforderlich	Zweck
[id]	nein	Tool-ID. Auslassen, wenn --name verwendet wird.

Optionen

Long	Wert	Beschreibung
--mcp <slug>	string	Erforderlich. Übergeordnete MCP-Server-Slug.
--name <substr>	string	Lookup-Flag (wählt aus, welches Tool aktualisiert werden soll) – keine Umbenennung. Verwenden Sie dazu --rename.
--allow-multiple	Markieren	Wenden Sie die Aktualisierung auf jede --name -Übereinstimmung an, anstatt bei Mehrdeutigkeit fehlzuschlagen.
--rename <name>	string	Neuer Toolname.
--description <text> / --target-identifier <guid> / --target-folder-key <key> / --target-folder-path <path> / --input-schema <json> / --output-schema <json> / --metadata <json>	–	Die gleiche Semantik wie die Felder create-resource/create-raw oben.

Beispiele

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

Datenform (--output json)

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

Eine Aktualisierung mit einer einzelnen ID gibt ein Objekt zurück; Eine --allow-multiple -Aktualisierung gibt ein Array zurück.

UIP AgentHub „mcp-tools“ löschen

Argumente

Name	Erforderlich	Zweck
[ids...]	nein	Tool-ID(s). Auslassen, wenn --name verwendet wird.

Optionen

Long	Beschreibung
--mcp <slug>	Erforderlich. Übergeordnete MCP-Server-Slug.
--name <substr>	Suche nach Name-Teilzeichenfolge anstelle von ID(s).
--allow-multiple	Löschen Sie jede Namensübereinstimmung, anstatt bei Mehrdeutigkeiten fehlzuschlagen.
-y, --yes	Zur Bestätigung erforderlich. Die CLI fordert Sie nie auf.
--dry-run	Drucken Sie den Migrationsplan aus, ohne zu löschen.

Beispiel

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

Datenform (--output json)

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

Vorlage für „uip agenthub mcp-tools“.

Geben Sie ein Ressourcentool-JSON-Framework aus. Keine Ordneroptionen.

Argumente

Name	Erforderlich	Zweck
<kind>	ja	resource oder raw.

Beispiel

uip agenthub mcp-tools template resource

Datenform (--output json)

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

Kandidaten für UIP AgentHub-MCP-Tools

Listen Sie Ressourcenkatalogdienst-Entitäten auf, die für die Auflösung create-resource --target-name/--target-identifier für eine Kategorie berechtigt sind.

Optionen

Long	Wert	Erforderlich	Beschreibung
--category <category>	automation|agent|agentic-process|api-workflow	ja	Kandidatenquellenkategorie. Fehlende/ungültige Werte schlagen beim clientseitigen Auflisten des zulässigen Satzes fehl.
--name <substr>	string	nein	Filtern Sie den Kandidatennamen.
--limit <number> / --offset <number>	Integer	nein	Paginieren.

Erfordert den Scope RCS.Search – ein Fehler vom Typ 401/invalid-Scope enthält eine Anweisung zum erneuten Ausführen von uip login und zum Wiederholen.

Beispiel

uip agenthub mcp-tools candidates --category automation

Datenform (--output json)

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

UIP AgentHub-mcp-tools aktivieren/deaktivieren

Die Toolmitgliedschaft auf der platform-Liste eines MCP-Servers vom Typ selectedToolNames umschalten. Schlägt fehl, wenn der übergeordnete Server nicht den Typ platformhat.

Optionen

Long	Wert	Beschreibung
--mcp <slug>	string	Erforderlich. Übergeordnete MCP-Server-Slug (muss vom Typ platformsein).
--name <name>	Zeichenfolge, wiederholbar	Toolname(n), der aktiviert/deaktiviert werden soll. Alternativ können Sie --file/--body mit einem JSON-Array oder einem einzelnen Namen übergeben.
--dry-run	Markieren	Geben Sie den Generierungsplan aus, ohne die API aufzurufen.

Beispiele

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

Datenform (--output json)

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

disable entspricht Code ist AgentHubMcpToolsDisable; Die Antwort spiegelt selectedToolNames nach dem Entfernen wider.

UIP AgentHub Remote-A2a-Agent

Verwalten von Remote-Registrierungen von Agent-zu-Agent (A2A) – in der Quelle beschrieben als „Erweitert – in der Orchestrator-Benutzeroberfläche nicht verfügbar gemacht“. Keine Verbindung zu MCP-Servern; enthält eigene Agent-Karten-Metadaten (Name, Beschreibung, Karten-URL oder Rohkarten-JSON), optionale statische Header, eine Integration Service-Verbindungs-ID und ein Aktivierungs-Flag. Ordner-Scope wie der Rest von AgentHub.

uip agenthub remote-a2a-agent-Liste

Optionen

Long	Wert	Beschreibung
--name <substr>	string	Filtern nach Namensteilzeichenfolge (serverseitiger Parameter search).
--limit <number> / --offset <number>	Integer	Paginieren (top/skip auf dem Web).

Beispiel

uip agenthub remote-a2a-agent list

Datenform (--output json)

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

Abrufen von uip agenthub remote-a2a-agent

Argumente

Name	Erforderlich	Zweck
<slug>	ja	Agent-Slug.

Beispiel

uip agenthub remote-a2a-agent get remote-agent

Datenform (--output json)

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

uip agenthub remote-a2a-agent erstellen

Optionen

Long	Wert	Beschreibung
--slug <slug> / --name <name> / --description <text>	string	Felder zur Agentenidentität.
--agent-card-url <url>	url	URL der Agent-Karte.
--agent-card-json <json>	JSON	Unformatierte JSON-Datei der Agent-Karte als Alternative zu einer URL.
--header <key=value>	Zeichenfolge, wiederholbar	Statischer Anforderungsheader. JSON-stringified in headers auf der Nutzlast.
--connection-id <id>	string	Integration Service-Verbindungs-ID.
--use-relay	Markieren	Leiten Sie Anforderungen über UiPath Relay weiter.
--file <path> / --body <json>	Pfad/JSON	Alternative zu skalan Flags – dieselbe sich gegenseitig ausschließende Eingabemodusregel wie mcp create.
--dry-run	Markieren	Geben Sie den Generierungsplan aus, ohne die API aufzurufen.

Beispiel

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

Datenform (--output json)

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

Aktualisierung von uip agenthub remote-a2a-agent

Die gleichen Felder wie create (minus --slug, das Positionsargument), plus:

Long	Wert	Beschreibung
--is-active <boolean>	true|false	Aktivierungsstatus. Weist alle anderen Literalwerte mit einem Fehler beim Parsen des Arguments zurück.

Argumente

Name	Erforderlich	Zweck
<slug>	ja	Agent-Slug.

Beispiel

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

Datenform (--output json)

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

Löschen von UIP AgentHub Remote-A2a-Agent

Argumente

Name	Erforderlich	Zweck
<slug>	ja	Agent-Slug.

Optionen

Long	Beschreibung
-y, --yes	Zur Bestätigung erforderlich. Die CLI fordert Sie nie auf.
--dry-run	Drucken Sie den Migrationsplan aus, ohne zu löschen.

Beispiel

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

Datenform (--output json)

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

UIP AgentHub Remote-A2a-Agent Refresh-Card

Die Kartenmetadaten eines Remote-Agents erneut abrufen und aktualisieren.

Argumente

Name	Erforderlich	Zweck
<slug>	ja	Agent-Slug.

Optionen

Long	Beschreibung
--dry-run	Drucken Sie den Migrationsplan ohne Aktualisierung aus.

Beispiel

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

Datenform (--output json)

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

Zugehörig

• uip agenthub – Konzepte und mcp (Serverregistrierungen).

Siehe auch

• Globale Optionen
• Exitcodes