Um comprovante de execução do agente permite conferir o que mudou depois de uma ação automatizada. A frase “concluído com sucesso” pode resumir um resultado, mas não o demonstra sozinha. Para confiar no relato, a equipe precisa relacionar o pedido, o recurso afetado e uma verificação do estado final.
Essa diferença importa quando a inteligência artificial passa a usar ferramentas. Ela pode preparar uma alteração, enviar um comando, receber uma confirmação ou apenas perder a resposta de uma operação. Cada situação exige uma descrição diferente, pois o efeito no sistema pode não corresponder à narrativa produzida.
Vamos usar uma tarefa fictícia: alterar a data de um acompanhamento interno num sistema de gestão. A ação já está autorizada para aquele contexto. Nosso foco será registrar e verificar o resultado, sem discutir novamente a matriz de permissões ou a escolha da primeira aplicação do agente.
Defina qual mudança precisa ser comprovada
Antes de executar, descreva o resultado esperado de forma verificável. “Organizar o acompanhamento” é amplo demais. Já “alterar a data da tarefa T-204 para o dia combinado, mantendo seu responsável e sua descrição” define uma mudança e também os elementos que precisam permanecer iguais.
No exemplo, a equipe deve saber se a data representa um dia inteiro ou um horário específico. Se houver horário, o contexto de fuso precisa acompanhar a interpretação. Essa definição evita que o agente declare sucesso com base num valor parecido, mas diferente daquele que a pessoa pretendia registrar.
Também identifique o sistema e o espaço de trabalho correto. Duas tarefas podem ter títulos iguais em projetos diferentes. Portanto, o comprovante deve apontar para o recurso exato, usando uma referência estável e um nome legível, sem depender apenas de uma descrição que o modelo resumiu.
Essa preparação não exige um relatório extenso. Ela estabelece o que a verificação posterior procurará. Sem um resultado esperado claro, qualquer resposta positiva da ferramenta pode parecer suficiente, mesmo quando a alteração alcançou outro registro ou mudou apenas parte do que era necessário.
Preserve um estado anterior proporcional à ação
O estado anterior permite comparar o que existia antes com o que apareceu depois. Para uma mudança de data, pode bastar registrar o identificador da tarefa, a data atual, o responsável e os campos relevantes que não devem mudar. A coleta precisa acompanhar o alcance da operação.
Não transforme esse registro em uma cópia indiscriminada de todo o sistema. Além de dificultar a revisão, isso pode reunir informações sem relação com a tarefa. O objetivo é ter contexto suficiente para reconhecer uma alteração inesperada e apoiar uma correção quando ela for necessária.
Registre também quando a leitura aconteceu. Um valor consultado ontem talvez não represente o estado imediatamente anterior à operação de hoje. Se outras pessoas trabalham no mesmo recurso, essa diferença precisa entrar na análise, para que uma alteração recente não seja tratada como se ainda não existisse.
No comprovante, separe o conteúdo observado do conteúdo esperado. Por exemplo, a data anterior pertence à leitura; a nova data pertence ao pedido autorizado. Essa organização permite conferir a passagem entre os dois estados e evita que o agente reescreva o passado para combinar com sua conclusão.
Diferencie proposta, tentativa e alteração confirmada
Uma proposta descreve o que o agente pretende fazer. Uma tentativa registra que ele acionou uma ferramenta. Já uma alteração confirmada exige evidência de que o resultado esperado está presente no recurso correto. Esses estados podem ocorrer em sequência, mas não são equivalentes.
Na tarefa fictícia, o agente pode preparar os parâmetros corretos e ainda não enviar a alteração. Também pode enviar o pedido e receber uma resposta de processamento pendente. Em ambos os casos, dizer que a data já mudou ultrapassa o que foi demonstrado naquele momento.
Use nomes de estado que a equipe consiga interpretar. Termos como “preparado”, “enviado”, “confirmado” e “precisa de conferência” podem ser suficientes, desde que tenham critérios claros. O sistema deve evitar um único indicador verde que mistura configuração pronta, chamada aceita e efeito verificado.
Essa distinção também melhora o relato de conclusão. Em vez de uma frase genérica, o agente pode informar que preparou a alteração ou que confirmou a nova data. Assim, a pessoa sabe se já pode usar o resultado na rotina ou se ainda precisa aguardar uma etapa concreta.
Relacione a operação ao retorno da ferramenta
Quando a ferramenta executa a ação, preserve uma referência da operação e o retorno pertinente. Pode ser um identificador, um estado ou uma descrição estruturada do resultado. Essa informação ajuda a localizar o que ocorreu sem depender de reconstruir toda a conversa do agente.
No entanto, o retorno deve ser interpretado conforme seu significado real. Uma resposta que informa “pedido aceito” pode indicar apenas que o sistema recebeu a solicitação. Se a operação continua em segundo plano, o comprovante precisa acompanhar esse processamento até o estado que interessa à tarefa.
Também diferencie o retorno original da explicação produzida pela IA. O agente pode resumir um resultado técnico para facilitar a leitura, mas o resumo deve manter uma ligação verificável com a evidência. Caso haja divergência, a equipe precisa conseguir consultar o registro da ferramenta.
Evite guardar senhas ou tokens como parte dessa prova. Identificadores de operação e valores relevantes normalmente bastam para explicar o resultado. Quando um retorno contém informação sensível, a forma de armazenamento e de apresentação deve respeitar o acesso previsto para aquele sistema e para quem revisará o trabalho.
Faça uma leitura posterior do recurso afetado
A leitura posterior consulta o recurso depois da ação para verificar o estado encontrado. No exemplo, ela abre novamente a tarefa T-204 e confere a data, o responsável e a descrição. Assim, o resultado não depende apenas da mensagem que acompanhou a tentativa de alteração.
A análise da Anthropic sobre avaliações de agentes distingue o registro das interações do estado final do ambiente. Essa diferença fundamenta uma pergunta prática: além de o agente dizer que fez, o efeito esperado existe onde deveria existir?
Sempre que possível, a verificação deve consultar a fonte pertinente à operação, não uma cópia do próprio texto enviado pelo agente. Comparar o pedido com um resumo do pedido prova apenas coerência interna. A conferência precisa alcançar o registro que a equipe utilizará depois.
Além disso, registre o horário dessa consulta. A leitura demonstra o estado naquele momento. Se alguém alterar a tarefa mais tarde, o comprovante anterior não deve fingir que descreve o presente. Essa limitação é normal e precisa permanecer clara para quem consultar o histórico.
Compare o efeito pedido e os campos que deveriam permanecer
Confirmar a nova data é necessário, mas pode não ser suficiente. Uma operação mal formulada poderia mudar também o responsável ou apagar uma observação. Portanto, a comparação deve incluir os campos que o escopo exigia preservar, além do valor que deveria mudar.
No nosso exemplo, a tarefa começa com um responsável e uma descrição conhecidos. Depois do reagendamento, esses valores devem continuar iguais, salvo outra alteração autorizada. Se houver diferença, o resultado merece investigação mesmo que a data esteja correta. O comprovante deve mostrar essa condição, sem escondê-la atrás do objetivo principal.
Trate mudanças paralelas como uma hipótese a esclarecer
Uma diferença inesperada pode ter sido causada por outra pessoa ou processo. Por isso, não atribua automaticamente toda mudança ao agente. Compare horários, histórico disponível e referências da operação. O importante é reconhecer a divergência e reunir evidência, em vez de produzir uma explicação conveniente sem fundamento.
Quando o sistema oferece histórico de versões, ele pode ajudar nessa análise. Ainda assim, a equipe deve entender o que o registro demonstra. A existência de uma entrada de log não comprova qualquer consequência possível; ela sustenta as informações que realmente registrou sobre aquela ação.
Mantenha resultado desconhecido diferente de falha confirmada
Um resultado desconhecido ocorre quando a operação pode ter produzido efeito, mas a resposta ou a conferência não permite concluir. Isso pode acontecer, por exemplo, se a conexão cai depois do envio. A ausência de confirmação não prova que o sistema deixou de processar a alteração.
Nesse estado, repetir a ação automaticamente pode criar um efeito duplicado em tarefas que não são simples atualizações. Portanto, a próxima etapa deve seguir o mecanismo de conferência disponível: consultar a operação, ler o recurso ou verificar a referência registrada, conforme o funcionamento da integração.
No comprovante, preserve a tentativa original e informe o que falta esclarecer. Não substitua o estado por “falhou” apenas para permitir outra execução. Também não use “concluído” porque a ação provavelmente funcionou. A equipe precisa enxergar a incerteza e o caminho previsto para reduzi-la.
Se a ferramenta não permite uma conferência suficiente, essa limitação deve aparecer no projeto da automação. Talvez aquela ação precise de um acompanhamento diferente antes de funcionar sem intervenção. Um registro honesto de resultado desconhecido é mais útil do que uma certeza inventada que induz a próxima decisão.
Apresente resultados parciais por etapa
Uma tarefa composta pode concluir algumas partes e interromper em outra. Imagine que o agente altera a data, mas não consegue atualizar uma anotação complementar. Um único estado global pode esconder essa diferença, levando a equipe a repetir o trabalho inteiro ou a assumir que tudo ficou pronto.
Registre cada etapa com sua evidência e seu estado. A alteração de data pode estar confirmada por leitura posterior, enquanto a anotação permanece não executada. Com isso, a continuidade consegue partir da parte pendente, respeitando o que já está comprovado, em vez de reiniciar por falta de contexto.
Também evite transformar a quantidade de etapas concluídas em uma medida automática de sucesso. A parte que falta pode ser justamente a que torna o resultado utilizável. O relato deve explicar o impacto da pendência para a operação, sem esconder uma limitação importante atrás de uma porcentagem alta.
Se for necessário desfazer uma etapa, registre a reversão como outra ação verificável. O histórico não deve apagar o que ocorreu. Ele precisa mostrar que houve uma mudança, que a equipe decidiu revertê-la e qual estado a nova leitura confirmou depois dessa decisão.
Escreva um relato de conclusão que alguém possa conferir
O relato de conclusão deve começar pelo resultado alcançado e indicar seu limite. No exemplo, uma formulação clara seria: “A data da tarefa T-204 foi alterada e conferida; responsável e descrição permaneceram iguais”. Em seguida, o sistema pode oferecer a referência da tarefa e o momento da verificação.
Para uma pendência, a mensagem precisa dizer o que ainda falta e por quê. “A alteração foi enviada, mas o estado final ainda não foi confirmado” é mais informativo do que “houve um problema”. A pessoa entende qual etapa ocorreu e qual evidência ainda está ausente.
Mantenha o detalhe técnico acessível sem obrigar todo usuário a lê-lo. Uma visão curta pode mostrar recurso, ação, estado e próxima etapa, enquanto um registro mais completo guarda comparação e retorno da ferramenta. Essa separação facilita o uso diário e preserva material para investigação.
Também permita corrigir o relato quando surgir nova evidência. Se a conferência posterior encontrar um erro, o sistema deve atualizar o estado de forma rastreável. Manter uma antiga mensagem de sucesso sem indicar a revisão cria uma contradição que dificulta a confiança na automação.
Teste se o comprovante detecta os erros que importam
Antes de confiar no comprovante de execução do agente, teste situações além do caminho comum. Use recursos de teste e resultados controlados: alteração correta, recurso errado, campo adicional modificado e resposta perdida. Cada caso deve produzir um estado que corresponda à evidência disponível.
Um teste particularmente útil compara uma mensagem de sucesso com um registro que não mudou. O mecanismo deve detectar a divergência, em vez de repetir a resposta da ferramenta como verdade final. Outro caso pode manter a data correta numa tarefa diferente, verificando se a identificação do alvo participa da análise.
Também teste uma leitura antiga apresentada como se fosse nova. O comprovante precisa guardar o contexto temporal para não reutilizar uma prova que não corresponde à tentativa atual. A validade da evidência depende da relação com o recurso, a operação e o momento verificado.
Esses testes não demonstram que o agente nunca errará. Eles mostram como o sistema reage a situações definidas e ajudam a revisar o mecanismo de verificação. Conforme surgirem falhas reais, novos casos podem ampliar essa cobertura com base no que a operação efetivamente precisa distinguir.
Faça do registro uma parte utilizável da rotina
Um registro verificável da ação automatizada precisa ter um lugar que a equipe consiga encontrar. Se cada comprovante fica escondido em uma conversa diferente, retomar uma tarefa se torna difícil. Associe a evidência ao recurso e ao trabalho correspondente, com uma organização compatível com o sistema utilizado.
Defina também quem acompanha estados pendentes ou desconhecidos. O comprovante não resolve uma incerteza sozinho; ele mostra o que precisa de investigação. Sem uma rotina de tratamento, a equipe pode acumular registros bem descritos, mas continuar sem saber se determinadas ações produziram o efeito necessário.
Revise o nível de detalhe conforme o uso. Uma pequena alteração interna pode exigir menos evidência do que uma ação com vários efeitos. O critério é conseguir conferir o resultado e continuar o trabalho com contexto suficiente, sem gerar relatórios enormes que ninguém utiliza.
Se sua empresa quer conectar agentes a sites e sistemas, conheça os serviços do Laboratório dos Sites e descreva a ação que pretende automatizar. Junto da tarefa, informe como a equipe reconhece hoje que ela foi realmente concluída.

