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. Add a live external lookup tool to the agent.
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.

There are three approaches to create UiPath agents. This uses the LangGraph SDK; you can also create agents using the low-code Agent Builder and using the UiPath CLI.

Tempo estimado: 45–60 minutos

O que você está criando

This lab walks you through building a quest intake classifier for a fictional adventurer's guild: a coded LangGraph agent that reads a quest description and sorts it into one of four difficulty tiers.

It starts as a simple, single-node classifier so the focus stays on the CLI workflow, not the domain logic. Then you give it a tool so it can check its answer against a live external API before finalizing a tier, instead of guessing from vibes alone.

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

Component	Detalhes
Entrada: description	string; the incoming quest description
Saída: tier	A Literal type constrained to exactly "Trivial", "Standard", "Heroic", or "Legendary", not a plain string, so the model cannot emit an out-of-vocabulary tier
Saída: reasoning	string; the agent's explanation for the tier it chose
Tool: get_challenge_rating	A LangGraph tool, called only when a quest names or implies a specific creature, that looks up its challenge rating from the Open5e System Reference Document (SRD) API and cites it in the reasoning

Observação:

Why add a tool at all? A driving reason to run a LangGraph agent on UiPath, instead of a low-code agent, is complex Python logic that can call out to external systems, not just classify text. The tool step in this lab demonstrates that: the agent decides at runtime whether a quest needs verification, calls a live API, and reasons over the result.

---

Pré-requisitos

• CLI version - validated against UiPath CLI v1.201.0 (installed in Step 1). Different versions may behave differently; report drift with 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.

When the instructions say "ask your coding agent," they mean your integrated development environment (IDE) assistant; when they say "run the agent" or "your LangGraph agent," they mean the UiPath agent being built.