Falha de ferramenta em agente de IA

Use este modelo para revisar uma falha real ou testar uma ação antes de colocar o agente em produção. O objetivo é descobrir o estado verdadeiro, recuperar sem duplicar e deixar evidência para a correção.

Identificação

• Data e horário:
• Canal: WhatsApp / voz / chat / e-mail / outro
• Conversa, ticket ou protocolo:
• Agente ou fluxo:
• Ferramenta chamada:
• Pessoa que revisou:

Intenção e autorização

Tentativa

Estado depois da falha

Marque apenas o que pode ser provado no sistema responsável.

• Não executado: existe evidência de que nada mudou.
• Executado: existe registro, protocolo ou identificador confirmado.
• Revertido: a ação aconteceu e uma compensação foi confirmada.
• Desconhecido: ainda não é possível provar se aconteceu.

Decisão de recuperação

Escolha uma saída:

• Verificar de novo com intervalo e limite.
• Repetir com a mesma chave idempotente.
• Corrigir a entrada e pedir nova confirmação.
• Executar ação compensatória aprovada.
• Abrir tarefa para humano com todo o contexto.
• Combinar retorno e não executar mais nada automaticamente.

Mensagem para o cliente

Preencha sem anunciar sucesso que o sistema não confirmou.

Modelo curto:

> A tentativa não retornou confirmação. Não vou repetir antes de verificar para evitar uma ação duplicada. Registrei o pedido no protocolo ______ e retorno por ______ até ______. Você não precisa enviar os dados de novo.

Handoff para humano

• Motivo e intenção do cliente acompanham a passagem.
• Entradas e tentativas já feitas estão registradas.
• Último estado confirmado está explícito.
• Risco de repetição ou duplicidade está destacado.
• Primeira ação esperada está escrita.
• Fila, pessoa ou papel responsável foi definido.
• Prazo informado ao cliente é visível.

Correção e reteste

Rode novamente:

• Rejeição antes da execução.
• Timeout antes da execução.
• Timeout depois da execução.
• Resposta atrasada.
• Ferramenta indisponível.
• Recuperação ou handoff também falha.

Regra de parada

O agente para de executar sozinho quando:

• não sabe se a ação anterior aconteceu;
• não consegue verificar pelo identificador;
• repetir pode cobrar, reservar, cancelar, alterar ou enviar duas vezes;
• sistema e conversa mostram estados diferentes;
• a recuperação exige exceção ou autoridade humana;
• não consegue informar prazo, protocolo e próxima ação confiáveis.