Environnement configuré

Installez la UiPath CLI et connectez-vous à votre compte UiPath Cloud, configurez votre agent de codage avec les compétences UiPath et installez les extensions UiPath VS Code.

Vue d'ensemble (Overview)

Les tutoriels de ce guide de démarrage du développeur utilisent une combinaison des éléments suivants:

• UiPath Automation Cloud
• Interface de ligne de commande UiPath
• Outils UiPath CLI (extensions)
• Extension UiPath Maestro pour Visual Studio Code ou le registre Open VSX
• Compétences UiPath pour les agents de codage

Cette page centralise les étapes d'installation requises pour la liste ci-dessus, avec des étapes de validation pour confirmer l'installation réussie.

Étape 1 - Installez la UiPath CLI et les outils

La UiPath CLI (uip) est un outil multiplateforme pour l’authentification, l’élaboration du projet et le déploiement UiPath. Il utilise un système de plug-in: la CLI de base gère l'authentification et vous installez des outils pour les types de projet que vous créez. Consultez la liste d’autorisation des outils installés automatiquement lorsque vous les utilisez pour la première fois. Chaque tutoriel inclura des instructions pour celles devant être installées manuellement.

1. Installez la CLI de base globalement:

   npm install -g @uipath/cli
   

2. Vérifiez l'installation:

   uip --version
   

   Vous devriez consulter 1.200.0 ou une version ultérieure.

3. Vérifiez les outils installés:

   uip tools list
   

   Confirmez que vous voyez une liste d’outils avec leurs versions installées.

   {
      "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"
         }
      ]
   }
   

Étape 2: installez des compétences UiPath pour votre agent de codage (facultatif)

Si vous utilisez un agent de codage ( Claude Code, Cursor, Copilot, Gemini ou Codex) avec la CLI, l'installation des compétences UiPath lui donne des connaissances de la structure du projet d'agent, des commandes CLI et des meilleures pratiques. Avant d’exécuter la commande pour installer les compétences pour votre agent de codage préféré, assurez-vous d’abord de l’avoir installé. L'exemple ci-dessous installe les compétences pour Claude Code:

uip skills install --agent claude

Remplacez claude par votre agent si vous en utilisez un autre. Vous pouvez exécuter uip skills install --help et consulter l'option --agent <agent> pour obtenir la liste des agents de codage pris en charge.

Les compétences s'installent globalement dans votre répertoire de base (~/.uipath/.skills/) et sont disponibles dans chaque projet à partir de maintenant.

Étape 3 - Installez l'extension UiPath Maestro pour VS Code (facultatif)

Les tutoriels qui créent un Maestro Flow, un diagramme BPMN ou un plan de cas utilisent cette extension pour ouvrir ces fichiers sur une zone de dessin visuelle plutôt que du texte brut. Il se connecte également à votre locataire et effectue les packages et les déploiements à partir de l'espace de travail local.

1. Installez UiPath Maestro depuis la VS Code Marketplace ou le registre Open VSX.

   L’extension nécessite VS Code 1.110.0 ou une version ultérieure. Vérifiez votre version dans Code > À propos du code de Visual Studio, ou exécutez code --version.

2. Recharger VS Code lorsque vous y êtes invité.

3. Sélectionnez l’icône UiPath dans la barre d’activité pour ouvrir la vue UiPath.

4. Dans la section Se connecter , sélectionnez Se connecter.

5. Terminez la connexion dans la fenêtre du navigateur qui s'ouvre.

   Si la CLI n’est pas encore installée, acceptez la requête et l’extension l’installe pour vous avec npm. La connexion utilise un flux de navigateur OAuth avec un rappel sur le port localhost 8104; s'il échoue, il est possible qu'un processus obsolète conserve ce port.

6. Exécutez UiPath: sélectionnez Environnement dans la Palette de commandes (Ctrl/Cmd+Shift+P) et confirmez votre environnement. La valeur par défaut est Cloud.

7. Exécuter UiPath: sélectionnez Locataire et choisissez le locataire dans lequel vous souhaitez intégrer.

L'extension remplira désormais la section Ressources avec des dossiers et des ressources Orchestrator pour ce locataire.

L'extension gère sa propre copie de la CLI. La version qu’il installe ne doit pas correspondre à celle que vous avez installée à l’étape 1. Exécutez uip --version après vous être connecté; si elle est déplacée vers l’arrière, npm install -g @uipath/cli vous renvoie à la version actuelle.

Astuce :

Vous travaillez dans un espace de travail distant? Dans le sous-système Windows pour Linux (WSL), Secure Shell (SSH), les espaces de code et les espaces de travail de conteneur de développement, l'extension s'exécute sur l'hôte distant, de sorte que la UiPath CLI doit y être installée plutôt que sur votre machine locale.

Étape 4 - S'authentifier auprès d'UiPath

Après avoir installé la CLI, utilisez les étapes ci-dessous pour l'authentifier, puis sélectionnez le locataire à utiliser.

1. Authentifiez la CLI de votre compte UiPath:

   uip login
   

   Cette action ouvre une fenêtre de navigateur dans laquelle vous vous connectez et sélectionnez votre locataire. Une fois terminé, le terminal confirme que vous êtes connecté.

2. Vérifiez le statut de votre connexion en confirmant que vous voyez "Status": "Logged in" en exécutant:

   uip login status
   

Vous êtes maintenant prêt à suivre les tutoriels.