Execuções
Uma execução é cada vez que uma tarefa roda. Ela guarda quem disparou, em que ambiente, com que parâmetros, tudo o que o agente fez e quanto custou.
De onde vem um disparo
| Origem | Como |
|---|---|
| Console | botão Executar agora (Executar uma tarefa) |
| Agendamento | expressão cron da tarefa num ambiente (Agendamentos) |
| API | POST /v1/tasks/{id}/run (API v1) |
| Endpoint | POST /run-task/{task_id} chamado por outro sistema (Endpoint de disparo) |
| Manage | disparo pela equipe da Kobana |
A origem aparece na coluna Origem de Analytics → Logs.
Status
| Status | No console | Significado |
|---|---|---|
queued | Na fila | Aceita, esperando a execução anterior da mesma tarefa terminar. |
pending | Pendente | Enviada para rodar. O agente começa em até 3 minutos. |
running | Rodando | O agente está trabalhando. |
success | Concluída | Terminou e gravou o resultado. |
failed | Falhou | Terminou com erro (a skill saiu com falha, estourou o tempo ou não pôde começar). |
cancelled | Cancelada | Interrompida por uma pessoa. O que já foi feito nos sistemas externos não é desfeito. |
Uma execução por tarefa de cada vez
Cada tarefa roda uma execução por vez. Um disparo com outra execução da
mesma tarefa em andamento não é recusado: ele entra na fila (queued) e
começa sozinho quando as anteriores terminarem. O console avisa quantas
execuções estão na frente antes de você confirmar.
Agendamentos são a exceção: se a tarefa já tem uma execução ativa ou na fila no horário agendado, aquele disparo é pulado, e não empilhado. Um cron mais curto do que a duração da tarefa perde disparos.
Tarefas diferentes rodam em paralelo.
O que uma execução registra
| Aba | Conteúdo |
|---|---|
| Histórico | A linha do tempo de eventos que a skill emitiu: início e fim de cada passo, avisos e erros. |
| Logs | As linhas de log e as chamadas HTTP aos sistemas externos, com os secrets mascarados. |
| Pendências | O que a skill deixou para uma pessoa resolver. |
| Arquivos | Os arquivos de entrada anexados no disparo e os arquivos de saída publicados pela execução. |
| Resultado | O relatório final em Markdown. |
| Custo | Tokens consumidos (entrada, saída, cache), nível e custo. |
Limites
- Tempo: uma execução roda por até 60 minutos. Passado isso, ela é interrompida e marcada como falha.
- Plano e teto de custo: sem o Kadu no plano da organização, ou com o teto mensal de custo atingido, o disparo é recusado. Ver Plano e custos.
- Retenção: eventos, logs e entregas de webhook ficam guardados por 90 dias.