Introduction

Créer, évaluer et publier un agent LangGraph codé à l’aide de la UiPath CLI et des compétences de l’agent de codage.

Dans ce lab, vous installerez la UiPath CLI et les compétences de l'agent de codage, puis utiliserez votre agent de codage pour créer, exécuter et évaluer un agent LangGraph. Vous allez procéder comme suit:

1. Installez la UiPath CLI et les compétences de l'agent de codage.
2. Élaborez un projet local et créez un agent LangGraph guidé par les compétences.
3. Add a live external lookup tool to the agent.
4. Exécutez et évaluez l'agent localement.
5. Connectez le projet à UiPath Studio Web et transmettez votre première version.

À la fin, un agent LangGraph de travail sera créé via votre agent de codage, guidé par les compétences UiPath, et des traçages d'évaluation passeront à 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.

Temps estimé: 45 à 60 minutes

Ce que vous créez

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.

Voici la conception complète de ce que vous créez:

Composant (Component)	Détails (Details)
Entrée : description	string; the incoming quest description
Sortie : 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
Sortie : 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

Remarque :

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érequis

• CLI version - validated against UiPath CLI v1.201.0 (installed in Step 1). Different versions may behave differently; report drift with uip feedback send.
• Compte UiPath : inscrivez-vous ou connectez-vous sur UiPath Automation Cloud avant de commencer.
• Node.js 18+ : requis pour installer la UiPath CLI. Vérifiez avec node --version. Téléchargez depuis nodejs.org si nécessaire.
• VS Code avec un agent de codage (Claude Code, Copilot ou Cursor). Les instructions de laboratoire utilisent Claude Code, mais tout agent de codage pris en charge fonctionnera.
• Terminal Bash : les commandes de ce magasin utilisent la syntaxe Bash. Dans VS Code, ouvrez un nouveau terminal et sélectionnez Git Bash (ou équivalent) comme type de terminal. Les syntaxes PowerShell et CMD sont différentes et peuvent provoquer des erreurs inattendues.
• uv - un gestionnaire de packages Python rapide. Installez-le avec:

  pip install uv
  

  ou consultez les documents d'installation uv pour d'autres options.
• Droits d’administrateur - l’installation des packages npm globaux et des dépendances Python nécessite des autorisations administratives/levées. Si vous utilisez un ordinateur portable professionnel comportant des restrictions, confirmez que vous pouvez installer des packages avant de commencer, ou travailler avec votre équipe informatique à l'avance.

Aucune connaissance existante d’UiPath n’est requise pour ce lab, mais cela permettra de le rendre plus rapide.

---

Remarque :

Deux « agents» dans ce lab. « Agent codé» est le terme d'UiPath pour un agent Python déployé sur la plateforme; ce lab en crée une à l'aide du SDK LangGraph. Les instructions du laboratoire font également référence à votre « agent de codage» (Claude Code, Copilot, Cursor) pour aider à écrire le code 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.