Agents codés dans Studio Web

Remarque :

Les agents codés dans Studio Web sont en aperçu.

Les agents codés vous permettent de définir le comportement de l'agent directement dans Python tout en bénéficiant de l'orchestration, de l'évaluation et de l'observabilité UiPath. Studio Web agit comme le plan de contrôle, tandis que votre environnement de développement intégré (IDE) reste l’environnement de développement principal.

Après avoir connecté votre projet local, Studio Web fournit un accès à :

• Définition - Une vue de haut niveau des points d’entrée et de la configuration de l’agent.
• Code source - Une vue en lecture seule des fichiers synchronisés. Votre IDE reste la source faisant autorité.
• Ensembles d'évaluations - Cas de test pour valider le comportement de l'agent.
• Évaluateurs - Évaluateurs basés sur la sortie et la trajectoire utilisés pendant les exécutions d’évaluation.

À partir de Studio Web, vous pouvez exécuter Debug ou Debug étape par étape, exécuter des évaluations dans l’espace Évaluations et publier l’agent pour une utilisation en production. Les agents publiés émettent des traces visibles dans l’espace Traces d’agent et peuvent être gérés à partir de la page Gestion des agents UiPath.

Prérequis

• Vous disposez de Python 3.11 ou version ultérieure et avez installé soit pip soit uv.
• Vous avez créé, initialisé et testé votre projet d’agent codé localement. Suivez le guide de démarrage rapide de votre framework :
  • Core Python SDK
  • LangChain (LangGraph)
  • LLamaIndex
  • Agents OpenAI
• Vous avez accès à Studio Web avec une solution ouverte ou prête à être créée.

Créer un agent codé dans Studio Web

1. Accédez à studio.uipath.com.
2. Sélectionnez Créer nouveau, puis sélectionnez Agent.
3. Sélectionnez Codé comme type d’agent.

Résultat : Studio Web crée un shell d'agent codé et ouvre la page Configurer votre agent codé.

Connecter votre projet local à Studio Web

Sur la page Configurer votre agent codé, Studio Web vous guide tout au long de la liaison de votre projet Python local à l’agent.

Copier la clé du projet

1. Sur la page Configurer votre agent codé, copiez la clé de projet d’agent. Studio Web génère automatiquement cette clé pour chaque projet de solution.

2. Dans votre projet local, ouvrez le fichier .env.

3. Ajoutez la ligne suivante, en remplaçant <project-id-from-studio> par la clé que vous avez copiée :

   UIPATH_PROJECT_ID=<project-id-from-studio>
   

Cette clé lie votre projet local à l’agent dans Studio Web.

Transférer votre projet vers Studio Web

1. Ouvrez un terminal dans votre répertoire de projets local.

2. Exécutez la commande suivante :

   uipath push
   

Résultat : Studio Web synchronise les fichiers suivants à partir de votre projet local et charge automatiquement le contenu de l’agent codé :

• Fichiers source (par exemple, graph.py, entry-points.json)
• Fichiers de configuration (pyproject.toml, uipath.json)
• Ressources d’évaluation (évaluateurs, ensembles d’évaluations)
• Métadonnées et liaisons