Auditoria — API

Veja o guia conceitual em Auditoria.

Consultar eventos

`GET /api/v1/logs` leitor

Parâmetros de query

Param	Tipo	Exemplo
`agent_id`	int	`3`
`tool_id`	int	`5`
`event_type`	string	`conversation.tool_blocked`
`severity`	string	`critical`
`actor`	string	`admin@empresa.com`
`session_id`	string	`a3f8c1d2-…`
`from_date`	ISO	`2026-05-01T00:00:00Z`
`to_date`	ISO	`2026-05-20T23:59:59Z`
`limit`	int (padrão 100)	`50`
`offset`	int	`0`

Feed em tempo real

`GET /api/v1/logs/stream` leitor

Fluxo de eventos em tempo real (Server-Sent Events). Cada novo evento é enviado assim que ocorre. Mantenha a conexão aberta e reconecte se cair.

Estatísticas

`GET /api/v1/logs/stats` leitor

Contagens das últimas 24 horas, agrupadas por hora e por tipo de evento.

Resposta 200

{
  "total": 248,
  "critical": 3,
  "by_hour": [{ "hour": "2026-05-20T09:00:00Z", "count": 12 }],
  "by_event_type": {
    "conversation.tool_called": 180,
    "conversation.tool_blocked": 3,
    "access_request.approved": 5
  }
}

Correlação por sessão

`GET /api/v1/logs/correlate/{session_id}` leitor

Retorna todos os eventos de uma mesma sessão — para reconstruir a trilha completa de uma conversa.

Consultar eventos​

GET /api/v1/logs leitor​

Feed em tempo real​

GET /api/v1/logs/stream leitor​

Estatísticas​

GET /api/v1/logs/stats leitor​

Correlação por sessão​

GET /api/v1/logs/correlate/{session_id} leitor​