Copilot Studio-Anleitung

Copilot Studio-Zeitpläne und Agent-Flows überwachen

Ein Konversationsagent „läuft“ nicht in einer Schleife wie ein nächtlicher Cron. Was sich zu überwachen lohnt, ist Arbeit, die nach Zeitplan oder nach abgeschlossener Automatisierung passieren soll: Agent-Flows, Topics mit fester Aktionssequenz oder — am häufigsten — ein vom Agenten aufgerufener Power Automate-Cloud-Flow. Hängen Sie keinen Heartbeat an jede Nutzernachricht; das beweist nur Chat-Traffic, nicht dass ein Geschäftsprozess noch läuft.

Bevor Sie beginnen

Erstellen Sie einen Monitor mit der tatsächlichen Frequenz Ihres Workflows und kopieren Sie dann die URL aus dem Dashboard. Der Token ist geheim — veröffentlichen Sie ihn nicht.

Zu verwendendes Modul : Send HTTP request. Platzieren Sie es nach der letzten sinnvollen Aktion auf dem Erfolgspfad.

Einrichtung

Entscheiden, was überwacht wird (oft der Power Automate-Flow)

Wenn die echte Arbeit des Agenten in einem Power Automate-Cloud-Flow liegt (häufiges Muster), erstellen Sie den Verifagent-Monitor auf diesem Flow und folgen Sie der Power Automate-Anleitung — das ist meist das bessere Signal. Verwenden Sie einen Copilot Studio-Heartbeat nur, wenn ein Topic oder Agent-Flow selbst eine geplante oder Batch-Arbeit ohne Power Automate abschließt. Ein Monitor pro wichtigem Prozess; kopieren Sie die Ping-URL.

https://verifagent.com/api/ping/your-ping-token

Send HTTP request-Knoten nach der echten Arbeit hinzufügen

Fügen Sie im Topic- (oder Agent-Flow-)Canvas einen Knoten nach der letzten Geschäftsaktion hinzu. Laut Microsoft Learn: Add node → Advanced → Send HTTP request. Method auf GET setzen und Verifagent-URL einfügen (oder Variable referenzieren). Body leer (No content). Für Verifagent ist keine Authentifizierung erforderlich.

Ping nur auf dem Erfolgspfad

Platzieren Sie Send HTTP request nach Dataverse-/Connector-/Flow-Aufruf-Schritten, die Erfolg definieren. Nicht am Topic-Anfang. Wenn das Topic Power Automate aufruft, platzieren Sie Verifagent lieber in diesem Flow (nach dessen Arbeit) statt vom Topic zu pingen, bevor der Flow fertig ist.

GET https://verifagent.com/api/ping/your-ping-token

# Copilot Studio · Send HTTP request
# Method: GET
# URL:    <Ping-URL>
# Body:   No content
# Erwartete Antwort (optionales Schema):
# {"ok":true}

Den Pfad testen, der Heartbeat senden soll

Lösen Sie Topic oder Agent-Flow einmal über Test (oder den relevanten Zeitplan) aus. Prüfen Sie, dass der HTTP-Knoten 200 / {"ok":true} zurückgibt, dann Up in Verifagent. Ruft der Agent nur Power Automate auf, testen Sie stattdessen diesen Flow — siehe Power Automate-Anleitung.

{"ok":true}

Heartbeat nur für Pfade mit abgeschlossener geplanter oder Batch-Arbeit. Passen Sie die erwartete Periode an diesen Zeitplan an; Kulanz über Agent- plus Connector-Latenz. Für rein chatbasierte Agenten ohne Zeitplan ist Verifagent meist das falsche Tool — überwachen Sie stattdessen den Backend-Flow.

Verfügbare Routen

Die Basis-URL reicht für einen Heartbeat. Varianten bereichern den Verlauf, wenn Ihre Plattform mehrere Zweige hat.

GET https://YOUR_PING_URL

POST https://YOUR_PING_URL/success

POST https://YOUR_PING_URL/fail?msg=Error

Prüfen

Ein erfolgreicher Test des überwachten Pfads setzt den Monitor auf Up. Überspringen Sie den HTTP-Knoten oder stoppen Sie den Zeitplan: kein Ping sollte ankommen und Verifagent eröffnet nach Periode + Kulanz einen Vorfall.

Erwartete Antwort: 200 {"ok":true}. Der Monitor wechselt von Pending zu Up.