Contexto útil e dados protegidos
O que colocar na conversa para a IA ajudar de verdade, e o que nunca colocar: senhas, chaves e dados pessoais.
Cerca de 15 min · Revisado em
Ao final, você vai conseguir
- Explicar o que é a janela de contexto e por que conversas longas perdem informação
- Montar um pedido de ajuda com trecho relevante, erro completo, versão e o que já tentou
- Diferenciar conversar sobre código de permitir que um agente edite e execute comandos
- Classificar o que pode e o que não pode ser colado numa ferramenta de IA
- Anonimizar um log ou trecho de código antes de pedir ajuda
Uma IA só consegue ajudar com o que você mostra para ela. Mostre de menos e ela chuta; mostre a coisa errada e ela resolve outro problema; mostre o que não devia, como uma senha ou o CPF de alguém, e o problema deixa de ser técnico e vira de segurança, ou até jurídico. Nesta aula você aprende a escolher o que vai para a conversa: o suficiente para uma boa resposta, e nada que precise ser protegido.
A mesa de trabalho da IA
Essa mesa se chama janela de contexto: a quantidade máxima de texto que o modelo consegue considerar de uma vez. Ela inclui suas mensagens, as respostas da IA e os arquivos ou trechos que você anexou. O tamanho é medido em tokens, pedaços de texto que, em português, costumam ser partes de palavras.
- A IA não vê seu computador por padrão. Num chat, ela só conhece o que você colou. Num editor com IA, ela vê os arquivos que a ferramenta incluiu ou que você indicou.
- Conversas longas perdem o começo. Quando a mesa enche, as ferramentas resumem ou descartam partes antigas, e uma instrução do início pode ser esquecida.
- Mais não é sempre melhor. Colar o projeto inteiro enche a mesa de coisas irrelevantes e esconde o trecho que importa.
No começo de uma conversa longa você pediu “use apenas laços for”. Cinquenta mensagens depois, a IA começa a usar map. Qual é a explicação mais provável?
- A instrução do início saiu ou perdeu força na janela de contexto, que está cheia
- A IA decidiu ignorar você de propósito
- A ferramenta ficou sem internet
O que vale colocar na mesa
Contexto útil é a informação que muda a resposta. Para dúvidas de código, quatro coisas quase sempre fazem diferença: o trecho relevante, o erro completo, a versão da linguagem ou ferramenta e o que você já tentou. Some a isso o comportamento esperado.
A mesma dúvida, com e sem contexto útil
Sem contexto
Deu erro no meu import, como resolve?Com contexto útil
Uso Python 3.12 no Windows, rodando pelo terminal do VS Code.
Arquivo principal.py, linha 1: from utilidades import calcular_total
Erro completo:
Traceback (most recent call last):
File "principal.py", line 1, in <module>
ModuleNotFoundError: No module named 'utilidades'
Os dois arquivos estão na pasta projeto/.
Já tentei: rodar de dentro da pasta projeto/, e o erro continua.
Esperado: importar a função e imprimir o total.Para pedir ajuda com um erro, o que é contexto útil e o que só enche a mesa?
Contexto útil · Ruído
- A mensagem de erro completa, do começo ao fim
- A versão da linguagem ou da biblioteca
- O que você já tentou e o que aconteceu
- O trecho de código onde o erro aparece
- Todos os arquivos do projeto, de uma vez
- Um log de 3 mil linhas sem indicar onde está o problema
- A história de como você decidiu estudar programação
A IA sugere uma solução que usa uma opção que só existe numa versão antiga da ferramenta que você usa. O que você faz antes de aceitar?
Você percebeu uma suposição incorreta: ela respondeu como se você usasse outra versão. Corrija o contexto (“uso a versão 5, não a 4”) e peça de novo. Depois confira na documentação da sua versão. Aceitar sem corrigir faz você colar código que não funciona, ou que funciona por acidente.
Conversar sobre o código ou deixar a IA mexer nele
Existem dois modos bem diferentes de usar IA com código. No chat, você cola trechos e conversa: nada muda no seu projeto até você copiar algo. Num agente, como os modos de agente do Cursor, do Claude Code ou do Codex, a ferramenta pode ler arquivos, editar o projeto e até executar comandos no seu computador.
O que acontece quando você dá permissão para um agente agir
- Você → IA: Corrija o teste que falha. Você pede uma tarefa pequena e diz quais arquivos podem mudar.
- IA → Seu projeto: Lê arquivos. O agente procura e lê arquivos do projeto. Tudo o que ele lê entra na janela de contexto e é enviado ao serviço da IA.
- IA → Seu projeto: Edita calculo.js. Ele altera um arquivo. Ferramentas boas mostram a mudança como um diff (as linhas removidas e adicionadas) para você revisar.
- IA → Seu projeto: Pede para rodar npm test. Executar comandos é o passo mais sensível: um comando errado pode apagar arquivos. Confira o comando antes de aprovar.
- Você → Você: Revisa o diff. Você lê a mudança, roda o teste e só então aceita. A responsabilidade pelo resultado continua sendo sua.
Você está começando e vai usar um agente de IA pela primeira vez num projeto. Qual configuração é mais segura?
- Um projeto de estudo, com Git, pedindo aprovação antes de cada edição e cada comando
- A pasta de documentos inteira, para o agente ter todo o contexto possível
- Aprovação automática de todos os comandos, para ganhar tempo
O que nunca vai para a mesa
Tudo o que você manda para uma ferramenta de IA sai do seu computador e vai para o servidor de uma empresa. Dependendo do serviço e do seu plano, pode ser guardado, revisado por pessoas ou usado para treinar modelos. Por isso, algumas coisas nunca entram na conversa.
- Senhas e tokens
- Um token de acesso, ou chave de API, é uma senha usada por programas, como
sk-...ou o conteúdo do arquivo.env. Quem tem a chave age como você e pode gerar cobranças na sua conta. - Dados pessoais
- Nome, CPF, telefone, endereço, e-mail, dados de saúde de pessoas reais. A LGPD (Lei Geral de Proteção de Dados) exige cuidado e motivo legítimo para tratar esses dados, e colar numa ferramenta externa é compartilhar.
- Código e dados da empresa
- Código, planilhas e documentos do trabalho ou de um cliente só entram se a empresa permitir aquela ferramenta. Muitas têm regras escritas sobre isso: pergunte antes.
Você pode colar isto numa ferramenta de IA externa?
Pode, com tranquilidade · Não cole
- Um exercício da trilha com dados inventados
- Uma mensagem de erro com o caminho
C:\Users\aluno\projeto - A tabela
pedidoscom três linhas que você criou para teste - O arquivo
.envcom a chave da API de pagamentos - Uma planilha com nome, CPF e telefone de clientes reais
- O código de um sistema da empresa onde você estagia, sem autorização
- Um print da tela do banco com seu saldo e número da conta
Anonimizar antes de perguntar
Anonimizar (ou sanitizar) é trocar valores sensíveis por exemplos que mantêm o formato, mas não identificam ninguém. A IA não precisa do CPF verdadeiro para entender por que a validação falha: precisa de um CPF com o mesmo formato.
Um log de erro já sanitizado, pronto para colar. Explore as trocas.
2026-10-14 09:12:03 ERROR pagamento falhou
cliente: Maria Exemplo
cpf: 000.000.000-00
api_key: <REMOVIDA>
url: https://api.exemplo.com/v1/cobrancas
status: 401 Unauthorized- Nome trocado: O nome real virou um nome claramente fictício. O erro não depende de quem é a pessoa.
- Formato mantido: Os dígitos sumiram, mas o formato com pontos e traço continua. Se o bug for no formato, a IA ainda consegue ver.
- Segredo removido: Chaves nunca são trocadas por outra parecida: são removidas. Um marcador como
<REMOVIDA>avisa que ali havia algo. - Domínio genérico: O domínio interno da empresa virou
exemplo.com. O caminho/v1/cobrancasfica, porque ajuda a entender o erro. - O que importa: A informação técnica que explica o problema continua intacta. Sanitizar é tirar o sensível, não o útil.
Coloque em ordem o preparo de um trecho antes de pedir ajuda.
- Recortar só a parte do código ou do log ligada ao problema
- Procurar senhas, tokens e chaves e removê-los
- Trocar nomes, documentos e contatos por exemplos com o mesmo formato
- Reler o trecho inteiro procurando algo que escapou
- Colar na ferramenta junto com versão, esperado e o que você já tentou
Você estagia em uma clínica e um relatório com dados de pacientes sai com as datas trocadas. Como pedir ajuda à IA?
- Criar três linhas inventadas com o mesmo formato, reproduzir o erro com elas e colar só esse exemplo e o código, se a clínica permitir essa ferramenta
- Colar o relatório inteiro, já que a IA não vai contar para ninguém
- Apagar só a coluna de nomes e colar o resto
Seu projeto pessoal dá erro ao conectar no banco de dados. A mensagem inclui a URL de conexão com usuário e senha. O que fazer?
Error: connect ECONNREFUSED
at postgres://admin:S3nh4Forte@db.meuprojeto.com:5432/loja- Trocar usuário, senha e domínio por marcadores antes de colar, mantendo o resto da mensagem
- Colar como está, porque é um projeto pessoal
- Não pedir ajuda, porque não dá para explicar o erro sem a senha
Fechamento
- A janela de contexto é a mesa de trabalho da IA: ela só considera o que está ali, e conversas longas perdem o começo.
- Contexto útil é o trecho relevante, o erro completo, a versão, o esperado e o que você já tentou; o resto vira ruído.
- Num chat você só conversa; um agente pode ler, editar e executar, então comece em projeto de estudo e aprove cada passo.
- Nunca cole senhas, tokens, chaves de API, dados pessoais ou código da empresa sem permissão; chave exposta deve ser revogada.
- Anonimizar é trocar o sensível por exemplos com o mesmo formato, mantendo a informação técnica que explica o problema.
A mesma dúvida, com e sem o contexto certo
Use um erro real de um exercício da sua trilha, ou provoque um de propósito no seu projeto de estudo, e descubra na prática como o contexto muda a resposta.
- Pergunte sobre o erro só com uma frase, sem trecho nem mensagem, e salve a resposta
- Prepare o trecho relevante e o erro completo, sanitizando qualquer senha, token ou dado pessoal
- Pergunte de novo com o trecho, a versão, o esperado e o que você já tentou
- Encontre uma suposição incorreta em alguma das respostas e corrija o contexto antes de aceitar a solução
- Rode a solução final e anote qual informação de contexto fez mais diferença