Agent runs e uso

Cada execução de um agent sobre um e-mail, com seus tokens, custo e duração — mais duas visões agregadas sobre os mesmos dados. Tudo somente leitura. Veja o modelo AgentRun e o modelo Usage.

Comando	HTTP	Descrição
agent-runs list	GET /agent-runs	Lista execuções de agent com tokens, custo e duração.
agent-runs get	GET /agent-runs/{id}	Busca uma execução, incluindo a versão do prompt e o erro, se houver.
usage summary	GET /usage/summary	Uso agregado para um intervalo de datas. Padrão: últimos 30 dias.
usage cost	GET /usage/cost	Custo detalhado por modelo para um intervalo de datas.

Exemplos

# Listar execuções de um agent
kobana inbox agent-runs list \
  --params '{"agent_id": "AGENT_ID", "status": "failed"}' \
  --fields "id,status,total_cost,duration_ms"

# Buscar uma execução
kobana inbox agent-runs get \
  --params '{"id": "AGENT_RUN_ID"}' \
  --fields "id,status,error,input_tokens,output_tokens"

# Resumo de uso para um intervalo de datas
kobana inbox usage summary \
  --params '{"from": "2026-08-01", "to": "2026-08-31"}'

# Custo por modelo
kobana inbox usage cost \
  --params '{"from": "2026-08-01", "to": "2026-08-31"}'

# Stream de todas as execuções que falharam com paginação automática
kobana inbox agent-runs list \
  --params '{"status": "failed"}' \
  --page-all --fields "id,agent_id,email_id,error"

Próximos passos

• Agents — o agent que produziu essas execuções.
• Workflow runs — a cadeia HTTP que o workflow de uma execução disparou.