- Vue d'ensemble (Overview)
- Démarrer
- Concepts
- Utilisation de la UiPath CLI
- UiPath pour les agents de codage
- Guides pratiques
- Revenus CI/CD
- Référence de commande
- Vue d'ensemble (Overview)
- Codes de sortie
- Options globales
- agent codé uip
- UiPath Docsai
- add-test-data-entity
- ajouter une file d'attente de données de test
- add-test-data-variation
- Analyser
- Construire
- créer-projet
- Différence
- recherche-activités
- Obtenir les règles de l'analyse
- récupérer-activité-xaml par défaut
- Récupérer les erreurs
- obtenir des cas de test manuels
- Obtenir les étapes de test manuelles
- Obtenir les versions
- exemple de workflow
- indiquer l'application
- indiquer l'élément
- inspecter-package
- install-data-fabric-entities
- installer-ou-Update-packages
- list-data-fabric-entités
- listes-exemples-workflow
- Créer un package
- restore
- Exécuter le fichier
- modèles-recherche
- Démarrer-Studio
- arrêter l'exécution
- UIA
- Traçages UIP
- Migration
- Référence et assistance
Guide de l'utilisateur de UiPath CLI
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
Datapeut é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-completionfacultatif. - 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_IDetUIPATH_CLIENT_SECRETne sont plus lus automatiquement. Transmettez-les via--client-id env.UIPATH_CLIENT_ID --client-secret env.UIPATH_CLIENT_SECRET(le préfixeenv.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 sortie3sur 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=FalseenUIPATH_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
- Nouvel utilisateur? Démarrage rapide.
- Vous migrez depuis la version 2025.10? Guide de migration.
- Configuration de CI? Votre premier pipeline → choisissez une licence CI/CD.
- Vous travaillez avec des agents d'IA? Utilisation de la UiPath CLI avec des agents de codage.
Consultez les notes de publication pour obtenir la liste complète des modifications et tout ce qui a été livré par la suite.