Après avoir configuré votre client MCP (Model Context Protocol) avec le point de terminaison du serveur MCP approprié et des identifiants utilisateur valides, vous accédez à un ensemble d\'outils MCP permettant à un agent tiers (tel que Microsoft Copilot) d\'interagir directement avec le référentiel d\'automatisation et l\'environnement d\'exécution d\'Automation Anywhere.

Ces outils permettent aux agents IA tiers de découvrir, d\'exécuter et de récupérer les résultats des automatisations Automation Anywhere via des connexions d\'agent sécurisées.

Outil Licence de base Licence Entreprise (PRE activé)
DiscoverAutomation Non disponible Disponible
RunAutomation Non disponible Disponible
GetAutomationResult Disponible Disponible
Remarque :

Les outils DiscoverAutomation et RunAutomation nécessitent une licence Enterprise avec l\'intégration du Moteur de raisonnement des processus (Process Reasoning Engine/PRE) activée. L\'intégration du PRE est actuellement prise en charge uniquement dans les régions États-Unis et Europe.

DiscoverAutomation

L\'outil DiscoverAutomation détecte les automatisations accessibles à l\'utilisateur disposant de l\'autorisation Exécuter/Planifier dans le référentiel d\'automatisation. Cet outil permet aux agents IA de déterminer dynamiquement quelle automatisation exécuter en fonction de l\'intention de l\'utilisateur.

Fonctionnement :

  • L\'outil évalue la requête de l\'utilisateur.
  • Il recherche les automatisations et ne renvoie que celles auxquelles l\'utilisateur est autorisé à accéder. À partir de la liste des automatisations correspondantes :
    • Si neuf automatisations ou moins sont disponibles, toutes sont affichées.
    • Si plus de neuf automatisations sont disponibles, seules les neuf principales automatisations sont renvoyées.
    • Les neuf premières sont déterminées par des critères internes de pertinence et de classement. Si une automatisation ne répond pas aux critères de classement, elle peut ne pas apparaître dans les résultats par défaut.
Pour récupérer des automatisations spécifiques qui ne figurent pas dans la liste par défaut, utilisez un format de requête spécifique à l\'outil :
Discover automations to <specific task>
Par exemple :
Discover automations to create invoice in SAP
Discover automations to extract data from Salesforce

L\'utilisation de requêtes spécifiques basées sur les tâches améliore la précision des correspondances et augmente la probabilité que l\'automatisation souhaitée apparaisse dans les résultats.

Meilleures pratiques :

  • Fournir des résumés descriptifs des automatisations.
  • Limiter les automatisations inutiles dans le périmètre d\'un seul agent lorsque cela est possible.

RunAutomation

L\'outil RunAutomation exécute une automatisation qui a été identifiée via DiscoverAutomation ou explicitement spécifiée par l\'agent.

Il peut exécuter des :
  • Robots (automatisations)
  • Processus
  • Tâches API

L\'exécution est lancée à partir d\'un agent IA tiers via le serveur MCP.

Fonctionnement :

  1. L\'automatisation est identifiée.
  2. Les paramètres d\'entrée requis sont transmis.
  3. Le serveur MCP valide les autorisations.
  4. La Control Room planifie et exécute l\'automatisation.
  5. Un ID de tâche ou une référence d\'exécution est renvoyé. Cette référence est requise pour extraire le statut d\'exécution ou les résultats en utilisant GetAutomationResult.

L\'automatisation s\'exécute dans l\'environnement d\'exécution configuré et les stratégies de contrôle d\'accès basé sur les rôles (RBAC) sont appliquées. Les variables d\'entrée doivent correspondre aux paramètres attendus par l\'automatisation. Tous les événements d\'exécution sont enregistrés dans les journaux d\'audit de la Control Room.

Meilleures pratiques :

  • Des paramètres d\'entrée incorrects ou manquants peuvent entraîner l\'échec de l\'automatisation.
  • L\'automatisation doit être publiée et activée en tant que connexion d\'agent.
  • L\'utilisateur doit avoir l\'autorisation d\'exécuter l\'automatisation.
  • La configuration du réseau et des identifiants doit être valide.

Si l\'exécution échoue, utilisez GetAutomationResult pour obtenir les détails de l\'erreur.

GetAutomationResult

L\'outil GetAutomationResult extrait le statut ou le résultat d\'une automatisation qui a été lancée en utilisant RunAutomation.

Cet outil peut être utilisé avec ces deux licences :
  • Une licence de base
  • Une licence Enterprise avec PRE activé (régions États-Unis et Europe)

Fonctionnement :

  • L\'outil accepte un ID de tâche ou une référence d\'exécution.
  • Il interroge la Control Room pour obtenir le statut d\'exécution actuel, qui inclut les réponses de statut possibles suivantes :
    • En cours d\'exécution/En cours : L\'automatisation est en cours d\'exécution.
      Remarque : Si le statut est En cours d\'exécution/En cours, l\'outil peut être appelé de nouveau ultérieurement pour extraire le statut mis à jour ou le résultat final.
    • Terminé : L\'automatisation s\'est terminée avec succès. Lorsque le statut est Terminée, l\'outil renvoie toutes les variables de sortie configurées définies dans l\'automatisation. La sortie peut inclure :
      • Valeurs texte
      • Objets JSON
      • Résultats des transactions traitées
      • Autres paramètres de retour définis
    • Échec : L\'exécution de l\'automatisation a échoué. Si le statut est Échec, la réponse inclut les détails d\'erreur pertinents et les journaux pour faciliter le dépannage.

Sécurité, gouvernance et interactions avec les outils

Toutes les opérations de l\'outil MCP :

  • Imposer l\'authentification de la Control Room
  • Respecter les autorisations RBAC
  • Maintenir la journalisation d\'audit
  • Respecter les contrôles d\'accès au niveau de l\'automatisation

Seuls les utilisateurs autorisés peuvent découvrir, exécuter ou récupérer les résultats d\'automatisation.

Un flux d\'interaction typique avec un outil suit la séquence suivante :

  1. DiscoverAutomation
  2. RunAutomation
  3. GetAutomationResult
Ce flux permet à l\'agent IA :
  • D\'identifier l\'automate correct
  • De l\'exécuter en toute sécurité
  • De récupérer le résultat final

De dépanner les outils MCP

Les automatisations n\'apparaissent pas dans DiscoverAutomation
  • Confirmez les autorisations des utilisateurs.
  • Assurez-vous que l\'automatisation est publiée.
  • Utilisez une requête d\'outil plus spécifique.
  • Vérifiez si plus de neuf automatisations existent (limite des neuf premières).
L\'automatisation s\'exécute, mais aucune sortie n\'est renvoyée
  • Vérifiez que les variables de sortie sont correctement configurées.
  • Assurez-vous que les variables de sortie sont correctement mappées.
  • Confirmez que GetAutomationResult est appelé avec le bon identifiant de tâche.
Échec de RunAutomation
  • Validez les noms et les types des paramètres d\'entrée.
  • Confirmez la disponibilité de l\'environnement d\'exécution.
  • Examinez les journaux d\'audit de la Control Room.
  • Vérifiez l\'état de l\'intégration PRE (licence Entreprise uniquement).