Configure seu ambiente

Instale o UiPath CLI e as habilidades de agente de codificação, em seguida, estruture um projeto de agente do LangGraph com o uip codedagent novo.

Etapa 1 - Instalar o UiPath CLI e a ferramenta de agente codificado

O UiPath CLI (uip) é uma ferramenta de linha de comando multiplataforma para autenticação, habilidades e ferramentas de projeto da UiPath. Ela usa um sistema de ferramentas modulares: a CLI de base lida com autenticação e habilidades, e você instala ferramentas adicionais para os tipos de fluxo de trabalho que criar.

1. Instale a CLI de base globalmente usando npm:

   npm install -g @uipath/cli
   

2. Verifique a instalação:

   uip --version
   

   Você deve ver um número de versão como 1.201.0.

3. Instalar a ferramenta de agente codificada: isso adiciona o grupo de comando uip codedagent usado em todo este laboratório:

   uip tools install @uipath/codedagent-tool
   

4. Verifique se a ferramenta está instalada:

   uip tools list
   

   Você deve ver na codedagent-tool .

---

Etapa 2 - Instale habilidades da UiPath para seu agente de codificação

As habilidades ensinam seu agente de codificação a criar automações, agentes e fluxos de trabalho da UiPath. Elas são arquivos de referência instalados na configuração do seu agente de codificação, cobrindo a estrutura do projeto, padrões de integração do LLM, estruturas de avaliação e implantação. Sem habilidades, seu agente de codificação precisaria de prompts detalhados para cada padrão específico da UiPath. Com habilidades, ele já as conhece.

Instale habilidades para seu agente de codificação:

uip skills install --agent claude

Se você estiver usando um agente de codificação diferente, substitua claude pelo seu agente: cursor, copilot, gemini ou codex.

O comando relata o sucesso junto com o número de habilidades instaladas (26 no momento em que este texto está sendo escrito). A lista exata cresce com cada versão da CLI, então não se preocupe se a sua for diferente.

Para o Claude Code especificamente, as habilidades são registradas por meio de um marketplace de plug-ins do Claude Code, além de serem copiadas para seu diretório inicial (por exemplo, ~/.claude/skills/). Elas estão disponíveis em todos os projetos a partir deste ponto. Se uma reinstalação parecer obsoleta ou as habilidades não aparecerem no seu agente de codificação, execute novamente a instalação com --force, que redefine o registro do Marketplace do Claude Code e o cache de plug-in.

---

Etapa 3 - Autenticar para UiPath

1. Autentique a CLI para sua conta da UiPath:

   uip login
   

   Isso abre uma janela de navegador onde você faz login na sua conta da UiPath e seleciona seu tenant (se tiver vários). Após a conclusão, o terminal confirma que você fez logon.

2. Verifique o status do seu logon:

   uip login status
   

   Você deve ver "Status": "Logged in" junto com o nome de sua organização e do tenant.

Observação:

Uma autenticação, uma CLI. Um único uip login abrange tudo neste laboratório: execuções de agentes, avaliações e publicação de fluxos, todos pelo mesmo armazenamento de credenciais. Não é necessária nenhuma etapa de autenticação do SDK Python separada.

---

Com a CLI instalada, habilidades implementadas e sua conta autenticada, você está pronto para estruturar o projeto local na próxima seção.