# Registro de falha de ferramenta do agente

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

| Campo | Preencher |
|---|---|
| O que o cliente pediu | |
| Ação: consultar, criar, alterar, cancelar, cobrar ou enviar | |
| O que foi confirmado antes de executar | |
| Limite da autorização | |
| Dado ou regra necessária | |

## Tentativa

| Campo | Preencher |
|---|---|
| Identificador estável da tentativa | |
| Ferramenta e operação | |
| Entrada enviada | |
| Horário de início | |
| Resposta recebida | sucesso / rejeição / erro / timeout / nenhuma |
| Código ou mensagem de erro | |
| Número de tentativas | |
| A mesma chave foi preservada? | sim / não / não existe |

## 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.

| Verificação | Preencher |
|---|---|
| Último estado confirmado | |
| Onde foi verificado | |
| Identificador encontrado | |
| Existe efeito duplicado? | |
| Cliente e sistema mostram o mesmo estado? | |

## Decisão de recuperação

| Pergunta | Resposta |
|---|---|
| É apenas leitura, sem efeito colateral? | |
| A ação aceita repetição com a mesma chave? | |
| É possível consultar antes de repetir? | |
| A ação é reversível? | |
| Dinheiro, prazo, cancelamento, reserva ou envio podem duplicar? | |
| Uma pessoa precisa assumir? | |

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.

| Parte | Texto |
|---|---|
| O que não foi confirmado | |
| O que será verificado | |
| O cliente precisa fazer algo? | |
| Protocolo | |
| Prazo realista | |
| Canal do retorno | |

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

| Campo | Preencher |
|---|---|
| Causa provável | entrada / regra / credencial / latência / indisponibilidade / integração / estado |
| Correção | |
| Dono | |
| Prazo | |
| Alerta que faltou | |
| Conversas ou clientes afetados | |
| Como reconciliar os casos afetados | |
| Data do 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.