Timeouts e novas tentativas em integrações de agentes de IA

Quando o agente chama um sistema externo e a resposta não vem, o que acontece? Se nada estiver configurado, a conversa pode ficar parada por muito tempo, e o cliente pensa que foi ignorado. Tempos limite e retentativas são o que dá previsibilidade a esse cenário. Neste artigo, você entenderá como esses recursos funcionam e como defini-los. --- ## 1. O que é timeout É o tempo máximo que o agente espera por uma resposta antes de desistir. Sem ele, uma integração lenta trava todo o atendimento. Com um limite razoável, o agente segue e trata a falha. --- ## 2. Como escolher o tempo Considere a rapidez esperada do sistema e a paciência do cliente no WhatsApp. Consultas simples devem ser rápidas, e esperar muito prejudica a experiência. Teste o tempo real de resposta antes de decidir. --- ## 3. Retentativas Em falhas passageiras, tentar de novo pode resolver. Defina poucas tentativas, com um intervalo entre elas, para não aumentar a carga em um sistema que já está com dificuldades. --- ## 4. Cuidado com ações que alteram dados Repetir uma consulta é seguro. Repetir uma ação, como criar um pedido, pode duplicar o resultado. Para esses casos, use mecanismos que evitem a duplicação. --- ## 5. Informe o cliente quando demorar Se a consulta leva alguns segundos, o agente pode avisar que está verificando. A mensagem evita a sensação de silêncio. --- ## 6. Monitore tempos de resposta Acompanhe médias e picos. Aumentos graduais indicam problemas que merecem atenção antes de virarem falhas. --- ## 7. Exemplo de configuração Uma consulta de agenda pode ter tempo limite de poucos segundos e até duas novas tentativas, com um pequeno intervalo entre elas. Já uma ação que cria um registro pode ter apenas uma tentativa, seguida de verificação do que aconteceu. Ajuste conforme o impacto de cada operação. --- ## 8. Teste com lentidão simulada Introduza atrasos propositais em um ambiente de teste e veja como o agente se comporta. Verifique se as mensagens para o cliente são claras e se o sistema respeita os limites definidos. --- ## Conclusão Defina limites claros, poucas tentativas e proteção contra duplicações. O resultado é um atendimento mais estável e uma experiência mais previsível.