Resposta direta
A trilha se define antes da primeira execução, não depois. O agente registra quem pediu, o que foi consultado, qual ação foi executada, sobre qual objeto, com qual parâmetro e quem aprovou. Cada execução recebe um identificador que liga pedido, decisão e efeito no sistema de destino. O registro fica no mesmo lugar para todas as execuções e não muda depois de gravado. Sem isso, a responsabilidade pela ação não tem como ser atribuída, e a operação passa a depender da memória de quem estava de plantão.
- Objetivo
- Orientar implementação
- Formato indicado
- Workshop executivo
- Atualizado em
O que esta página acrescenta: Trata a trilha como decisão de implementação anterior à entrada em produção, com campos, guarda e responsável definidos, em vez de tratá-la como recurso do fornecedor.
O que cada execução precisa deixar registrado
Toda ação precisa de um identificador que ligue o pedido ao efeito causado. Junto dele ficam quem pediu, por qual canal, o que o agente consultou, qual versão do dado ou do documento foi usada, a ação escolhida, os parâmetros, o objeto afetado, o resultado devolvido pelo sistema de destino e o horário de cada passo.
Aprovação humana também é registro. Quando a ação depende de liberação, fica gravado quem liberou, o que foi apresentado no momento da liberação e qual foi a resposta. Sem esse vínculo, não há como separar a decisão do agente da decisão da pessoa que autorizou.
Onde o registro mora e quem responde por ele
O registro pertence ao processo, não ao agente. Ele fica no sistema que já responde pela operação, com prazo de guarda definido pela obrigação do processo, e não apenas enquanto o agente estiver ligado. Log isolado no servidor do agente não responde a auditoria, a cliente nem a disputa interna.
Definir o responsável é parte da implementação. Alguém responde por manter o formato, revisar o que foi gravado e conseguir reconstruir uma execução específica a partir do identificador. Se essa pessoa não existe, a trilha é decorativa.
O que a trilha não resolve
Trilha não prova que a decisão foi boa. Ela mostra o que foi feito, com qual insumo e sob qual autorização. Erro de critério continua erro, mesmo bem registrado. Ela também não substitui a definição de quem responde pelo efeito quando a ação está errada.
A profundidade do registro depende do tipo de ação. Agente que apenas lê, resume ou sugere não altera estado em sistema de destino e não precisa do mesmo detalhamento. Em sentido oposto, um registro completo que ninguém consulta não protege ninguém: existe no papel e não na operação.
Recurso prático
Roteiro para definir a trilha antes da entrada em produção
- Levantar as ações que o agente pode executar e marcar quais alteram estado em sistema de destino.
- Para cada ação que altera estado, listar os campos de registro: identificador, solicitante, insumos consultados com versão, parâmetros, objeto afetado, resultado devolvido e horário.
- Definir quais ações exigem aprovação humana e o que fica gravado no momento da liberação.
- Escolher o sistema que guarda o registro e o prazo de guarda, conforme a obrigação do processo.
- Nomear o responsável por manter o formato e por reconstruir uma execução a partir do identificador.
- Testar a reconstrução com uma execução real, refazendo o caminho apenas com o que ficou registrado.
O erro mais comum é aceitar o log padrão da ferramenta como trilha e só encontrar as lacunas quando alguém pede a reconstrução de uma execução específica.
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 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 · registro de execução · aprovação por ação · sistema de destino · prazo de guarda. 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
- IA aplicada e agentes — Página central do tema
- Incerteza no início com IA: o que exigir na c… — não saber por onde começar
- Ferramentas de IA dispersas: onde o fluxo se… — ferramentas isoladas
Páginas relacionadas
O mesmo problema em outro objetivo
- Agente sem trilha de auditoria: o que falta registrar — Diagnosticar
- Agente que executa sem trilha: o que registrar antes — Organizar um processo
- Agente que age sem registro: o que comparar — Comparar alternativas
- Agente que age sem registro: o que medir — Explicar medição
- Agente sem trilha de auditoria: o que exigir na contratação — Orientar avaliação e contratação
Outras leituras em IA aplicada e agentes
- Agente com acesso demais: o que revisar na permissão — Sinais de permissão excessiva em agentes, perguntas de diagnóstico por acesso e uma matriz que separa o necessário do herdado.
- Permissão ampla demais: como reduzir o escopo do agente — Escopo, identidade e trilha de auditoria para agentes: o que separar por operação e o que a permissão ampla não resolve.
- Agente rodando sem ninguém olhar: como medir — Explica como medir agentes que rodam sem supervisão: o que registrar, o que revisar por amostra e por exceção, e o que a medição não resolve.
- Automação total sem revisão: o que comparar entre propostas — Compara propostas de automação total sem revisão: o que observar em cada uma, o que elas não resolvem e o que medir antes de decidir.
- Processo que ninguém documentou: onde a IA trava — O que verificar em um processo não documentado antes de aplicar IA: onde o conhecimento está, quem responde e o que medir.