Guia das chaves

Chaves e senhas: onde achar e como guardar

Neste projeto você vai usar algumas informações secretas. Aqui você descobre onde encontrar cada uma, onde guardar e como pedir ajuda ao Gemini sem mostrar o segredo.

O que é uma chave

Uma chave (ou token) é como a chave da porta da sua oficina. Quem tem a chave entra e usa o que é seu. Por isso ela é secreta.

As 4 regras de ouro

1. Nunca no chat

Não escreva chave nem senha no chat do assistente, do Gemini ou de qualquer pessoa.

2. Nunca em print

Antes de mandar um print ou foto, tape a chave com o dedo ou corte a imagem.

3. Nunca no GitHub

A chave fica num arquivo que não vai para o GitHub (o .env).

4. Vazou? Troque

Se a chave apareceu onde não devia, apague e crie outra. Veja o quadro no fim da página.

As chaves do projeto

Cada linha diz para que serve, onde achar e onde guardar.

Qual	Para que serve	Onde achar	Onde guardar
Chave do Gemini (chave de API)	Deixa o agente CrewAI usar o Gemini.	Em aistudio.google.com, no menu Chaves de API, botão Criar chave de API.	Nos Segredos do Colab, com o nome `GEMINI_API_KEY`.
Token do bot do Telegram	Deixa o seu programa mandar mensagens como o bot.	No Telegram, @BotFather: aparece no fim do `/newbot`. Se perder, envie `/mybots`, escolha o bot e veja API Token.	No arquivo .env da pasta do projeto.
Seu Id do Telegram	O bot só obedece a quem tem esse número.	No Telegram, @userinfobot, envie `/start`. Ou peça ao Gemini um programa que mostre o seu Id.	No arquivo .env.
Login do GitHub	Enviar a sua pasta para o GitHub.	Na sua conta em github.com. O Git costuma abrir uma janela de login no navegador.	Não guarde em arquivo. Faça o login você mesmo.
Conta Google	Antigravity, NotebookLM, Colab e AI Studio.	É a sua conta (de preferência `@gmail.com`).	Não guarde a senha em arquivo.

Dúvida sobre onde achar alguma? Pergunte ao Gemini sem colar a chave. O pedido pronto está mais abaixo.

Como guardar: o arquivo .env

O .env é um arquivo de texto onde ficam as informações secretas do programa. Ele não vai para o GitHub.

Peça ao Gemini para criar o arquivo .env.example e o .gitignore (pedido abaixo). O .env.example mostra só os nomes, sem valores.
No editor do Antigravity, crie um arquivo novo chamado .env na mesma pasta.
Escreva uma linha para cada nome. O valor vai logo depois do sinal de igual, sem espaços e sem aspas. Exemplo com valores falsos:
```
TELEGRAM_TOKEN=123456789:valor-do-seu-token
TELEGRAM_CHAT_ID=123456789
```
Troque os valores falsos pelos seus e salve com Ctrl + S.
Abra o .gitignore e confira que existe uma linha escrita .env.
Feche e ligue o programa de novo. Ele só lê o .env quando começa.

Use os nomes que o assistente escolheu no .env.example. Os nomes do exemplo acima são só um modelo.

Como guardar: Segredos do Colab

No Google Colab, a chave do Gemini fica nos Segredos (ícone de chave na barra da esquerda). O passo completo está no Passo 8 do tutorial.

Como pedir ajuda ao Gemini sem mostrar o segredo

Você pode e deve pedir ajuda. O segredo é pedir o caminho, e não colar o valor.

Pedido 1: onde encontro uma chave

Preciso de [ESCREVA AQUI QUAL CHAVE: por exemplo, a chave do Gemini ou o token do meu bot do Telegram].
Explique, em passos curtos, onde eu encontro essa informação e onde devo guardá-la no meu projeto.
NÃO peça que eu cole o valor aqui no chat.

Pedido 2: criar o .env.example e o .gitignore

Crie um arquivo .env.example com os NOMES das variáveis secretas deste projeto, sem valores.
Crie um arquivo .gitignore que impeça o envio do arquivo .env, do ambiente virtual (.venv) e do banco de dados.
Depois me explique, em passos curtos, como eu mesmo crio o arquivo .env e escrevo os valores nele.
NÃO peça que eu cole os valores aqui no chat.

Pedido 3: conferir se alguma chave ficou escrita nos arquivos

Procure, em todos os arquivos desta pasta, chaves, tokens ou senhas escritos no código.
NÃO mostre os valores. Mostre só o nome do arquivo e o número da linha.
Se achar algo, explique como trocar por uma variável do arquivo .env.

E se a chave vazou?

Vazou é quando a chave foi para o chat, para um print, para o GitHub ou para outra pessoa. Troque na hora:

Chave	O que fazer
Chave do Gemini	No AI Studio, abra Chaves de API, apague a chave que vazou e crie outra. Guarde a nova nos Segredos do Colab.
Token do bot	No @BotFather, envie `/token` e escolha o bot. Ele gera um token novo. Troque no `.env`.
Chave que foi para o GitHub	Apagar o arquivo não basta: a chave continua no histórico. Troque a chave e avise o professor.

Quando em dúvida, troque a chave. Criar outra é grátis e leva um minuto. Avise o professor.

Voltar ao Tutorial · Voltar ao Manual do Aluno