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.1.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 emite JSON listando as habilidades instaladas. O catálogo de habilidades cresce com cada versão do CLI; sua saída pode incluir mais habilidades do que as mostradas aqui. O seguinte reflete a CLI v1.1.0:

{
  "Result": "Success",
  "Code": "SkillsInstall",
  "Data": {
    "RootDir": "C:\\Users\\<you>",
    "Skills": [
      "uipath-agents",
      "uipath-coded-apps",
      "uipath-data-fabric",
      "uipath-diagnostics",
      "uipath-feedback",
      "uipath-gov-access-policy",
      "uipath-gov-aops-policy",
      "uipath-human-in-the-loop",
      "uipath-interact",
      "uipath-maestro-case",
      "uipath-maestro-flow",
      "uipath-planner",
      "uipath-platform",
      "uipath-review",
      "uipath-rpa",
      "uipath-rpa-legacy",
      "uipath-solution-design",
      "uipath-tasks",
      "uipath-test"
    ],
    "Agents": ["claude"],
    "Installed": 19
  }
}

As habilidades são instaladas globalmente em seu diretório inicial (por exemplo, para ~/.claude/skills/ Code). Elas estão disponíveis em todos os projetos a partir deste ponto.

---

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.