Créer l'agent

Utilisez votre agent de codage et les compétences UiPath pour créer, configurer et exécuter un agent LangGraph localement.

Une fois la CLI installée, les compétences en place et votre compte authentifié, vous êtes prêt à élaborer le projet local.

Étape 4 - Configurer le projet local

Créez un nouveau dossier pour votre projet d'agent et ouvrez-le dans VS Code (Fichier → Ouvrir le dossier). Toutes les commandes de cette étape sont ensuite exécutées à partir de la racine du dossier du projet.

Créer l’environnement Python

Créez un environnement virtuel épinglé à une version de Python prise en charge et activez-le:

mkdir QuestIntake
cd QuestIntake

uv venv --python 3.13
source .venv/bin/activate

Remarque :

Windows: utilisez .venv\Scripts\activate au lieu de source .venv/bin/activate.

Remarque :

Version Python: uv télécharge et gère automatiquement Python si la version 3.13 ne se trouve pas sur votre PATH. Les versions prises en charge sont les versions 3.11, 3.12 et 3.13.

Installer l'intégration LangGraph

LangGraph est une infrastructure Python permettant de créer des agents LLM à l'état sous forme de graphiques de nœuds et de bords. uipath-langchain est la couche d'intégration UiPath qui empaquète un agent LangGraph pour le déploiement et l'évaluation sur la plate-forme UiPath.

Installez le package UiPath LangGraph dans le venv actif. Cela rend également l'infrastructure disponible pour l'élaboration du projet à l'étape suivante:

uv pip install uipath-langchain

Enregistrer Python avec la UiPath CLI

Indiquez à la CLI où se trouve l'exécutable Python compatible UiPath:

uip codedagent setup --force

Vous devriez voir "Result": "Success". Cette étape est requise une fois par machine (et après toute modification venv) avant d’utiliser les commandes uip codedagent .

Élaborer le projet

Créez la structure du projet UiPath. uip codedagent new détecte l'infrastructure installée et génère les fichiers d'élaboration du bon:

uip codedagent new QuestIntake

Cela crée des fichiers pyproject.toml, main.py, langgraph.json, uipath.json, entry-points.json, bindings.json et de contexte d'agent de codage (AGENTS.md, CLAUDE.md, .agent/). Le main.py est un espace réservé; votre agent de codage le remplace à l'étape 5.

Ajoutez la dépendance du serveur de développement local et synchronisez le fichier de verrouillage:

uv add uipath-dev --dev
uv sync

Générer des points d’entrée

Exécutez init pour générer les schémas de point d'entrée à partir du code sBuild:

uip codedagent init

Le projet dispose d'un point d'entrée d'espace réservé à cette étape. Réexécutez init à l'étape 5 après que votre agent de codage a écrit le code réel de l'agent.

---

Étape 5 - Créer l’agent avec votre agent de codage

C’est là que les compétences UiPath sont payantes. Ouvrez votre agent de codage et invitez-le à créer la logique de l’agent. L'invite ci-dessous est courte: elle décrit ce que l'agent doit faire, pas comment le créer.

La compétence uipath-agents que votre agent de codage a installée connaît déjà les modèles d'intégration LangGraph, les importations correctes de SDK, les conventions de schéma pyexécution et les exigences pertinentes du SDK. Sans ces compétences, vous devrez spécifier tout cela dans l’invite elle-même.

Utilisez l’invite suivante (ou adaptez-la à votre cas d’utilisation):

Update main.py to implement this UiPath coded agent using LangGraph as a single-node graph with no tools and no retry or error-handling logic.

The agent is a quest intake classifier for a fantasy adventurer's guild. Given a
description of an incoming quest, it classifies the difficulty as one of four tiers:
- Trivial: Simple errands anyone can handle (e.g., deliver a letter, clear rats from a cellar)
- Standard: Moderate quests requiring some skill (e.g., escort a merchant caravan)
- Heroic: Difficult quests requiring significant expertise (e.g., slay a wyvern, infiltrate a thieves' guild)
- Legendary: Extreme quests requiring top-tier heroes and special approval (e.g., defeat a lich, close a planar rift)

Return the classification tier and a brief reasoning. Use these exact field names in the State schema:
- Input field: `description` (string)
- Output fields: `tier` (a Literal type constrained to exactly "Trivial", "Standard", "Heroic", "Legendary" — not a plain string, so the model can't emit an out-of-vocabulary tier) and `reasoning` (string)

Update the existing langgraph.json to point at the new graph, and create an input.json with this exact sample quest: {"description": "Clear the rats out of the inn cellar"}.

Only touch main.py, langgraph.json, and input.json.

Don't run any uip codedagent commands or otherwise verify that the agent runs — I will do this myself.

Remarque :

Pourquoi cette invite est-elle si spécifique? Il nomme les fichiers exacts à manipuler et indique à l'agent de codage de ne pas exécuter de commandes uip codedagent ou de vérifier son propre travail. C'est délibéré ici: le reste de ce laboratoire exécute ces mêmes commandes CLI directement dans les étapes suivantes, de sorte que la vérification vous soit laissée au lieu de l'agent de codage qui l'exécute en premier.

L'invite ci-dessus est un bon modèle de démarrage pour vos propres projets, mais vous devez supprimer les deux dernières phrases pour permettre à l'agent de codage de tester son travail et d'organiser les fichiers en fonction de son propre jugement.

Important :

Les agents de codage sont non déterministes. Votre code généré sera différent de tous les exemples affichés ici; ce qui est attendu. Ce qui compte, c'est que main.py s'exécute sans erreur et renvoie une classification.

Et notez que si votre agent de codage présente une question « Livraison» (Studio Web, serveur de développement local ou ignorer), sélectionnez Ignorer - J’ai terminé pour le moment. Connectez-vous à Studio Web à l'étape 10.

Une fois l'agent de codage terminé, réexécutez init pour récupérer les points d'entrée mis à jour des nouveaux schémas Pyexécution:

uip codedagent init

Vous devriez voir la sortie confirmant que le point d'entrée a été détecté avec un diagramme graphique ASCII:

Created 'entry-points.json' file with 1 entrypoint(s).

Avant de continuer, ouvrez pyproject.toml et ajoutez une entrée authors sous [project] si ce n’est déjà fait. UiPath requiert ce champ pour compresser le projet:

authors = [{ name = "Your Name" }]

---

Lorsque l’agent est exécuté localement et que les points d’entrée sont enregistrés, vous êtes prêt à l’exécuter lors de l’étape suivante.

Étape 6 - Exécuter l’agent localement

Exécutez l'agent avec le fichier d'entrée exemple votre agent de codage créé:

uip codedagent run agent --file input.json

Vous devriez voir l'agent classer la demande et renvoyer un niveau avec un raisonnement.

Vous pouvez également transmettre l'entrée en ligne. Ces exemples utilisent la syntaxe à apostrophes Bash; si vous êtes dans PowerShell, utilisez plutôt --file avec un fichier JSON:

uip codedagent run agent '{"description": "Clear the rats out of the inn cellar"}'

Essayez vos propres entrées pour vérifier le sens des classifications, par exemple:

uip codedagent run agent '{"description": "Slay the ancient red dragon terrorizing the countryside"}'

---

Si l’agent est correctement classé, vous êtes prêt à lui donner de quoi vérifier ses réponses.