Créez des agents codés avec Coded Agents

Élaborez, écrivez, empaquetez et publiez des agents codés basés sur Python dans UiPath Orchestrator entièrement à partir d’un agent de codage et d’un terminal.

Un agent de codage avec la compétence uipath-agents installée peut élaborer, écrire, empaqueter et publier des agents basés sur Python dans UiPath Orchestrator entièrement depuis votre terminal. Les agents codés sont des projets Python standard créés avec les agents LangGraph, LlamaIndex ou OpenAI, et UiPath gère l’orchestration, la planification, l’escalade et la gouvernance une fois l’agent déployé.

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

Pour une référence complète des commandes uip codedagent , consultez le guide CLI UiPath.

Prérequis

• La compétence uipath-agents installée pour votre agent de codage. Voir Installer et configurer.
• Une session connectée (uip login).
• Python 3.11 ou version ultérieure.
• Le gestionnaire de paquets .v

Ce que l’agent peut faire

Area	Ce que l’agent peut faire	Exemple de requête
Initialiser un projet	Créez un nouveau projet Python avec uv, ajoutez le package UiPath SDK de votre choix et exécutez uip codedagent setup et uip codedagent new pour élaborer la structure du projet	« Initialisez un nouveau projet d'agent codé appelé processus de facture.»
Écrire la logique de l’agent	Écrire et itérer sur le code de l’agent Python à l’aide des agents LangGraph, LlamaIndex ou OpenAI	« Ajoutez un outil qui appelle l’index d’ancrage dans le contexte UiPath pour vérifier la politique de l’entreprise.»
Configurer	Exécutez uip codedagent init pour connecter le projet Python à la couche d'orchestration d'UiPath	« Configurez l'agent pour UiPath Orchestrator.»
Paquet (Package)	Exécutez uip codedagent pack pour regrouper l’agent en tant qu’artefact déployable	« Empaquetez l'agent.»
Publier	Exécutez uip codedagent publish pour télécharger le package dans Orchestrator et créer automatiquement un processus	« Publie l’agent sur mon espace de travail personnel.»
Synchroniser avec Studio Web	Exécutez uip codedagent push pour télécharger des fichiers locaux dans le projet Studio Web distant, ou uip codedagent pull pour télécharger tous les fichiers du projet distant dans votre espace de travail local	« Transmettez mes modifications locales à Studio Web.»

La boucle de création

L’agent de codage suit ce cycle lors de la création ou de l’itération d’un agent codé:

Initialiser > Écrire > Évaluer > Package > Synchroniser avec Studio Web (facultatif) > Publier > Définir les variables d'environnement > Exécuter

1. Initialiser — créer un nouveau projet Python, ajouter le SDK UiPath et élaboration de la structure du projet:

   mkdir my-agent && cd my-agent
   uv init
   uv add uipath-langchain   # or uipath-llamaindex / uipath-openai-agents
   uip codedagent setup
   uip codedagent new my-agent
   uip login
   uip codedagent init
   

2. Écrire — demander à l'agent de codage d'écrire et de modifier la logique de l'agent Python. Les agents codés sont en Python standard et ne sont pas limités aux capacités spécifiques à UiPath.

3. Évaluer — testez l'agent avant la publication:

   • Analyser : demandez à l’agent de codage de configurer un ensemble de tests, de l’exécuter et d’expliquer les scores.

   • Itérer : affinez l’invite ou la logique jusqu’à ce que les résultats soient corrects.

4. Package : packagez l'agent avec uip codedagent pack pour créer un artefact déployable.

5. Synchroniser avec Studio Web (facultatif) : si vous souhaitez apporter d'autres modifications dans Studio Web:

   • Transmettre — exécutez uip codedagent push pour télécharger des fichiers locaux dans le projet Studio Web distant.
   • Extraction : exécutez uip codedagent pull pour télécharger tous les fichiers du projet Studio Web distant vers votre espace de travail local.

6. Publier : publiez l’agent avec uip codedagent publish --my-workspace pour télécharger le package dans Orchestrator. Un processus est créé automatiquement dans votre espace de travail personnel lors de la première publication.

7. Définir les variables d'environnement : dans Orchestrator, ouvrez la configuration du processus et ajoutez toutes les variables d'environnement requises (clés API, chaînes de connexion).

8. Exécuter : démarrez la tâche.

Résultat: l'agent est déployé dans Orchestrator et s'exécute en tant que processus. UiPath gère la planification, les nouvelles tentatives et la journalisation.

Packages SDK

Choisissez le package qui correspond à votre infrastructure d'agent:

Paquet (Package)	Infrastructures
uipath-langchain	LangChain/LangGraph
uipath-llamaindex	LLamaIndex
uipath-openai-agents	Agents OpenAI

Les trois packages exposent les mêmes fonctionnalités UiPath (ancrage dans le contexte, escalade humaine, garde-fous, pièces jointes de tâche) via des abstraites natives de l'infrastructure.

Exemples de constructions

Ouvrez votre agent de codage et décrivez l'agent que vous souhaitez créer. Étant donné que les agents codés sont en Python standard, il n'y a pas de limite sur ce que vous pouvez demander. Le SDK UiPath ajoute l'orchestration, la gouvernance et l'intégration de la plateforme.

Que demander	Ce qui est construit
« Crée un agent codé qui étudie un sujet et produit un rapport résumé.»	Rechercher l’agent avec des appels LLM
« Créer un agent codé qui analyse un fichier CSV fourni en entrée.»	L’agent est connecté pour recevoir une pièce jointe de tâche en tant qu’entrée
« Créez un agent codé qui utilise un index d’ancrage dans le contexte UiPath pour vérifier la politique de l’entreprise.»	Pipeline RAG (génération augmentée par récupération) par rapport à un index d’ancrage dans le contexte UiPath

Échantillon

Les référentiels suivants contiennent des implémentations de référence:

• Exemples de LangChain UiPath — plus de 20 échantillons couvrant les garde-fous, l'intervention humaine, les agents distribués et les agents conversationnels.
• Exemples LlamaIndex - Modèles d’intégration UiPath pour LlamaIndex.
• Exemples d'agents OpenAI - Modèles d'intégration UiPath pour les agents OpenAI.

Voir également

• Installation et configuration — Configuration de l'agent et installation des compétences.
• Créez des agents low-code avec des agents de codage — créez des agents Agent Builder à partir d’un agent de codage.
• Documentation du SDK UiPath Python — référence complète du SDK pour les agents codés.