Créez des agents codés avec Coding Agents

Échafaudez, écrivez, créez des packages 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 échafauder, écrire, créer un package et publier des agents basés sur Python dans UiPath Orchestrator entièrement à partir de votre terminal. Les agents codés sont des projets Python standard créés avec LangGraph, LlamaIndex ou des agents 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, journalisation, installation de compétences), consultez la section Installer et configurer.

Pour obtenir 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. Consultez la section Installer et configurer.
• Une session connectée (uip login).
• Python 3.11 ou version ultérieure.
• Le gestionnaire des packages uv.

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 SDK UiPath de votre choix, puis exécutez uip codedagent setup et uip codedagent new pour échafauder la structure du projet	« Initialiser un nouveau projet d’agent codé appelé invoice-processor. »
Écrire la logique de l’agent	Écrire et itérer sur le code de l’agent Python à l’aide de LangGraph, LlamaIndex ou des agents OpenAI	« Ajouter un outil qui appelle l’index d’ancrage dans le contexte UiPath pour vérifier la politique de l’entreprise. »
Configurer	Exécuter uip codedagent init pour connecter le projet Python à la couche d’orchestration d’UiPath	« Configurer l’agent pour UiPath Orchestrator. »
Paquet (Package)	Exécuter uip codedagent pack pour regrouper l’agent en tant qu’artefact déployable	« Créer un package de l’agent. »
Publier	Exécuter uip codedagent publish pour télécharger le package dans Orchestrator et créer automatiquement un processus	« Publier l’agent dans mon espace de travail personnel. »
Synchroniser avec Studio Web	Exécutez uip codedagent push pour charger des fichiers locaux dans le projet Studio Web distant ou uip codedagent pull pour télécharger tous les fichiers du projet distant vers votre workspace local	« Transmettre mes modifications locales vers Studio Web. »

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 codé :

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

1. Initialiser - créez un nouveau projet Python, ajoutez le SDK UiPath et échafaudez 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 - demandez à 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 de publier :

   • 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. Créer un package - créez un package de 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 :

   • Push - exécutez uip codedagent push pour charger des fichiers locaux dans le projet Studio Web distant.
   • Pull - exécutez uip codedagent pull pour télécharger tous les fichiers du projet Studio Web distant vers votre workspace local.

6. Publier - publiez l’agent avec uip codedagent publish --my-workspace pour 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 d'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 à l’infrastructure de votre agent :

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

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

Exemples de builds

Ouvrez votre agent de codage et décrivez l’agent que vous souhaitez créer. Les agents codés étant du Python standard, il n’y a aucune limite à ce que vous pouvez demander ; le SDK UiPath ajoute en outre une orchestration, une gouvernance et une intégration de la plateforme.

Que demander	Ce qui est créé
« Créer un agent codé qui recherche un sujet et produit un rapport récapitulatif. »	Agent de recherche avec des appels LLM
« Créer un agent codé qui analyse un fichier CSV fourni comme entrée. »	Agent connecté pour recevoir une pièce jointe de tâche en tant qu'entrée
« Créer 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 la 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 UiPath LangChain - Plus de 20 exemples couvrant les garde-fous, les interventions humaines, les agents distribués et les agents conversationnels.
• Exemples de 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

• Installer et configurer - configuration de l’agent et installation des compétences.
• Créez des agents low-code avec Coding Agents - 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.