À propos des agents codés

Les Agents codés UiPath® sont créés en développant directement du code au sein de l'environnement de développement intégré (IDE) préféré d'un développeur. un développement de code direct dans l’environnement de développement intégré (IDE) préféré d’un développeur. Ils permettent aux développeurs de contrôler entièrement la logique de l'agent, son comportement et son intégration à des systèmes externes.

How coded agents work

À l'aide d'un SDK UiPath, vous pouvez empaqueter ce code et le déployer dans Orchestrator sous forme de package standard .nupkgdans un flux de packages de votre choix. À partir de là, il peut être utilisé pour créer des processus dans un ou plusieurs dossiers.

L'agent codé est déployé en tant que processus UiPath dans des dossiers Orchestrator. Une fois intégré à la plateforme, il adhère aux mêmes principes de gouvernance que les processus standard. Cela permet de le déployer de manière organisée dans des dossiers et signifie que vous pouvez planifier, déclencheur et surveiller l'exécution de l'agent, tout en l'intégrant à des workflows d'automatisation plus étendus.

L'illustration suivante décrit le processus de création, de déploiement et d'exécution d'un agent codé au sein de la plateforme UiPath.

Le processus comprend :

1. Defining the agent logic in an IDE.
2. Establishing a secure connection to UiPath.
3. Deploying the agent to Orchestrator.
4. Executing the agent within the UiPath ecosystem.

Langages et frameworks pris en charge par les SDK

La bibliothèque de SDK UiPath et les langages et frameworks qu'ils prennent en charge évoluent continuellement. Nous prenons en charge :

Langue/infrastructure	Référentiel	Fonctionnalité
Python (versions 3.11, 3.12, 3.13)	uipath-python	Le SDK Python qui comprend une CLI permettant de créer, de packager et de déployer des agents sur UiPath Platform. Il permet également d'interagir de manière programmatique avec les ressources de la plateforme UiPath, telles que les processus, les ressources, les compartiments, l'ancrage dans le contexte, les services de données, les tâches, etc.
Python avec LangGraph	Extension uipath-python : uipath-langchain-python	SDK Python qui permet aux développeurs de créer et de déployer des agents LangGraph sur UiPath Platform. Ce package permet d’interagir par programmation avec les services de la plateforme UiPath et d’intervenir par le biais d’Action Center.
LLamaIndex	uipath-llamaindex-python	SDK Python qui permet aux développeurs de créer et de déployer des agents LlamaIndex sur UiPath Platform. Ce package fournit une interaction programmatique avec les services UiPath Platform et la sémantique avec intervention humaine (HITL) via l'intégration d'Action Center.
Agents OpenAI	uipath-openai-agents	Le SDK Python qui permet aux développeurs de créer et de déployer des agents OpenAI sur UiPath Platform. Ce package fournit une interaction programmatique avec les services UiPath Platform.

Pour obtenir les dernières informations sur les mises à jour des SDK UiPath, consultez la section Politique de publication.

Fonctionnalités des agents codés

Intégrer les ressources UiPath par le biais d'un SDK

UiPath SDKs provide the logic to invoke and interact with other UiPath resources directly within your code, enabling seamless integration with existing UiPath functionalities. For example, you can:

• Use UiPath assets for secure storage and management of sensitive data.
• Access and manipulate data stored in UiPath storage buckets.
• Establish and manage connections to various systems and services.
• Trigger and interact with other UiPath processes from within the coded agent.

Pour de plus amples informations sur les ressources UiPath que vous pouvez utiliser dans votre agent codé, consultez la documentation des SDK.

Pour obtenir d’autres exemples et modèles de mise en œuvre, étudiez les exemples de projets dans notre référentiel GitHub (Python, LlamaIndex).

L'intervention humaine dans les agents codés

Vous pouvez définir des points d'interruption dans votre agent pour demander une intervention humaine. Lorsqu'une interruption est déclenchée, l'exécution de l'agent est suspendue et l'utilisateur affecté est invité à intervenir. L'exécution reprend dès que la personne concernée est intervenue.

La définition des points d'interruption varie en fonction de la langue de l'agent :

• Certains frameworks, tels que LangGraph, offrent des schémas d'interruption natifs, permettant à une personne d'intervenir lors de l'exécution de l'agent.

• Avec les SDK UiPath, vous pouvez introduire une tâche UiPath sous forme de logique d'interruption. Lorsqu'une interruption est déclenchée, l'exécution est suspendue et une tâche est créée dans Action Center.

  • Les utilisateurs peuvent examiner la progression de l'agent, fournir des commentaires ou prendre des décisions et agir en fonction de la tâche générée par le biais d'une application d'action.
  • Une fois que l'interaction humaine est terminée, l'exécution de l'agent reprend à partir du point d'interruption.

Configurer les variables d'environnement des agents codés

Vous pouvez configurer votre projet avec des variables d'environnement à l'aide de ressources secrètes, ce qui élimine la nécessité de modifier directement le code.

En tirant parti de la capacité d'Orchestrator d'intégrer ses ressources d'informations d'identification aux magasins externes d'informations d'identification tels que CyberArk, vous pouvez vous lier à votre magasin CyberArk et configurer une variable d'environnement pour que votre agent utilise cette ressource secrète. Au moment de l'exécution, Orchestrator récupère de manière sécurisée la clé auprès de CyberArk par l'intermédiaire de la ressource et la met à disposition de votre agent sous forme de variable d'environnement.

Accédez au processus de votre agent dans Orchestrator pour définir et gérer les clés API, les paramètres d'exécution et les autres valeurs de configuration qu'exige le code de votre agent. Pour plus d'informations, consultez la section Démarrer une tâche d'agent.

Activer le traçage et le débogage avec LangSmith

Configurez les variables d'environnement LangSmith standard (telles que LANGCHAIN_TRACING_V2, LANGCHAIN_API_KEY, LANGCHAIN_PROJECT) afin d'activer un traçage détaillé de l'exécution de votre agent dans LangSmith.

Cette intégration fournit des traces détaillées dans votre compte LangSmith pour chaque exécution d'un agent UiPath. Cela vous permet d’analyser le raisonnement de l’agent, le chemin d’exécution et d’identifier les zones de débogage et d’optimisation des performances.