Pular para o conteúdo

Soluções · IA aplicada e agentes

Agente sem trilha de auditoria: o que falta registrar

O agente executou uma ação e não existe registro de como ela foi decidida. Como diagnosticar o que falta?

Resposta direta

Antes de procurar ferramenta, vale separar três coisas: o que o agente decidiu, o que ele executou e quem respondeu por aquela ação. Sem essas três ligadas pelo mesmo identificador, não existe trilha. O diagnóstico começa pela ação de maior impacto e segue o caminho inverso: do efeito no sistema para o pedido original. Onde o identificador se perde, ali está a lacuna. Registrar depois não resolve, porque a trilha nasce no desenho do fluxo e não no fim dele. O resultado é uma lista de campos que precisam existir antes da execução.

Objetivo
Diagnosticar
Formato indicado
Workshop executivo
Atualizado em

O que esta página acrescenta: Parte do efeito já produzido no sistema e mostra onde reconstruir a cadeia de decisão, em vez de tratar supervisão ou limites de atuação.

Onde a cadeia de registro se rompe

Trilha de auditoria é a ligação entre três registros: o pedido que originou a ação, a decisão do agente e a execução no sistema. Muitas operações têm os três, guardados em lugares diferentes, sem nada que os una. O log da ferramenta mostra a chamada. O histórico do sistema mostra o efeito. Ninguém guarda a regra usada para decidir.

O rompimento aparece sempre nos mesmos pontos. Falta identificador comum entre pedido e execução. Falta o conteúdo que sustentou a decisão, não apenas o resultado. Falta o autor humano ou a regra que autorizou aquela ação específica. Quando um desses elos falta, a ação existe e a explicação não.

Diagnóstico pela ação, não pela ferramenta

O trabalho começa pela escolha de uma ação já executada que tenha efeito real. A pergunta de referência é simples: o que seria necessário para explicar essa ação daqui a seis meses, para outra pessoa que não participou do processo. Se a resposta depende de quem operava naquele dia, a trilha não existe.

O caminho é inverso ao fluxo: do efeito no sistema para o pedido original. Em cada salto, verifica-se se há registro que permita seguir adiante sem depender de memória ou de acesso informal. Duas ou três ações do mesmo tipo separam falha pontual de falha de desenho. O produto do diagnóstico é a lista de campos obrigatórios antes da execução.

O que o diagnóstico não resolve

Reconstruir a trilha de uma ação passada não cria a trilha das próximas. Também não devolve a decisão que não foi registrada: se a regra não foi guardada, o máximo que se recupera é a sequência técnica de chamadas, que explica o mecanismo e não o critério.

O diagnóstico não decide onde o agente pode agir. Ele mostra o que é rastreável. Há ações irreversíveis que continuam inaceitáveis mesmo com registro completo, e há operações em que registrar tudo conflita com prazo, volume ou sigilo. Essa é uma escolha de risco assumida, não uma falha de log.

Recurso prático

Reconstrução de uma ação já executada

  1. Escolher uma ação já executada com efeito real: pagamento, envio, alteração de cadastro, exclusão.
  2. Partir do efeito no sistema e buscar o identificador que liga o registro ao pedido que o originou.
  3. Anotar em que ponto a cadeia se rompe: sem identificador comum, sem conteúdo da decisão, sem autor ou regra que a permitiu.
  4. Repetir em duas ou três ações do mesmo tipo, para separar falha pontual de falha de desenho.
  5. Listar os campos que precisam existir no fluxo antes da execução, com quem preenche cada um.

O erro mais comum é aceitar o log técnico do serviço como trilha. Ele mostra que houve chamada, não o que foi decidido nem sob qual regra. O ponto mais ignorado é a ação irreversível: ela precisa de registro anterior à execução, não posterior, porque depois não há o que recuperar.

Conceitos usados nesta página

  • Trilha de auditoria — Trilha de auditoria é o conjunto de registros que permite reconstruir quem fez o quê, quando e com qual dado — inclusive depois que o resultado já foi usado.
  • Registro de decisão — Registro de decisão é o registro mínimo do que foi decidido, por quem, com qual premissa e a partir de quando — o que permite reconstruir a escolha depois, sem depender da memória de quem estava na sala.
  • Registro de execução — Registro de execução é a evidência de que uma rotina, automação ou tarefa rodou — com identificador, data, insumo, resultado e responsável.

Sobre o que está escrito aqui

Conceitos relacionados: trilha de auditoria · identificador de correlação · registro de decisão · registro de execução · responsável pela ação. Exemplos são ilustrativos. Não há cliente, resultado, preço, prazo ou certificação nesta página. Quando o formato indicado é Workshop executivo, ele descreve uma possibilidade de trabalho — a conversa inicial avalia contexto e aderência.

Para continuar

Páginas relacionadas

O mesmo problema em outro objetivo

Outras leituras em IA aplicada e agentes

Quer avaliar isso no seu contexto?

Esta página trata de agente que executa ação sem trilha de auditoria. Arquitetura e implementação de agentes é a frente que investiga o mecanismo por trás desse tipo de problema. O formato mais associado é Workshop executivo.