Monitoramento e registro de execução
Lista de execução, transmissão de eventos ao vivo, logs / custo / tokens e localização de erro – veja o estado de execução claramente.
Uma vez que um workflow está em execução, se você pode fazer sentido do "o que ele realmente fez e quanto ele custa" determina se você vai ousar colocá-lo em produção. Esta página cobre a lista de execução, detalhes de execução, eventos em tempo real, registros de token e custo, exportação e painel de dados.
Página da lista de execução
Nav esquerdo → "História de execução." Ele suporta as visualizações de cartas e tabelas, e a lista atualiza automaticamente (pausable) enquanto as execuções estão sendo executadas. Filtragem e ordenação:
- Pesquisa de palavras-chave — por ID de execução ou nome do workflow
- Filtro de estado — PENDING / RUNNING / COMPLETED / FAILED / CANCELADO / INTERRUPTED
- Filtragem de workflow - visualize apenas o histórico de um determinado workflow
- Ordenar — hora de início / hora de fim / duração / workflow / estado / progresso
No topo da lista está uma linha de filtros rápidos com contagens (Executando / Falhou / Terminou / Interrompeu); clique para alternar.
Informações exibidas para cada registro
- Estado emblema + execução ID + nome do workflow
- Uma barra de progresso e a contagem de conclusão de passos (por exemplo, 5/7)
- Tempo de início (relativo) e duração
- Registros de execução também mostram o passo atualmente em execução
- Os registos acabados podem ser exportados para JSON / YAML em linha
Após multi-selecionar, você pode executar execuções em massa ou apagar registros terminados.
PENDING— Criado mas ainda não iniciado. Execuções sobre a fila de limite de concorrência neste estado e mover automaticamente para RUNNING uma vez terminados mais cedo.RUNNING— Pelo menos um passo é executar.COMPLETED— Todos os passos terminaram (incluindo passos SKIPPED porque sua condição não foi cumprida).FAILED— Um passo errou, e a execução terminou em falha.CANCELLED— Cancelado manualmente pelo utilizador.INTERRUPTED— Interrompido por uma causa do sistema, como uma reinicialização do serviço. Para se auto-resume, veja a página de auto-resume em "Próximos passos" abaixo.
Página de detalhes de execução
Clique em qualquer execução para abrir sua página de detalhes. De cima para baixo:
- Barra superior — cancelar, atualizar, exportar (JSON / YAML), e saltar para o editor de workflow correspondente
- Cartão de estado — status, progresso, duração e uma visão geral do token (enviado / recebido / total)
- Páginas da área principal (ver quadro abaixo)
- O fluxo inferior "Execution log" — um registro de rolagem de todos os eventos, filtrado por nível (debug / info / warn / error), pesquisável por palavra-chave, com auto-scroll pausable
| Página | conteúdo |
|---|---|
| Passos | Uma linha do tempo vertical: o status de cada passo, duração e progresso de iteração. Clique para abrir os detalhes do passo painel lateral; após o final da execução, você pode repetir a partir de um passo escolhido. |
| diálogo | Tece enunciados Agente, saída LLM, chamadas de ferramentas e mensagens do sistema em um único fluxo de chat cronológico. |
| Mensagens externas | Veja apenas os registros de envio/receção do canal IM (Slack / Telegram, etc.). |
| DAG | Um gráfico de passos desenhado por dependência, colorido pelo estado de execução em tempo real. |
| Reprodução | Repita esta execução ao longo de uma linha do tempo. |
| cadeia de raciocínio | O raciocínio intermediário do Agente. |
| Artefacto | Todos os arquivos de artefato: visualização, download, compartilhar um único arquivo, ou gerar um link público para todo o diretório. |
| Desempenho | Análise da duração pós-execução. |
| Depurar | Aparece quando os pontos de paragem foram definidos ou existe uma sessão de depuração. |
Passo detalhes painel lateral
Clique em um passo na linha do tempo e um painel lateral desliza para fora com tudo sobre ele: Saída, Eventos, Raciocínio, Artefatos e guias de conversação (iteração / interação / etapas de orquestração obter abas extras), além dos tempos de início e fim e um botão "Rerun from this step". A mensagem de erro de um passo falhou e a contagem de repetição também estão aqui.
Atualizações em tempo real (WebSocket)
Enquanto uma execução é RUNNING, a página de detalhes recebe atualizações incrementais sobre WebSocket sem atualização manual. Uma conexão caída reconecta automaticamente (retorno exponencial, até 5 vezes); se isso ainda falhar, ela cai de volta à votação a cada 2 segundos e mostra um aviso.
Tipos de mensagens Push
| Tipo | significado |
|---|---|
full_status | Uma imagem completa do estado da execução |
status_change | Alterações do estado de execução / progresso |
step_update | Uma atualização de status para um único passo |
new_event | Um novo evento de execução (veja os tipos de eventos abaixo) |
artifact_found | Um novo arquivo de artefato foi gerado |
user_interaction_request | Um passo solicita entrada humana, e uma caixa de resposta aparece na aba conversação |
Lista de tipos de eventos
O fluxo de eventos de cada etapa usa o campo tipo para distinguir tipos de eventos. Os comuns, listados pela família:
| tipo de evento | significado |
|---|---|
agent_starting / agent_completed / agent_failed | O ciclo de vida de um passo Agente |
llm_call_starting / llm_call_completed | Uma chamada LLM; o evento completo carrega a contagem de fichas desta chamada |
llm_streaming_starting / llm_streaming_completed / llm_streaming_failed | Fluxo de saída LLM |
tool_call_starting / tool_call_completed / tool_call_failed | Uma chamada de ferramenta do Agente, com argumentos e um resumo do resultado |
external_message / im_message / telegram_message | Enviar/receber mensagens de canal IM |
group_chat_started / group_chat_message / group_chat_summarizing / group_chat_completed | A discussão multi-Agent em uma etapa group chat |
state_machine_started / state_machine_transition / state_machine_state_completed | As transições de estado de um passo estado máquina |
agent_based_started / agent_based_completed | O processo de delegação de uma etapa de orquestração baseada em agentes |
user_interaction_request / user_interaction_message / user_interaction_timeout | Fazer uma pergunta ao usuário no meio da execução, receber uma resposta e esperar um tempo |
claude_code_* | Transmissão de eventos de progresso a partir do tempo de execução do Código Claude |
Os eventos também carregam um campo de categoria (agente / llm / ferramenta / mensagem / estratégia / user interaction), e grupos de filtro de categoria da aba de conversação por ele.
Filtros de visão de conversação
- Busca de palavras-chave — pesquisa o conteúdo da mensagem e o alto-falante
- Filtrar por Agent — veja apenas as mensagens de um Agente ou passo
- Filtro de categoria — Agente / LLM / Ferramenta / Mensagem externa / Estratégia / Interacção
- Activar automaticamente a opção — se deve seguir para baixo à medida que chegam novas mensagens
Tokens e custo
- Os eventos relacionados ao LLM registram os tokens de entrada/saída por chamada, e o cartão de estado os soma ao vivo para mostrar o envio / recebido / total.
- Após a execução terminar,
GET /api/executions/{executionId}/costestima o custo dessa execução utilizando os preços dos modelos utilizados, retornando o total e uma desagregação por etapa. - O custo é estimado depois do uso do token; a plataforma não cita custos antes de uma execução.
Exportar o processo de execução
A ação "Exportar" na barra superior de detalhes ou uma linha de lista exporta uma execução para um arquivo JSON ou YAML contendo o estado de execução, resultados, métricas de desempenho e um instantâneo da definição de workflow e fonte YAML no momento da exportação. Campos sensíveis como senhas, API Keys e endereços webhook são substituídos automaticamente por [REDACTED]. O nome do arquivo se parece com execution-process-79621f70-completed.json.
A definição de workflow na exportação é a versão atual puxada no momento da exportação; se o workflow foi alterado após esta execução, ela pode diferir da definição no momento da execução.
Painel de dados
A visão agregada de execução cruzada está em Análise o painel: execução total, taxa de sucesso, duração média e uso total de tokens, além de tendências de execução, distribuição de status e classificação de workflows superiores, com um intervalo de tempo de 24 horas / 7 dias / 30 dias.
Localização do erro
Quando uma execução é FAILED, primeiro encontre o passo vermelho na linha do tempo e abra seus detalhes: a mensagem de erro está na aba "Saída", e os detalhes do processo estão na aba "Eventos" (um stderr de passo de código está aqui também). Os passos que foram repetidos mostram a contagem de tentativas.
Para como lidar com erros comuns, consulte Resolução de Problemas.
Período de retenção
Registros de execução (status, resultados, eventos, dados de desempenho) e arquivos de artefato são retidos por 90 dias por padrão, após o que a plataforma os limpa em um cronograma; o período exato depende de seu plano ou configuração de implantação, e uma execução em execução nunca é limpa.
Próximo passo
- Depuração de pontos de paragem — Use-o quando você "não consegue entender por que está correndo assim"
- Resolução de Problemas — Erros comuns e como corrigi-los
- Continuar automaticamente — Como lidar com execuções INTERRUPTED