Verwalten von Tools und Fähigkeiten

Tools und Fähigkeiten sind die beiden Erweiterungssysteme, die sich neben dem Kernhost uip befinden. Tools fügen Befehle hinzu, die mit UiPath-Diensten kommunizieren; Fähigkeiten lehren KI-Codierungs-Agents, wie sie diese Befehle ausführen können. Beide werden über die CLI selbst installiert, aktualisiert und entfernt. Diese Seite behandelt die täglichen Workflows – nicht die konzeptionelle Aufteilung (siehe Tools (Plugins) und Fähigkeiten) und nicht die vollständige Befehlsreferenz (siehe UIP-Tools und UIP-Fähigkeiten).

Tools – Tag für Tag

Sehen Sie an, was installiert ist

uip tools list --output table

Gibt eine Tabelle mit name, version, commandPrefix zurück. Verwenden Sie dies, um die Abweichung zwischen einem Entwickler-Laptop und einem Buildserver zu erkennen.

Um einen Snapshot zu erfassen, können Sie später unterscheiden:

uip tools list --output json --output-filter "Data[*].{name: name, version: version}" > tools.json

Installieren Sie ein Tool

Drei Bezeichnerformulare funktionieren – wählen Sie dasjenige aus, das im Kontext am besten liest:

uip tools install or                                # alias (shortest)
uip tools install orchestrator-tool                 # short name
uip tools install @uipath/orchestrator-tool         # full npm name

Explizite Version (für CI-Reproduzierbarkeit):

uip tools install orchestrator-tool@1.0.2

Vorschaukanal:

uip tools install flow-tool@beta

Installieren Sie in CI die Tools, die Sie benötigen, immer als dedizierten Schritt – die automatische Installation übernimmt einmalige Downloadkosten für den Befehl, der zuerst ausgeführt wird, und es gibt keine env-var-Option (Details):

uip tools install @uipath/orchestrator-tool \
                  @uipath/solution-tool \
                  @uipath/test-manager-tool

Aktualisieren Sie Tools nach einer CLI-Erfahrung

Wenn Sie @uipath/cli aktualisieren, bleiben die installierten Tools in ihrer vorherigen Version. Führen Sie uip tools update aus, um sie auf die neueste Version innerhalb der neuen Zeile MaJOR.MINOR der CLI zu bringen:

npm install -g @uipath/cli@1.1.0
uip tools update

Ein einzelnes Tool aktualisieren:

uip tools update --name orchestrator-tool

Ein bestimmtes Tool an eine genaue Version anheften:

uip tools update --name orchestrator-tool --version 1.0.3

Der Data in UpdateResult gibt Ihnen from → to Unterschiede pro Tool – nützlich für Prüfungsprotokolle.

Tipp:

Aktualisieren Sie den Shell-Abschluss nach einem Upgrade

Das Shell-Vervollständigungsskript ist eine statische Snapshot der Verben und Flags, die bei der letzten Ausführung von uip completion bekannt waren. Führen Sie nach npm install -g @uipath/cli@<new>, uip tools install oder uip tools update uip completion erneut aus, sodass neu hinzugefügte Befehle und Flags in <TAB> angezeigt werden. Siehe UIP-Vervollständigung – Statischer Snapshot.

Entfernen Sie ein Tool

uip tools uninstall or

Nach der Deinstallation löst der nächste uip or … -Aufruf erneut die automatische Installation aus, es sei denn, die automatische Installation wird blockiert (Offline-Ausführung, Whitelist-Anheftung). Um ein Tool in einem Stateless Runtime zu behalten, installieren Sie nur die gewünschten Tools vor und rufen Sie die deinstallierten Tools nicht auf.

Prüfungsdifferenz zwischen Umgebungen

Erfassen Sie in jeder Umgebung den installierten Satz:

uip tools list --output json --output-filter "Data[*].{name: name, version: version}" | jq -S . > tools.$(hostname).json

Unterscheiden Sie die Dateien über verschiedene Umgebungen hinweg. Jedes Delta ist eine Quelle von „funktioniert auf meiner Maschine“ – lösen Sie durch Anheften in CI.

Fähigkeiten – Tag für Tag

Sehen Sie an, was installiert ist

ls ~/.uipath/.skills         # the on-disk skill catalog cache
cat ~/.uipath/.skills/manifest.json   # manifest of installed skills per agent

Bei einer lokalen Installation befindet sich der Speicher unter dem Projektstamm auf ./.uipath/.skills/. Alternativ können Sie einen Agent bitten, seine installierten Fähigkeiten aufzulisten – jeder unterstützte Agent stellt dies über eine eigene Benutzeroberfläche/einen eigenen Befehl bereit.

Installieren Sie Fähigkeiten in einem Codierungs-Agent

Nach Agent:

uip skills install --agent claude        # Claude Code (global only)
uip skills install --agent cursor        # Cursor
uip skills install --agent copilot       # GitHub Copilot
uip skills install --agent gemini        # Gemini CLI
uip skills install --agent codex         # Codex
uip skills install --agent opencode      # OpenCode

Interaktiv (Mehrfachauswahl über Kontrollkästchen):

uip skills install

Scope:

• Standard ist global – wird im Benutzerprofil des Agent installiert. Überall verfügbar, wo der Agent ausgeführt wird.
• --local wird stattdessen im aktuellen Verzeichnis installiert. Gut für an Projektn angeheftete Fähigkeiten oder wenn Sie das Benutzerprofil nicht überladen möchten. Claude Code ist nur global – übergibt --local mit --agent claude Fehlern.

Halten Sie Ihre Fähigkeiten auf dem neuesten Stand

uip skills update ruft den UiPath-Fähigkeitenkatalog erneut ab und installiert Folgendes:

uip skills update --agent claude

Das Update entfernt auch Fähigkeiten, die seit der letzten Installation aus dem Remote-Katalog verschwunden sind – Agents bleiben im Schritt mit dem veröffentlichten Set von UiPath.

Fähigkeiten entfernen

uip skills uninstall --agent claude

Entfernt nicht den Agent selbst und beeinflusst nicht die Fähigkeiten anderer Agents. Führen Sie die Aktion einmal pro Agent aus, von dem Sie Fähigkeiten entfernen möchten.

Kombinieren von Tools und Fähigkeiten in einem Projekt

Ein gängiges Muster für ein Repository, das KI-Codierungsagents für UiPath-Arbeit verwendet:

1. Anheften von @uipath/cli in der Projektdokumentation (nicht in package.json – die CLI ist eine Entwicklungsabhängigkeit auf der Maschine des Operators, keine Projektlaufzeitabhängigkeit).
2. Dokumentieren Sie die externe Anwendung und mandanten die Projektziele in Ihrer README-Datei. Jeder Mitwirkende legt die entsprechenden Umgebungsvariablen auf seiner Maschine fest und meldet sich mit uip login an.
3. Installieren Sie die projektrelevanten Tools auf der Maschine jedes Mitwirkenden:

   uip tools install or solution tm
   

4. Installieren Sie Fähigkeiten lokal für den Codierungs-Agent, der vom Projekt verwendet wird:

   uip skills install --agent cursor --local
   

5. Fügen Sie das lokale Verzeichnis für den Fähigkeitenspeicher zu .gitignore hinzu (der Installationsbefehl gibt den Pfad bei der ersten Ausführung aus).

Agents, die im Repository ausgeführt werden, authentifizieren sich mit der Sitzung des Mitwirkenden, die Fähigkeiten lehren sie die Verwendung uip und die angehefteten Tools halten Builds lassen sich gut ausführen lassen.

Wenn etwas schief läuft

Die Befehle eines Tools werden nicht in uip --help angezeigt

Entweder ist das Tool nicht installiert, oder es konnte nicht geladen werden. Prüfen:

uip tools list                  # is it installed?
uip --log-level debug or folders list   # what does the host say during tool load?

Ein Tool, das mit einem Fehler geladen wird, wird von der Vervollständigungsstruktur und vom Befehlsverteiler im Hintergrund übersprungen.

Ein Tool ist installiert, aber Befehle schlagen mit „unbekannte Option“ fehl.

Wahrscheinlich eine Versionsinkonsistenz – das Tool wurde für eine andere CLI-Nebenzeile erstellt. Mit uip tools update --name <tool> beheben.

Fähigkeiten werden in meinem Codierungs-Agent nicht angezeigt

Jeder Agent verarbeitet Fähigkeitsdateien über ein eigenes Plugin-/Regelsystem. Nach uip skills install --agent <name>:

• Claude Code – Claude Code neu starten; Fähigkeiten werden unter der Plugin-Auswahl angezeigt.
• Cursor – Fähigkeiten werden bei der nächsten Konversation automatisch geladen; Überprüfen Sie ~/.cursor/skills/ ( global) oder ./.cursor/skills/ (lokal).
• GitHub Copilot – Öffnen Sie den Copilot-Bereich. Fähigkeiten live unter ~/.github/skills/ ( global) oder ./.github/skills/ (lokal).
• Gemini-CLI – Fähigkeiten werden in ~/.gemini/skills/ oder ./.gemini/skills/ geschrieben.
• Codex – Fähigkeiten werden in ~/.agents/skills/ oder ./.agents/skills/ (das Standardverzeichnis von Open Agent Skills) geschrieben.
• OpenCode – Fähigkeiten werden in ~/.config/opencode/skills/ ( global) oder ./.opencode/skills/ (lokal) geschrieben.

Führen Sie uip skills install --agent <name> --print aus (oder das entsprechende Kontrollkästchen im interaktiven Modus), um das genaue Ziel anzuzeigen.

Siehe auch

• Tools (Plugins) – das Host-Plus-Plugins-Modell.
• Fähigkeiten – das KI-Agent-Erweiterungssystem.
• UIP-Tools-Referenz – vollständige Flag-Liste.
• Referenz für UIP-Fähigkeiten – vollständige Flag-Liste.
• Installieren von UiPath CLI – Steuern der automatischen Installation des Tools – wie sich die automatische Installation in CI verhält.
• Using UiPath CLI with Coding Agents — per-agent setup walkthroughs.