Utilizar UiPath CLI con agentes de codificación

Los agentes de codificación de IA (Claude Code, Cursor, GitHub Copilot, Gemini CLI, Codex, OpenCode) pueden crear y operar automatizaciones de UiPath utilizando uip de la misma manera que lo hace un desarrollador. Se les enseña instalando habilidades: paquetes de instrucciones orientados a tareas publicados por UiPath. Una vez instalada una habilidad, el agente sabe cuándo empaquetar una solución, cómo encadenar publish con deploy run, cuándo esperar un trabajo, cómo inspeccionar una carpeta de Orchestrator: toda la superficie, no solo los nombres de los comandos.

Esta página te guía por la configuración por agente: instala la propia CLI del agente, inicia sesión en UiPath, instala las habilidades y verifica la instalación.

Requisitos previos

Todos los agentes compatibles comparten los mismos requisitos previos:

1. @uipath/cli instalado en tu máquina. Consulta Instalar UiPath CLI.
2. Una sesión iniciada. Ejecutar uip login una vez; las habilidades utilizan la misma sesión que utiliza el resto de la CLI. Consulta Autenticación.
3. El agente de codificación instalado. Cada sección a continuación se vincula al instalador del agente.

No es necesario instalar las herramientas de UiPath (uip tools install …) antes de instalar las habilidades: el agente puede instalarlas automáticamente la primera vez que se utilicen.

Elegir un agente

Agente	--agent valor	Soporte de ámbito	Notas
Claude Code (complemento)	claude	Solo global	Las habilidades se instalan como complementos de Claude Code; el sistema de complementos es de ámbito de usuario, no hay opción de proyecto.
Cursor	cursor	Global o local	Las habilidades se instalan en .cursor/skills/<skill>/; El cursor los carga por espacio de trabajo.
Copilot de GitHub	copilot	Global o local	Las habilidades se instalan en .github/skills/<skill>/; Copilot las carga como instrucciones personalizadas.
CLI de Gemini	gemini	Global o local	Las habilidades se instalan en .gemini/skills/<skill>/.
Códice	codex	Global o local	Las habilidades se instalan en .agents/skills/<skill>/ : el directorio estándar abierto de habilidades de agente.
Abrir código	opencode	Global o local	Las habilidades se instalan en .opencode/skills/<skill>/ (local) o ~/.config/opencode/skills/<skill>/ (global).

Consulta Habilidades para el modelo y la referencia de habilidades de UIP para la superficie de marca completa.

Código Claude

Instalar el agente

Consulta claude.com/claude-code para la instalación. En macOS/Linux, la ruta común es curl -fsSL https://claude.ai/install.sh | bash.

Instalar habilidades

uip skills install --agent claude

Claude Code es solo global para las habilidades. Pasando --local errores con un ValidationError.

Comprobar

Abre Claude Code. Pregunta: "Empaqueta esta solución e impleméntala en la carpeta compartida". El agente debe proponer uip solution pack → uip solution publish → uip solution deploy run : el flujo canónico.

Si el agente no reconoce las tareas específicas de UiPath, reinicia Claude Code para que vuelva a cargar los complementos y vuelve a intentarlo.

Cursor

Instalar el agente

Consulta cursor.com para la instalación.

Instalar habilidades

Global (disponible en todos los espacios de trabajo):

uip skills install --agent cursor

Por proyecto (seguido junto con tu repositorio):

cd /path/to/project
uip skills install --agent cursor --local

Las instalaciones locales añaden el directorio del almacén de habilidades a .gitignore automáticamente: los paquetes de habilidades en caché quedan fuera de las confirmaciones.

Comprobar

Abre el Cursor en el repositorio. En el Redactor, pregunta: "Crea un nuevo proyecto de UiPath Agent y empaquetalo". El agente debe proponer uip agent init → uip agent validate → uip agent pack.

Copilot de GitHub

Instalar el agente

GitHub Copilot es un complemento de VS Code/JetBrains/Visual Studio. Consulta github.com/features/copilot.

Instalar habilidades

uip skills install --agent copilot

(Añade --local para reglas por repositorio).

Comprobar

Abra un proyecto en VS Code (o su editor compatible) y abra el panel Copilot Chat. Preguntar una tarea específica de UiPath. Copilot debe citar las reglas de habilidad instaladas al redactar su respuesta.

CLI de Gemini

Instalar el agente

Consulta github.com/google-gemini/gemini-cli.

Instalar habilidades

uip skills install --agent gemini

(Añade --local para habilidades de ámbito de proyecto).

Comprobar

Ejecuta gemini en el repositorio. Solicita una tarea de UiPath y comprueba que propone comandos uip de las habilidades instaladas.

Códice

Instalar el agente

Consulta las instrucciones de instalación del Codex de OpenAI.

Instalar habilidades

uip skills install --agent codex

Comprobar

Iniciar Codex. Solicitar una tarea de UiPath; las habilidades deben guiarlo a la cadena de comandos uip correcta.

Abrir código

Instalar el agente

Consulta opencode.ai.

Instalar habilidades

uip skills install --agent opencode

Comprobar

Inicia OpenCode en el directorio del proyecto. Marca ~/.config/opencode/skills/ (global) o ./.opencode/skills/ (local) para los archivos de habilidad instalados.

Trabajar con agentes en la práctica

Deje que el agente maneje: no especifique cada comando

Las habilidades codifican la secuencia de comandos que se va a utilizar. Solicite resultados ("implementar esta solución en producción"), no comandos específicos. El agente encadenará pack → publish → deploy run (o te pedirá que confirmes cada paso, dependiendo del modo del agente).

Comparte tu sesión

Los agentes se ejecutan uip en tu máquina, utilizando la configuración de la sesión uip login . Si has iniciado sesión con una cuenta personal, el agente actúa como tú. Utiliza una sesión de aplicación externa (Flujo 2 en Autenticación) si quieres que el agente se vincule a una identidad de servicio.

Mantén las habilidades y herramientas en sintonía

Después de una actualización de CLI, ejecuta también uip skills update --agent <name> para recoger cualquier habilidad recién publicada y uip tools update para llevar herramientas a la línea MAYOR.MINOR coincidente. Consulta Gestionar herramientas y habilidades.

Cuando el agente se atasca

Pide al agente que ejecute uip <command> --help y vuelva a introducir la salida en la conversación. La ayuda integrada es autorizada y cubre marcadores que las habilidades aún no pueden describir. Los agentes suelen recuperarse por sí mismos una vez que se les da la salida de ayuda.

MCP (ruta alternativa)

Para los clientes compatibles con MCP que no están en la lista de agentes compatibles, UiPath CLI envía un servidor MCP a través de uip mcp. Expone una herramienta, run_command, que permite al cliente ejecutar cualquier comando uip . Esta no es la ruta de IA principal para UiPath (las habilidades lo son), pero está disponible para integraciones que ya hablan MCP. Consulta la referencia de uip mcp.

Ver también

• Habilidades : qué son las habilidades, los agentes compatibles y el modelo de granularidad.
• referencia de habilidades de uip : referencia de marca.
• Gestionar herramientas y habilidades : mantenimiento diario.
• Instalar UiPath CLI : configuración única.
• Autenticación : flujos de sesión que heredan los agentes.

Descargo de responsabilidad

El agente de codificación no valida el cumplimiento de ningún código que genera, los comandos operativos que ejecuta o las acciones de solución de problemas que recomienda: eres responsable de revisar todo el código generado, los cambios operativos y las salidas de diagnóstico antes de aplicarlos a la producción. Para usarlo de forma responsable: autentícate con un token dedicado con permisos mínimos (no tu acceso completo) para obtener registros de auditoría más limpios; ejecutar en modo attended para mantener a un humano al tanto; garantizar que las barreras de seguridad de agentes de terceros estén configuradas para limitar el ámbito y evitar comportamientos inesperados en los flujos de trabajo de codificación, operativos y de solución de problemas; verificar que cualquier procesamiento de datos personales cumpla con las políticas y los requisitos de protección de datos de su organización; y mantener la supervisión humana en cada control interno o punto de aprobación, especialmente antes de ejecutar cambios operativos o actuar sobre recomendaciones de solución de problemas que podrían afectar a los entornos activos.