Dar acesso a uma planilha a um agente de IA deve começar pela tarefa, não pela credencial. Consultar a data de atualização de um pedido é diferente de editar preços ou apagar linhas. A integração precisa permitir somente o que foi aprovado, inclusive quando o agente recebe uma solicitação inesperada.
Uma instrução como “não altere nada” ajuda a orientar o comportamento, mas não transforma uma credencial ampla em acesso somente leitura. A proteção precisa existir na identidade, nas permissões e na ferramenta que faz a consulta. O modelo não deve ser a única barreira entre uma conversa e todos os dados da empresa.
Delimite arquivo, campos e ação
Escreva quais perguntas serão atendidas e quais dados são necessários. Um assistente pode precisar consultar número de pedido e situação, sem ler observações pessoais ou informações financeiras de toda a carteira. Sempre que possível, prepare uma fonte com apenas os campos adequados ao público.
Diferencie leitura de escrita. Para um primeiro piloto, uma cópia controlada e fictícia facilita testar sem afetar a operação. Se a planilha participa de um processo real, identifique também o sistema oficial e quem resolve divergências. Uma visão de apoio não deve substituir o ERP por acidente.
O roteiro de como atualizar uma planilha com pedidos do ERP trata essa separação quando pedidos são sincronizados. Já permissões de um agente conectado ao CRM ajuda a entender limites de consulta e atualização em outro sistema empresarial.
Escolha uma identidade adequada à integração
Há projetos que usam autorização OAuth de uma pessoa e outros que usam uma conta técnica. A escolha depende do fornecedor e da operação. Evite conectar a conta pessoal de um administrador que também acessa arquivos sem relação com o agente.
Em uma conta de serviço, compartilhe somente o arquivo necessário e verifique a permissão concedida. A conta não precisa receber acesso a uma pasta inteira se consulta uma única planilha. Mantenha um responsável pela credencial e uma forma de revogá-la quando a integração deixar de ser necessária.
No OAuth, apresente e revise as permissões solicitadas. A pessoa que autoriza deve entender o alcance do acesso, e não clicar em uma autorização ampla apenas para terminar a configuração. O armazenamento de credenciais precisa seguir o mecanismo seguro do serviço, fora das instruções do agente.
Entenda o que os escopos realmente permitem
A documentação do Google Sheets descreve escopos como spreadsheets.readonly, para leitura, e opções que incluem escrita. Também apresenta drive.file, voltado a arquivos específicos usados com o aplicativo, mas com capacidades que não devem ser confundidas com acesso somente leitura.
Um escopo e uma regra de compartilhamento resolvem partes diferentes do problema. Não presuma que escolher leitura impede acessar outras planilhas que aquela identidade pode consultar. Avalie o alcance real da conta e do conector, não apenas o nome da permissão solicitada.
Da mesma forma, selecionar uma aba ou intervalo na configuração de consulta não cria, por si só, uma barreira contra acesso a outras partes do arquivo. Se o limite precisa ser rígido, uma camada de integração ou uma fonte separada deve aplicar a restrição fora do modelo.
Crie uma ferramenta de consulta específica
Uma interface limitada pode receber um identificador de pedido, validar o formato, consultar um intervalo definido e devolver apenas os campos permitidos. Ela não deve aceitar qualquer arquivo, intervalo ou expressão enviado livremente pelo agente.
A verificação de quem está perguntando também importa. Se a resposta contém informação de um cliente, o fluxo precisa confirmar o vínculo pelo procedimento autorizado. Saber o número de um pedido não deve permitir consultar dados de qualquer pessoa por tentativa e erro.
Retorne data de atualização e uma indicação clara de resultado: encontrado, não encontrado ou falha de consulta. Não transforme indisponibilidade em “saldo zero” ou “pedido inexistente”. O artigo de pedidos e estoque consultados por IA aprofunda essas diferenças na consulta operacional.
Se precisar escrever, acrescente controles
Defina quais colunas podem mudar, quem aprova e como registrar o antes e depois sem expor informação desnecessária. Use identificadores estáveis para localizar registros; uma posição de linha pode mudar quando alguém ordena a planilha.
Teste reenvio e falha de rede. O sistema pode aceitar uma alteração antes de a integração receber a resposta; repetir cegamente pode criar duplicidade ou sobrescrever informação atualizada. Prefira operações que possam ser conferidas e repetidas com segurança, conforme a estrutura do processo.
Não autorize exclusão, compras, pagamentos ou alteração de condições comerciais por uma decisão livre do modelo. Uma ferramenta que prepara sugestões é diferente de uma que aplica alterações. Preserve aprovação humana para as ações de maior impacto.
Onde guardar credenciais e o que registrar
Nunca coloque tokens, senhas ou arquivos de chave em uma célula acessível ao atendimento, no prompt ou em exemplos enviados ao cliente. Use o armazenamento protegido previsto pela ferramenta de integração e restrinja quem consegue consultá-lo ou substituí-lo.
Os registros devem permitir saber que operação foi solicitada, quando ocorreu e qual foi o resultado, sem copiar a planilha inteira. Também é preciso definir retenção e acesso aos logs: um mecanismo de observação pode virar outra cópia indevida dos dados se não houver controle.
Checklist de teste antes de liberar
- Consultar uma informação conhecida usando uma identidade autorizada.
- Tentar acessar outro arquivo, aba ou campo fora do limite previsto.
- Pedir escrita com uma conexão definida para leitura.
- Simular identificador inexistente, informação desatualizada e falha da API.
- Repetir a solicitação e verificar se nenhuma ação foi duplicada.
- Revogar uma permissão e confirmar que o acesso deixa de funcionar.
Perguntas frequentes
Proteger uma coluna na interface é suficiente?
Não como estratégia completa. É necessário verificar como o acesso por API, a identidade e a ferramenta se comportam. Teste o limite real da integração.
Posso começar sem conectar a planilha principal?
Sim. Use uma cópia de demonstração sem dados reais para validar formato, leitura e tratamento de falhas. Conectar a fonte de produção deve ser uma etapa posterior e autorizada.
Próximo passo
Comece por uma consulta específica, com poucos campos e uma resposta que possa conferir. A Academia NT Labz é o caminho para aprender os fundamentos antes de ampliar as ferramentas de um agente.