Configuración del entorno

Instala UiPath CLI e inicia sesión en tu cuenta de UiPath Cloud, configura tu agente de codificación con habilidades de UiPath e instala las extensiones de UiPath VS Code.

Información general

Los tutoriales de esta guía para desarrolladores de Primeros pasos utilizan una combinación de lo siguiente:

• UiPath Automation Cloud
• Interfaz de línea de comandos (CLI) de UiPath
• Herramientas de UiPath CLI (complementos)
• Extensión de UiPath Maestro para Visual Studio Code o el registro de Open VSX
• Habilidades de UiPath para agentes de codificación

Esta página centraliza los pasos de instalación necesarios para la lista anterior, con pasos de validación para confirmar que la instalación se ha realizado correctamente.

Paso 1: instala la UiPath CLI y las herramientas

UiPath CLI (uip) es una herramienta multiplataforma para la autenticación, el andamiaje de proyectos y la implementación de UiPath. Utiliza un sistema de complementos: la CLI base maneja la autenticación y tú instalas herramientas para los tipos de proyectos que creas. Consulta la lista de herramientas permitidas que se instalan automáticamente cuando las utilizas por primera vez. Cada tutorial incluirá instrucciones para aquellos que deben instalarse manualmente.

1. Instala la CLI base globalmente:

   npm install -g @uipath/cli
   

2. Verifica la instalación:

   uip --version
   

   Debería ver 1.200.0 o posterior.

3. Verifica las herramientas instaladas:

   uip tools list
   

   Confirme que ve una lista de herramientas con sus versiones instaladas.

   {
      "Result": "Success",
      "Code": "ToolList",
      "Data": [
         {
            "Name": "solution-tool",
            "Version": "1.200.0",
            "Description": "Create, pack, publish, and deploy UiPath Automation Solutions.",
            "CommandPrefix": "solution"
         },
         {
            "Name": "agent-tool",
            "Version": "1.200.0",
            "Description": "cli plugin for creating and managing UiPath low-code agents",
            "CommandPrefix": "agent"
         },
         {
            "Name": "codedagent-tool",
            "Version": "1.200.0",
            "Description": "Build, run, deploy, and manage AI Agents.",
            "CommandPrefix": "codedagent"
         },
         {
            "Name": "rpa-tool",
            "Version": "1.200.1",
            "Description": "Tool for creating and managing UiPath RPA projects",
            "CommandPrefix": "rpa"
         },
         {
            "Name": "maestro-tool",
            "Version": "1.200.0",
            "Description": "Create, debug, and run Maestro projects and jobs.",
            "CommandPrefix": "maestro"
         }
      ]
   }
   

Paso 2: instala las habilidades de UiPath para tu agente de codificación (opcional)

Si utilizas un agente de codificación (Claude Code, Cursor, Copilot, Gemini o Codex) junto con la CLI, la instalación de las habilidades de UiPath te permite conocer la estructura del proyecto del agente, los comandos CLI y las mejores prácticas. Antes de ejecutar el comando para instalar las habilidades para tu agente de codificación preferido, asegúrate de tenerlo instalado. El siguiente ejemplo instala las habilidades para Claude Code:

uip skills install --agent claude

Sustituye claude por tu agente si utilizas uno diferente. Puedes ejecutar uip skills install --help y buscar en la opción --agent <agent> la lista de agentes de codificación compatibles.

Las habilidades se instalan globalmente en tu directorio de inicio (~/.uipath/.skills/) y están disponibles en todos los proyectos a partir de este momento.

Paso 3: instala la extensión de UiPath Maestro para VS Code (opcional)

Los tutoriales que crean un Maestro Flow, un diagrama BPMN o un plan de caso utilizan esta extensión para abrir esos archivos en un lienzo visual en lugar de como texto sin formato. También inicia sesión en tu tenant y empaqueta e implementa desde el espacio de trabajo local.

1. Instala UiPath Maestro desde el VS Code Marketplace o el registro de Open VSX.

   La extensión requiere VS Code 1.110.0 o superior. Comprueba tu versión en Código > Acerca de Visual Studio Code o ejecuta code --version.

2. Vuelva a cargar VS Code cuando se le solicite.

3. Selecciona el icono de UiPath en la barra de actividad para abrir la vista de UiPath.

4. En la sección Conectar , selecciona Iniciar sesión.

5. Complete el inicio de sesión en la ventana del navegador que se abre.

   Si la CLI aún no está instalada, acepta la solicitud y la extensión la instalará por ti con npm. El inicio de sesión utiliza un flujo de navegador OAuth con una devolución de llamada en el puerto localhost 8104; si falla, un proceso obsoleto puede estar reteniendo ese puerto.

6. Ejecuta UiPath: selecciona Entorno en la Paleta de comandos (Ctrl/Cmd+Shift+P) y confirma tu entorno. El valor predeterminado es Cloud.

7. Ejecutar UiPath: selecciona Tenant y elige el tenant que deseas crear.

La extensión ahora rellenará la sección Recursos con carpetas y recursos de Orchestrator para ese tenant.

La extensión gestiona su propia copia de la CLI. No es necesario que la versión que instale coincida con la que instalaste en el Paso 1. Ejecuta uip --version después de iniciar sesión y, si se ha movido hacia atrás, npm install -g @uipath/cli te devuelve a la versión actual.

Consejo:

¿Trabajas en un espacio de trabajo remoto? En el subsistema de Windows para Linux (WSL), Secure Shell (SSH), Codespaces y espacios de trabajo de contenedores de desarrollo, la extensión se ejecuta en el host remoto, por lo que UiPath CLI debe instalarse allí en lugar de en tu máquina local.

Paso 4: autenticarse en UiPath

Después de instalar CLI, sigue los pasos a continuación para autenticarlo y selecciona el tenant que deseas usar.

1. Autentica el CLI en tu cuenta de UiPath:

   uip login
   

   Esto abre una ventana del navegador donde inicias sesión y seleccionas tu tenant. Una vez completado, el terminal confirma que has iniciado sesión.

2. Verifique su estado de inicio de sesión confirmando que ve "Status": "Logged in" ejecutando:

   uip login status
   

Ya estás listo para seguir los tutoriales.