Como organizar o espaço de trabalho de um agente de IA: pastas

Para organizar o espaço de trabalho de um agente de IA, use poucas pastas, cada uma com uma única função: instruções que o agente lê, material de entrada que ele recebe, notas que ele guarda, rascunhos em que ele trabalha, entregas que ele conclui e um registro de cada execução. Separe o que só pessoas podem alterar do que o agente pode alterar, e dê nomes aos arquivos de modo que quem revisa saiba o que cada um é e se já está final. O objetivo não é arrumação. É que alguém abra o espaço de trabalho amanhã e entenda o que aconteceu sem precisar perguntar ao agente.

Principais pontos

• Dê a cada pasta uma função: instruções, entrada, notas, trabalho, entregas e execuções cobrem a maioria dos papéis em uma empresa.
• Separe rascunhos de entregas finais e nunca deixe um rascunho onde o revisor espera encontrar uma versão final.
• Mantenha as notas curtas, datadas e com fonte, um assunto por nota, com um índice que o agente abre primeiro.
• Defina permissões por pasta: o agente lê as instruções, acrescenta registros e não sobrescreve entregas finais.
• Teste o modelo pedindo a alguém que não acompanhou a tarefa que encontre o resultado, as fontes e as dúvidas em aberto.

Por que o espaço de trabalho de um agente precisa de estrutura?

Um agente que trabalha em várias etapas, ou ao longo de vários dias, produz material: arquivos recebidos, fatos aprendidos, rascunhos, resultados parciais e trabalho concluído. Se tudo isso cai no mesmo lugar, surgem três problemas. Quem revisa não encontra o resultado. O agente carrega o material errado, ou material demais. E um rascunho antigo é confundido com a versão aprovada.

Há também um motivo técnico. Um agente só consegue manter uma quantidade limitada de informação à vista ao mesmo tempo, então ele funciona melhor quando consulta o que precisa na hora, em vez de carregar tudo. Um modelo claro, com nomes previsíveis, permite que ele abra só o arquivo necessário. Os textos da Anthropic sobre engenharia de contexto descrevem essa ideia de carregar informação conforme a necessidade, e não toda de uma vez, e tratam as anotações estruturadas fora do contexto imediato como uma forma de manter coerente um trabalho longo.

A estrutura também serve às pessoas ao redor do agente. Um gestor, um auditor ou um colega que assume a tarefa precisa conseguir seguir o caminho do pedido até o resultado. Quando uma execução para no meio, é o espaço de trabalho que permite continuar, tema de checkpoints de agentes de IA e como retomar o trabalho inacabado.

Qual é a estrutura mais simples que funciona?

Comece com seis áreas. Cada uma tem um único propósito e nenhuma exige software especial. Uma unidade compartilhada, um repositório de documentos ou um armazenamento de arquivos comum servem.

• Instruções: a descrição do papel, as regras, os limites de aprovação e a definição de pronto. As pessoas editam esta área. O agente apenas lê.
• Entrada: material que chega de fora, como e-mails, formulários, exportações e anexos. Os arquivos ficam como foram recebidos e nunca são editados.
• Notas: memória durável que o agente escreve e lê. Curtas, datadas, um assunto por nota, com um índice.
• Trabalho: rascunhos, arquivos de apoio e resultados intermediários da tarefa em andamento. Pode ser limpa quando a tarefa fecha.
• Entregas: produtos finalizados, uma pasta por tarefa, cada um pronto para uma pessoa revisar.
• Execuções: um registro curto de cada execução, com o que foi pedido, o que foi feito, quais ferramentas foram chamadas e o que ficou pendente.

Resista a criar mais pastas no início. Pastas extras geram dúvidas sobre onde cada arquivo deve ficar, e o agente vai decidir isso de forma inconsistente. Acrescente uma área só quando surgir um problema real, por exemplo uma área de referência separada quando o agente passar a depender de um conjunto estável de documentos de política mantido por pessoas.

Se você opera mais de um agente, dê a cada um seu próprio espaço de trabalho, com o mesmo modelo. Misturar os arquivos de vários agentes em um só lugar apaga a informação de quem escreveu o quê. Quando eles realmente precisarem compartilhar algo, use uma área de passagem definida, e não as pastas de trabalho um do outro.

Como o agente deve manter as notas?

As notas são a memória do agente em forma de arquivo, e notas ruins são piores do que nenhuma. Uma nota vaga, sem data ou sem fonte será aceita mais tarde por um agente que não tem como questioná-la. Algumas regras mantêm as notas úteis.

• Um assunto por nota, com um título claro que diga o que ela cobre.
• Toda nota registra a data, a fonte e quem ou o que a escreveu.
• Fatos e decisões ficam separados de suposições, e as suposições são identificadas como tal.
• Notas que mudariam o tratamento dado a clientes, equipe ou dinheiro só valem depois de confirmadas por uma pessoa.
• Uma nota de índice lista todas as notas, com uma linha para cada, para que o agente abra o índice primeiro em vez de ler tudo.

Data e fonte são o que mais importa. Quando duas notas discordam, é preciso ter algo para decidir qual prevalece, e em geral uma nota mais recente de uma fonte mais forte vence uma mais antiga de uma fonte mais fraca. Sem data e sem fonte, nenhuma regra pode ser aplicada.

Decida também o que não deve entrar nas notas. Senhas, tokens de acesso e dados pessoais desnecessários para a tarefa devem ficar de fora. Uma nota é um arquivo de longa duração que muitas pessoas e processos podem ler, e deve ser tratada assim.

Como nomear arquivos e separar rascunhos de entregas?

Quem revisa deve conseguir ler o nome de um arquivo e saber o que ele é. Um padrão simples funciona bem: a data na ordem ano, mês e dia, depois o assunto, depois o tipo de documento e, por fim, uma palavra de status, como rascunho ou final. Assim, a ordenação por nome agrupa o trabalho por dia e o status aparece sem abrir nada.

Três hábitos protegem quem revisa.

• Rascunhos ficam na área de trabalho. Só itens concluídos vão para as entregas. Se um arquivo está em entregas, uma pessoa pode presumir que ele foi feito para ser lido.
• Uma versão final nunca é sobrescrita. Se algo muda, o agente salva uma nova versão e deixa a antiga no lugar, para que o revisor veja o que mudou.
• Toda pasta de entrega leva uma nota de entrega curta.

A nota de entrega é o arquivo mais valioso do espaço de trabalho. Ela registra o pedido original, as fontes usadas, as verificações feitas, tudo o que o agente não conseguiu confirmar e qualquer decisão que ele deixou para uma pessoa. É nela que mora a evidência, e ela se conecta diretamente a uma definição de pronto que exige evidência. Quem lê a nota de entrega primeiro costuma decidir em poucos minutos se o material merece uma revisão mais atenta.

Quais permissões cada pasta deve ter?

O modelo de pastas também é um mapa de permissões. Cada área tem um nível de confiança diferente, então cada uma deve ter um nível de acesso diferente.

• Instruções: o agente lê. Só pessoas nomeadas escrevem.
• Entrada: o agente lê. Arquivos novos chegam pelo canal de recebimento. O agente não edita nem apaga.
• Notas: o agente lê e acrescenta. Alterar ou remover notas antigas passa por uma pessoa ou por um processo revisado.
• Trabalho: acesso total para o agente, já que nada ali é definitivo.
• Entregas: o agente cria arquivos novos, mas não sobrescreve uma versão final. Enviar qualquer coisa para fora da empresa exige aprovação.
• Execuções: somente acréscimo, para que o registro não possa ser reescrito sem ninguém perceber.

A separação entre instruções e entrada merece atenção especial. Tudo o que está na entrada veio de fora da empresa, e um e-mail ou anexo pode conter texto escrito para parecer uma instrução. Manter as instruções reais em uma área separada, somente leitura, e tratar o conteúdo da entrada estritamente como dado a ser lido, e não como comando, reduz esse risco. Não o elimina. O guia de prevenção de prompt injection do OWASP lista outras defesas que vale somar a essa. Para uma visão mais ampla de quais controles implantar primeiro, veja guardrails para agentes de IA nas empresas.

Como implantar isso, passo a passo?

Você pode montar e testar o modelo em um único papel antes de ampliá-lo.

• Passo um: escolha um papel de agente e um tipo de tarefa. Não desenhe para todos os usos futuros.
• Passo dois: crie as seis áreas e escreva, no topo de cada uma, uma frase dizendo o que pertence ali e o que não pertence.
• Passo três: leve a descrição do papel, as regras e os limites de aprovação para a área de instruções e acrescente um trecho curto explicando ao agente como o espaço de trabalho está organizado.
• Passo quatro: escreva a nota de índice e um modelo para o registro de execução e para a nota de entrega.
• Passo cinco: aplique as permissões da seção anterior e confira tentando fazer algo que o agente não deveria conseguir fazer.
• Passo seis: rode uma tarefa real. Depois peça a alguém que não a acompanhou que encontre o resultado, as fontes e as dúvidas em aberto usando apenas o espaço de trabalho.
• Passo sete: corrija o que a pessoa não conseguiu achar, renomeando, movendo ou ampliando o modelo da nota de entrega, e repita com a próxima tarefa.

Cenário ilustrativo: um agente prepara os acompanhamentos semanais de uma equipe de compras. A pasta de entrada guarda as respostas dos fornecedores exatamente como chegaram. A área de notas tem uma nota por fornecedor com os prazos de entrega combinados, cada uma datada e com fonte. A área de trabalho guarda os rascunhos de mensagens. Para cada semana, a área de entregas tem uma pasta com as mensagens aprovadas e uma nota de entrega listando quais respostas foram lidas e quais fornecedores não responderam. No meio de uma execução, uma ferramenta falha, e o registro mostra onde ela parou. A execução seguinte parte desse registro. Mais tarde, a gerente pergunta por que um fornecedor foi cobrado. Ela abre a nota de entrega, depois a nota do fornecedor, depois a resposta original na entrada, e tem a resposta sem perguntar a ninguém.

Como uma operação gerenciada cuida do espaço de trabalho?

A Be Human trata o espaço de trabalho como parte do primeiro projeto, junto com o papel, a memória e as ferramentas necessárias, os limites de aprovação e um critério de sucesso observável. O modelo de pastas, as regras de nomes, o formato das notas e as permissões por pasta são combinados e registrados por escrito no início. Durante a operação gerenciada, a equipe revisa permissões, verifica se há notas desatualizadas ou conflitantes e altera o modelo de forma controlada, para que a estrutura acompanhe as mudanças do papel. O cliente mantém o controle das instruções e aprova tudo o que muda o que o agente pode fazer.

Perguntas frequentes

Cada agente deve ter seu próprio espaço de trabalho? Na maioria dos casos, sim. Um espaço separado, com o mesmo modelo, deixa claro quem escreveu o quê e permite definir permissões por papel. Se os agentes precisarem passar trabalho entre si, use uma área de passagem definida em vez de abrir a pasta de trabalho de um agente para outro.

O espaço de trabalho deve ser uma unidade compartilhada, um repositório de código ou um banco de dados? Use o que sua equipe já sabe revisar e controlar. O espaço de trabalho precisa de pastas, histórico de versões e permissões, e uma unidade compartilhada ou um repositório de documentos costuma oferecer os três. Registros estruturados, como uma lista de pedidos, ficam melhor em um banco de dados que o agente acessa por uma ferramenta controlada, e não como arquivos soltos.

Com que frequência as notas devem ser revisadas? Revise em intervalos combinados com quem é responsável pelo papel, e com mais frequência no começo. Arquive as notas desatualizadas em vez de apagá-las, para poder rastrear uma decisão anterior se alguém questionar. A revisão deve procurar fatos vencidos, duplicidades e notas que se contradizem.

O espaço de trabalho substitui as instruções do agente? Não. As instruções ficam dentro do espaço de trabalho e dizem ao agente o que fazer. Elas devem incluir uma explicação breve do modelo de pastas, para que o agente saiba onde ler, onde escrever e o que não pode tocar. Manter essa explicação curta facilita a manutenção.

Orientação editorial Be Human. Exemplos são ilustrativos, salvo atribuição explícita. Fontes oferecem contexto; a implementação depende do seu processo.