Idempotência: como evitar ações duplicadas em agentes de IA

O cliente pede para agendar um horário. O agente chama o sistema, a resposta demora, ele tenta de novo, e o horário é agendado duas vezes. Esse tipo de problema, comum em integrações, tem solução bem conhecida: a idempotência. Neste artigo, você entenderá o conceito de forma simples e como aplicá-lo. --- ## 1. O que significa idempotência É a propriedade de uma operação que, repetida várias vezes com os mesmos dados, produz o mesmo resultado que se fosse feita uma só vez. Consultar é naturalmente idempotente. Criar um registro, em geral, não é. --- ## 2. Onde o problema aparece - **Novas tentativas** depois de uma falha de rede. - **Mensagens duplicadas** enviadas pelo canal. - **Cliente que repete o pedido** por achar que não funcionou. --- ## 3. Como proteger o sistema Uma prática comum é enviar um identificador único junto com a ação. Se o sistema receber o mesmo identificador de novo, reconhece a repetição e não duplica. Essa tarefa é do sistema que recebe, em conjunto com quem integra. --- ## 4. Verifique antes de criar Outra forma é consultar se o registro já existe antes de criar um novo. O agente pode checar a agenda, por exemplo, para ver se o horário já foi marcado para aquele cliente. --- ## 5. Confirme com o cliente Depois de realizar a ação, o agente confirma com clareza o que foi feito. Quando o cliente vê a confirmação, evita repetir o pedido. --- ## 6. Exemplo prático O cliente pede para marcar uma consulta e a conexão cai logo depois da solicitação. O agente tenta de novo. Com um identificador único para aquele pedido, o sistema percebe que é o mesmo e mantém um único agendamento. Sem ele, o cliente teria dois horários marcados. --- ## 7. Combine com a equipe técnica A garantia de não duplicar depende também do sistema de destino. Converse com quem mantém agenda, ERP ou CRM e confirme se há suporte a identificadores únicos ou verificações de existência. Planeje junto a solução mais simples que funcione. --- ## Conclusão Duplicações são evitáveis com identificadores únicos, verificações prévias e confirmações claras. Inclua esses cuidados em qualquer integração que crie ou altere dados.