Nachdem Sie Ihren MCP-Client (Model Context Protocol) mit dem entsprechenden MCP-Server-Endpunkt und gültigen Anmeldeinformationen konfiguriert haben, erhalten Sie Zugriff auf eine Reihe von MCP-Tools, mit denen ein Drittanbieter-Agent (wie Microsoft Copilot) direkt mit dem Automatisierungs-Repository und der Laufzeit von Automation Anywhere interagieren kann.

Diese Tools ermöglichen es Drittanbieter-KI-Agents, Automation Anywhere-Automatisierungen über sichere Agentenverbindungen zu entdecken, auszuführen und Ergebnisse abzurufen.

Tool Basislizenz Enterprise-Lizenz (PRE aktiviert)
DiscoverAutomation Nicht verfügbar Verfügbar
RunAutomation Nicht verfügbar Verfügbar
GetAutomationResult Verfügbar Verfügbar
Anmerkung:

Die DiscoverAutomation- und RunAutomation-Tools erfordern eine Enterprise-Lizenz mit aktivierter Process Reasoning Engine (PRE)-Integration. Die PRE-Integration wird derzeit nur in den Regionen USA und Europa unterstützt.

DiscoverAutomation

Das DiscoverAutomation-Tool findet Automatisierungen, auf die der Benutzer mit der Berechtigung Ausführen/Planen im Automatisierungs-Repository zugreifen kann. Mit diesem Tool können KI-Agents dynamisch bestimmen, welche Automatisierung basierend auf der Benutzerabsicht ausgeführt werden soll.

So funktioniert\'s:

  • Das Tool bewertet die Anfrage des Benutzers.
  • Es durchsucht die Automatisierungen und gibt nur diejenigen Automatisierungen zurück, auf die der Benutzer zugriffsberechtigt ist. Aus der Liste der passenden Automatisierungen:
    • Wenn neun oder weniger Automatisierungen verfügbar sind, werden alle angezeigt.
    • Wenn mehr als neun Automatisierungen verfügbar sind, werden nur die neun wichtigsten Automatisierungen zurückgegeben.
    • Die besten neun werden anhand interner Relevanz- und Ranking-Kriterien ermittelt. Wenn eine Automatisierung die Bewertungskriterien nicht erfüllt, wird sie möglicherweise nicht in den Standardergebnissen angezeigt.
Um bestimmte Automatisierungen abzurufen, die nicht in der Standardliste angezeigt werden, verwenden Sie ein tool-spezifisches Abfrageformat:
Discover automations to <specific task>
Beispiel:
Discover automations to create invoice in SAP
Discover automations to extract data from Salesforce

Die Verwendung spezifischer, auf Aufgaben basierender Abfragen verbessert die Übereinstimmungsgenauigkeit und erhöht die Wahrscheinlichkeit, dass die gewünschte Automatisierung in den Ergebnissen erscheint.

Best Practices:

  • Geben Sie beschreibende Zusammenfassungen für Automatisierungen an.
  • Begrenzen Sie nach Möglichkeit unnötige Automatisierungen im Geltungsbereich eines einzelnen Agents.

RunAutomation

Das RunAutomation-Tool führt eine Automatisierung aus, die entweder durch DiscoverAutomation identifiziert oder explizit vom Agent angegeben wurde.

Es kann ausführen:
  • Bots (Automatisierungen)
  • Prozesse
  • API-Aufgaben

Die Ausführung wird von einem Drittanbieter-KI-Agent über den MCP-Server initiiert.

So funktioniert\'s:

  1. Die Automatisierung ist identifiziert.
  2. Erforderliche Eingabeparameter werden übergeben.
  3. Der MCP-Server überprüft Berechtigungen.
  4. Der Control Room plant und führt die Automatisierung aus.
  5. Eine Job-ID oder Ausführungsreferenz wird zurückgegeben. Diese Referenz ist erforderlich, um den Ausführungsstatus oder die Ergebnisse mit GetAutomationResult abzurufen.

Die Automatisierung läuft in der konfigurierten Laufzeitumgebung und rollenbasierte Zugriffssteuerungsrichtlinien (RBAC) werden durchgesetzt. Eingabevariablen müssen mit den erwarteten Parametern der Automatisierung übereinstimmen. Alle Ausführungsereignisse werden in das Auditprotokoll des Control Room protokolliert.

Best Practices:

  • Falsche oder fehlende Eingabeparameter können zu einem Ausfall der Automatisierung führen.
  • Die Automatisierung muss veröffentlicht und als Agent-Verbindung aktiviert werden.
  • Der Benutzer muss die Berechtigung haben, die Automatisierung auszuführen.
  • Netzwerk- und Anmeldeinformationskonfiguration müssen gültig sein.

Wenn die Ausführung fehlschlägt, verwenden Sie GetAutomationResult, um Fehlerdetails abzurufen.

GetAutomationResult

Das Tool GetAutomationResult ruft den Status oder die Ausgabe einer Automatisierung ab, die mit RunAutomation gestartet wurde.

Dieses Tool kann verwendet werden entweder mit:
  • Einer Basislizenz
  • Einer Enterprise-Lizenz mit aktiviertem PRE (USA- und Europa-Regionen)

So funktioniert\'s:

  • Das Tool akzeptiert eine Job-ID oder eine Ausführungsreferenz.
  • Es fragt den Control Room nach dem aktuellen Ausführungsstatus ab, der folgende mögliche Statusantworten umfasst:
    • Wird ausgeführt/In Bearbeitung: Die Automatisierung wird derzeit ausgeführt.
      Anmerkung: Wenn der Status „Wird ausgeführt“ oder „In Bearbeitung“ ist, kann das Tool später erneut aufgerufen werden, um den aktualisierten Status oder das Endergebnis abzurufen.
    • Abgeschlossen: Die Automatisierung wurde erfolgreich abgeschlossen. Wenn der Status auf „Abgeschlossen“ steht, gibt das Tool alle in der Automatisierung definierten konfigurierten Ausgabewerte zurück. Die Ausgabe kann Folgendes enthalten:
      • Textwerte
      • JSON-Objekte
      • Verarbeitete Transaktionsergebnisse
      • Andere definierte Rückgabeparameter
    • Fehlgeschlagen: Ausführen der Automatisierung fehlgeschlagen. Wenn der Status „Fehlgeschlagen“ lautet, enthält die Antwort relevante Fehlerinformationen und Protokolle zur Unterstützung bei der Fehlerbehebung.

Sicherheit, Governance und Tool-Interaktionen

Alle MCP-Tool-Operationen:

  • Control Room-Authentifizierung erzwingen
  • RBAC-Berechtigungen befolgen
  • Auditprotokollierung aufrechterhalten
  • Automatisierungsbezogene Zugriffskontrollen beachten

Nur autorisierte Benutzer können Automatisierungsergebnisse entdecken, ausführen oder abrufen.

Ein typischer Ablauf der Tool-Interaktion folgt dieser Reihenfolge:

  1. DiscoverAutomation
  2. RunAutomation
  3. GetAutomationResult
Dieser Ablauf ermöglicht es dem KI-Agent:
  • Die richtige Automatisierung zu identifizieren
  • Sie sicher auszuführen
  • Das Endergebnis abzurufen

Fehlerbehebung für MCP-Tools

Automatisierungen werden in DiscoverAutomation nicht angezeigt
  • Bestätigen Sie Benutzerberechtigungen.
  • Stellen Sie sicher, dass die Automatisierung veröffentlicht ist.
  • Verwenden Sie eine spezifischere Tool-Abfrage.
  • Prüfen Sie, ob mehr als neun Automatisierungen vorhanden sind (Top-Neun-Grenze).
Die Automatisierung läuft, aber es wird keine Ausgabe zurückgegeben
  • Überprüfen Sie, ob die Ausgabewerte korrekt konfiguriert sind.
  • Stellen Sie sicher, dass Ausgabewerte korrekt zugeordnet sind.
  • Bestätigen Sie, dass GetAutomationResult mit der richtigen Job-ID aufgerufen wird.
RunAutomation schlägt fehl
  • Validieren Sie Eingabeparameternamen und -typen.
  • Bestätigen Sie die Verfügbarkeit der Laufzeitumgebung.
  • Überprüfen Sie die Auditprotokolle des Control Room.
  • Überprüfen Sie den PRE-Integrationsstatus (nur mit Enterprise-Lizenz).