À propos des agents codés

Les agents codés UiPath® sont créés en développant directement du code 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.

Vous pouvez, à l'aide d'un kit SDK UiPath, packager ce code et le déployer dans Orchestrator sous forme de package .nupkg standard, dans le flux de package 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.

Figure 1. Le processus comprend : 1) la définition de la logique de l'agent dans un IDE, 2) l'établissement d'une connexion sécurisée à UiPath, 3) le déploiement de l'agent dans Orchestrator, et 4) l'exécution de l'agent dans l'écosystème UiPath.

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 actuellement en charge :

Langue/infrastructure	Référentiel	Fonctionnalité
Python	uipath-python	Le SDK Python qui comprend une CLI permettant de créer, de mettre en package et de déployer des agents sur la plateforme UiPath Cloud. 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	Le SDK Python qui permet aux développeurs de créer et de déployer des agents LangGraph sur la plateforme UiPath Cloud. 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 la plateforme UiPath. Ce package fournit une interaction programmatique avec les services de la plateforme UiPath Cloud et la sémantique HITL (Human-in-the-loop) grâce à l’intégration d’Action Center.

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

Les SDK UiPath fournissent aux développeurs la logique nécessaire pour invoquer d'autres ressources UiPath et interagir avec elles directement dans leur code, ce qui permet une intégration transparente avec les fonctionnalités UiPath existantes. Par exemple, les développeurs peuvent utiliser des ressources UiPath pour stocker et gérer de manière sécurisée des données sensibles, accéder aux données stockées dans des compartiments de stockage UiPath et les manipuler, et établir et gérer des connexions à divers systèmes et services. En outre, les développeurs peuvent déclencher d'autres processus UiPath et interagir avec eux depuis l'agent codé.

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, son chemin d'exécution, et d'identifier les domaines à déboguer et les performances à optimiser.