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.

The command reports success along with the number of skills installed (26 as of this writing). The exact list grows with each CLI release, so do not worry if yours differs.

For Claude Code specifically, skills are registered through a Claude Code plugin marketplace in addition to being copied to your home directory (for example, ~/.claude/skills/). They are available in every project from this point forward. If a re-install looks stale or skills don't show up in your coding agent, re-run the install with --force, which resets the Claude Code marketplace registration and plugin cache.

---

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.