Créez des agents low-code avec Coded Agents

Élaborez, 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 avec des compétences UiPath installées peut élaborer, configurer, valider et publier des agents UiPath low-code entièrement depuis 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 du projet, puis charge le résultat dans Studio Web.

Pour la configuration (installation de l'agent, connexion, installation des compétences), consultez Installer et configurer.

Prérequis

• La compétence uipath-agents installée pour votre agent de codage. Voir 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 sélectionne les bonnes commandes uip agent dans la compétence installée — vous indiquez le résultat, pas la commande.

Area	Ce que l’agent peut faire	Exemple de requête
Élaboration	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/de sortie et les ensembles d’évaluation par défaut	« Crée 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/de sortie et les paramètres du modèle LLM dans agent.json	« Mettez à jour l’invite système pour gérer les données des factures et ajoutez un champ de confiance au schéma de sortie.»
Ajouter et gérer des outils	Ajouter 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	« Ajoutez un outil de recherche SharePoint et un processus RPA pour la validation des documents.»
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); corriger automatiquement les erreurs	« Validez l’agent et corrigez 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 à modifier localement (uip solution download)	« Chargez l’agent dans Studio Web afin que je puisse l’examiner.»
Évaluer	Créer des ensembles d’évaluations et des cas de test, les exécuter par rapport au runtime de l’agent et examiner les scores et les traçages d’exécution	« Exécutez l’ensemble d’évaluations de régression et montrez-moi quels cas de test ont obtenu des notes inférieures à 0,7.»
Créer et déployer	Créez un package et publiez la solution via uip solution pack et uip solution publish, déployez-la en tant que processus et démarrez une tâche	« Déployez l'agent de facture dans le dossier Production.»

La boucle de création

L'agent de codage suit ce cycle lorsqu'il crée ou itère sur un agent low-code:

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

1. Élaborer : créez la solution avec uip solution init, puis élaborez 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 les erreurs de validation, puis revenez à l’activité Actualiser. Plusieurs cycles sont attendus et normal.

7. Charger — une fois le projet est propre, téléchargez-le vers Studio Web avec uip solution upload.

Résultat: le projet d'agent est désormais visible dans Studio Web et disponible pour révision, évaluation ou 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’outil

L'agent de codage enregistre les types d'outils en auteur directement les 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é Studio Web mais ne s'exécutent pas encore sur le runtime de l'agent.

Type d’outil	resource.json Type	S'exécute lors du runtime de l'agent
Connecteur Integration Service	integration	Oui (Yes)
Processus Orchestrator	process	Oui (non interactif)
Sous-agent	agent	Oui (Yes)
Workflow d’API	api	Inscription uniquement
Flux Maestro	processOrchestration	Inscription uniquement
IXP (Document Processing)	ixp	Inscription 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 de 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 constructions

Ouvrez votre agent de codage et décrivez l'agent souhaité. L'agent charge la compétence des Agents UiPath et gère le reste.

Que demander	Ce qui est construit
« Crée 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/de sortie structurés
« Ajoutez un agent gestionnaire 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 gestionnaire utilisant l'agent d'analyse des sentiments comme outil
« Créer un flux avec un agent d’IA pour rédiger des e-mails professionnels.»	Projet de flux avec un nœud d'agent intégré connecté aux nœuds de début et aux nœuds finaux

Évaluer 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. Charger 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 d'abord chargé.
3. Exécutez un ensemble d’évaluations et attendez les résultats.
4. Examinez les scores par cas de test, les traçages 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 de l'évaluation se termine avec succès, avec des scores visibles pour chaque cas de test et des indications claires des cas ayant réussi ou échoué.

Exemples de requêtes:

• « Crée un ensemble d’évaluation appelé tests de régression avec cinq cas de test couvrant les principaux scénarios d’entrée de factures.»
• « Exécutez l’ensemble d’évaluation des tests de régression et affichez 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 de l’outil plus explicite et réexécuter.»

Les types d’évaluateurs suivants sont disponibles:

Évaluateur	Ce qu'il mesure
Similitude sémantique	Compare la sortie attendue à la sortie réelle sur le plan sémantique
Trajectoire	Vérifie si l’agent a suivi les étapes d’utilisation et de raisonnement attendues de l’outil
Précision du contexte	Scores de 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

• Getting started with UiPath agents — hands-on lab for building and deploying a low-code agent from the CLI.
• Installation et configuration — Configuration de l'agent et installation des compétences.
• Créer des agents codés avec des agents de codage — Agents codés basés sur Python à partir d'un terminal d'agent de codage.
• Vue d’ensemble des compétences — le modèle de compétences qui détermine ce comportement.
• référence de l'agent uip — référence de commande complète pour le cycle de vie de l'agent, les outils, les évaluations, le push, le pull et le déploiement.