Ambiente configurado

Instale o UiPath CLI e faça login na sua conta do UiPath Cloud, configure seu agente de codificação com habilidades da UiPath e instale as extensões do UiPath VS Code.

Visão geral

Os tutoriais neste guia de Introdução ao desenvolvedor usam uma combinação do seguinte:

• UiPath Automation Cloud
• Interface de linha de comando da UiPath (CLI)
• Ferramentas do UiPath CLI ( plugins )
• Extensão UiPath Maestro para Visual Studio Code ou o Open VSX Registry
• Habilidades da UiPath para agentes de codificação

Esta página centraliza as etapas de instalação necessárias para a lista acima, com etapas de validação para confirmar a instalação bem-sucedida.

Etapa 1 - Instalar o UiPath CLI e Ferramentas

O UiPath CLI ()uip é uma ferramenta multiplataforma para autenticação, estruturação de projetos e implantação da UiPath. Ele usa um sistema de plug-in: a CLI de base lida com a autenticação, e você instala ferramentas para os tipos de projeto que cria. Consulte a lista de permissões para ferramentas instaladas automaticamente quando você as usa pela primeira vez. Cada tutorial incluirá instruções para aqueles que precisam ser instalados manualmente.

1. Instale a CLI base globalmente:

   npm install -g @uipath/cli
   

2. Verifique a instalação:

   uip --version
   

   Você deve ver 1.200.0 ou posterior.

3. Verifique as ferramentas instaladas:

   uip tools list
   

   Confirme se você vê uma lista de ferramentas com suas versões 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"
         }
      ]
   }
   

Etapa 2 - Instale as habilidades da UiPath para seu agente de codificação (opcional)

Se você estiver usando um agente de codificação (Claude Code, Cursor, Copilot, Gemini ou Codex) ao lado do CLI, a instalação das habilidades da UiPath fornece conhecimento da estrutura do projeto do agente, comandos da CLI e práticas recomendadas. Antes de executar o comando para instalar as habilidades para seu agente de codificação preferido, primeiro certifique-se de que você o tenha instalado. O exemplo abaixo instala as habilidades para o Claude Code:

uip skills install --agent claude

Substitua claude por seu agente se você estiver usando um diferente. Você pode executar uip skills install --help e procurar a opção --agent <agent> para obter a lista de agentes de codificação compatíveis.

As habilidades são instaladas globalmente em seu diretório inicial~/.uipath/.skills/ () e estão disponíveis em todos os projetos a partir deste ponto.

Etapa 3 - Instalar a extensão UiPath Maestro para VS Code (opcional)

Os tutoriais que criam um Maestro Flow, um diagrama BPMN ou um plano de caso usam essa extensão para abrir esses arquivos em uma tela visual em vez de como texto bruto. Ele também faz login no seu tenant e pacotes e implanta a partir do espaço de trabalho local.

1. Instale o UiPath Maestro a partir do VS Code Marketplace ou do Open VSX Registry.

   A extensão requer o VS Code 1.110.0 ou superior. Verifique sua versão em Código > Sobre o Visual Studio Code ou code --version.

2. Recarregue o VS Code quando solicitado.

3. Selecione o ícone da UiPath na Barra de atividades para abrir a visualização da UiPath.

4. Na seção Conectar , selecione Entrar.

5. Conclua o login na janela do navegador que se abre.

   Se a CLI ainda não estiver instalada, aceite o prompt e a extensão a instalará para você com npm. O login usa um fluxo de navegador OAuth com um retorno de chamada na porta localhost 8104; se ela falhar, um processo obsoleto pode estar mantendo essa porta.

6. Executar o UiPath: selecione Ambiente na Paleta de Comandos (Ctrl/Cmd+Shift+P) e confirme seu ambiente. O padrão é Cloud.

7. Executar a UiPath: selecione Tenant e escolha o tenant em que você deseja criar.

A extensão agora preencherá a seção Recursos com pastas e recursos do Orchestrator para esse tenant.

A extensão gerencia sua própria cópia da CLI. A versão que ele instala não precisa corresponder à que você instalou na Etapa 1. Execute uip --version após fazer login e, se ela foi movida para trás, npm install -g @uipath/cli retorna você para a versão atual.

Dica:

Trabalhando em um espaço de trabalho remoto? No Windows Subsystem for Linux (WSL), Secure Shell (SSH), Codespaces e espaços de trabalho de contêiner dev, a extensão é executada no host remoto, portanto, o UiPath CLI deve ser instalado lá, em vez de em sua máquina local.

Etapa 4 - Autenticar para UiPath

Após instalar a CLI, siga as etapas abaixo para autentique-a e selecione o tenant a ser usado.

1. Autentique a CLI para sua conta da UiPath:

   uip login
   

   Isso abre uma janela de navegador onde você faz logon e seleciona seu tenant. Após a conclusão, o terminal confirma que você fez logon.

2. Verifique seu status de login confirmando que você vê "Status": "Logged in" executando:

   uip login status
   

Agora você está pronto para seguir os tutoriais.