Para garantir um atendimento eficiente e fluido, é essencial entender os principais modos de falha que podem ocorrer nos fluxos do Eddie e na comunicação entre Eddie e ClaudIA. Identificar e mitigar essas falhas permite aprimorar a experiência do cliente e evitar interrupções indesejadas.
Timeout e Cancelamento de Requisição
A comunicação entre ClaudIA e Eddie precisa ser rápida e eficiente para garantir um atendimento fluido ao cliente. No entanto, existe uma limitação de tempo para a execução de cada requisição dentro do Eddie. Se esse tempo for ultrapassado, a requisição é cancelada automaticamente, interrompendo o fluxo e impedindo que o cliente receba uma resposta adequada.
Como Funciona o Timeout?
-
Quando ClaudIA chama um fluxo do Eddie, a execução das ações dentro do fluxo deve ocorrer dentro de um tempo limite de 45 segundos.
-
Esse limite existe para garantir que a conversa aconteça em tempo real, sem atrasos perceptíveis para o cliente.
-
Se uma requisição demorar mais do que esse período, o Eddie não consegue completar a ação, resultando no cancelamento da operação e na ausência de resposta para ClaudIA.
Principais Causas de Timeout e Cancelamento de Requisição
APIs com Tempo de Resposta Alto
-
Quando um fluxo do Eddie faz uma chamada a uma API externa, o tempo de resposta pode ser muito longo, ultrapassando o limite permitido.
-
Algumas APIs não são otimizadas para consultas rápidas e podem demorar para processar e retornar dados.
-
Se a API não responder dentro dos 45 segundos, a requisição será cancelada automaticamente, prejudicando a experiência do usuário.
🔹 Como evitar:
Utilize APIs que tenham tempo de resposta rápido (idealmente menos de 2-3 segundos).
Priorize APIs assíncronas ou com respostas em cache para evitar atrasos.
Se precisar de uma API lenta, considere dividir a requisição em partes menores ou usar soluções intermediárias (como armazenar dados temporários).
Falha no Retrieval
-
Isso pode acontecer por erro de configuração, alterações recentes no fluxo ou falha na indexação de dados.
-
Para mitigar esse problema, é essencial revisar e testar regularmente os conteúdos anexados ao fluxo.
Erro de Execução Interna no Eddie
-
O Eddie pode apresentar falhas internas que impedem a execução correta do fluxo.
-
Isso pode ocorrer devido a configurações incorretas, blocos mal estruturados ou uso inadequado de condições lógicas (IF/ELSE).
-
Para minimizar esse risco, é recomendado testar cada fluxo antes da publicação e revisar logs de erro no Hub caso ocorra.
Erro na Execução de Integrações
-
Integrações externas (como chamadas de API, Google Sheets) podem retornar mensagens de erro ou falhar completamente.
-
Quando isso acontece, o Eddie pode seguir um caminho incorreto ou não responder ao cliente.
-
Para mitigar esse problema, configure tratamentos de erro adequados, como:
-
Retornar uma mensagem explicativa para o cliente.
-
Escalar o atendimento para um agente humano (N2).
-
5. Fluxo Incorreto de Execução
-
Em fluxos que utilizam LLMs (Modelos de Linguagem como GPT) para definir a rota de execução, pode haver falhas na escolha do próximo passo.
-
Isso ocorre quando a interpretação do modelo leva a um caminho inesperado ou quando as condições dentro do fluxo não estão bem definidas.
-
Para evitar esse tipo de erro:
-
Defina prompts claros e bem estruturados.
-
Configure respostas condicionais para diferentes cenários.
-
Teste variações do fluxo para garantir previsibilidade.
-
Falha Total do Eddie
-
Em casos extremos, o Eddie pode falhar completamente, impedindo a continuidade do fluxo.
-
Para evitar que o cliente fique preso na conversa, existe uma feature de segurança que escala automaticamente a conversa para N2.
-
Essa escalabilidade garante que, mesmo em um cenário de falha geral, o atendimento ao cliente não seja interrompido.
