Execuções

A tela de Execuções foi desenhada para permitir que o usuário acompanhe, investigue e valide o comportamento dos chatbots em tempo real.
Ela funciona como um log inteligente centralizado que mostra cada execução de um fluxo, permitindo auditoria, depuração, verificação de erros, e entendimento do comportamento do bot em cada etapa.

• 1. Estrutura geral da tela
• 1.1 Dashboard resumido (cards de indicadores)
• 1.2 Filtros avançados
• 1.3 Lista de execuções
• 2. Visualização detalhada da execução
• 2.1 Timeline da execução
• 2.2 Painel lateral (dados da execução)
• A. Status da etapa
• B. Dados de entrada
• C. Dados de saída
• D. Mensagens de erro
• 3. Exportação
• 3.1 Exportar dados da execução
• 3.2 Exportar execuções (lista)
• 4. Auto-refresh

1. Estrutura geral da tela

1.1 Dashboard resumido (cards de indicadores)

Os cards superiores oferecem uma visão rápida das execuções dos bots:

• Total de execuções
  Quantidade geral de execuções.

• Sucesso
  Execuções concluídas sem falhas em nenhuma etapa.

• Erro
  Execuções interrompidas por falhas no fluxo, integrações, API, assistentes, regras de negócio, etc.

• Executando
  Execuções ainda ativas, geralmente em workflows com esperas, delays, ou assistentes assíncronos.

Esses indicadores ajudam a entender rapidamente se há um aumento anormal de erros ou gargalos.

1.2 Filtros avançados

A barra de filtros permite uma investigação refinada:

• Origem da chamada
  Qual serviço/origem iniciou a execução (ex: Chat, agendador de rotina, Api).

• Canal de atendimento
  Tipo de canal usado naquela execução.
  Ajuda a diagnosticar falhas específicas de canal.

• Período
  Intervalo customizado para filtrar execuções, essencial para análises temporais e bugs intermitentes. (última hora, últimas 24h, últimos 7 dias, últimas 4 semanas ou período personalizado).

• Busca livre
  Permite pesquisar por:

  • ID de execução

  • Bot

  • Workflow

  • Usuário

  • Protocolo

  • Mensagens de erro

É o principal recurso para localizar execuções específicas.

1.3 Lista de execuções

A tabela reúne todas as execuções com colunas estruturadas:

Essa estrutura dá rastreabilidade total.

2. Visualização detalhada da execução

Ao clicar em qualquer linha da tabela, abre-se uma página dedicada, trazendo:

2.1 Timeline da execução

É a espinha dorsal do diagnóstico. Cada node aparece como um bloco com:

• Nome do node

• Tipo da ação

• Status da execução

• Tempo de início e fim

• Tempo de processamento

Essa timeline permite enxergar claramente:

• A ordem dos eventos

• Onde um erro foi disparado

• Qual node executou com lentidão

• Como o fluxo se comportou em tempo real

2.2 Painel lateral (dados da execução)

No painel lateral direito, aparecem dados críticos para auditoria:

A. Status da etapa

• Sucesso ou erro

• Tempo de execução

• Duração em milissegundos

B. Dados de entrada

JSON que mostra tudo o que entrou no node:

• Payloads

• Mensagens do usuário

• Variáveis do workflow

• Comandos internos do builder

C. Dados de saída

Exibe o resultado gerado pelo node:

• Resposta enviada ao usuário

• Variáveis criadas/alteradas

• Retornos de API

• Respostas de assistentes

D. Mensagens de erro

Em caso de falhas, o painel exibe:

• Código HTTP (ex: 400)

• Mensagem legível

• Detalhes técnicos

• Parâmetro que causou falha

• Tipo de erro (invalid_request, unsupported_parameter, etc.)

Exemplo real:

Erro: 400 - { "error": { "message": "Unsupported parameter: 'max_tokens' is not supported with this model. Use 'max_completion_tokens' instead.", "type": "invalid_request_error", "param": "max_tokens", "code": "unsupported_parameter" } }

Isso permite correção rápida sem precisar procurar logs externos.

3. Exportação

3.1 Exportar dados da execução

O botão com ícone de download exporta toda a execução, incluindo:

• Timeline completa

• Dados de entrada e saída

• Erros

• Metadados

• IDs de execução

• Payloads do usuário

• Conexões com APIs externas

Esse recurso é essencial para:

• Abrir incidentes

• Realizar debugging profundo

• Fornecer logs para fornecedores

3.2 Exportar execuções (lista)

Na tabela principal existe o botão Exportar JSON que gera um arquivo com as execuções filtradas.

4. Auto-refresh

A função Auto-refresh atualiza automaticamente a lista de execuções conforme novas chamadas acontecem, permitindo acompanhamento em tempo real.

Útil para:

• Homologações

• Testes de carga

• Debug com desenvolvedor acompanhando

• Fluxos com alta recorrência