Rastro de decisão do agente de IA: o que registrar, por quanto tempo guardar e como provar o que a IA fez

Resposta rápida

Quando um agente de IA toma uma decisão na sua empresa, você precisa guardar sete coisas: quem pediu, o que o agente recebeu, qual versão do modelo e das instruções rodou, quais ferramentas ele chamou, o que ele devolveu, quem aprovou (se alguém aprovou) e o que aconteceu depois. Cada registro leva data, hora e um identificador que liga todos os passos da mesma decisão. A regra prática é guardar por no mínimo seis meses, que é o piso que o AI Act europeu fixa para sistemas de alto risco, e estender o prazo conforme o setor, o contrato e o risco de contestação. Para provar o que a IA fez, o registro precisa ser gravado fora do alcance do próprio agente e de quem o opera, de preferência em armazenamento que só aceita acréscimo.

Eu uso agentes em produção todos os dias na operação da CPDF (Comunidade Profissionais do Futuro - por Danilo Gato), e o que segue é o desenho que eu montaria se tivesse que explicar a um auditor, a um juiz ou a um cliente bravo o que o agente fez numa terça-feira às 14h.

Por que o log comum do sistema não resolve

Um log de servidor responde “a requisição chegou e o código rodou”. Um agente de IA exige mais, porque a decisão não está escrita em código: ela sai de um modelo, a partir de instruções, de documentos consultados e de ferramentas chamadas no caminho. Se você guarda só a resposta final, perde exatamente o que alguém vai perguntar: por que ele decidiu isso?

Três situações em que a falta de registro custa caro:

1. Um cliente contesta uma decisão (um desconto negado, um cadastro recusado, uma cobrança). Sem o contexto que o agente viu, você não consegue nem confirmar nem desmentir.
2. O agente erra e você precisa saber o tamanho do estrago. Quantas decisões usaram a mesma instrução defeituosa? Sem versão registrada, a resposta é “não sei”.
3. Um auditor ou regulador pede evidência. Declaração de que “a IA funciona bem” não vale como prova. Registro vale.

Se você quer ver como esse tipo de falha aparece na prática, o caso real está em Agente de IA em produção: o que ele faz sozinho, quanto custa e o que já quebrou.

O que registrar: os sete campos de cada decisão

Monte um registro por decisão, não um arquivo de texto corrido. Cada decisão ganha um decision_id, e todos os passos dela carregam esse mesmo identificador.

Campo	O que guardar	Por que importa
1. Origem	Quem ou o que disparou (usuário, e-mail, rotina agendada, outro agente) e com que permissão	Define a responsabilidade e o escopo
2. Entrada	O texto ou os dados que o agente recebeu, com os dados pessoais mascarados quando possível	É o “o que ele sabia”
3. Versão	Nome e versão do modelo, versão do prompt de sistema, versão das regras e dos documentos de apoio	Permite reproduzir e medir o alcance de um erro
4. Ferramentas	Cada chamada: qual ferramenta, com quais parâmetros, o que voltou, quanto demorou	É o “o que ele fez” de verdade
5. Saída	A resposta ou a ação final, antes e depois de qualquer filtro	É a decisão em si
6. Revisão humana	Se houve aprovação: quem, quando, o que mudou, o que deixou passar	Separa decisão automatizada de decisão assistida
7. Desfecho	O que aconteceu depois (enviado, revertido, contestado, corrigido)	Fecha o ciclo e alimenta a melhoria

Dois cuidados que poupam dor de cabeça:

• Registre a decisão e o motivo declarado, mas não confie no “raciocínio” do modelo como prova. O texto que o modelo escreve para justificar uma decisão é uma explicação plausível, não um retrato fiel do cálculo interno. Guarde a justificativa como informação útil, e guarde as entradas e as ferramentas como evidência.
• Registre também o que o agente NÃO fez. Uma recusa, um pedido de ajuda a um humano e uma ação bloqueada por regra são decisões, e é nelas que o auditor costuma olhar primeiro.

Um exemplo de registro, campo a campo

Imagine um agente de atendimento que analisa um pedido de reembolso. Um registro enxuto fica assim:

decision_id: 2026-10-24-000417
origem: cliente via chat, plano Pro, permissão: ler pedido, sugerir reembolso até R$ 300
entrada: "comprei duas vezes por engano" (CPF mascarado)
versao: modelo X v2 / prompt-reembolso v14 / politica-reembolso 2026-09
ferramentas: consulta_pedido(id=8841) -> 2 cobranças iguais, 11h02 e 11h03
saida: reembolso de R$ 149 aprovado para a cobrança duplicada
revisao_humana: dispensada (valor abaixo do limite de R$ 300)
desfecho: estorno confirmado em 24/10 15h20, cliente respondeu "ok"

Com isso, qualquer pessoa reconstrói a decisão sem precisar adivinhar. E se amanhã a política de reembolso mudar, você sabe que essa decisão seguiu a versão de setembro.

Quanto tempo guardar

Não existe um número único, e quem promete um está simplificando. O que existe são pisos e razões para guardar mais:

• AI Act europeu (artigos 19 e 26): quem fornece e quem usa sistemas de IA de alto risco deve manter os logs gerados automaticamente por no mínimo seis meses, salvo outra norma exigir mais, em especial a de proteção de dados. Vale para empresa brasileira que atende o mercado europeu. A Comissão Europeia resume o dever dos usuários no Service Desk do AI Act.
• LGPD: a lei exige que controlador e operador mantenham registro das operações de tratamento de dados pessoais (artigo 37), e o princípio da responsabilização e prestação de contas (artigo 6, inciso X) obriga a demonstrar as medidas adotadas. A lei não fixa um prazo. O prazo é o que for necessário para a finalidade, e depois disso os dados pessoais devem ser eliminados (artigo 16). Isso cria uma tensão real: guardar para provar versus apagar para proteger. A saída é guardar a evidência com os dados pessoais mascarados ou separados, e apagar o dado bruto no prazo definido.
• Prazo de contestação do seu negócio: se um contrato, uma venda ou uma cobrança pode ser contestada por anos, o registro das decisões ligadas a ele precisa durar pelo menos esse tempo.

Uma política simples para começar: decisões de baixo risco, seis meses. Decisões que afetam dinheiro, acesso, emprego ou saúde de alguém, o prazo de contestação do caso, com revisão anual. Escreva isso numa página e aprove com o jurídico.

Como provar que o registro não foi alterado

Guardar não basta. Se o próprio agente, ou o time que o opera, consegue editar o log, ele perde valor de prova. Quatro práticas resolvem a maior parte:

1. Grave fora do agente. O agente escreve o registro por uma interface que só aceita acréscimo. Ele não tem permissão de ler nem de apagar o histórico.
2. Use armazenamento de acréscimo. Muitos serviços de nuvem oferecem armazenamento com bloqueio de exclusão por um período definido. Ative esse bloqueio para os logs de decisão.
3. Encadeie os registros com hash. Cada registro guarda o resumo criptográfico do anterior. Se alguém alterar um registro antigo, a cadeia quebra e a verificação automática acusa.
4. Sincronize relógios. Um carimbo de data confiável (mesma fonte de hora em todos os sistemas) evita a discussão sobre o que veio primeiro.

Teste uma vez por trimestre: sorteie dez decisões, peça a alguém de fora da equipe do agente para reconstruir cada uma só com o registro. Onde a reconstrução falhar, falta campo.

Perguntas frequentes

Preciso guardar o texto completo que o cliente enviou?

Guarde o necessário para reconstruir a decisão e mascare o que for dado pessoal sensível. Se o texto completo for indispensável, guarde-o em local separado, com acesso restrito e prazo próprio de exclusão. O artigo sobre IA e LGPD na empresa detalha como separar o que é evidência do que é dado pessoal.

O titular dos dados pode pedir explicação sobre uma decisão da IA?

Pode. O artigo 20 da LGPD dá ao titular o direito de pedir a revisão de decisões tomadas apenas com base em tratamento automatizado que afetem seus interesses, e o controlador deve informar os critérios e procedimentos usados, observados os segredos comercial e industrial. Quando existe revisão humana de verdade antes da decisão, o cenário muda, e é por isso que o campo 6 do registro importa tanto: ele mostra se um humano realmente decidiu ou só clicou em “aprovar”.

O PL 2338 vai mudar o que preciso registrar?

Provavelmente vai reforçar. O projeto de regulação da IA, que passou pelo Senado e tramita na Câmara dos Deputados (em março de 2026 ainda estava em análise, segundo o alerta do escritório Demarest), trata de sistemas de alto impacto e de dever de transparência. Confira a tramitação atual antes de fechar sua política. Eu resumi o que o texto pede em Regulamentação da IA no Brasil: o que o PL 2338 exige da sua empresa.

Quem responde se o agente errar: a empresa ou o fornecedor do modelo?

Perante o cliente, quase sempre a empresa que ofereceu o serviço. O contrato com o fornecedor define o que você consegue cobrar de volta, e o seu registro é a prova de que o erro veio de lá e não de uma instrução sua. Sem registro, o ônus de provar fica com você.

Isso vale só para agentes grandes, ou para um assistente simples também?

Vale a partir do momento em que a IA decide ou recomenda algo que afeta uma pessoa ou um valor. Para um assistente que só resume textos internos, um registro mínimo basta (quem usou, quando, qual versão). Para um agente que age, use os sete campos completos.

Como isso se liga à auditoria interna?

O registro de decisões é a matéria-prima do controle interno. O auditor testa uma amostra, verifica se a política foi seguida e se há revisão humana onde deveria haver. Veja como montar esse controle em IA para auditoria e compliance.

Checklist para começar esta semana

• Liste os agentes que já tomam alguma decisão e classifique cada um por risco (baixo, médio, alto).
• Defina os sete campos e um decision_id comum, mesmo que no começo seja uma planilha alimentada por script.
• Mova o armazenamento do log para fora do alcance do agente.
• Escreva a política de retenção em uma página e leve ao jurídico.
• Marque na agenda o teste trimestral de reconstrução.

Quem registra bem decide melhor, corrige mais rápido e dorme tranquilo quando alguém pergunta “por que a IA fez isso?”. Quem não registra descobre o preço na pior hora.