Guía Copilot Studio

Monitoriza calendarios y flujos de agente de Copilot Studio

Un agente conversacional no «se ejecuta en bucle» como un cron nocturno. Lo que merece monitorización es el trabajo que debería ocurrir según un calendario o tras una automatización completada: flujos de agente, topics que realizan una secuencia fija de acciones o — más a menudo — un flujo cloud de Power Automate que el agente invoca. No adjuntes un heartbeat a cada mensaje de usuario; eso solo demuestra tráfico de chat, no que un proceso de negocio siga ejecutándose.

Antes de empezar

Crea un monitor con la frecuencia real de tu workflow y copia su URL desde el panel. Su token es secreto: no lo publiques.

Módulo a usar : Send HTTP request. Colócalo después de la última acción útil en la ruta de éxito.

Configuración

Decide qué monitorizar (a menudo el flujo Power Automate)

Si el trabajo real del agente vive en un flujo cloud de Power Automate (patrón habitual), crea el monitor Verifagent en ese flujo y sigue la guía Power Automate — suele ser la señal más fiable. Usa un heartbeat de Copilot Studio solo cuando un topic o flujo de agente completa por sí mismo un job programado o por lotes sin pasar por Power Automate. Crea un monitor por proceso que te importe y copia su URL de ping.

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

Añade un nodo Send HTTP request después del trabajo real

En el lienzo de autoría del topic (o flujo de agente), añade un nodo después de la última acción de negocio. Según Microsoft Learn: Add node → Advanced → Send HTTP request. Pon Method en GET y pega la URL de Verifagent (o referencia una variable que la contenga). Deja el body vacío (No content). Verifagent no requiere autenticación.

Mantén el ping solo en la ruta de éxito

Coloca Send HTTP request después de pasos Dataverse / conector / llamada a flujo que definen el éxito. No lo pongas al inicio del topic. Si llamas a Power Automate desde el topic, prefiere poner Verifagent dentro de ese flujo (después de su trabajo) en lugar de hacer ping desde el topic antes de que termine el flujo.

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

# Copilot Studio · Send HTTP request
# Method: GET
# URL:    <URL de ping>
# Body:   No content
# Ejemplo de respuesta esperada (schema opcional):
# {"ok":true}

Prueba la ruta que debería hacer heartbeat

Activa el topic o flujo de agente una vez mediante Test (o el calendario que importe). Confirma que el nodo HTTP devuelve 200 / {"ok":true} y revisa Up en Verifagent. Si el agente solo llama a Power Automate, prueba ese flujo — consulta la guía Power Automate.

{"ok":true}

Heartbeat solo en rutas que representen trabajo programado o por lotes completado. Ajusta el periodo esperado a ese calendario; define el margen por encima de la latencia del agente y los conectores. Para agentes solo de chat sin calendario, Verifagent suele ser la herramienta equivocada — monitoriza el flujo backend.

Rutas disponibles

La URL base basta para un heartbeat. Las variantes enriquecen el historial si tu plataforma tiene varias ramas.

GET https://YOUR_PING_URL

POST https://YOUR_PING_URL/success

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

Verificar

Una prueba correcta de la ruta monitorizada cambia el monitor a Up. Omite el nodo HTTP o detén el calendario: no debería llegar ningún ping y Verifagent abrirá un incidente tras periodo + margen.

Respuesta esperada: 200 {"ok":true}. El monitor pasa de Pending a Up.