Gérer les outils et les compétences

Les outils et les compétences sont les deux systèmes d’extension qui se trouvent à côté de l’hôte uip principal. Les outils ajoutent des commandes qui concernent les services UiPath; Les compétences apprennent aux agents de codage d'IA à piloter ces commandes. Les deux sont installés, mis à jour et supprimés via la CLI elle-même. Cette page couvre les workflows quotidiens - non la division conceptuelle (voir Outils (Plugins) et Compétences) et non la référence complète de la commande (voir les outils uip et les compétences uip).

Outils — quotidien

Découvrez ce qui est installé

uip tools list --output table

Renvoie une table de name, version, commandPrefix. Utilisez-le pour repérer les dérives entre un ordinateur portable et un serveur de build.

Pour capturer un instantané, vous pouvez différer ultérieurement:

uip tools list --output json --output-filter "Data[*].{name: name, version: version}" > tools.json

Installer un outil

Trois formulaires d'identification fonctionnent — choisissez celui qui se lit le mieux en contexte:

uip tools install or                                # alias (shortest)
uip tools install orchestrator-tool                 # short name
uip tools install @uipath/orchestrator-tool         # full npm name

Version explicite (pour la reproductibilité CI):

uip tools install orchestrator-tool@1.0.2

Aperçu du canal:

uip tools install flow-tool@beta

Dans CI, installez toujours les outils dont vous avez besoin sous forme d'une étape dédiée - l'installation automatique paye un coût de téléchargement unique sur la première commande exécutée, et il n'y a pas d'inscription à Env-var (détails):

uip tools install @uipath/orchestrator-tool \
                  @uipath/solution-tool \
                  @uipath/test-manager-tool

Mettre à niveau les outils après un pic de CLI

Lorsque vous mettez à niveau @uipath/cli, les outils installés restent dans leur version précédente. Exécutez uip tools update pour les mettre à la dernière version dans la nouvelle ligne MAJOR.MINOR de la CLI:

npm install -g @uipath/cli@1.1.0
uip tools update

Mettre à jour un outil unique:

uip tools update --name orchestrator-tool

Épingler un outil spécifique à une version exacte:

uip tools update --name orchestrator-tool --version 1.0.3

Le Data dans UpdateResult vous donne des diff par outil from → to - utile pour les journaux d'audit.

Astuce :

Actualiser l'achèvement du shell après une mise à niveau

Le script de complétion de shell est un instantané statique des verbes et des indicateurs connus lors de la dernière exécution de uip completion . Après npm install -g @uipath/cli@<new>, uip tools install ou uip tools update, réexécutez uip completion afin que les commandes et les indicateurs récemment ajoutés apparaissent dans <TAB>. Voir la rubrique Complétion UIP — Instantané statique.

Supprimer un outil

uip tools uninstall or

Après la désinstallation, la prochaine uip or … invocation déclenchera à nouveau l'installation automatique, sauf si l'installation automatique est bloquée (exécuteur hors ligne, épinglage de la liste blanche). Pour qu’un outil fonctionne sur un exécuteur sans état, préinstallez uniquement les outils souhaités et n’appelez pas les outils désinstallés.

Déplacement d'audit entre les environnements

Sur chaque environnement, capturez l'ensemble installé:

uip tools list --output json --output-filter "Data[*].{name: name, version: version}" | jq -S . > tools.$(hostname).json

Différez les fichiers entre les environnements. Tout delta est une source de « fonctionne sur ma machine» — résolu en épinglant dans CI.

Compétences — quotidienne

Découvrez ce qui est installé

ls ~/.uipath/.skills         # the on-disk skill catalog cache
cat ~/.uipath/.skills/manifest.json   # manifest of installed skills per agent

Pour une installation locale, le magasin se trouve sous la racine du projet au niveau de ./.uipath/.skills/. Vous pouvez également demander à un agent de répertorier ses compétences installées; chaque agent pris en charge l'expose via sa propre interface utilisateur / commande.

Installer des compétences dans un agent de codage

Par agent:

uip skills install --agent claude        # Claude Code (global only)
uip skills install --agent cursor        # Cursor
uip skills install --agent copilot       # GitHub Copilot
uip skills install --agent gemini        # Gemini CLI
uip skills install --agent codex         # Codex
uip skills install --agent opencode      # OpenCode

De manière interactive (sélections multiples via case à cocher):

uip skills install

Étendue :

• Par défaut est global — installé dans le profil d'utilisateur de l'agent. Disponible partout où l’agent est exécuté.
• --local s'installe dans le répertoire actuel à la place. Convient aux compétences épinglées dans un projet ou lorsque vous ne souhaitez pas encombrer le profil de l'utilisateur. Le code est global uniquement — Claude --local transmis avec --agent claude erreurs.

Actualiser les compétences

uip skills update récupère le catalogue de compétences UiPath et réinstalle:

uip skills update --agent claude

La mise à jour supprime également les compétences qui ont disparu du catalogue à distance depuis la dernière installation - les agents restent informés de l'ensemble publié d'UiPath.

Supprimer les compétences

uip skills uninstall --agent claude

Ne supprime pas l’agent lui-même et n’affecte pas les compétences des autres agents. Exécutez une fois par agent dont vous souhaitez supprimer des compétences.

Combiner des outils et des compétences dans un projet

Un schéma courant pour un référentiel qui utilise des agents de codage d'IA pour le travail UiPath:

1. Épinglez @uipath/cli dans la documentation du projet (pas dans package.json — la CLI est une dépendance de développement sur la machine de l'opérateur, pas une dépendance de l'exécution du projet).
2. Documentez l’application externe et le locataire des cibles du projet dans votre fichier README. Chaque contributeur définit les variables d'environnement correspondantes sur sa machine et se connecte avec uip login.
3. Installez les outils pertinents du projet sur la machine de chaque contributeur:

   uip tools install or solution tm
   

4. Installez localement les compétences pour l’agent de codage utilisé par le projet:

   uip skills install --agent cursor --local
   

5. Ajoutez le répertoire local Skills-Store à .gitignore (la commande d’installation imprime le chemin lors de la première exécution).

Les agents s’exécutant dans le référentiel s’authentifient auprès de la session du contributeur, les compétences leur apprennent à utiliser uip et les outils épinglés préservent la reproductibilité des builds.

Lorsque les choses vont mal

Les commandes d'un outil ne s'affichent pas dans uip --help

Soit l’outil n’est pas installé, soit il n’a pas pu se charger. Vérifier:

uip tools list                  # is it installed?
uip --log-level debug or folders list   # what does the host say during tool load?

Un outil qui se charge avec une erreur est ignoré en mode silencieux par l'arborescence de complétion et par le répartiteur de commandes.

Un outil est installé, mais les commandes échouent avec « option inconnue»

Probablement une incompatibilité de version — l’outil a été construit avec une ligne mineure de CLI différente. Corrigez avec uip tools update --name <tool>.

Les compétences ne s’affichent pas dans mon agent de codage

Chaque agent gère les fichiers de compétence via son propre système de plug-ins/de règles. Après uip skills install --agent <name>:

• Claude Code — redémarrer Claude Code; les compétences apparaissent sous le sélecteur de plugins.
• Curseur — chargement automatique des compétences lors de la conversation suivante; vérifiez ~/.cursor/skills/ (global) ou ./.cursor/skills/ (local).
• GitHub Copilot — ouvrez le panneau Copilot; les compétences se trouvent sous ~/.github/skills/ (global) ou ./.github/skills/ (local).
• CLI Gemini — les compétences sont écrites dans ~/.gemini/skills/ ou ./.gemini/skills/
• Codex : les compétences sont écrites dans ~/.agents/skills/ ou ./.agents/skills/ (le répertoire standard des compétences de l'agent ouvert).
• OpenCode - les compétences sont écrites dans ~/.config/opencode/skills/ (global) ou ./.opencode/skills/ (local).

Exécutez uip skills install --agent <name> --print (ou la case à cocher équivalente en mode interactif) pour voir la destination exacte.

Voir également

• Outils (extensions) : le modèle hôte plus plug-ins.
• Compétences — le système d'extension AI-agent.
• référence des outils uip — liste complète des indicateurs.
• référence des compétences uip — liste complète des indicateurs.
• Installation de la UiPath CLI — Contrôle de l'installation automatique de l'outil — comportement de l'installation automatique dans CI.
• Utilisation de la UiPath CLI avec des agents de codage — procédures pas à pas de configuration par agent.