Créer des agents low-code avec Coding Agents

Échafaudez, configurez, évaluez et publiez les agents low-code UiPath entièrement à partir d'un agent de codage et d'un terminal, sans navigateur après la connexion initiale.

Un agent de codage doté de compétences UiPath installées peut échafauder, configurer, valider et publier des agents low-code UiPath entièrement à partir de votre terminal ; aucun navigateur requis après la connexion initiale. Vous décrivez l’agent que vous souhaitez créer, l’agent de codage crée et itère les fichiers de projet et télécharge le résultat dans Studio Web.

Pour la configuration (installation de l’agent, journalisation, installation de compétences), consultez la section Installer et configurer.

Prérequis

• La compétence uipath-agents installée pour votre agent. Consultez la section Installer et configurer.
• Une session connectée (uip login).

Ce que l’agent peut faire

Chaque ligne couvre une étape du cycle de vie de l’agent. L’agent de codage choisit les bonnes commandes uip agent dans la compétence installée ; vous précisez le résultat et non la commande.

Area	Ce que l’agent peut faire	Exemple de requête
Échafaudage	Créez un nouveau projet d’agent avec la structure de répertoire complète, y compris agent.json, les schémas d’entrée/sortie et les ensembles d’évaluation par défaut	« Créer un nouvel agent d'analyse des sentiments pour les commentaires entrants sur les réseaux sociaux. »
Configurer les invites et les schémas	Modifiez l’invite système, le modèle de message utilisateur, les schémas d’entrée/sortie et les paramètres du modèle LLM dans agent.json	« Mettre à jour l’invite système pour gérer les données de facture et ajouter un champ de confiance au schéma de sortie. »
Ajouter et gérer des outils	Ajoutez des processus RPA, d'autres agents, des workflows d'API, des flux Maestro, des outils de connecteur Integration Service, un ancrage dans le contexte et des applications d'escalade	« Ajouter un outil de recherche SharePoint et un processus RPA pour la validation du document. »
Actualiser et valider	Exécutez uip agent refresh pour écrire des artefacts et synchroniser les schémas de point d’entrée, puis uip agent validate pour vérifier la structure JSON (lecture seule) ; corrigez les erreurs automatiquement	« Valider l’agent et corriger les erreurs. »
Charger et télécharger	Chargez le projet local dans Studio Web (uip solution upload) ou téléchargez une solution Studio Web existante pour modifier localement (uip solution download)	« Charger l’agent dans Studio Web afin que je puisse l’examiner. »
Évaluer	Créer des ensembles d’évaluation et des cas de test, les exécuter par rapport au runtime de l’agent et examiner les scores et les traces d’exécution	« Exécuter l’ensemble d’évaluation de régression et me montrer les cas de test dont la note est inférieure à 0,7. »
Créer un package et déployer	Créer un package et publier la solution via uip solution pack et uip solution publish, déployer en tant que processus et démarrer une tâche	« Déployer l’agent de facture dans le dossier Production. »

La boucle de création

L’agent de codage suit ce cycle lors de la création ou de l’itération sur un agent low-code :

Échafauder > Configurer > Ajouter des ressources > Actualiser > Valider > Corriger > Télécharger

1. Échafauder - créez la solution avec uip solution init, puis échafaudez l’agent avec uip agent init.

2. Configurer - définissez les invites, les schémas et les paramètres du modèle dans agent.json.

3. Ajouter des ressources - créez un fichier resource.json sous resources/<tool-name>/ pour chaque outil dont l'agent a besoin.

4. Actualiser - écrivez des artefacts et synchronisez les schémas de point d’entrée avec uip agent refresh.

5. Valider - vérifiez la structure JSON avec uip agent validate (lecture seule).

6. Corriger - corrigez toutes les erreurs de validation, puis revenez à Actualiser. Plusieurs cycles sont attendus et normaux.

7. Charger - une fois que le projet est propre, chargez-le dans Studio Web avec uip solution upload.

Résultat : le projet de l'agent est désormais visible dans Studio Web et disponible pour l'examen, l'évaluation ou le déploiement.

Structure du projet d’agent

Lorsque l’agent de codage exécute uip solution init et uip agent init, il crée la structure suivante :

<AgentName>/
├── agent.json               # System prompt, user message template, LLM settings, input/output schemas
├── project.json             # Project metadata
├── entry-points.json        # Entry point definitions, kept in sync with agent.json schemas
├── bindings_v2.json         # Resource binding references
├── SolutionStorage.json     # Written after push — captures the Studio Web solution ID
│
├── resources/               # One directory per tool
│   └── <tool-name>/
│       └── resource.json    # Tool config: type, connector key, schema, connection ID
│
├── connections/             # Connection references for bound Integration Service tools
│
├── evals/                   # Evaluation configuration
│   ├── evaluators/          # Evaluator definitions (semantic similarity, trajectory by default)
│   └── eval-sets/           # Test case collections
│
└── userProfile/
    └── debug_overwrites.json  # Local connection overrides for debugging

Types d’outils

L’agent de codage enregistre les types d’outils en créant directement des fichiers resource.json sous resources/<tool-name>/. Le champ type de chaque fichier détermine le type d’outil. La prise en charge de l’exécution du runtime varie - certains types peuvent être enregistrés pour la compatibilité avec Studio Web, mais ne s’exécutent pas encore dans le runtime de l’agent.

Type d’outil	resource.json Type	S'exécute sur le runtime de l'agent
Connecteur Integration Service	integration	Oui (Yes)
Processus Orchestrator (RPA)	process	Oui (non interactif)
Sous-agent	agent	Oui (Yes)
Workflow d’API	api	Enregistrement uniquement
Flux Maestro	processOrchestration	Enregistrement uniquement
IXP (traitement de documents)	ixp	Enregistrement uniquement

L'ancrage dans le contexte, les applications d'escalade et les serveurs MCP sont ajoutés en tant que ressources de solution distinctes plutôt que des fichiers resource.json de type outil. L’agent de codage les crée et les synchronise dans le projet avec uip solution resources refresh.

Exemples de builds

Ouvrez votre agent de codage et décrivez l’agent que vous souhaitez. L’agent charge la compétence UiPath Agents et gère le reste.

Que demander	Ce qui est créé
« Créer un nouvel agent d'analyse des sentiments pour les commentaires entrants sur les réseaux sociaux. »	Agent autonome avec une invite système personnalisée et des schémas d'entrée/sortie structurés
« Ajouter un agent de gestion des réseaux sociaux qui délègue à l’agent d’analyse des sentiments pour gérer un lot de commentaires entrants. »	Solution multi-agents avec un agent de gestion utilisant l’agent d’analyse des sentiments comme outil
« Créez-moi un flux avec un agent d'IA pour la rédaction d'e-mails professionnels. »	Projet Flow avec un nœud d’agent en ligne connecté aux nœuds de début et de fin

Évaluation de votre agent

L’agent de codage peut piloter une boucle complète créer-évaluer-améliorer :

1. Créez et configurez l’agent localement.
2. Téléverser vers Studio Web (uip solution upload) - les évaluations s'exécutent par rapport au runtime de l'agent et nécessitent que le projet soit téléversé en premier.
3. Exécutez un ensemble d'évaluation et attendez les résultats.
4. Examinez les scores par cas de test, les traces d'exécution et les messages d'échec.
5. Ajustez les invites ou la configuration en fonction des échecs.
6. Chargez l’agent mis à jour (uip solution upload).
7. Réexécutez l’ensemble d’évaluation.

Résultat : l’exécution d’évaluation se termine avec succès, avec des scores visibles pour chaque cas de test et des indications claires sur les cas ayant réussi ou ayant échoué.

L’exemple demande :

• « Créer un ensemble d'évaluation appelé régression-tests avec cinq cas de test couvrant les principaux scénarios d'entrée de facture. »
• « Exécuter l'ensemble d'évaluation régression-tests et afficher les résultats. »
• « Le troisième cas de test a échoué avec un score de trajectoire faible - mettez à jour l’invite système pour rendre la sélection d’outils plus explicite et réexécutez. »

Les types d’évaluateurs suivants sont disponibles :

Évaluateur	Ce qu'il mesure
Similitude sémantique	Compare sémantiquement la sortie attendue à la sortie réelle
Trajectoire	Vérifie si l’agent a suivi les étapes d’utilisation et de raisonnement attendues de l’outil
Précision du contexte	Note la pertinence du contexte récupéré par rapport à la requête
Fidélité	Note si les réponses de l’agent sont ancrées dans le contexte fourni

Voir également

• Mise en route avec les agents UiPath - laboratoire pratique pour la création et le déploiement d’un agent low-code à partir de la CLI.
• Installer et configurer - configuration de l’agent et installation des compétences.
• Créer des agents codés avec Coding Agents - agents codés basés sur Python à partir d'un terminal d'agent.
• Vue d'ensemble des compétences - le modèle de compétences qui entraîne ce comportement.
• Référence de l'agent uip - référence complète des commandes pour le cycle de vie de l'agent, les outils, les évaluations, le push, le pull et le déploiement.