Installieren und einrichten

Installieren Sie die uip-CLI und die UiPath-Fähigkeiten für Ihren Codierungs-Agent und authentifizieren Sie sich dann bei Ihrer UiPath-Organisation.

Diese Anleitung führt Sie von einer sauberen Maschine zu einer funktionierenden Einrichtung: der uip -CLI, den UiPath-Fähigkeiten für Ihren Codierungs-Agent und einer authentifizierten Verbindung zu Ihrer UiPath-Organisation.

Hinweis:

Bevor Sie einen Codierungs-Agent auf Ihrer UiPath-Organisation handeln lassen, überprüfen Sie die empfohlenen Richtlinien für die konforme und verantwortungsvolle Nutzung.

Voraussetzungen

• Ein UiPath-Konto mit Zugriff auf eine Organisation und einen Mandanten.
• Ein unterstützter installierter Codierungsagent: Claude Code, Cursor, Codex CLI oder Google Antischwerity.
• Administratorrechte auf Ihrer Maschine, damit das Installationsprogramm Runtimes hinzufügen kann.

Eingeschränkte Netzwerke und interne npm-Registrierungen

UiPath-Pakete werden unter dem öffentlichen @uipath -Scope auf npm veröffentlicht. Die Paketseiten auf www.npmjs.com dienen der Information; npm-Clients und Repository-Proxys rufen Paketmetadaten und Archive von https://registry.npmjs.org/ ab.

Wenn Ihre Organisation den npm-Zugriff einschränkt:

• Lassen Sie den vollständigen öffentlichen @uipath/* -Scope von https://registry.npmjs.org/ zu oder spiegeln Sie ihn.

• Lassen Sie nicht nur @uipath/cli zu. Die CLI ruft auch @uipath/skills, funktionsspezifische Tools, Aktualisierungsmetadaten und plattformspezifische Unterstützungspakete ab.

• Wenn Sie einen internen npm-Proxy verwenden, konfigurieren Sie den @uipath -Scope, um ihn zu verwenden. Ersetzen Sie die Beispiel-URL durch Ihre interne Registrierungs-URL:

  npm config set @uipath:registry https://npm.example.com/
  

Stellen Sie sicher, dass die CLI- und Fähigkeitspakete über die konfigurierte Registrierung verfügbar sind, bevor Sie das Installationsprogramm ausführen:

npm view @uipath/cli version
npm view @uipath/skills version

Der unterstützende Paketsatz entwickelt sich weiter, wenn Funktionen hinzugefügt werden. Lassen Sie lieber den @uipath/* -Scope zu, anstatt eine einzelne Paketliste zu verwalten.

Installieren

Der schnellste Pfad ist das einzeilige Installationsprogramm. Eine erneute Ausführung ist sicher – bei jedem Schritt wird übersprungen, was bereits vorhanden ist.

1. Führen Sie das Installationsprogramm für Ihr Betriebssystem aus.

   # macOS / Linux
   curl -fsSL https://download.uipath.com/uipath-cli/install.sh | bash
   

   # Windows (PowerShell)
   irm https://download.uipath.com/uipath-cli/install.ps1 | iex
   

2. Öffnen Sie ein neues Terminal, damit die aktualisierte PATH wirksam wird, und führen Sie dann uip --help aus.

Ergebnis: Die uip -CLI- und UiPath-Fähigkeiten werden installiert und die CLI reagiert in Ihrem Terminal.

Was das Installationsprogramm tut

Das Skript führt sechs Schritte der Reihenfolge nach aus und überspringt alle, die bereits zufrieden sind:

• Stellt sicher, dass curl verfügbar ist, und wird zum Herunterladen der verbleibenden Installationsprogramme verwendet.
• Stellt sicher, dass Node.js 20 oder höher installiert ist.
• Installiert die UiPath CLI von npm mit npm install -g @uipath/cli.
• Führt uip skills install aus, wodurch UiPath-Fähigkeiten für die Codierungs-Agents hinzugefügt werden, die es auf Ihrer Maschine erkennt.
• Installiert das.NET SDK 8.0.
• Installiert Python 3.11 bis 3.14.

Hinweis:

Die CLI wird in der öffentlichen npm-Registrierung veröffentlicht, sodass zum Installieren kein Token erforderlich ist.

Authentifizieren

Melden Sie sich mit uip login bei UiPath an. Ihr Browser wird geöffnet und führt Sie durch die Anmeldung.

Passen Sie den Befehl für Ihre Umgebung und Ihren Mandanten an:

• Um eine andere Umgebung als cloud.uipath.com zu verwenden, übergeben Sie eine Autorisierung: uip login --authority "https://alpha.uipath.com".
• Um einen Mandanten auszuwählen, führen Sie uip login -it für die interaktive Auswahl oder uip login -t TenantName aus, wenn Sie den Namen kennen.

Ergebnis: Die CLI ist bei Ihrer Organisation angemeldet und der Standardmandant wird ausgewählt.

Überprüfen Sie Ihr Setup

1. Führen Sie uip --help aus, um zu bestätigen, dass die CLI antwortet.
2. Öffnen Sie Ihren Codierungs-Agent und stellen Sie ihm eine einfache UiPath-Frage, um zu bestätigen, dass die Fähigkeiten verfügbar sind, z. B.: „Welche UiPath-Fähigkeiten haben Sie installiert?“

Ergebnis: Die CLI antwortet und Ihr Codierungs-Agent kann die installierten UiPath-Fähigkeiten auflisten.

Installationsoptionen

Überspringen Sie nicht gewünschte Teile. Übergeben Sie unter macOS/Linux ein Flag an das Skript mit bash -s -- (oder verwenden Sie die passende Umgebungsvariable); verwenden Sie unter Windows den PowerShell-Schalter.

Markieren (.sh)	Umschalten (.ps1)	Umgebungsvariable	Wird übersprungen
--skip-node	-SkipNode	UIP_SKIP_NODE	Node.js installieren
--skip-skills	-SkipSkills	UIP_SKIP_SKILLS	uip skills install
--skip-dotnet	-SkipDotnet	UIP_SKIP_DOTNET	.NET SDK
--skip-python	-SkipPython	UIP_SKIP_PYTHON	Python
--skip-runtimes	-SkipRuntimes	UIP_SKIP_RUNTIMES	.NET SDK + Python
--dry-run	-DryRun	UIP_DRY_RUN	Führt nichts aus; Gibt den Plan aus

Sobald Sie eingerichtet sind, fahren Sie mit Ihrem ersten Build fort.