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 py tant que l'exigence d'initialisation LLM (le client LLM doit être initialisé dans la fonction de nœud, et non au moment du chargement du module — UiPath le runtime du conteneur ne prend pas en charge les objets LLM au niveau du module; consultez le démarrage rapide du SDK pour obtenir un exemple pratique). Sans 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):

Create a UiPath coded agent using LangGraph.

The agent is a quest intake classifier for a D&D 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` (string) and `reasoning` (string)

Create a langgraph.json and an input.json with a sample D&D quest for testing.

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.

Remarque :

Question sur la livraison: si votre agent de codage présente une question de « 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 9.

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" }]

---

Avec l'agent exécuté localement et les points d'entrée enregistrés, vous êtes prêt à l'exécuter et à créer un ensemble d'évaluation dans la section suivante.