Flow: do histórico ao detalhe de cada evento
Investigue a execução das tarefas com histórico paginado e detalhes de etapas, responsáveis e tentativas de modelo.
Investigue a execução das tarefas com histórico paginado e detalhes de etapas, responsáveis e tentativas de modelo.
Como usar
No Zild Admin, abra a atividade do Flow em Compliance e filtre o período da ocorrência. Selecione o evento para consultar tarefa, etapas, responsável e descrição; o painel reúne metadados de execução quando disponíveis. No Zild Flow, abra o quadro correto e a tarefa para consultar seu histórico. A lista Flow History apresenta execuções de agentes e não deve ser confundida com a auditoria de eventos da tarefa.
Limites e pré-requisitos
Tokens, fornecedor, modelo e tentativas dependem dos metadados registrados no evento. Campos ausentes não devem ser interpretados como consumo zero. A visualização de um evento não reexecuta a tarefa nem corrige automaticamente uma falha.
Como validar na sua operação
Acompanhe uma tarefa de teste entre duas etapas e confira a sequência de eventos. Ao investigar falhas, registre o ID da tarefa e do evento para evitar confundir tentativas distintas.
Conferir o arquivo exportado
Use Excel para analisar os resultados ou a opção de impressão para preparar uma visualização imprimível. A tabela exporta as colunas configuradas para esse fim; botões de ação e campos internos não fazem parte automaticamente do arquivo. Compare IDs, datas e uma amostra dos eventos com a consulta aplicada.
Se a quantidade total mudar durante a leitura das páginas, ou faltar uma página, a coleta pode falhar e pedir que a busca seja executada novamente. Atualize a consulta e tente outra vez, preferencialmente com um período menor. Uma exportação concluída não é uma versão imutável da base: para reproduzir uma análise, guarde também período, filtros e horário da extração.
Se a impressão não abrir, confira a mensagem sobre bloqueio de pop-ups do navegador. Aguarde a preparação terminar antes de fechar a página.
Filtros, datas e exportação no Admin
Na tela de auditoria de fluxos do Admin, selecione período, fluxo, tipos de evento, agente e usuário e use Atualizar. Para filtrar por usuário, selecione uma opção do autocompletar: digitar um nome sem escolhê-lo não aplica um ID de usuário. Limpar remove os filtros e restaura o período inicial de 30 dias.
O calendário usa dias locais e inclui o último dia selecionado. A tela converte o intervalo para a consulta com fim exclusivo. Ao comparar com chamadas diretas da API ou com uma pessoa em outro fuso horário, confira as datas e os limites efetivos. Não acrescente um dia ao calendário manualmente: a interface já faz esse ajuste.
A tabela oferece páginas de 25, 50 ou 100 eventos. A exportação busca todas as páginas dos filtros aplicados, não apenas a página visível. Se mudar os campos, use Atualizar antes de exportar: alterações ainda não aplicadas não mudam a consulta exportada. Confira o período e os dados antes de compartilhar. Os filtros ficam na URL, mas compartilhar o link não concede permissão de acesso. Abra uma linha para consultar o detalhe do evento e a sequência da tarefa.
Permissão e período da consulta de auditoria
A consulta paginada de auditoria exige a permissão ViewTenantConfig. Sem essa permissão, uma resposta 403 não significa ausência de eventos: solicite acesso ao administrador responsável.
Na API, o período usa UTC, inclui o instante inicial e exclui o final. Para consultar um dia inteiro, informe o início desse dia e o início do dia seguinte. O intervalo informado deve ser de até 366 dias. Sem período, buscas gerais consideram os últimos 30 dias; a consulta por uma única tarefa não recebe esse período padrão. Cada página aceita até 100 registros.
Uma resposta 400 pede revisão do período, da paginação ou dos identificadores. Confira esses parâmetros antes de concluir que um registro está ausente. Essas regras são da consulta de auditoria, não do filtro de sete dias da lista de execuções de agentes.
Escolha a visão adequada para investigar
Use o histórico da tarefa para sua sequência de eventos e a auditoria do Admin para os detalhes registrados de execução. Antes de comparar com indicadores, confira os filtros do dashboard: uma tarefa pode ter participação humana e de IA, e as datas de criação da tarefa e execução não são equivalentes.
Investigar uma tarefa · Consultar execuções de agentes · Interpretar o dashboard
Disponibilidade
Novidade identificada no código da plataforma em outubro de 2026. A disponibilidade depende da versão implantada, das permissões e dos conectores do seu ambiente. Consulte a Zild se o recurso ainda não aparecer.
Documentação revisada: 2026-10-28.