Agente de IA com Google Sheets: leia antes de escrever
Caminho em etapas para agentes de IA no Google Sheets: comece só com leitura, libere escritas após checagens e registre cada alteração com um dono nomeado.

Um agente de IA pode trabalhar com o Google Sheets de forma segura quando começa com acesso somente leitura e ganha permissões de escrita uma ação estreita por vez. Toda escrita deve seguir uma regra definida antes, carregar o registro de quem aprovou e aparecer em um registro de alterações que identifique o dono da planilha. Este artigo descreve esse caminho em etapas para equipes de negócio que querem automação útil sem entregar ao agente uma planilha editável no primeiro dia.
Principais pontos
- Comece com leitura de uma cópia ou de uma visão dedicada, e confirme que o agente lê os valores certos antes de liberar qualquer escrita.
- Dê a cada planilha e a cada aba um dono nomeado, que decide o que o agente pode alterar.
- Avance para as escritas em etapas: sugestões em uma aba de revisão, depois escrita em uma coluna com aprovação e, só então, escrita agendada apenas para linhas que casam com uma regra escrita.
- Registre cada escrita do agente com o valor anterior, o novo valor, o motivo, quem aprovou e o identificador da execução.
- Trate o conteúdo das células como dado, não como instrução, porque um texto digitado por alguém de fora da equipe pode parecer um comando.
Por que o agente precisa de leitura antes de escrever?
Uma planilha parece simples, mas na maioria das empresas ela é uma superfície de trabalho com dependências escondidas. Fórmulas apontam para outras abas, um responsável financeiro filtra uma coluna toda semana e um coordenador digita observações em uma célula da qual outro relatório depende. Um agente que escreve no intervalo errado pode quebrar essas dependências sem exibir nenhuma mensagem de erro. O acesso somente leitura funciona como um teste. Se o agente consegue ler a planilha e explicar em linguagem simples o que cada coluna significa, você aprendeu algo sobre os dados antes que qualquer alteração fosse possível.
O trabalho de leitura também revela se a interpretação do agente bate com o significado de negócio. Datas podem estar guardadas como texto em algumas linhas, valores podem trazer símbolo de moeda em outras, e uma coluna de situação pode usar três grafias para o mesmo estado. Esses problemas aparecem nos primeiros dias de leitura, e não depois que uma escrita sobrescreveu um valor correto. O princípio é o mesmo que aparece nas orientações de autorização da OWASP: conceda o menor conjunto de permissões que ainda permite fazer o trabalho e amplie apenas quando houver um motivo.
Quem é dono da planilha, e quais colunas pertencem a quem?
Antes de conceder qualquer acesso, registre o dono de cada planilha. O dono é uma pessoa nomeada, não uma caixa de e-mail compartilhada da equipe. Essa pessoa responde perguntas como se o agente pode sobrescrever uma coluna e recebe o alerta quando algo parece errado. Em seguida, divida cada aba em três grupos de colunas. Uma divisão simples basta para começar:
- Leitura: colunas que o agente usa como contexto, como código do produto, nome do fornecedor, prazo de entrega ou região do cliente.
- Sugestão: colunas em que o agente coloca valores propostos em uma aba de revisão ou em uma coluna de sugestão, que uma pessoa aceita ou rejeita.
- Somente humano: colunas com aprovações, assinaturas, totais usados na contabilidade e qualquer dado pessoal que você não tenha documentado como necessário para a tarefa do agente.
Essa divisão importa mais do que a conexão técnica. Uma conexão que funciona tecnicamente, mas não tem regras por coluna, é o caminho pelo qual um agente acaba editando um valor que o financeiro havia travado no mês anterior. A versão mais detalhada dessas regras está em coluna e regras de propriedade para o Google Sheets como fonte de dados de agentes, que vale a leitura antes de você definir seus próprios limites.
Um ponto a mais pertence a esta seção. As células costumam conter texto digitado por pessoas de fora da sua equipe, como um comentário em um formulário de fornecedor ou uma observação importada de uma página da web. Esse texto pode incluir frases que parecem instruções para o agente. As orientações de injeção de prompt da OWASP tratam conteúdo externo como não confiável por esse motivo. Desenhe o agente para que o texto das células seja tratado como dado, e para que as escritas dependam das suas regras e aprovações, e não daquilo que a célula por acaso diz.
Qual é o caminho em etapas da leitura até as escritas controladas?
Use a sequência a seguir. Cada etapa deve durar o tempo suficiente para que o dono revise resultados reais. Passar para a etapa seguinte deve ser uma decisão registrada, e não um padrão que acontece só porque a conexão existe.
- Etapa 1, leitura: o agente lê uma cópia da aba ou uma visão limitada às colunas necessárias. Ele responde perguntas e informa o que encontrou. Avance quando o dono confirmar que as respostas batem com a planilha em uma amostra de linhas, incluindo as mais bagunçadas.
- Etapa 2, rascunho: o agente escreve os valores propostos em uma aba de revisão separada, com a linha de origem, o valor sugerido e uma frase com o motivo. A aba de trabalho não muda. Avance quando o dono tiver aceitado ou corrigido os rascunhos ao longo de vários ciclos de trabalho e as correções formarem um padrão que possa virar regra.
- Etapa 3, escrita com aprovação: o agente escreve em uma coluna nomeada, e somente depois que uma pessoa aprova cada alteração por um botão ou por uma resposta no canal da equipe. Avance quando as aprovações forem rotina e o registro de alterações mostrar escritas apenas na coluna prevista.
- Etapa 4, escrita controlada e agendada: o agente escreve na coluna estreita em um agendamento, apenas para linhas que casam com uma regra definida antes, com um resumo diário para o dono e um alerta quando o volume de escrita fugir do normal. Não chegue a esta etapa antes de as três primeiras terem rodado sem problemas.
A etapa 4 não encerra a supervisão. Ela muda de forma. Em vez de revisar cada alteração, o dono passa a revisar padrões, exceções e linhas ignoradas. Cada execução agendada também precisa ser segura para repetir. Se uma tarefa falha no meio e roda de novo, ela não pode incluir a mesma entrada duas vezes. A forma de construir essa proteção está descrita em idempotência em execuções repetidas de agentes.
O que cada escrita do agente deve registrar?
Um registro de alterações é a única forma confiável de responder, semanas depois, o que mudou e por quê. Mantenha-o em uma aba separada, na qual o agente pode acrescentar linhas, mas não pode editar, e que o dono consiga ler sem precisar pedir ajuda a um engenheiro. Cada entrada deve conter:
- O horário e o identificador da execução que produziu a alteração.
- A planilha, a aba, a chave da linha e o nome da coluna.
- O valor anterior e o novo valor, exatamente como estão guardados na célula.
- A regra ou o motivo que o agente cita, em uma frase.
- A pessoa que aprovou a escrita, ou a regra nomeada que a permitiu sem aprovação.
- O resultado: aplicada, ignorada por ser duplicada, ignorada porque a célula mudou desde a leitura, ou falha, com o texto do erro.
O vocabulário do material introdutório de observabilidade da OpenTelemetry ajuda a pensar nisso. Logs, traces e métricas respondem perguntas diferentes. O registro de alterações é a descrição detalhada do que aconteceu. Um resumo curto semanal de escritas, ignorados e falhas mostra se o agente está se afastando das regras. Dê um dono para os dois. Se ninguém lê o resumo, o registro é apenas armazenamento, e armazenamento não protege uma lista de preços de fornecedores de uma execução ruim.
Uma verificação final pertence ao próprio passo de escrita. Antes de alterar uma célula, o agente deve comparar o valor atual com o valor que leu antes. Se forem diferentes, alguém editou a planilha nesse meio tempo. A ação segura é não escrever, registrar o conflito e perguntar ao dono, e não sobrescrever a alteração humana.
Cenário ilustrativo: uma planilha de preços de fornecedores
O cenário a seguir é ilustrativo e descreve uma configuração genérica, não um cliente específico. Uma responsável de compras mantém uma planilha com nomes de fornecedores, códigos de produto, custos unitários e uma coluna com a data da última verificação de preço. Ela quer que o agente marque as linhas em que a última verificação é mais antiga que o intervalo de revisão combinado com a equipe.
Na etapa 1, o agente lê a planilha e lista as linhas que considera desatualizadas. A responsável compara essa lista com o próprio filtro e percebe que um bloco de fornecedor guarda as datas como texto, em outro formato, e por isso o agente as interpretou errado. A equipe corrige o tipo da coluna antes de seguir. Essa correção só apareceu porque o agente estava lendo, e não escrevendo.
Na etapa 2, o agente coloca as marcações de revisão propostas em uma aba separada. A responsável aceita a maioria e corrige duas linhas em que um fornecedor tem um acordo vigente que substitui o intervalo habitual. Ela registra essa exceção como uma regra que o agente precisa checar.
Na etapa 3, o agente só pode escrever na coluna de marcação de revisão, e apenas depois que ela aprova no canal da equipe. O registro de alterações mostra cada marcação, a regra citada e a aprovação dela. Os custos unitários permanecem somente para humanos em todas as etapas, porque uma mudança de preço afeta decisões de compra que exigem a assinatura de uma pessoa, qualquer que seja a etapa do agente.
Como a Be Human trata o acesso a planilhas em operações gerenciadas?
A Be Human desenha o primeiro projeto em torno de um papel útil, da memória e das ferramentas que esse papel precisa, dos limites de aprovação e de um critério de sucesso observável para cada etapa. Em uma integração com o Google Sheets, isso significa documentar o dono e as regras por coluna, começar o agente com acesso somente leitura e montar a aba de revisão e o registro de alterações antes de habilitar qualquer escrita. A operação gerenciada pode então incluir o monitoramento do volume de escritas, avaliações periódicas dos rascunhos do agente comparadas com as correções do dono, revisões de permissões quando o escopo crescer e mudanças controladas quando a estrutura de uma planilha for reorganizada. O objetivo é que cada ampliação de acesso seja uma decisão registrada, que alguém consiga explicar depois.
Se você quer encontrar a primeira tarefa das suas próprias planilhas que vale entregar a um agente, o diagnóstico gratuito de IA da Be Human é um ponto de partida prático.
Perguntas frequentes
Um agente de IA pode editar uma planilha do Google sem a minha aprovação? Pode, se você conceder acesso de escrita e não configurar nenhuma etapa de aprovação. Para dados de negócio, porém, o padrão mais seguro é exigir aprovação. Comece com uma aba de revisão ou com uma etapa de aprovação, e passe para escritas sem supervisão apenas em uma coluna estreita, com regras definidas antes. Mantenha o registro de alterações visível para o dono, para que cada escrita não supervisionada ainda possa ser questionada.
Devo dar ao agente acesso ao meu Google Drive inteiro ou a apenas uma planilha? Comece com uma planilha ou com uma cópia dedicada da aba. Acesso amplo a pastas aumenta a chance de o agente ler ou alterar arquivos que ninguém revisou. Mantenha separados os escopos de leitura e os de escrita, para que qualquer ampliação futura apareça como uma decisão visível na sua revisão de permissões.
Como impedir que um agente adicione a mesma linha duas vezes? Dê a cada escrita uma chave formada pela planilha, pela linha e pela regra que a produziu, e verifique essa chave antes de escrever. Assim, uma nova tentativa ou um agendamento repetido vai encontrar a entrada existente e ignorá-la. Registre cada duplicata ignorada no registro de alterações, para que o dono veja que a proteção funcionou.
O que acontece se alguém editar a planilha enquanto o agente trabalha? O agente deve comparar o valor atual da célula com o valor que leu antes de escrever. Se os dois forem diferentes, deve deixar de escrever, registrar o conflito e pedir ao dono que decida. Isso protege as edições humanas e mantém o registro de alterações como um relato fiel do que o agente de fato mudou.
Seu próximo passo
Descubra primeiro onde um agente de IA cabe na sua empresa.
Faça o diagnóstico gratuito de IA da Be Human. Algumas perguntas sobre o seu trabalho mostram qual tarefa entregar primeiro a um agente, o que ele precisa saber e onde uma pessoa aprova.
Orientação editorial Be Human. Exemplos são ilustrativos, salvo atribuição explícita. Fontes oferecem contexto; a implementação depende do seu processo.


