O Histórico de execuções registra tudo o que os agentes fizeram: quando começaram e terminaram, quanto demoraram, se deram certo, o resumo do resultado, os arquivos gerados e a situação da entrega. É a tela para conferir um relatório recebido, baixar de novo um arquivo, investigar uma falha e comprovar que o agente rodou. Este artigo explica as colunas, os status, os gatilhos, a tela de detalhe com o resultado e os arquivos, e como usar o histórico para ajustar os agentes.
Índice
Onde fica e quem vê
Abra Filipa IA, Agentes, Histórico de execuções para ver as execuções de todos os agentes, ou toque no botão Histórico de execuções dentro de um agente para ver só as dele. A tela exige a permissão Execuções de agente de IA e os agentes habilitados nas Configurações de IA.
Colunas da lista
| Coluna | Conteúdo |
|---|---|
| Agentes de IA | Nome do agente. |
| Iniciado / Finalizado | Iniciado é quando a execução entrou na fila; Finalizado, quando terminou. |
| Duração | Tempo entre a criação e o término, incluindo a espera na fila. |
| Status | Na fila, Em processamento, Pronto, Falhou, Cancelado ou Concluído com falha na entrega. |
| Formato de saída | Formato do arquivo gerado. |
| Arquivos | Nome dos arquivos gerados na execução. |
| Resumo | Texto produzido pelo agente resumindo o que foi entregue. Fica oculto por padrão; exiba pela escolha de colunas. |
| Gatilho | Agendado ou Manual. |
| Nome do proprietário | Usuário dono do agente, com quem a execução rodou. Não aceita filtro nem ordenação. |
Como em toda lista do Vendelo, é possível filtrar por período, agente, status e gatilho, ordenar, salvar pesquisas favoritas e exportar para o Excel.
Status da execução
| Status | Significado |
|---|---|
| Na fila | A execução foi criada e aguarda a vez. Execuções concorrem com as demais do provedor. |
| Em processamento | O agente está consultando o Vendelo e produzindo o resultado. |
| Pronto | Resultado gerado e entrega concluída. |
| Concluído com falha na entrega | Resultado gerado, mas o e-mail ou webhook falhou. O arquivo está disponível na execução. |
| Falhou | A execução não produziu resultado. Tipo e mensagem do erro ficam no detalhe. Conta para a pausa automática (três seguidas). |
| Cancelado | Status reservado; nesta versão nenhuma rotina o utiliza. |
Gatilhos
- Agendado: execução disparada pelo horário do agendamento.
- Manual: execução disparada pelo botão Executar agora.
Filtre por Agendado para auditar a regularidade do agente: se faltam execuções em horários previstos, verifique se ele estava pausado ou se houve falhas.
O detalhe da execução
Toque no ícone da primeira coluna da execução para abrir o detalhe (tocar no nome do agente apenas seleciona a linha). Ele traz:
- Status, início e término da execução.
- Entrega: “Entrega concluída (E-mail)” ou “Entrega concluída (Webhook)”; em caso de falha, o tipo e a mensagem do erro, em vermelho.
- Arquivos: cada arquivo com o tamanho, “Disponível até” (ou Expirado) e o download.
- Resultado da execução: o texto produzido pelo agente, formatado, com os botões Copiar e Fechar.
O consumo de tokens da execução fica na tela Uso de tokens dos agentes.
Arquivos e download
Cada arquivo mostra o nome e a data limite de disponibilidade, definida pelo prazo de retenção das Configurações de IA (sete dias após a geração, por padrão). Toque em Baixar para receber o arquivo com a sua sessão do Vendelo. Depois do prazo, o arquivo aparece como Expirado e não pode mais ser baixado; execute o agente de novo para gerar uma versão atual.
Quem recebe o e-mail ou o webhook baixa pelo link. Quem tem acesso ao Vendelo pode baixar por aqui mesmo depois de perder o e-mail, enquanto o arquivo não expirar.
Investigando uma falha
Abra a execução com Falhou ou Concluído com falha na entrega e leia o tipo e a mensagem do erro.
Erros de consulta aos dados (tipos mcp_query_failed, mcp_transient_failure e mcp_data_not_consulted, com a mensagem “Não foi possível consultar as informações desta vez”): se for pontual, a próxima execução costuma resolver; se repetir, revise a instrução do agente e valide de novo com a Filipa, porque a estrutura pode ter mudado ou o proprietário perdeu uma permissão.
Acesso do proprietário (tipo ai_copilot_access_required): o dono do agente perdeu a permissão Chat da Filipa, assistente de IA. Libere no perfil dele.
Erros do provedor (créditos, limite de uso, indisponibilidade): regularize a conta ou aguarde. Um provedor “via assinatura hospedada” pode ficar em espera até a cota liberar; a execução aparece Na fila por mais tempo.
Erros de tempo (execução muito longa): reduza o escopo da instrução, por exemplo limitando o período ou as colunas.
Erros de entrega (tipos email_delivery_failed e webhook_delivery_failed): o resultado foi gerado, mas o destino recusou. No webhook, o código HTTP vem junto do tipo (por exemplo, webhook_http_404 quando o endereço não existe no destino), seguido da resposta que o destino devolveu. Corrija destinatários, URL ou canal. Outras falhas aparecem como execution_failed.
Depois de corrigir, use Executar agora para confirmar e, se o agente foi pausado automaticamente, use Retomar.
Perguntas frequentes
Por quanto tempo o histórico fica guardado?
Os registros ficam enquanto o agente existir; excluir o agente apaga também o histórico dele. Os arquivos são removidos ao fim do prazo de retenção.
Posso cancelar uma execução em andamento?
Nesta versão não há cancelamento manual pela tela. Pausar o agente evita as próximas execuções; a atual termina ou falha por tempo.
Vejo execuções de agentes de outros usuários?
Sim, conforme a permissão Execuções de agente de IA do seu perfil. A coluna Nome do proprietário indica de quem é cada agente.
O resumo está vazio. É erro?
Não necessariamente. Confira se a coluna Resumo está visível (ela fica oculta por padrão). No formato JSON, o Resumo mostra o próprio JSON produzido. Se ainda assim estiver vazio, verifique o arquivo.
A execução ficou Na fila por muito tempo.
O provedor pode estar no limite de execuções simultâneas ou em espera de cota. Aguarde; se persistir por horas, fale com o administrador.
Como sei se o e-mail foi enviado?
No detalhe da execução, a seção Entrega mostra “Entrega concluída” para o canal E-mail. Se o destinatário não recebeu, confira spam e o endereço no cadastro do agente.
Próxima leitura
Uso de tokens dos agentes: acompanhe o consumo de cada execução e dimensione o custo dos agentes.
