UiPath Documentation
uipath-cli
latest
false
Important :
Ce contenu a été traduit à l'aide d'une traduction automatique. La localisation du contenu nouvellement publié peut prendre 1 à 2 semaines avant d’être disponible.

Guide de l'utilisateur de UiPath CLI

Nouveautés

UiPath CLI est une réécriture à la base de l’outil de ligne de commande, remplaçant l’outil uipcli.exe .NET utilisé via 2025.10. Si vous migrez à partir d'un pipeline 2025.10, lisez le guide de migration - cette page est le résumé de ce qui a changé et pourquoi.

Un autre outil

La UiPath CLI est une CLI de TypeScript distribuée sur npm en tant que @uipath/cli et invoquée en tant que uip. Il s'exécute sur Node.js 18+ sur Windows, macOS et Linux. L'hôte et la plupart des outils n'ont pas de dépendance.NET; le rpa-tool est l'exception. Il encapsule le package Studio et le compilateur de workflow, qui nécessitent tous deux un runtime.NET. Installez l'hôte de la même manière dans chaque environnement:

npm install -g @uipath/cli
npm install -g @uipath/cli

La CLI est un hôte de plug-in. Les commandes pour chaque interface UiPath — Orchestrator, Solutions, Agents, Flux, Maestro, Test Manager, etc. — sont fournies sous forme de packages npm distincts qui uip s'installent automatiquement la première fois que vous les utilisez. Voir Outils.

Contrôle de version sémantique

La gestion des versions basée sur le calendrier (2023.10, 2024.10, 2025.10) a été supprimée. 1.0.0 est le point de départ d’un contrat serveur :

  • MAJOR — rupture des modifications avec un cycle d'obsolescence complet d'abord.
  • INFÉRIEUR — nouvelles commandes, nouveaux indicateurs, cumulés uniquement. La forme Data peut évoluer.
  • PATCH — corrections de bogues uniquement.

Coordonnée des versions d’hôte et d’outil: chaque outil suit la ligne MAJOR.MINIOR de la CLI par défaut. Voir Contrôle des versions et stabilité.

Plus de CI/CD

La CLI héritée était un outil CI/CD permettant de compresser, analyser, déployer, exécuter des tests. UiPath CLI 1.x couvre la plate-forme complète — créer, gérer, exploiter, déployer — et est conçu pour être utilisé de manière interactive par les développeurs ainsi que de manière programmatique par les pipelines. Vous pouvez désormais:

  • Élaborer et valider des projets (uip solution new, uip agent init, uip flow init, uip maestro init).
  • Gérer les ressources Orchestrator (dossiers, processus, packages, machines, utilisateurs, rôles, licences, files d'attente, ressources, compartiments, webhooks).
  • Démarrer et surveiller les tâches (uip or jobs start, uip or jobs get), avec --wait-for-completion facultatif.
  • Conduisez le cycle de vie complet de l'agent, y compris l'évaluation (uip agent eval).
  • Inspecter les instances et les incidents Flow et Maestro.
  • Gérer les entités Data Fabric et les connexions Integration Service.

Chaque commande renvoie la même enveloppe JSON structurée, de sorte que tout ce que vous pouvez faire à la main est scriptable.

JSON par défaut

La sortie est JSON sur stdout par défaut, avec une enveloppe stable (Result, Code, Data, Message, Instructions). Les humains optent pour la vue de la table avec --output table; les pipelines et les agents d'IA obtiennent des données précises et structurées sans indicateurs supplémentaires. Voir Formats de sortie.

Connexion interactive conviviale

uip login ouvre un navigateur, vous connecte à UiPath et conserve la session actualisée à l'intérieur ~/.uipath/. Les informations d'identification du client n'ont plus besoin d'être intégrées sur une station de travail de développeur. Les pipelines CI utilisent toujours les informations d'identification du client de l'application externe (désormais transmises par --client-id env.UIPATH_CLIENT_ID), et les conteneurs peuvent utiliser l'authentification basée sur l'environnement avec un jeton d'accès sombre. Voir Authentification.

Conçu pour les agents de codage d'IA

Le système uip skills apprend Claude Code, Cursor, GitHub Copilot, Gemini CLI, Coded et OpenCode à utiliser uip. Les compétences sont publiées par UiPath et installées par agent. Une fois installé, l'agent peut générer un flux pack-publier-déployer complet sans que vous ayez à saisir chaque commande. Voir Utilisation de la UiPath CLI avec des agents de codage.

Achèvement de l’shell

uip completion installe l'achèvement d'onglet pour bash, zsh, pool et PowerShell. L'achèvement dynamique de la valeur d'indicateur (par exemple, uip or packages upload --package-name <TAB>) est disponible sur zsh lorsque jq se trouve sur le PATH; La sous-commande statique et la complétion de nom d'option fonctionnent sur les quatre shells.

Autres changements significatifs

  • Aucune lecture d’authentification implicite env-var. UIPATH_CLIENT_ID et UIPATH_CLIENT_SECRET ne sont plus lus automatiquement. Transmettez-les via --client-id env.UIPATH_CLIENT_ID --client-secret env.UIPATH_CLIENT_SECRET (le préfixe env. recherche la variable au moment du runtime sans l'exposer sur la ligne de commande).
  • Codes de sortie affinés à cinq valeurs (0 / 1 / 2 / 3 / 4, plus 130 pour l'annulation de l'utilisateur). Le contrat est stable dans une version MAJOR — script contre eux. Voir Codes de sortie.
  • Filtrage JMESPath (--output-filter) sur chaque commande, au moment de l’analyse, avec le code de sortie 3 sur les erreurs de syntaxe afin qu’une faute de frappe ne consomme pas d’appel API.
  • Multiplate-forme. ARM64 Windows, macOS et Linux sont pris en charge — ce qui reflète le runtime Node.js.
  • Variable de désactivation de la télémétrie renommée de UIPATH_EXTENSIONS_CLI_TELEMETRY_ENABLED=False en UIPATH_TELEMETRY_DISABLED=1. Les deux génération se refusent par défaut — mettez à jour les exécuteurs CI qui reposent sur l'ancien nom.

Par où commencer

Consultez les notes de publication pour obtenir la liste complète des modifications et tout ce qui a été livré par la suite.

Cette page vous a-t-elle été utile ?

Connecter

Besoin d'aide ? Assistance

Vous souhaitez apprendre ? UiPath Academy

Vous avez des questions ? UiPath Forum

Rester à jour