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. Ajoutez un outil de recherche externe actif à l’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.

Il existe trois approches pour créer des agents UiPath. Cela utilise le SDK LangGraph; vous pouvez également créer des agents à l'aide d' Agent Builder low-code et à l'aide de la UiPath CLI.

Temps estimé: 45 à 60 minutes

Ce que vous créez

Ce lab vous guide dans la création d'un classifieur d'admission de requête pour la garde-fou d'un amuseur fictif: un agent LangGraph codé qui lit une description de requête et la trie dans l'un des quatre niveaux de difficulté.

Il commence par un simple classifieur à nœud unique de sorte que l'accent reste sur le workflow CLI, et non sur la logique du domaine. Ensuite, vous lui donnez un outil afin qu'il puisse vérifier sa réponse par rapport à une API externe active avant de finaliser un niveau, au lieu de deviner à partir de seules valeurs.

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

Composant (Component)	Détails (Details)
Entrée : description	string; description de la demande entrante
Sortie : tier	Un type Literal limité à exactement "Trivial", "Standard", "Heroic" ou "Legendary", et non une chaîne simple, pour que le modèle ne puisse pas émettre de niveau hors langage
Sortie : reasoning	string; l'explication de l'agent pour le niveau qu'il a choisi
Outil: get_challenge_rating	Un outil LangGraph, appelé uniquement lorsqu'une requête nomme ou implique une création spécifique, qui recherche sa notation de défi à partir de l' API de document de référence système Open5e et le cite dans le raisonnement

Remarque :

Pourquoi ajouter un outil? L’une des raisons d’exécuter un agent LangGraph sur UiPath, au lieu d’un agent low-code, est la logique Python complexe qui peut faire appel à des systèmes externes, et pas seulement classer du texte. L'étape de l'outil dans ce texte montre: l'agent décide au moment de l'exécution si une requête nécessite une vérification, appelle une API active et raisonne sur le résultat.

---

Prérequis

• Version CLI : validée par rapport à la UiPath CLI v1.201.0 (installé à l'étape 1). Des versions différentes peuvent se comporter différemment; signaler la dérive avec 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.

Lorsque les instructions indiquent « demander à votre agent de codage», elles désignent votre assistant d'environnement de développement intégré; lorsqu'il indique « exécuter l'agent» ou "votre agent LangGraph" elles signifient que l'agent UiPath est en cours de création.