agent.run.completed

EVENTOagent.run.completeddesde A1envelope v1

Execução de agente terminou.

Quando é emitido

Um agente LiteZap terminou uma execução (mensagem nova ou Executar agora). status: completed, step_limit (limite de passos), failed (provedor, limite diário) ou discarded (um humano assumiu o chat). Os passos ficam em GET /agents/runs/{run_id}.

Campos de data

Campo	Tipo	Descrição
run_id	string	Id da execução.
agent_id	string	Agente.
agent_name	string	Nome do agente.
trigger	string	message ou manual.
chat	string	Chat do gatilho (pode ser vazio).
status	string	completed, step_limit, failed ou discarded.
mode	string	aprovacao, autonomo ou sugerir.
sent	integer	Escritas executadas.
drafts	integer	Rascunhos criados.
cost_usd	number	Custo estimado.
error	string	Motivo, quando não completou.

O envelope (id, type, version, instance_id, timestamp,data) está em Visão geral. Campos novos podem ser adicionados emdata sem mudar a versão: ignore os que não conhecer.

Exemplos

Corpo do POST

{
  "id": "evt_1c3e5a7b9d2f4068",
  "type": "agent.run.completed",
  "version": 1,
  "instance_id": "inst_7f3a9c2e5b1d4086",
  "timestamp": "2026-10-20T14:02:11.020Z",
  "data": {
    "run_id": "arun_7a3c1e9f5d2b4068",
    "agent_id": "agn_3c9e1a7f5d2b4086",
    "agent_name": "Atendente",
    "trigger": "message",
    "chat": "[email protected]",
    "message_id": "msg_1a2b3c4d5e6f7a8b",
    "mode": "aprovacao",
    "status": "completed",
    "steps": 1,
    "model_calls": 2,
    "sent": 0,
    "drafts": 1,
    "cost_usd": 0.0042,
    "error": ""
  }
}

Entrega e ordem

• Por webhook: pelo menos uma vez, com retry por até 24 horas. O mesmo evento pode chegar duas vezes: deduplique porX-LiteZap-Event-Id. Veja Entrega e retentativas.
• A ordem entre eventos não é garantida (retentativas reordenam): use timestamp.
• Por SSE: ao vivo, sem replay. Veja Tempo real com SSE.
• Para assinar só este tipo: "events": ["agent.run.completed"] no webhook, ou?types=agent.run.completed no SSE.

Relacionados: agent.draft.created · agent.draft.decided

Equivalente na Z-API: (sem equivalente).