Cancelar Monitor
Tipo de ação: actions/monitors/cancel.
Use esta ação para desarmar um monitor armado de que o agente não precisa mais — o fluxo "deixa pra lá". O monitor passa a expired sem disparar: seu despertar nunca é enviado, e a vaga no limite de monitores armados é liberada imediatamente em vez de esperar o TTL.
Não existe rearmar. Para mudar o que um monitor vigia, cancele-o e crie um novo com Criar Monitor.
Campos
| Campo | O que faz |
|---|---|
| monitorId | CEL que resolve para o _id do monitor armado — o monitorId que um passo Criar Monitor retornou (ex.: step(0).monitorId), ou lido do tipo de dados somente-leitura monitors |
| conversationId | A conversa que o monitor acorda. Por padrão é a conversa em que a execução está — uma execução de workflow não tem conversa, então passos de workflow precisam defini-la. Precisa bater com a do próprio monitor |
O que passos seguintes podem usar
step(N).monitorId— o id do monitor canceladostep(N).monitorState—expiredapós um cancelamento bem-sucedido
(Como no Criar Monitor, leia o resultado por essas saídas, não por step(N).status — status é reservado para códigos de status HTTP.)
Escopo: só monitores da sua conversa
Um cancelamento é recusado a menos que o monitor pertença à sua conta e acorde a conversa a que o cancelamento está escopado. Para cancelar um monitor ligado a outra conversa, passe o id daquela conversa explicitamente. A conta é a fronteira rígida aqui; a checagem de conversa protege contra enganos (desarmar a vigia de outra conversa por acidente), não contra quem nomeia deliberadamente a conversa certa.
Quando o cancelamento é recusado
| Erro | Significado |
|---|---|
monitor_invalid_id | monitorId não é um id de monitor válido |
monitor_missing_conversation | Nenhuma conversa para escopar o cancelamento — execuções de workflow precisam passar uma |
monitor_not_found | Nenhum monitor com esse id nesta conta |
monitor_not_in_conversation | O monitor acorda outra conversa — passe o conversationId dela |
monitor_not_armed | Já está fired, expired ou error — nada a cancelar. Se disparou, a mensagem de despertar já está na conversa |
monitor_being_evaluated | O varredor está avaliando o monitor neste instante — tente de novo em breve (uma concessão de avaliação dura no máximo 2 minutos; 3 para vigias agent_tool) |
Corridas, com honestidade
Um monitor que dispara enquanto você cancela permanece disparado — o cancelamento responde monitor_not_armed, e o despertar já está na conversa. Um monitor em avaliação recusa o cancelamento (monitor_being_evaluated) em vez de disputar com ele — o varredor reconfirma sua posse no último instante antes de enviar, então cancelar nunca despublica um despertar e um monitor cancelado nunca dispara depois. Um resíduo estreito vale conhecer: se um worker cair depois de entregar um despertar mas antes de registrar o disparo, a linha volta a parecer armada por um instante e um cancelamento pode vencê-la — você teria então um despertar entregue para um monitor que consta como cancelado. Isso exige uma queda no instante exato, e o despertar em si é deduplicado de qualquer forma.