Execuções

A página Execuções (/admin/executions, no menu lateral aparece como Execuções) mostra o histórico das tarefas agendadas que os agentes da organização rodaram. Cada linha representa uma rodada — uma vez que um agendamento disparou e o agente respondeu.

O que é uma execução

Uma execução é a rodada completa de um agente respondendo a um agendamento (cron, intervalo, gatilho). Ela inclui:

• a chamada inicial do agendamento;
• as iterações do agente chamando ferramentas;
• a resposta final ou o erro.

Execuções vindas de conversas normais (Hub, canal público, WhatsApp, API) não aparecem aqui — para essas, use a página de Conversas ou Analytics.

Filtros

Quatro filtros permitem reduzir o ruído (com label exato como aparece na tela):

• Agente: seleciona um agente específico (default: Todos os agentes).
• Status: Ativo, Concluído, Pendente ou Falhou (default: Todos os status).
• Data inicial e Data final: limita ao intervalo desejado, com seletor de data.

Os filtros são combináveis. Cada mudança reseta para a primeira página.

Informações por linha

A tabela mostra, em cada execução:

• Agente: nome do agente que rodou. Se o agente foi removido depois, você vê Agente removido em texto cinza.
• Agendamento: nome do agendamento que disparou a execução (extraído do título da conversa).
• Data/Hora: quando a execução começou (formato dd/MM/yyyy HH:mm).
• Status: badge colorido — verde Ativo, azul Concluído, amarelo Pendente, vermelho Falhou. Quando o status é Falhou e há mensagem de erro, um ícone de alerta aparece ao lado — passe o mouse para ver o erro completo no tooltip.
• Créditos: quanto a execução consumiu (em pt-BR). Mostra — quando ainda não foi calculado.
• Ações: o botão de olho (Ver conversa) leva direto para a conversa daquela execução.

Debug de execuções que falharam

Quando uma execução aparece com status Falhou:

1. Passe o mouse no ícone de alerta para ler a mensagem de erro resumida no tooltip.
2. Clique no ícone de olho para abrir a conversa completa.
3. Na conversa, expanda cada chamada de ferramenta para ver o input enviado e o retorno do serviço externo.

Causas comuns de falha:

• credencial expirada em uma ferramenta conectada (reconecte em Ferramentas);
• timeout do serviço externo;
• limite de tokens excedido;
• erro de prompt que faz o LLM responder fora do formato esperado.

Paginação

A tabela mostra 20 execuções por página. O rodapé exibe N execuções no total à esquerda e setas de navegação à direita com página atual / total.

Boas práticas

• Defina uma rotina semanal de revisar execuções com status Falhou dos agentes principais.
• Se um agendamento falha sempre no mesmo passo, suspeite primeiro da ferramenta envolvida — abra os detalhes da conta dessa ferramenta para ver se há erro de credencial.
• Use o filtro de Agente quando você sabe que só um agente está com problema, em vez de varrer a tabela inteira.
• Picos de Créditos em execuções específicas geralmente indicam loops de ferramenta ou contexto inflado — vale rever o prompt do agente.