- Introduction
- Démarrage
- Modélisation des processus
- Understanding Process modeling
- Opening the modeling canvas
- Modéliser votre processus
- Aligning and connecting BPMN elements
- Autopilot™ pour Maestro (version préliminaire)
- Implémentation des processus
- Managing files with Data Fabric
- Utilisation d’agents dans Maestro
- Règles métier (version préliminaire)
- Process Apps (version préliminaire)
- Débogage
- Simulating
- Publication et mise à niveau des processus agentiques
- Scénarios de mise en œuvre courants
- Extraire et valider des documents
- Opérations de processus
- Surveillance des processus
- Optimisation des processus
- Informations de référence
Guide de l'utilisateur de 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.
- 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.
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.
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.
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.
- 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.
- 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.
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.
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.
{
"key1": "value1",
"key2": "value2"
}{
"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
Example Inputs (from Maestro to 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'. »
Example outputs (from agent to 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 |
