Utilisation d’agents dans Maestro

Fonctionnement des agents dans Maestro

Les agents sont représentés dans les workflows Maestro BPMN en tant que Tâches de service. Lorsque votre processus appelle une tâche de service, Maestro invoque l'agent correspondant avec les paramètres d'entrée requis pour une instance de processus spécifique.

Les agents renvoient les données de sortie à Maestro, qui sont utilisées pour déterminer les étapes suivantes du workflow. Vous pouvez configurer les agents pour signaler les outils utilisés, les décisions prises et les données de traçage pour faciliter le débogage et la transparence.

Les agents peuvent être :

• Création directe dans la plateforme UiPath (low-code ou codé)
• Connecté via des API externes ou Integration Service
• Déclenché par des événements ou des signaux basés sur la logique du workflow

Découvrez un exemple concret : UiPath Maestro, le cerveau à l'origine de l'automatisation transparente des prêts.

Connexion des agents via Integration Service

UiPath Integration Service fournit des connecteurs prêts à l'emploi et sur mesure pour intégrer des systèmes externes dans vos automatisations :

• Connecteurs préconfigurés pour des services tels que Salesforce, Microsoft 365 et Google Workspace
• Générateur de connecteurs personnalisés pour exposer toute API REST à la plateforme UiPath
• Gestion unifiée des informations d’identification et des connexions

Utilisez Integration Service pour permettre à Maestro d'envoyer/recevoir des données d'agents ou de systèmes qui ne sont pas hébergés nativement dans UiPath. En savoir plus sur Integration Service.

Utilisation d’agents externes

Maestro est neutre vis-à-vis du fournisseur. Vous pouvez orchestrer le travail avec vos Agents d'IA externes préférés, sans reconstruire vos Processes, à l'aide des connecteurs UiPath Integration Service.

Vous pouvez orchestrer :

• Services d’IA propriétaires
• Moteurs de décision externes
• Microservices ou bots hébergés sur d’autres plateformes

Maestro invoque ces agents en appelant des points de terminaison REST et s'attend à une réponse contenant des données structurées.

Connexion des agents externes via Integration Service

Au moment de la conception, ajoutez une tâche de service, choisissez Démarrer et attendez l'agent externe, puis configurez l'activité de l'agent depuis le connecteur sélectionné. Au moment du runtime, Maestro envoie la requête et le contexte à l'agent et attend la réponse. Vous associez cette réponse à des variables pour piloter les passerelles, les affectations et les actions suivantes.

Les liens suivants montrent comment connecter un agent externe, l'exécuter à partir d'un processus Maestro et capturer sa sortie pour le routage et les décisions :

• Agents Snowflake Cortex
• Agents Databricks
• Agents Azure AI Foundry
• Démarrer l'agent CrewAI (aperçu)
• Exécuter l'agent Google Vertex

Démarrage rapide : Intégrations de workflow d'API

Préférez les connecteurs Integration Service lorsqu'ils existent. Utilisez des workflows d'API lorsque vous avez besoin d'une connectivité au niveau de l'API (premières API, schémas en évolution ou flux de réponses). Définissez les requêtes et les sorties de manière déclarative, analysez JSON sans code personnalisé et transmettez les résultats dans votre processus Maestro.

Quand utiliser lesquelles :

• Connecteur : Système pris en charge, schéma stable, authentification gérée, meilleur choix à long terme.
• Workflow d'API : API nouvelle ou non prise en charge, modification des formats de réponse ou sortie en streaming uniquement.

Guides étape par étape

• Snowflake Cortex – Workflow d'API : Gérez la sortie de flux de l'agent Cortex, assemblez-la dans une réponse utilisable et renvoyez un fichier JSON structuré pour l'automatisation en aval.
• Databricks Genie – workflow d'API : Démarrez une conversation, interrogez le statut du message jusqu'à ce que ce soit TERMINÉ, extrayez le SQL généré (attachment_id), exécutez-le et renvoyez la réponse.

Configuration des propriétés de l’agent

Dans Maestro, les agents sont traités comme des participants à un processus métier. Dans un workflow BPMN, les agents sont représentés à l'aide de tâches de service, qui peuvent invoquer à la fois des agents hébergés par UiPath et des agents externes. Chaque tâche d'agent peut être configurée avec des paramètres d'entrée et de sortie spécifiques, ce qui permet à Maestro de transmettre des données contextuelles à l'agent et de recevoir des résultats structurés en retour.

Pour obtenir un aperçu des Tâches de service dans Maestro, consultez la section Tâches de la modélisation BPMN.

Modes d’exécution de l’agent

Le comportement de l'agent est défini dans le panneau Propriétés d'une tâche de service. Vous pouvez configurer la tâche pour appeler un agent UiPath ou un agent externe, en fonction des besoins de votre entreprise.

Démarrer et attendre un agent

Utilisez cette option pour invoquer un agent déployé dans votre locataire UiPath. Cela implique les éléments suivants :

• Des Agents low-code créés à l'aide d'outils tels qu'Agent Builder.
• Des Agents codés développés en Python ou d'autres langages et déployés dans Orchestrator.

Lors du runtime, Maestro envoie des paramètres d'entrée à l'agent au format JSON. Lorsque l’agent termine l’exécution, il renvoie une réponse contenant les valeurs de sortie attendues par le processus.

Démarrer et attendre un agent externe

Utilisez cette option pour vous connecter à des systèmes tiers ou externes. Vous devez spécifier les éléments suivants :

• Connecteur : la cible de l'intégration (par exemple, CrewAI, Salesforce ou un autre service)

• Connexion : une instance configurée du connecteur, représentant un agent spécifique ou un ensemble d'informations d'identification spécifiques au contexte.

  Remarque :

  Vous pouvez utiliser le même agent avec des autorisations ou des comportements différents en définissant plusieurs connexions.

  

Entrées et sorties

Les entrées et les sorties des agents sont configurées de la même manière que les autres types de tâches Maestro.

• Entrées : variables ou expressions transmises à l'agent au runtime.
• Sorties : variables renseignées à partir de la réponse JSON de l'agent.

Maestro envoie les paramètres d'entrée sous forme de données JSON au format :

{
  "key1": "value1",
  "key2": "value2"
}

L'agent doit renvoyer une réponse JSON en utilisant les mêmes noms de paramètres attendus par Maestro. Ces valeurs sont mappées aux variables de processus à l'aide de la section Sortie > Réponse du panneau Propriétés de la tâche.

Exemples d'entrée et de sortie

Exemples d'entrées (de Maestro à l'agent) :

Paramètre	Description
role	Rôle ou contexte de la tâche (par exemple, validation ou résumé)
prompt	Instructions fournies à l’agent, incluant souvent des données spécifiques à un processus
tools	Liste des outils que l'agent peut utiliser pour effectuer la tâche
user_id	Identifiant unique partagé entre le processus et le contexte de l'agent

Exemple d'invite :"Complete loan validation for {loan_application_number}. Respond in JSON format using the parameter 'loan_application_status'."

Exemples de sorties (de l'agent à Maestro)

Paramètre	Description
conversation_id	Référence à la session de dialogue ou d'interaction
loan_application_status	Résultat de statut renvoyé par l’agent
tokens_used	Métadonnées sur l'utilisation des ressources

Avertissement :

Pour utiliser la sortie de l'agent dans votre workflow, vous devez affecter chaque paramètre de sortie à une variable de processus dans la configuration des paramètres de Sortie > Réponse de la tâche.