Outils (extensions)

UiPath CLI est un petit hôte encapsulé dans un ensemble d' outils installables. Chaque outil est un package npm simple qui enregistre une commande de niveau supérieur (et ses sous-commandes) avec l'hôte. Il s'agit du concept le plus important pour comprendre pourquoi uip fonctionne comme il le fait: ce qui s'installe automatiquement, ce qui ne s'installe pas, comment les versions sont synchronisées et pourquoi uip --help affiche des commandes différentes sur différentes machines.

Hôte et outils

L’hôte (@uipath/cli, l’exécutable uip ) possède uniquement un ensemble restreint de préoccupations:

• Authentification (uip login, uip logout, uip login status, uip login tenant …).
• Gestion des sessions et des informations d’identification.
• Cycle de vie de l’outil (uip tools list / search / install / update / uninstall).
• Compétences pour coder les agents (uip skills install / update / uninstall).
• Le pont du protocole de contexte du modèle (uip mcp).
• Installation de complétion du shell (uip completion).
• Options globales (--output, --output-filter, --log-level, --log-file) et l'enveloppe de sortie JSON.

Tout ce qui touche une interface UiPath — Orchestrator, Solutions, Agents, Flows, Maestro, Empaquetage RPA, Test Manager, Integration Service, Data Fabric, Insights, Traces, DocsAI, API Workflow, Solutions verticales, Agents codés et Apps codées — réside dans un package npm distinct que l'hôte charge à la demande.

Pourquoi choisir le fractionnement:

• Cadences de publication indépendantes - l'outil Orchestrator peut être livré sans libérer à nouveau l'hôte, et vice versa.
• Empreinte d'installation plus petite — un utilisateur qui exécute uniquement des pipelines de test n'a pas besoin des outils Flow ou Maestro sur le disque.
• Contrat stable — les outils communiquent avec l'hôte via une interface programmatique versionnée (enregistrement des commandes, enveloppe de sortie, contexte, télémétrie), et non via des internes partagées.
• Démarrage plus rapide : le code de l’outil est chargé de manière incorrecte. L'hôte effectue le minimum pour analyser argv et identifier l'outil pertinent, puis requiert le bundle de cet outil une fois.

La liste blanche d’installation automatique

Un ensemble d’outils appartenant à UiPath est sur une liste blanche d’installation automatique. L'hôte les connaît par leur alias de commande et mappe l'alias à un package npm:

Alias	Paquet (Package)	Nom long
or	@uipath/orchestrator-tool	Orchestrator
solution	@uipath/solution-tool	Solution
resource	@uipath/resource-tool	Ressource
rpa	@uipath/rpa-tool	RPA (empaquetage de Studio, analyse, restauration)
agent	@uipath/agent-tool	Agent (Agent)
codedagent	@uipath/codedagent-tool	Agent codé
codedapp	@uipath/codedapp-tool	Application codée
maestro	@uipath/maestro-tool	Maestro
tm	@uipath/test-manager-tool	Test Manager
is	@uipath/integrationservice-tool	Integration Service
vss	@uipath/vertical-solutions-tool	Solutions verticales
api-workflow	@uipath/api-workflow-tool	Workflow d’API
df	@uipath/data-fabric-tool	Data Fabric
insights	@uipath/insights-tool	Insights
traces	@uipath/traces-tool	Traçages
docsai	@uipath/docsai-tool	DocsAI

L'hôte traite tout le reste comme n'est pas un outil. Deux outils supplémentaires sont fournis, mais nécessitent une installation explicite — ils ne figurent pas sur la liste blanche d'installation automatique:

• Flux (@uipath/flow-tool, alias flow): installez avec uip tools install @uipath/flow-tool avant d'exécuter les commandes uip flow .
• RPA Legacy (@uipath/rpa-legacy-tool, alias rpa-legacy) — wrapper Windows uniquement vers uipcli.exe pour les commandes Studio pas encore portées à l'outil rpa multiplate-forme (déboguer, valider, trouver-activités, trouver-package, définition de type, package). Installez avec uip tools install @uipath/rpa-legacy-tool. Voir uip rpa-legacy.

Ce qui s’installe automatiquement et ce qui ne s’installe pas

Rien n’est préinstallé. Un nouveau npm install -g @uipath/cli place uniquement l'hôte sur le disque.

Un outil est installé sur votre machine de deux manières:

1. Installation automatique lors de la première utilisation. La première fois que vous invoquez une commande dont le préfixe correspond à une entrée de liste blanche, par exemple uip or folders list avant l'installation de l'outil Orchestrator, l'hôte télécharge et installe @uipath/orchestrator-tool depuis npm, puis exécute votre commande. Les invocations suivantes utilisent l’outil installé directement de sorte que la deuxième exécution est rapide.

2. Installation explicite. Exécutez uip tools install <alias> (ou le nom complet du package). Même état de fin; plus rapidement au moment de l’exécution, car aucune étape d’installation automatique n’est nécessaire. Voir la référence des outils uip.

Utilisez l'installation explicite dans les lanceurs CI et pour les environnements hors ligne afin que les temps de création soient déterministes et que la première commande d'une tâche ne paye pas le coût de téléchargement unique. Consultez la section d’installation automatique du guide d’installation pour connaître le compromis complet.

Remarque :

L’installation automatique ne peut pas être désactivée aujourd’hui. Aucune variable d'environnement ou indicateur qui l'ignore, pas même CI=true. La solution de contournement pratique consiste à préinstaller les outils que vous savez utiliser; l’installation automatique n’est pas compatible lorsque l’outil est déjà présent. Cela est susceptible de changer dans une version mineure future.

Les outils tiers ne sont pas pris en charge dans UiPath CLI 1.x. L'hôte valide par rapport à la liste blanche au moment de l'installation, donc uip tools install my-company/some-tool échoue avec ValidationError. Un mécanisme d'extension public peut apparaître dans une version ultérieure; pour l'instant, uip ne charge que les outils dans la table ci-dessus.

Où les outils sont installés sur le disque

Les outils sont installés dans un dossier @uipath/ sous le préfixe npm qui possède le script d'entrée de la CLI:

• Si vous avez installé @uipath/cli globalement (npm install -g @uipath/cli), les outils sont installés globalement à côté — à $(npm root -g)/@uipath/<tool-name>/.
• Si vous avez installé la CLI dans un projet local (npm install @uipath/cli à l'intérieur d'un package), les outils s'installent localement à côté — à la node_modules/@uipath/<tool-name>/ de ce projet.

En d'autres termes, les outils suivent la CLI: CLI globale, outils globaux; CLI locale, outils locaux. Ceci est géré automatiquement — vous n'avez pas besoin de transmettre d'indicateur d'étendue à uip tools install.

Exécutez uip tools list pour voir quels outils sont installés et quelle version. Exécutez npm root -g pour trouver le chemin d'installation global sur votre machine.

Résolution de version — les outils suivent l’hôte

Par défaut, chaque version d'outil est épinglée à la ligne major.minor de la CLI. Lorsque vous exécutez uip tools install or avec CLI 1.0.x, l'hôte résout le dernier @uipath/orchestrator-tool dont la version commence par 1.0. et l'installe. Lorsque vous exécutez uip tools update, chaque outil installé est rejeté dans la dernière version toujours dans la ligne major.minor de la CLI.

Les conséquences pratiques:

• La mise à niveau de la CLI vers une nouvelle version mineure est une opération en deux étapes. Après npm install -g @uipath/cli@1.1.0, exécutez uip tools update pour mettre chaque outil installé au niveau 1.1.x ligne.
• L'épinglage de la CLI épingle efficacement tous les outils. npm install -g @uipath/cli@1.0.3 , puis uip tools update produit un ensemble déterministe de versions d'outils sur n'importe quelle machine.
• L'hôte et les outils sont livrés avec des modifications de protocole compatibles. Un outil construit contre 1.1.x peut appeler un contrat interne qui 1.0.x ne sait pas — autoriser des versions mixtes CLI + outil risque de charger un outil que l’hôte ne peut pas comprendre.

Vous pouvez remplacer la valeur par défaut et installer explicitement une version d’outil spécifique:

uip tools install orchestrator-tool@1.2.3
uip tools update --name @uipath/orchestrator-tool --version 1.2.5

Les canaux (alpha, beta) sont pris en charge via le mécanisme dist-tag de npm — par exemple uip tools install orchestrator-tool@beta choisit la version bêta la plus récente. Les commandes d’aperçu dans un outil stable sont étiquetées indépendamment; voir Contrôle de version et stabilité.

Astuce :

Pour vérifier quelles versions d’outil se trouvent sur une machine après un déploiement, uip tools list --output json imprime le nom, la version et le préfixe de commande de chaque outil installé. Comparez-le à un instantané connu pour capturer la dérive.

Comment l'hôte charge les outils

Lorsque uip <alias> … s’exécute:

1. L'hôte lit argv, strie les indicateurs globaux (--output, --log-level, etc.) et identifie le premier jeton non-indicateur comme un alias d'outil potentiel.
2. Si l’alias correspond à un outil installé, l’hôte charge cet outil à la demande et lui demande d’enregistrer ses sous-commandes.
3. Si l'alias se trouve sur la liste blanche mais que l'outil n'est pas installé, l'hôte exécute l'installation automatique (voir ci-dessus), puis passe à l'étape 2.
4. Si l'alias ne figure pas sur la liste blanche et ne constitue pas une commande de l'hôte reconnue, l'hôte échoue avec une « commande inconnue» et l'utilisation des imprime.

Il s'agit de l'ensemble du modèle de chargement. Il n’y a aucun manifeste de plug-in, aucun fichier de configuration de registre, aucune liste modifiable par l’utilisateur. La liste blanche intégrée au package hôte est la source de la vérité.

Quoi lire ensuite

• référence des outils uip — syntaxe complète et exemples pour chaque sous-commande uip tools .
• Installation de la UiPath CLI — installez l'hôte; les outils en suivent.
• Contrôle de l'installation automatique des outils — la réalité du refus et la solution de contournement avant l'installation pour CI.
• Gestion des outils et des compétences — workflows quotidiens (mise à niveau, épingler les versions, inspecter la dérive).
• Compétences — un système parallèle pour apprendre aux agents de codage à utiliser uip. Les compétences ne sont pas des outils et uip skills est un groupe de commandes distinct.
• Contrôle des versions et stabilité - comment les versions de l'hôte et de l'outil sont coordonnées sous semer.