Monitora pianificazioni e agent flow Copilot Studio
Un agent conversazionale non «gira in loop» come un cron notturno. Vale la pena monitorare il lavoro che dovrebbe avvenire secondo una pianificazione o dopo un'automazione completata: agent flow, topic che eseguono una sequenza fissa di azioni, o — più spesso — un cloud flow Power Automate chiamato dall'agent. Non attaccare un heartbeat a ogni messaggio utente: prova solo traffico chat, non che un processo di business continui a girare.
Prima di iniziare
Crea un monitor con la frequenza reale del workflow, poi copia l'URL dalla dashboard. Il token è segreto: non pubblicarlo.
Configurazione
Decidi cosa monitorare (spesso il cloud flow Power Automate)
Se il lavoro reale dell'agent vive in un cloud flow Power Automate (pattern comune), crea il monitor Verifagent su quel flow e segui la guida Power Automate — di solito è il segnale migliore. Usa un heartbeat Copilot Studio solo quando un topic o agent flow completa da solo un job pianificato o batch senza passare da Power Automate. Crea un monitor per ogni processo che ti interessa e copia l'URL di ping.
https://verifagent.com/api/ping/your-ping-tokenAggiungi un nodo Send HTTP request dopo il lavoro reale
Nel canvas del topic (o agent flow), aggiungi un nodo dopo l'ultima azione di business. Da Microsoft Learn: Add node → Advanced → Send HTTP request. Imposta Method su GET e incolla l'URL Verifagent (o una variabile che lo contiene). Lascia il body vuoto (No content). L'autenticazione non è richiesta per Verifagent.
Tieni il ping solo sul percorso di successo
Posiziona Send HTTP request dopo i passaggi Dataverse / connettore / chiamata flow che definiscono il successo. Non metterlo all'inizio del topic. Se chiami Power Automate dal topic, preferisci mettere Verifagent dentro quel flow (dopo il suo lavoro) piuttosto che pingare dal topic prima che il flow finisca.
GET https://verifagent.com/api/ping/your-ping-token
# Copilot Studio · Send HTTP request
# Method: GET
# URL: <URL di ping>
# Body: No content
# Risposta attesa di esempio (schema opzionale):
# {"ok":true}Testa il percorso che dovrebbe fare heartbeat
Attiva il topic o agent flow una volta tramite Test (o la pianificazione rilevante). Conferma che il nodo HTTP restituisce 200 / {"ok":true}, poi controlla Up in Verifagent. Se l'agent chiama solo Power Automate, testa quel flow — vedi la guida Power Automate.
{"ok":true}Route disponibili
L'URL base basta per un heartbeat. Le varianti arricchiscono la cronologia se la piattaforma ha più rami.
GET https://YOUR_PING_URLPOST https://YOUR_PING_URL/successPOST https://YOUR_PING_URL/fail?msg=ErrorVerifica
Un test riuscito del percorso monitorato porta il monitor a Up. Salta il nodo HTTP o ferma la pianificazione: non dovrebbe arrivare alcun ping e Verifagent apre un incidente dopo periodo + tolleranza.
200 {"ok":true}. Il monitor passa da In attesa a Up.