Introdução

Crie, avalie e publique um agente LangGraph codificado usando a UiPath CLI e as habilidades do agente de codificação.

Neste laboratório, você vai instalar a UiPath CLI e as habilidades de agente de codificação, e depois usar seu agente de codificação para criar, executar e avaliar um agente do LangGraph. Você fará o seguinte:

1. Instale o UiPath CLI e as habilidades de agente de codificação.
2. Estruture um projeto local e crie um agente do LangGraph guiado por habilidades.
3. Adicione uma ferramenta de pesquisa externa em tempo real ao agente.
4. Execute e avalie o agente localmente.
5. Conecte o projeto ao UiPath Studio Web e envie sua primeira versão.

No final, você terá um agente do LangGraph em funcionamento criado por meio do seu agente de codificação, guiado por habilidades da UiPath, com rastreamentos de avaliação fluindo para o Studio Web.

Há três abordagens para criar agentes da UiPath. Isso usa o SDK do LangGraph; você também pode criar agentes usando o Agent Builder de pouco código e usando o UiPath CLI.

Tempo estimado: 45–60 minutos

O que você está criando

Este laboratório orienta você na criação de um classificador de entrada de busca para a run de um explorador fictício: um agente do LangGraph codificado que lê uma descrição de busca e a classifica em um dos quatro níveis de dificuldade.

Ele começa como um classificador simples de nó único para que o foco permaneça no fluxo de trabalho da CLI, não na lógica do domínio. Em seguida, você fornece uma ferramenta para que ele possa verificar sua resposta em relação a uma API externa em tempo real antes de finalizar um nível, em vez de adivinhar apenas pelas tendências.

Aqui está o design completo do que você está criando:

Component	Detalhes
Entrada: description	string; a descrição da busca de entrada
Saída: tier	Um tipo Literal restrito a exatamente "Trivial", "Standard", "Heroic" ou "Legendary", não uma string simples, então o modelo não pode emitir um nível fora do uso do dicionário
Saída: reasoning	string; a explicação do agente para o nível escolhido
Ferramenta: get_challenge_rating	Uma ferramenta LangGraph, chamada apenas quando uma busca nomeia ou implica uma criação específica, que pesquisa sua classificação de desafio na API do Documento de referência do sistema Open5e (SRD) e a menciona no raciocínio

Observação:

Por que adicionar uma ferramenta? Um motivo para executar um agente LangGraph no UiPath, em vez de um agente de pouco código, é a lógica complexa do Python que pode chamar sistemas externos, não apenas classificar texto. A etapa da ferramenta neste laboratório demonstra que: o agente decide no runtime se uma busca precisa de verificação, chama uma API em tempo real e raciocina sobre o resultado.

---

Pré-requisitos

• Versão da CLI – validada com o UiPath CLI v1.201.0 (instalada na Etapa 1). Versões diferentes podem se comportar de maneira diferente; reportar desvio com uip feedback send.
• Conta da UiPath — inscreva-se ou faça login no UiPath Automation Cloud antes de começar.
• Node.js 18+ - necessário para instalar a UiPath CLI. Verifique com node --version. Baixe no nodejs.org se necessário.
• VS Code com um agente de codificação (Claude Code, Copilot ou Cursor). As instruções do laboratório usam Claude Code, mas qualquer agente de codificação compatível funcionará.
• Terminal Bash - os comandos neste laboratório usam a sintaxe Bash. No VS Code, abra um novo terminal e selecione Git Bash (ou equivalente) como o tipo de terminal. A sintaxe do PowerShell e do CMD diferem e podem causar erros inesperados.
• uv - um gerenciador de pacotes rápido Python. Instale-o com:

  pip install uv
  

  ou consulte a documentação de instalação uv para ver outras opções.
• Direitos de administrador - a instalação de pacotes npm globais e dependências do Python requer permissões de administrador/elevadas. Se você estiver em um laptop de trabalho com restrições, confirme se você pode instalar pacotes antes de começar ou trabalhe com sua equipe de TI com antecedência.

Nenhum conhecimento existente da UiPath é necessário para este laboratório, mas fará com que ele seja mais rápido.

---

Observação:

Dois "agentes" neste laboratório. "Agente codificado" é o termo da UiPath para um agente Python implantado na plataforma; este laboratório cria um usando o SDK do LangGraph. As instruções do laboratório também fazem referência ao seu "agente de codificação" (Claude Code, Copilot, Cursor) para ajudar a escrever o código Python.

Quando as instruções dizerem "Perguntar ao seu agente de codificação",; eles significam seu assistente de ambiente de desenvolvimento integrado (IDE); quando eles dizerem "executar o agente" ou "seu agente do LangGraph" eles significam que o agente da UiPath está sendo criado.