Umgebung eingerichtet

Installieren Sie die UiPath CLI, melden Sie sich bei Ihrem UiPath Cloud-Konto an, konfigurieren Sie Ihren Codierungsagenten mit UiPath-Fähigkeiten und installieren Sie die UiPath VS Code-Erweiterungen.

Überblick

Die Tutorials in diesem Entwicklerhandbuch „Erste Schritte“ verwenden eine Kombination aus Folgendem:

• UiPath Automation Cloud
• UiPath-Befehlszeilenschnittstelle (CLI)
• UiPath CLI Tools (Plugins)
• Die UiPath Maestro-Erweiterung für Visual Studio Code oder die Open VSX-Registrierung
• UiPath-Fähigkeiten für Coding Agents

Auf dieser Seite werden die erforderlichen Installationsschritte für die obige Liste mit Validierungsschritten zur Bestätigung einer erfolgreichen Installation zentralisiert.

Schritt 1 – Installieren der UiPath CLI und der Tools

Die UiPath CLI (uip) ist ein plattformübergreifendes Tool für die UiPath-Authentifizierung, die Projekterstellung und die Bereitstellung. Es verwendet ein Plugin-System: Die Basis-CLI übernimmt die Authentifizierung und Sie installieren Tools für die Projekttypen, die Sie erstellen. Sehen Sie sich die Zulassungsliste für Tools an, die automatisch installiert werden, wenn Sie sie zum ersten Mal verwenden. Jedes Tutorial enthält Anweisungen für diejenigen, die manuell installiert werden müssen.

1. Installieren Sie die Basis-CLI global:

   npm install -g @uipath/cli
   

2. Überprüfen Sie die Installation:

   uip --version
   

   Sie sollten 1.200.0 oder später sehen.

3. Überprüfen Sie die installierten Tools:

   uip tools list
   

   Bestätigen Sie, dass Sie eine Liste der Tools mit ihren installierten Versionen sehen.

   {
      "Result": "Success",
      "Code": "ToolList",
      "Data": [
         {
            "Name": "solution-tool",
            "Version": "1.200.0",
            "Description": "Create, pack, publish, and deploy UiPath Automation Solutions.",
            "CommandPrefix": "solution"
         },
         {
            "Name": "agent-tool",
            "Version": "1.200.0",
            "Description": "cli plugin for creating and managing UiPath low-code agents",
            "CommandPrefix": "agent"
         },
         {
            "Name": "codedagent-tool",
            "Version": "1.200.0",
            "Description": "Build, run, deploy, and manage AI Agents.",
            "CommandPrefix": "codedagent"
         },
         {
            "Name": "rpa-tool",
            "Version": "1.200.1",
            "Description": "Tool for creating and managing UiPath RPA projects",
            "CommandPrefix": "rpa"
         },
         {
            "Name": "maestro-tool",
            "Version": "1.200.0",
            "Description": "Create, debug, and run Maestro projects and jobs.",
            "CommandPrefix": "maestro"
         }
      ]
   }
   

Schritt 2 – Installieren von UiPath-Fähigkeiten für Ihren Codierungs-Agent (optional)

Wenn Sie einen Codierungsagenten (Claude Code, Cursor, Copilot, Gemini oder Codex) neben der CLI verwenden, erhält dieser durch die Installation der UiPath-Fähigkeiten Kenntnisse über die Projektstruktur des Agents, CLI-Befehle und Best Practices. Bevor Sie den Befehl ausführen, um die Fähigkeiten für Ihren bevorzugten Codierungs-Agent zu installieren, stellen Sie sicher, dass er installiert ist. Im folgenden Beispiel werden die Fähigkeiten für Claude Code installiert:

uip skills install --agent claude

Ersetzen Sie claude durch Ihren Agent, wenn Sie einen anderen verwenden. Sie können uip skills install --help ausführen und sich die Option --agent <agent> für die Liste der unterstützten Codierungs-Agents ansehen.

Fähigkeiten werden global in Ihrem Basisverzeichnis (~/.uipath/.skills/) installiert und sind ab diesem Zeitpunkt in jedem Projekt verfügbar.

Schritt 3 – Installieren der UiPath Maestro-Erweiterung für VS Code (optional)

Tutorials, die einen Maestro-Flow, ein BPMN-Diagramm oder einen Fallplan erstellen, verwenden diese Erweiterung, um diese Dateien auf einer visuellen Arbeitsfläche statt als Rohtext zu öffnen. Er meldet sich auch bei Ihrem Mandanten und Ihren Paketen an und stellt sie über den lokalen Arbeitsbereich bereit.

1. Installieren Sie UiPath Maestro über den VS Code Marketplace oder die Open VSX Registry.

   Die Erweiterung erfordert VS Code 1.110.0 oder höher. Überprüfen Sie Ihre Version in Code > Über Visual Studio Code oder führen Sie code --version aus.

2. Laden Sie den VS-Code neu, wenn Sie dazu aufgefordert werden.

3. Wählen Sie das UiPath- Symbol in der Aktivitätsleiste aus, um die UiPath-Ansicht zu öffnen.

4. Wählen Sie im Abschnitt Verbinden die Option Anmelden aus.

5. Schließen Sie die Anmeldung im Browserfenster ab, das sich öffnet.

   Wenn die CLI noch nicht installiert ist, akzeptieren Sie die Eingabeaufforderung und die Erweiterung installiert sie mit npm für Sie. Die Anmeldung verwendet einen OAuth-Browserflow mit einem Rückruf auf localhost Port 8104; Wenn sie fehlschlägt, befindet sich möglicherweise ein veralteter Prozess an diesem Port.

6. UiPath ausführen: Wählen Sie Umgebung aus der Befehlspalette (Ctrl/Cmd+Shift+P) aus und bestätigen Sie Ihre Umgebung. Der Standardwert ist Cloud.

7. UiPath ausführen: Wählen Sie Mandant und dann den Mandanten aus, in den Sie erstellen möchten.

Die Erweiterung füllt nun den Abschnitt Ressourcen mit Ordnern und Orchestrator-Ressourcen für diesen Mandanten aus.

Die Erweiterung verwaltet ihre eigene Kopie der CLI. Die installierte Version muss nicht mit der übereinstimmen, die Sie in Schritt 1 installiert haben. Führen Sie uip --version nach der Anmeldung aus. Wenn sie rückgängig gemacht wird, kehren npm install -g @uipath/cli zur aktuellen Version zurück.

Tipp:

Arbeiten Sie in einem Remote-Arbeitsbereich? In Windows Subsystem for Linux (WSL), Secure Shell (SSH), Codespaces und Dev Container-Workspaces wird die Erweiterung auf dem Remotehost ausgeführt, daher muss die UiPath CLI dort und nicht auf Ihrer lokalen Maschine installiert werden.

Schritt 4 – Authentifizieren von UiPath

Nach der Installation der CLI verwenden Sie die folgenden Schritte, um sie zu authentifizieren, und wählen Sie den zu verwendenden Mandanten aus.

1. Authentifizieren Sie die CLI bei Ihrem UiPath-Konto:

   uip login
   

   Dadurch wird ein Browserfenster geöffnet, in dem Sie sich anmelden und Ihren Mandanten auswählen. Nach Abschluss bestätigt das Terminal, dass Sie angemeldet sind.

2. Überprüfen Sie Ihren Anmeldestatus, indem Sie bestätigen, dass "Status": "Logged in" angezeigt wird, indem Sie Folgendes ausführen:

   uip login status
   

Sie sind jetzt bereit, den Tutorials zu folgen.