Gestionar herramientas y habilidades

Las herramientas y las habilidades son los dos sistemas de extensión que se encuentran junto al host principal uip . Las herramientas añaden comandos que se comunican con los servicios de UiPath; las habilidades enseñan a los agentes de codificación de IA cómo impulsar esos comandos. Ambos se instalan, actualizan y eliminan a través de la propia CLI. Esta página cubre los flujos de trabajo del día a día, no la división conceptual (consulta Herramientas (complementos) y Habilidades) y no la referencia completa de comandos (consulta Herramientas de UIP y Habilidades de UIP).

Herramientas: día a día

Ver lo que está instalado

uip tools list --output table

Devuelve una tabla de name, version, commandPrefix. Utilízalo para detectar la desviación entre un portátil de desarrollador y un servidor de compilación.

Para capturar una instantánea que puedes diferenciar más tarde:

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

Instalar una herramienta

Tres formularios de identificador funcionan: elige el que se lea mejor en contexto:

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

Versión explícita (para reproducibilidad de CI):

uip tools install orchestrator-tool@1.0.2

Vista previa del canal:

uip tools install flow-tool@beta

En CI, instala siempre las herramientas que necesitas como un paso dedicado: la instalación automática paga un coste de descarga único en el comando que se ejecute primero, y no hay opción de exclusión de env-var (detalles):

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

Actualizar herramientas después de un aumento de CLI

Al actualizar @uipath/cli, las herramientas instaladas permanecen en su versión anterior. Ejecuta uip tools update para llevarlos a la última versión dentro de la nueva línea MAYOR.MINOR de CLI:

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

Actualizar una sola herramienta:

uip tools update --name orchestrator-tool

Anclar una herramienta específica a una versión exacta:

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

El Data en UpdateResult te ofrece diferencias from → to por herramienta: útil para los registros de auditoría.

Consejo:

Actualizar la finalización del shell después de una actualización

El script de finalización de shell es una instantánea estática de los verbos y marcadores conocidos cuando uip completion se ejecutó por última vez. Después de npm install -g @uipath/cli@<new>, uip tools install o uip tools update, vuelve a ejecutar uip completion para que los comandos y marcadores recién añadidos aparezcan en <TAB>. Consulta finalización de uip: instantánea estática.

Eliminar una herramienta

uip tools uninstall or

Después de la desinstalación, la siguiente invocación uip or … desencadenará la instalación automática de nuevo a menos que la instalación automática esté bloqueada (ejecución sin conexión, fijación de la lista blanca). Para mantener una herramienta deshabilitada en un ejecutor sin estado, preinstala solo las herramientas que deseas y no llames a las desinstaladas.

Desviación de auditoría entre entornos

En cada entorno, captura el conjunto instalado:

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

Diferencia los archivos en todos los entornos. Cualquier delta es una fuente de "funciona en mi máquina": se resuelve anclando en CI.

Habilidades: día a día

Ver lo que está instalado

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

Para una instalación local, el almacén se encuentra en la raíz del proyecto en ./.uipath/.skills/. Como alternativa, pide a un agente que enumere sus habilidades instaladas: cada agente compatible expone esto a través de su propia IU/comando.

Instalar habilidades en un agente de codificación

Por agente:

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 forma interactiva (selección múltiple mediante casilla de verificación):

uip skills install

Ámbito:

• El valor predeterminado es global : se instala en el perfil de usuario del agente. Disponible en todos los lugares en los que se ejecuta el agente.
• --local se instala en el directorio actual en su lugar. Bueno para habilidades ancladas al proyecto o cuando no quieres sobrecargar el perfil de usuario. Claude Code es solo global : pasa --local con --agent claude errores.

Mantener las habilidades actualizadas

uip skills update vuelve a obtener el catálogo de habilidades de UiPath y reinstala:

uip skills update --agent claude

La actualización también elimina las habilidades que han desaparecido del catálogo remoto desde la última instalación: los agentes se mantienen al día con el conjunto lanzado de UiPath.

Eliminar habilidades

uip skills uninstall --agent claude

No elimina el propio agente y no afecta a las habilidades de otros agentes. Ejecutar una vez por agente del que desea eliminar habilidades.

Combinar herramientas y habilidades en un proyecto

Un patrón común para un repositorio que utiliza agentes de codificación de IA para el trabajo de UiPath:

1. Anclar @uipath/cli en la documentación del proyecto (no en package.json : la CLI es una dependencia de desarrollo en la máquina del operador, no una dependencia del runtime del proyecto).
2. Documenta la aplicación externa y el tenant a los que se dirige el proyecto en tu LÉAME. Cada colaborador establece las variables de entorno correspondientes en su máquina e inicia sesión uip login.
3. Instala las herramientas relevantes para el proyecto en la máquina de cada colaborador:

   uip tools install or solution tm
   

4. Instala habilidades localmente para el agente de codificación utilizado por el proyecto:

   uip skills install --agent cursor --local
   

5. Añade el directorio del almacén de habilidades local a .gitignore (el comando de instalación imprime la ruta en la primera ejecución).

Los agentes que se ejecutan en el repositorio se autentican con la sesión del colaborador, las habilidades les enseñan a utilizar uip y las herramientas ancladas mantienen las compilaciones reproducibles.

Cuando las cosas van mal

Los comandos de una herramienta no se muestran en uip --help

La herramienta no está instalada o no se pudo cargar. Comprobar:

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

Una herramienta que se carga con un error se omite silenciosamente por el árbol de finalización y por el distribuidor de comandos.

Hay una herramienta instalada pero los comandos fallan con "opción desconocida"

Es probable que la versión no coincida: la herramienta se creó en una línea secundaria CLI diferente. Corregir con uip tools update --name <tool>.

Las habilidades no se muestran en mi agente de codificación

Cada agente gestiona los archivos de habilidades a través de su propio sistema de complementos/reglas. Después de uip skills install --agent <name>:

• Claude Code : reinicia Claude Code; las habilidades aparecen en el selector de complementos.
• Cursor : las habilidades se cargan automáticamente en la siguiente conversación; marca ~/.cursor/skills/ (global) o ./.cursor/skills/ (local).
• Copilot de GitHub : abre el panel de Copilot; habilidades activas en ~/.github/skills/ (global) o ./.github/skills/ (local).
• CLI de Gemini : las habilidades se escriben en ~/.gemini/skills/ o ./.gemini/skills/.
• Codex : las habilidades se escriben en ~/.agents/skills/ o ./.agents/skills/ (el directorio estándar abierto de habilidades de agente).
• OpenCode : las habilidades se escriben en ~/.config/opencode/skills/ (global) o ./.opencode/skills/ (local).

Ejecuta uip skills install --agent <name> --print (o la casilla de verificación equivalente en modo interactivo) para ver el destino exacto.

Ver también

• Herramientas (complementos) : el modelo de host más complementos.
• Habilidades : el sistema de extensión del agente de IA.
• Referencia de herramientas de UIP : lista completa de marcadores.
• referencia de habilidades de uip : lista completa de marcadores.
• Instalar UiPath CLI — Controlar la instalación automática de la herramienta : cómo se comporta la instalación automática en CI.
• Uso de UiPath CLI con agentes de codificación : tutoriales de configuración por agente.