Quando usar
- Você precisa auditar fluxos Eddie em produção e identificar gargalos
- Você quer rastrear quando um Eddie é chamado, o que aconteceu durante a execução, e quando o fluxo terminou
- Você quer estabelecer um processo seguro de teste e melhoria dos fluxos antes de publicar
Pré-requisitos
- Acesso ao Hub do projeto ClaudIA
- Pelo menos um fluxo Eddie publicado e ativo
Sobre este artigo
Para garantir que os fluxos operem corretamente, é essencial monitorar os processos da ClaudIA e do Eddie. O Hub centraliza todos os atendimentos que passam pela ClaudIA — incluindo fluxos chamados pelo Eddie — e permite identificar oportunidades de melhoria.

Visão geral do Hub: tela principal exibindo o histórico de conversas da ClaudIA
O Hub funciona como um painel central que permite auditar, analisar e aprimorar o atendimento ao cliente. Ele oferece visão detalhada do fluxo das conversas, ajudando a identificar gargalos e facilitando a otimização contínua.

Rastreamento de fluxo: exemplo de conversa com indicação do início do fluxo no Eddie e o sinalizador de retorno para a ClaudIA ao final.
Funcionalidades do Hub
-
Registro completo das conversas — todas as mensagens trocadas entre clientes e a ClaudIA ficam armazenadas para análise e auditoria
-
Monitoramento dos fluxos do Eddie — sempre que a ClaudIA aciona um fluxo, o Hub exibe sinalização com o nome do fluxo e as mensagens trocadas, permitindo rastrear a jornada do cliente
-
Indicação do fim de fluxo — quando um fluxo é finalizado, há sinalização de retorno para a ClaudIA, mostrando o momento em que a IA reassumiu o atendimento
-
Auditorias para melhoria contínua — possibilita ajustes estratégicos: refinamento de conteúdos N1/N2, criação de fluxos interativos, identificação de pontos de falha
-
Monitoramento de erros nas requisições — falhas em chamadas de API ou integrações aparecem como bloco de log no momento exato em que ocorreram, facilitando o diagnóstico

Exemplo de log no Hub: indicação de falha na requisição do Eddie
Identificação do momento de chamada do Eddie
-
No Hub é possível visualizar exatamente quando um Eddie foi chamado dentro de uma conversa
-
O início e o término do fluxo são registrados, permitindo rastreamento claro do que aconteceu durante a execução
Processo sugerido de teste e melhoria
Para garantir qualidade e evolução contínua dos fluxos Eddie, siga um processo estruturado. Como o Eddie não tem controle de versão nativo, as boas práticas envolvem backup, testes isolados e validação antes da publicação.
Construção e modularização
-
Divida fluxos complexos em partes menores e reutilizáveis sempre que possível
-
Use chamadas entre fluxos para facilitar manutenção e evitar retrabalho
-
Certifique-se de que todas as condições (if/else) estejam corretamente preenchidas
Testes antes da publicação
-
Antes de publicar qualquer alteração, duplique o fluxo e teste em ambiente isolado
-
Execute simulações completas: lógica de decisão, mensagens enviadas, integrações configuradas
-
Valide os tempos de resposta observando o intervalo entre mensagem do cliente e resposta da ClaudIA no Hub. Isso ajuda a identificar lentidões nas requisições
Evite requisições que possam ultrapassar o tempo limite de 45 segundos. Após esse limite, a requisição é cancelada automaticamente.
Backup e controle de alterações
Como não há sistema nativo de versionamento:
-
Baixe uma cópia do fluxo antes de qualquer modificação
-
Publique apenas após todas as alterações estarem validadas
-
Se precisar fazer downgrade, use a versão salva para restaurar rapidamente
Monitoramento e aprimoramento contínuo
-
Acompanhe a execução dos fluxos no Hub, verificando quais foram chamados e se houve falhas
-
Analise logs e mensagens de erro para identificar pontos de otimização
-
Em casos de falhas recorrentes, ajuste condições de decisão e fluxos alternativos
Esse processo estruturado minimiza erros, otimiza o desempenho do Eddie e melhora a experiência do cliente, garantindo que cada fluxo funcione da melhor forma possível.
Observações
-
Para evitar falhas comuns: Como identificar e evitar falhas nos fluxos e requisições do Eddie
-
Para reduzir erros e aumentar retenção: Como reduzir erros de chamada do Eddie para aumentar a retenção
-
Para validações automáticas no editor: Validação de erros nos fluxos Eddie