Tools (Plugins)

UiPath CLI ist ein kleiner Host, der eine Reihe installierbarer Tools umgibt. Jedes Tool ist ein gewöhnliches npm-Paket, das einen Befehl auf oberster Ebene (und dessen Unterbefehle) beim Host registriert. Dies ist das wichtigste Konzept, um zu verstehen, warum uip so funktioniert – was wird automatisch installiert, was nicht, wie Versionen synchronisiert werden und warum uip --help auf verschiedenen Maschinen unterschiedliche Befehle anzeigt.

Host und Tools

Der Host (@uipath/cli, die ausführbare Datei uip ) hat nur eine begrenzte Anzahl von Bedenken:

• Authentifizierung (uip login, uip logout, uip login status, uip login tenant …).
• Sitzungs- und Anmeldeinformationsverwaltung.
• Toollebenszyklus (uip tools list / search / install / update / uninstall).
• Fähigkeiten zum Codieren von Agents (uip skills install / update / uninstall).
• Die Bridge (uip mcp) für das Modellkontextprotokoll.
• Installation der Shell-Vervollständigung (uip completion).
• Globale Optionen (--output, --output-filter, --log-level, --log-file) und der Umschlag der JSON-Ausgabe.

Alles, was eine UiPath-Oberfläche erreicht – Orchestrator, Lösungen, Agents, Flows, Maestro, RPA-Verpacken, Test Manager, Integration Service, Data Fabric, Insights, Traces, DocsAI, API Workflow, vertikale Lösungen, codierte Agents und codierte Apps – befindet sich in ein separates npm-Paket, das der Host bei Bedarf lädt.

Warum die Aufteilung:

• Unabhängige Veröffentlichungskadenz – Das Orchestrator-Tool kann ausgeliefert werden, ohne den Host erneut freizugeben, und umgekehrt.
• Geringerer Installationsbedarf – ein Benutzer, der nur Testpipelines ausführt, benötigt die Flow- oder Maestro-Tools nicht auf dem Datenträger.
• Stabiler Vertrag – Tools kommunizieren mit dem Host über eine versionierte programmgesteuerte Schnittstelle (Befehlsregistrierung, Ausgabeumschlag, Kontext, Telemetrie), nicht über gemeinsam genutzte Interne Elemente.
• Schnellerer Start – Toolcode wird langsam geladen. Der Host führt das Minimum an, um argv zu parsen und das relevante Tool zu identifizieren, und benötigt dann einmal das Paket dieses Tools.

Die Zulassungsliste für die automatische Installation

Eine Reihe von UiPath-eigenen Tools befindet sich auf einer weißen Liste für die automatische Installation. Der Host erkennt sie durch ihren Befehls-Alias und ordnet den Alias einem npm-Paket zu:

Alias	Paket	Langer Name
or	@uipath/orchestrator-tool	Orchestrator
solution	@uipath/solution-tool	Lösung
resource	@uipath/resource-tool	Ressource
rpa	@uipath/rpa-tool	RPA (Studio-Verpacken, Analysieren, Wiederherstellen)
agent	@uipath/agent-tool	Mitarbeiter
codedagent	@uipath/codedagent-tool	Codierter Agent
codedapp	@uipath/codedapp-tool	Codierte App
maestro	@uipath/maestro-tool	Maestro
tm	@uipath/test-manager-tool	Test Manager
is	@uipath/integrationservice-tool	Integration Service
vss	@uipath/vertical-solutions-tool	Vertikale Lösungen
api-workflow	@uipath/api-workflow-tool	API-Workflow
df	@uipath/data-fabric-tool	Data Fabric
insights	@uipath/insights-tool	Insights
traces	@uipath/traces-tool	Ablaufverfolgungen
docsai	@uipath/docsai-tool	DocsAI

Der Host behandelt alles andere als Nicht-a-Tool. Zwei zusätzliche Tools werden ausgeliefert, erfordern jedoch eine explizite Installation – sie stehen nicht auf der weißen Liste für die automatische Installation:

• Flow (@uipath/flow-tool, Alias flow) – Installieren Sie mit uip tools install @uipath/flow-tool bevor Sie uip flow -Befehle ausführen.
• RPA Legacy (@uipath/rpa-legacy-tool, Alias rpa-legacy) – Nur Windows-Wrapper um uipcli.exe für die Studio-Befehle, die noch nicht auf das plattformübergreifende rpa -Tool portiert wurden (Debug, Validieren, Find-Activities, Find-Package, Typdefinition, Paket). Installieren Sie mit uip tools install @uipath/rpa-legacy-tool. Siehe uip rpa-legacy aus.

Was automatisch installiert wird und was nicht

Es ist nichts vorinstalliert. Ein neues npm install -g @uipath/cli bringt nur den Host auf den Datenträger.

Zwei Möglichkeiten, wie ein Tool auf Ihrer Maschine installiert wird:

1. Automatische Installation bei der ersten Verwendung. Wenn Sie zum ersten Mal einen Befehl aufrufen, dessen Präfix mit einem Whitelist-Eintrag übereinstimmt – z. B. uip or folders list , bevor das Orchestrator-Tool installiert wird –, lädt der Host @uipath/orchestrator-tool von npm herunter und installiert ihn. Dann wird Ihr Befehl ausgeführt. Nachfolgende Aufrufe verwenden das installierte Tool direkt, sodass die zweite Ausführung schnell ist.

2. Explizite Installation. Führen Sie uip tools install <alias> aus (oder den vollständigen Paketnamen). Derselbe Endzustand; schneller zur Runtime, da keine automatische Installation erforderlich ist. Siehe UIP-Tools-Referenz.

Verwenden Sie die explizite Installation in CI-Ausführungen und für Offline-Umgebungen, damit die Erstellungszeiten deterministisch sind und der erste Befehl in einem Auftrag nicht die einmaligen Downloadkosten bezahlt. Den vollständigen Kompromiss finden Sie im Abschnitt zur automatischen Installation der Installationsanleitung .

Hinweis:

Die automatische Installation kann heute nicht deaktiviert werden. Es gibt keine Umgebungsvariable oder kein Flag, das es überspringt – nicht einmal CI=true. Die praktische Problemumgehung besteht darin, die Tools vorzuinstallieren, von denen Sie wissen, dass Sie sie verwenden; Die automatische Installation ist ein No-Op, wenn das Tool bereits vorhanden ist. Dies wird sich wahrscheinlich in einer zukünftigen minor-Version ändern.

Tools von Drittanbietern werden in der UiPath CLI 1.x nicht unterstützt . Der Host validiert zur Installationszeit anhand der weißen Liste, sodass uip tools install my-company/some-tool mit einem ValidationError fehlschlägt. Ein öffentlicher Erweiterungsmechanismus kann in einer späteren Version angezeigt werden; derzeit lädt uip nur die Tools in der obigen Tabelle.

Wo Tools auf der Festplatte live sind

Tools werden in einem @uipath/ -Ordner unter dem Präfix npm installiert, das das Einstiegsskript der CLI besitzt:

• Wenn Sie @uipath/cli global (npm install -g @uipath/cli) installiert haben, werden Tools global daneben installiert – unter $(npm root -g)/@uipath/<tool-name>/.
• Wenn Sie die CLI in einem lokalen Projekt installiert haben (npm install @uipath/cli innerhalb eines Pakets), werden Tools lokal daneben installiert – auf der node_modules/@uipath/<tool-name>/ dieses Projekts.

Mit anderen Worten: Tools folgen der CLI: globale CLI, globale Tools; lokale CLI, lokale Tools. Dies wird automatisch behandelt – Sie müssen kein Scope-Flag an uip tools install übergeben.

Führen Sie uip tools list aus, um anzuzeigen, welche Tools installiert sind und welche Version. Führen Sie npm root -g aus, um den globalen Installationspfad auf Ihrer Maschine zu finden.

Versionsauflösung – Tools verfolgen den Host

Standardmäßig ist jede Toolversion an die Zeile major.minor der CLI angeheftet. Wenn Sie uip tools install or mit CLI 1.0.x ausführen, löst der Host das neueste @uipath/orchestrator-tool auf, dessen Version mit 1.0. beginnt, und installiert es. Wenn Sie uip tools update ausführen, wird jedes installierte Tool auf die neueste Version übertragen , die sich noch innerhalb der Zeile major.minor der CLI befindet.

Die praktischen Folgen:

• Das Upgrade der CLI auf eine neue Minor-Version ist ein zweistufiger Vorgang. Führen Sie nach npm install -g @uipath/cli@1.1.0 uip tools update aus, um jedes installierte Tool in die Version 1.1.x zu bringen Zeile.
• Das Anheften der CLI heftet effektiv alle Tools an. npm install -g @uipath/cli@1.0.3 und dann uip tools update erzeugt einen deterministischen Satz von Toolversionen auf einer beliebigen Maschine.
• Host und Tools senden zusammen kompatible Protokolländerungen. Ein Tool, das für 1.1.x erstellt wurde kann einen internen Vertrag aufrufen, der 1.0.x ist weiß nichts über – das Zulassen gemischter CLI+Tool-Versionen würde das Laden eines Tools mit sich bringen, das der Host nicht verstehen kann.

Sie können die Standardeinstellung überschreiben und explizit eine bestimmte Toolversion installieren:

uip tools install orchestrator-tool@1.2.3
uip tools update --name @uipath/orchestrator-tool --version 1.2.5

Kanäle (alpha, beta) werden durch den Dist-Tag-Mechanismus von npm unterstützt – z. B. wählt uip tools install orchestrator-tool@beta die neueste Betaversion aus. Vorschaubefehle innerhalb eines stabilen Tools werden unabhängig beschriftet; Siehe Versionierung und Stabilität.

Tipp:

Um zu überprüfen, welche Toolversionen sich nach einer Bereitstellung auf einer Maschine befinden, gibt uip tools list --output json den Namen, die Version und das Befehlspräfix jedes installierten Tools aus. Vergleichen Sie dies mit einem bekannt guten Snapshot, um Abweichungen zu erkennen.

Wie der Host Tools lädt

Wenn uip <alias> … ausgeführt wird:

1. Der Host liest argv, entfernt globale Flags (--output, --log-level usw.) und identifiziert das erste Nicht-Flag-Token als potenzielles Tool-Alias.
2. Wenn der Alias mit einem installierten Tool übereinstimmt, lädt der Host dieses Tool bei Bedarf und fordert es auf, seine Unterbefehle zu registrieren.
3. Wenn sich der Alias auf der weißen Liste befindet, das Tool jedoch nicht installiert ist, führt der Host die automatische Installation aus (siehe oben) und fährt dann mit Schritt 2 fort.
4. Wenn sich der Alias nicht auf der weißen Liste befindet und kein erkannter Hostbefehl ist, schlägt der Host mit „Unbekannter Befehl“ fehl und gibt die Nutzung aus.

Das ist das gesamte Lademodell. Es gibt kein Plugin-Manifest, keine Registrierungskonfigurationsdatei, keine vom Benutzer bearbeitbare Liste. Die in das Hostpaket integrierte Whitelist ist die Source of Truth.

Was als Nächstes gelesen werden soll

• UIP-Tools-Referenz – vollständige Syntax und Beispiele für jeden uip tools -Unterbefehl.
• Installing UiPath CLI – Installieren Sie den Host; Tools folgen von dort aus.
• Die automatische Installation des Tools steuern – die No-Opt-out-Realität und die Problemumgehung vor der Installation für CI.
• Verwalten von Tools und Fähigkeiten – tägliche Workflows (Upgrade, Versionen anheften, Abweichung inspizieren).
• Fähigkeiten – ein paralleles System, um Codierungsagenten die Verwendung uip beizubringen. Fähigkeiten sind keine Tools und uip skills ist eine separate Befehlsgruppe.
• Versionierung und Stabilität – wie Host- und Toolversionen unter Servern koordiniert werden.