Reconciliação em agentes de IA: como corrigir estados

O sistema voltou, mas o processo ainda pode estar errado

Um agente envia atualizações ao CRM durante a manhã. A integração sofre instabilidade, algumas respostas expiram e o fluxo entra em contingência. Vendedores assumem casos urgentes manualmente.

Horas depois, a API volta a responder. Religar a fila parece o próximo passo. Também é a forma mais rápida de criar tarefas duplicadas, sobrescrever decisões humanas e enviar mensagens que perderam validade.

A recuperação técnica confirma que os componentes estão disponíveis. A recuperação operacional exige descobrir o que aconteceu com cada unidade de trabalho.

A reconciliação em agentes de IA compara o estado registrado pela automação com o sistema que possui autoridade sobre o efeito. Ela confirma ações concluídas, identifica falhas sem consequência, bloqueia conflitos e define o destino seguro de casos incertos.

Sem essa disciplina, a empresa pode ter vários sistemas funcionando e continuar sem saber qual deles representa a realidade.

Quando a reconciliação é necessária

A reconciliação entra quando existe distância possível entre comando, consequência e registro.

Cenários comuns:

• timeout depois de uma escrita;
• resposta de sucesso sem identificador verificável;
• webhook entregue novamente;
• worker reiniciado durante uma ação;
• fila retomada depois de indisponibilidade;
• operação manual durante contingência;
• duas automações atuando no mesmo objeto;
• atualização concorrente feita por uma pessoa;
• migração de versão com unidades em andamento;
• confirmação recebida fora de ordem;
• sistema oficial disponível, mas telemetria indisponível;
• correção de incidente em lote;
• reversão parcial de uma mudança;
• troca de fornecedor ou integração.

Ela também pode funcionar como controle periódico. Uma rotina diária ou por ciclo encontra unidades antigas demais, efeitos sem confirmação e divergências que não geraram erro técnico.

Reconciliação, idempotência e contingência cumprem papéis diferentes

Os três controles se conectam.

Idempotência protege a repetição

A idempotência em agentes de IA define a unidade do efeito, reserva uma chave estável e impede que uma nova tentativa produza a mesma consequência novamente.

Contingência preserva o serviço

O plano de contingência para agentes de IA organiza prioridades, capacidade manual, modos degradados e registros enquanto uma capacidade está indisponível.

Reconciliação restabelece um estado confiável

Ela compara registros, incorpora ações manuais, resolve ambiguidades e devolve cada unidade ao ponto correto do fluxo.

Idempotência reduz a quantidade de divergências. Contingência mantém trabalho e evidência durante a falha. Reconciliação fecha a lacuna restante antes da retomada completa.

Comece pela autoridade de cada objeto

Reconciliar exige saber qual sistema decide o estado final.

Em um processo comercial, por exemplo:

• o CRM pode governar estágio, responsável e próxima ação;
• o provedor de mensagens confirma entrega;
• a agenda governa o compromisso marcado;
• o contrato aprovado governa condição comercial;
• o agente mantém estado de execução, mas não substitui esses registros.

Para cada objeto, documente:

1. sistema oficial;
2. identificador estável;
3. campos governados;
4. eventos que alteram o estado;
5. versão ou horário da última mudança;
6. condição de conclusão;
7. evidência de confirmação;
8. regra para conflito;
9. responsável por exceções.

O guia sobre fonte da verdade para agentes de IA ajuda a definir essa autoridade. Memória, cache, fila e trace fornecem contexto. Eles não ganham precedência apenas porque são mais fáceis de consultar.

Defina a unidade reconciliada

A unidade precisa representar um efeito ou resultado de negócio verificável.

Exemplos:

• tarefa de follow-up da reunião identificada;
• mensagem de cobrança referente a uma parcela;
• atualização de endereço de um pedido;
• criação de lançamento preliminar de uma nota;
• agendamento ligado a uma solicitação;
• aprovação de uma versão de documento;
• encaminhamento de um chamado para uma fila.

Evite reconciliar “a execução do agente” como um bloco único. Uma execução pode produzir vários efeitos, e cada efeito pode possuir autoridade e confirmação próprias.

Registre para cada unidade:

• work_item_id;
• objeto empresarial;
• ação pretendida;
• chave de idempotência;
• versão esperada do objeto;
• estado local;
• destino oficial;
• identificador devolvido;
• última confirmação;
• tentativas;
• ação manual conhecida;
• prazo de validade;
• responsável atual.

Essa estrutura permite comparar o que o agente pretendia, o que enviou e o que o destino realmente registrou.

Use uma máquina de estados explícita

Um campo genérico como falhou não sustenta reconciliação.

Estados úteis podem incluir:

• preparado;
• autorizado;
• enviado;
• confirmado;
• falhou_sem_efeito;
• resultado_incerto;
• conflito_detectado;
• concluido_manualmente;
• exige_reconciliacao;
• reconciliando;
• reprocessamento_autorizado;
• encerrado_sem_execucao;
• expirado.

Cada transição precisa declarar a evidência exigida.

enviado → confirmado pode exigir um ID retornado e uma consulta posterior no destino. resultado_incerto → falhou_sem_efeito exige prova de que o objeto não existe. concluido_manualmente → confirmado exige registro da ação humana no sistema oficial.

O agente pode ajudar a resumir o caso. A transição que libera nova escrita deve ser aplicada por regra determinística ou pessoa autorizada.

Colete três visões do mesmo caso

A reconciliação costuma comparar três perspectivas.

Intenção registrada

O que a operação autorizou o agente a fazer:

• ação;
• objeto;
• parâmetros validados;
• versão esperada;
• política aplicada;
• aprovação recebida.

Execução observada

O que o fluxo realmente tentou:

• ferramenta chamada;
• identidade usada;
• horário;
• tentativas;
• timeout ou retorno;
• identificador técnico;
• eventos de fila;
• confirmação recebida.

Estado oficial

O que o sistema de destino mostra agora:

• objeto encontrado ou ausente;
• campos atuais;
• versão;
• responsável;
• histórico de alterações;
• ação manual;
• duplicidades;
• status final.

A divergência entre essas visões define a próxima decisão.

Classifique os resultados da comparação

Uma taxonomia curta ajuda a automatizar os casos claros e encaminhar o restante.

Confirmado

A intenção autorizada corresponde ao efeito encontrado no destino. Identidade, objeto, versão e valores coincidem.

Ação: registrar confirmação e avançar a unidade.

Falha sem efeito

Existe evidência de que a ação foi recusada ou não chegou ao compromisso externo.

Ação: corrigir a causa e permitir nova tentativa somente dentro da política.

Efeito existente sem confirmação local

O destino possui o objeto esperado, mas a automação perdeu a resposta.

Ação: importar identificador e estado, marcar a unidade como confirmada e bloquear repetição.

Conclusão manual

Uma pessoa resolveu o caso durante pausa ou contingência.

Ação: vincular a ação manual à unidade, confirmar o estado oficial e impedir execução automática atrasada.

Conflito de versão

O objeto mudou depois da leitura do agente. A ação preparada usa contexto antigo.

Ação: cancelar a intenção anterior e reavaliar com o estado atual.

Duplicidade

Mais de um efeito corresponde à mesma unidade protegida.

Ação: bloquear avanço, preservar evidência e encaminhar correção com autoridade adequada.

Divergência de conteúdo

O objeto existe, mas campos, valor, destinatário ou condição não correspondem ao autorizado.

Ação: tratar como exceção ou incidente conforme impacto.

Ausência de evidência

Nenhuma camada consegue confirmar o resultado.

Ação: manter bloqueio, aprofundar consulta ou encaminhar decisão humana. Ausência de log não prova ausência de efeito.

Efeito expirado

A ação ainda não ocorreu, mas perdeu validade. Um lembrete, preço, agenda ou condição comercial pode ter mudado.

Ação: encerrar a intenção antiga e criar nova unidade somente se o processo atual justificar.

Desenhe o fluxo de reconciliação

Uma rotina segura pode seguir esta sequência.

1. Feche a fronteira de novas mudanças

Pause a ação ou classe afetada enquanto a comparação acontece. Continuar gravando no mesmo objeto transforma a base de análise em alvo móvel.

2. Extraia unidades candidatas

Selecione:

• estados incertos;
• unidades antigas demais;
• tentativas sem confirmação;
• casos processados durante a janela de falha;
• ações manuais registradas;
• itens de versões afetadas;
• divergências levantadas por usuário ou monitoramento.

3. Normalize identificadores

Relacione evento, unidade, chave de idempotência, objeto, cliente, execução, tentativa e ID do destino. Evite comparar apenas texto, nome ou horário aproximado.

4. Consulte os sistemas oficiais

Use APIs, relatórios ou consultas autorizadas. Preserve horário e versão do dado obtido.

5. Aplique regras de correspondência

Compare identidade, ação, valor, versão, status e janela. Regras determinísticas resolvem casos exatos. Correspondências ambíguas seguem para revisão.

6. Classifique a divergência

Use a taxonomia operacional e registre evidência suficiente para reproduzir a decisão.

7. Corrija o estado local

Importe confirmações perdidas, vincule ações manuais, marque falhas sem efeito e bloqueie conflitos.

8. Autorize o destino

Cada unidade recebe uma decisão: concluir, reprocessar, corrigir, cancelar, expirar, escalar ou investigar.

9. Retome por classes

Libere primeiro casos confirmados e de baixo risco. Monitore volume, duplicidade, latência e falha antes de ampliar.

10. Encerre com relatório

Registre cobertura, divergências, correções, casos pendentes, responsáveis e prazo para revisão.

Correspondência precisa ser conservadora

O maior risco da reconciliação é declarar equivalência onde existem apenas semelhanças.

Use identificadores fortes sempre que possível:

• ID de evento;
• chave de idempotência;
• ID externo gravado no destino;
• protocolo da API;
• versão do objeto;
• combinação autorizada de contrato, competência e ação.

Sinais fracos, como nome parecido, valor igual ou horário próximo, podem ajudar a encontrar candidatos. Eles não deveriam confirmar sozinhos uma ação financeira, comunicação externa ou mudança sensível.

Quando a correspondência exigir julgamento, mostre:

• registros candidatos;
• campos iguais e divergentes;
• fontes;
• horários;
• ações posteriores;
• risco de confirmar errado;
• opções permitidas.

A pessoa decide com contexto. O agente não deve escolher silenciosamente o candidato mais parecido.

Considere a consistência eventual

Alguns sistemas aceitam a escrita e demoram para disponibilizar o registro em consultas. Uma busca imediata pode indicar ausência mesmo quando o efeito existe.

Defina por integração:

• janela normal de propagação;
• consulta principal e alternativa;
• quantidade máxima de verificações;
• intervalo e backoff;
• estado durante a espera;
• momento de escalar;
• retenção da chave de idempotência.

Esperar dentro de uma janela conhecida é diferente de repetir a escrita. O fluxo consulta o estado até confirmar ou até entrar em reconciliação humana.

Trate ações manuais como eventos oficiais

Durante uma falha, a equipe pode atender cliente, atualizar cadastro, criar tarefa ou processar pagamento fora da automação.

Essas ações precisam de:

• identificador da unidade;
• responsável;
• horário;
• sistema usado;
• resultado;
• evidência;
• observação sobre trabalho pendente;
• marcação que bloqueie repetição.

Uma planilha temporária pode servir em operação pequena, desde que possua campos obrigatórios, controle de acesso e retorno ao sistema oficial. Mensagens soltas não oferecem base confiável para reconciliação.

Ao restaurar o agente, consulte as ações manuais antes de liberar o backlog. O sistema deve assumir o estado atual, e não impor a intenção antiga sobre trabalho já concluído.

Reprocessamento exige nova autorização operacional

Encontrar uma falha sem efeito não significa que a ação ainda deve acontecer.

Antes de reprocessar, confirme:

• objeto continua ativo;
• prazo ainda é válido;
• cliente ou responsável não mudou;
• política permanece vigente;
• fonte foi atualizada;
• ação manual não ocorreu;
• chave original será reutilizada;
• versão atual entende o estado antigo;
• capacidade do destino suporta o lote;
• monitoramento está reforçado.

Uma tarefa comercial atrasada pode ter perdido sentido. Uma cobrança pode ter sido quitada por outro canal. Um agendamento pode ter sido alterado. Reprocessar com segurança inclui verificar utilidade, além de evitar duplicidade.

A fila de erros para agentes de IA pode preservar unidades que esgotaram tentativas. A reconciliação decide se e como elas retornam ao fluxo.

Use IA para preparar a análise, com limites

A IA pode reduzir trabalho em lotes grandes.

Ela pode:

• resumir trajetória e tentativas;
• agrupar divergências por causa;
• localizar registros candidatos;
• comparar campos textuais;
• destacar mudanças entre versões;
• preparar pacote para decisão;
• sugerir prioridade;
• gerar relatório de cobertura.

Ela não deveria:

• confirmar identidade por semelhança fraca;
• criar nova chave para contornar bloqueio;
• assumir que ausência de retorno representa falha;
• escolher qual sistema tem autoridade;
• executar correção sensível sem regra ou aprovação;
• apagar evidência depois da conciliação;
• liberar o próprio reprocessamento.

A interpretação pode ser probabilística. A autorização da consequência precisa permanecer em política verificável.

Exemplo: reconciliação de follow-ups no CRM

Um agente revisa oportunidades e cria tarefas de acompanhamento.

Durante duas horas, o CRM aceitou escritas, mas devolveu timeout em parte das chamadas. Vendedores também criaram tarefas manualmente.

Unidade

Tarefa ligada ao compromisso de uma oportunidade e reunião específicas.

Chave

followup + oportunidade + reuniao + compromisso

Comparação

A rotina consulta oportunidade, tarefas atuais, histórico de alterações e registros manuais. Ela verifica responsável, data, tipo de ação e chave externa.

Resultados

• tarefa encontrada com a chave: confirmar sem repetir;
• tarefa manual equivalente: vincular e cancelar intenção automática;
• oportunidade encerrada: expirar a unidade;
• duas tarefas equivalentes: bloquear e enviar para correção;
• nenhuma tarefa e oportunidade ativa: autorizar reprocessamento com a mesma chave;
• condição comercial mudou: reavaliar, sem criar tarefa antiga.

Retomada

A fila retorna por pequenos lotes durante horário com equipe disponível. Duplicidades, conflitos de versão e falhas de confirmação recebem alerta específico.

Exemplo: reconciliação de lançamentos financeiros

Uma automação prepara lançamentos a partir de documentos e pedidos.

Autoridades

• ERP governa o lançamento;
• pedido governa itens e valor contratado;
• documento fiscal governa dados fiscais;
• fluxo local governa somente estado de processamento.

Comparação

Use CNPJ, número do documento, série, competência, pedido, valor, moeda e identificador externo. Valor e fornecedor isolados são insuficientes.

Destinos

• lançamento exato encontrado: confirmar;
• lançamento manual exato: vincular;
• divergência de valor: bloquear;
• duplicidade: encaminhar ao financeiro;
• documento cancelado: encerrar sem execução;
• ausência confirmada: permitir nova preparação, mantendo aprovação financeira.

O agente pode organizar o pacote. A decisão sobre correção, estorno ou pagamento permanece com a alçada definida pela empresa.

Métricas da reconciliação

Acompanhe:

• unidades candidatas;
• percentual reconciliado automaticamente;
• confirmações recuperadas;
• falhas sem efeito;
• conclusões manuais incorporadas;
• conflitos de versão;
• duplicidades encontradas;
• divergências de conteúdo;
• casos sem evidência;
• itens expirados;
• tempo até estado confiável;
• backlog por idade e risco;
• reprocessamentos autorizados;
• falhas depois do reprocessamento;
• causas por integração e versão;
• horas humanas consumidas;
• incidentes evitados na retomada.

A taxa automática isolada pode incentivar correspondência permissiva. Leia cobertura junto com correções posteriores, falsos vínculos e impacto por classe.

O relatório de encerramento

Ao fim da rotina ou da recuperação, produza uma visão curta:

• janela analisada;
• sistemas e versões envolvidos;
• quantidade de unidades;
• estados encontrados;
• correções executadas;
• duplicidades e conflitos;
• casos ainda bloqueados;
• responsáveis e prazos;
• regras alteradas;
• testes adicionados;
• critério para encerrar monitoramento reforçado.

O relatório precisa apontar os registros de evidência. Totais sem rastreabilidade ajudam a gestão, mas não permitem corrigir uma unidade contestada.

Checklist de reconciliação

• [ ] Cada efeito possui uma unidade identificável?
• [ ] O sistema oficial de cada objeto está definido?
• [ ] Intenção, execução e estado oficial podem ser comparados?
• [ ] A chave de idempotência permanece igual entre tentativas?
• [ ] Existem estados próprios para resultado incerto e conflito?
• [ ] Novas mudanças são limitadas durante a comparação?
• [ ] A correspondência usa identificadores fortes?
• [ ] Consistência eventual possui janela conhecida?
• [ ] Ações manuais entram como eventos oficiais?
• [ ] Divergências sensíveis exigem autoridade humana?
• [ ] Reprocessamento verifica validade atual da ação?
• [ ] A retomada ocorre por classe e volume controlado?
• [ ] Métricas distinguem confirmação, falha, duplicidade e conflito?
• [ ] A causa recorrente volta para integração, política ou processo?
• [ ] O encerramento deixa evidência e pendências com dono?

Reconciliação devolve autoridade à operação

Agentes trabalham entre filas, modelos, ferramentas, pessoas e sistemas oficiais. Nesse percurso, uma resposta perdida pode esconder um sucesso, uma tarefa manual pode tornar o backlog obsoleto e uma nova tentativa pode repetir uma consequência já realizada.

A reconciliação impede que a retomada seja conduzida por suposição. Ela compara o que foi autorizado, o que foi executado e o que a fonte da verdade registra. Depois, confirma, corrige, expira, bloqueia ou reprocessa cada unidade com evidência.

Essa capacidade preserva memória operacional sem criar uma realidade paralela dentro do agente. Quando os sistemas divergem, a arquitetura precisa saber quem governa o estado e como recuperar a confiança antes de acelerar novamente.