Guide Copilot Studio

Surveiller les planifications et flux d’agent Copilot Studio

Un agent conversationnel ne « tourne » pas en boucle comme un cron nocturne. Ce qui mérite d’être surveillé, c’est le travail qui doit se produire à une cadence ou à la fin d’une automatisation : flux d’agent, topics qui enchaînent des actions fixes, ou, le plus souvent, un flux cloud Power Automate appelé par l’agent. N’attachez pas un heartbeat à chaque message utilisateur : cela ne prouve que du trafic de chat, pas qu’un processus métier continue de tourner.

Avant de commencer

Créez un monitor avec la fréquence réelle de votre workflow, puis copiez son URL depuis le dashboard. Son token est secret : ne le publiez pas.

Module à utiliser : Send HTTP request. Placez-le après la dernière action utile du chemin de succès.

Installation

Choisissez quoi surveiller (souvent le flux Power Automate)

Si le vrai travail de l’agent vit dans un flux cloud Power Automate (cas fréquent), créez le monitor Verifagent sur ce flux et suivez le guide Power Automate : c’est en général le meilleur signal. Utilisez un heartbeat Copilot Studio seulement lorsqu’un topic ou un flux d’agent termine lui-même un travail planifié ou batch sans passer par Power Automate. Un monitor par processus critique ; copiez l’URL de ping.

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

Ajoutez un nœud Send HTTP request après le vrai travail

Dans le canevas du topic (ou du flux d’agent), ajoutez un nœud après la dernière action métier. D’après Microsoft Learn : Ajouter un nœud → Avancé → Envoyer une requête HTTP (Send HTTP request). Méthode GET, collez l’URL Verifagent (ou une variable qui la contient). Corps vide (Aucun contenu). Aucune authentification n’est requise pour Verifagent.

Gardez le ping uniquement sur le chemin de succès

Placez Send HTTP request après les étapes Dataverse / connecteur / appel de flux qui définissent le succès. Ne le mettez pas au début du topic. Si le topic appelle Power Automate, préférez placer Verifagent dans ce flux (après son travail) plutôt que de pinguer depuis le topic avant la fin du flux.

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

# Copilot Studio · Send HTTP request
# Method: GET
# URL:    <URL de ping>
# Body:   No content / Aucun contenu
# Exemple de réponse (schéma optionnel) :
# {"ok":true}

Testez le chemin qui doit battre

Déclenchez une fois le topic ou le flux d’agent via Tester (ou la planification concernée). Vérifiez que le nœud HTTP renvoie 200 / {"ok":true}, puis Up dans Verifagent. Si l’agent ne fait qu’appeler Power Automate, testez plutôt ce flux (voir le guide Power Automate).

{"ok":true}

Heartbeat uniquement sur les chemins qui représentent un travail planifié ou batch terminé. Alignez la période sur cette cadence ; grâce au-dessus de la latence agent + connecteurs. Pour un agent purement conversationnel sans planification, Verifagent est souvent le mauvais outil : surveillez le flux backend à la place.

Routes disponibles

L’URL de base suffit pour un heartbeat. Les variantes enrichissent l’historique si votre plateforme gère plusieurs branches.

GET https://VOTRE_URL_DE_PING

POST https://VOTRE_URL_DE_PING/success

POST https://VOTRE_URL_DE_PING/fail?msg=Erreur

Vérification

Un test réussi du chemin surveillé passe le monitor à Up. Sautez le nœud HTTP ou arrêtez la planification : aucun ping ne doit arriver et Verifagent ouvre un incident après période + grâce.

Réponse attendue : 200 {"ok":true}. Le monitor passe de Pending à Up.