Cancelar Monitor
Tipo de acción: actions/monitors/cancel.
Usa esta acción para desarmar un monitor armado que el agente ya no necesita — el flujo "olvídalo". El monitor pasa a expired sin dispararse: su despertar nunca se envía, y su lugar en el límite de monitores armados se libera de inmediato en vez de esperar el TTL.
No existe rearmar. Para cambiar lo que un monitor vigila, cancélalo y crea uno nuevo con Crear Monitor.
Campos
| Campo | Qué hace |
|---|---|
| monitorId | CEL que resuelve al _id del monitor armado — el monitorId que devolvió un paso Crear Monitor (p. ej. step(0).monitorId), o leído del tipo de datos de solo lectura monitors |
| conversationId | La conversación que el monitor despierta. Por defecto es la conversación de la ejecución — una ejecución de workflow no tiene conversación, así que los pasos de workflow deben definirla. Debe coincidir con la del propio monitor |
Qué pueden usar los pasos siguientes
step(N).monitorId— el id del monitor canceladostep(N).monitorState—expiredtras una cancelación exitosa
(Como en Crear Monitor, lee el resultado por estas salidas, no por step(N).status — status está reservado para códigos de estado HTTP.)
Alcance: solo monitores de tu conversación
Una cancelación se rechaza a menos que el monitor pertenezca a tu cuenta y despierte la conversación a la que la cancelación está limitada. Para cancelar un monitor conectado a otra conversación, pasa el id de esa conversación explícitamente. La cuenta es la frontera dura aquí; la comprobación de conversación protege contra errores (desarmar la vigía de otra conversación por accidente), no contra quien nombra deliberadamente la conversación correcta.
Cuándo se rechaza la cancelación
| Error | Significado |
|---|---|
monitor_invalid_id | monitorId no es un id de monitor válido |
monitor_missing_conversation | Ninguna conversación a la que limitar la cancelación — las ejecuciones de workflow deben pasar una |
monitor_not_found | Ningún monitor con ese id en esta cuenta |
monitor_not_in_conversation | El monitor despierta otra conversación — pasa su conversationId |
monitor_not_armed | Ya está fired, expired o error — nada que cancelar. Si disparó, el mensaje de despertar ya está en la conversación |
monitor_being_evaluated | El barredor está evaluando el monitor en este instante — reintenta en breve (una concesión de evaluación dura como máximo 2 minutos; 3 para vigías agent_tool) |
Carreras, con honestidad
Un monitor que dispara mientras cancelas permanece disparado — la cancelación responde monitor_not_armed, y el despertar ya está en la conversación. Un monitor en evaluación rechaza la cancelación (monitor_being_evaluated) en vez de competir con ella — el barredor reconfirma su posesión en el último instante antes de enviar, así que cancelar nunca despublica un despertar y un monitor cancelado nunca dispara después. Un residuo estrecho conviene conocer: si un worker cae después de entregar un despertar pero antes de registrar el disparo, la fila vuelve a parecer armada por un instante y una cancelación puede ganarla — tendrías entonces un despertar entregado para un monitor que consta como cancelado. Eso exige una caída en el instante exacto, y el despertar en sí se deduplica de todos modos.