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

Tableau 1. Exemples d'entrées (depuis Maestro vers 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 : « Terminer la validation du prêt pour {loan_application_number}. Réponse au format JSON utilisant le paramètre 'loan_application_status'. »

Tableau 2. Exemples de sorties (depuis l'agent vers 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

Important :

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.