Seu manual de técnico de bancada

Você vai trabalhar numa pasta sua, aberta no Antigravity, um editor de código do Google. Dentro dele mora o Gemini, o assistente de IA que ajuda você a construir o projeto, do começo ao fim.

Instalar o Antigravity

1. Abra antigravity.google/download.
2. Escolha Windows (versão x64). A página mostra mais de um produto (por exemplo, o Antigravity 2.0 no topo). Role até Antigravity IDE (Standalone) e clique em Download for x64. Os nomes podem mudar: procure o IDE, o editor onde se abre uma pasta.
3. Abra o arquivo baixado e siga as telas do instalador.
4. Ao abrir o programa, entre com a sua conta Google.

Criar a sua pasta de trabalho

1. Abra a pasta Documentos do Windows.
2. Clique com o botão direito num espaço vazio → Novo → Pasta.
3. Dê o nome oficina-digital (minúsculo, sem acento e sem espaço).

Abrir a pasta no Antigravity

1. No Antigravity, procure no menu a opção de abrir pasta (em inglês: File → Open Folder).
2. Escolha a pasta oficina-digital. Ela está vazia, e isso é normal.
3. O painel do assistente fica do lado direito do editor. É ali que você conversa com o Gemini.

Diga olá ao Gemini

Olá! Sou aluno iniciante. Fale sempre em frases curtas e palavras simples. Explique, em 5 linhas, o que você pode fazer por mim nesta pasta e como eu devo pedir as coisas.

O NotebookLM lê os documentos e explica em áudio. Aqui ele ensina o que você vai construir. Você estuda de fone de ouvido.

Os 4 documentos de estudo

1. Especificação da oficina 2. Defeitos comuns 3. Catálogo de peças 4. Histórico de serviços

1. Abra notebooklm.google.com e entre com a conta Google.
2. Clique em Novo caderno.
3. Adicionar fonte → envie os 4 arquivos (baixe cada um antes).
4. Adicione também as páginas deste site. Procure a opção de adicionar site (Website) e cole um endereço de cada vez:

   https://rcminitor.github.io/Oficina_CuCa_IA/sobre.html
   https://rcminitor.github.io/Oficina_CuCa_IA/aluno.html
   https://rcminitor.github.io/Oficina_CuCa_IA/tutorial.html
   https://rcminitor.github.io/Oficina_CuCa_IA/chaves.html

   Copiar endereços

Antes de abrir o NotebookLM

O caderno é uma pasta de estudo. Você coloca fontes (textos, páginas) e ele só responde com base nelas. Por isso ele erra menos que um chat comum.

Ouvir o resumo em áudio

1. Clique em Resumo em áudio (Audio Overview). Espere alguns minutos.
2. Clique em Play. Coloque o fone.

Pergunta pronta (copie e cole na conversa):

Meu cliente disse que o notebook desliga sozinho. Quais peças eu devo olhar primeiro? Responda em 5 linhas curtas.

Para que o NotebookLM serve no projeto inteiro

O NotebookLM não é só desta etapa. Ele é o seu colega de estudo do começo ao fim. A diferença para um chat comum: ele responde só com o que está nas suas fontes, então erra menos sobre este projeto.

Personalize o áudio

Antes de gerar o resumo em áudio, procure a opção de personalizar (Customize). Escreva um pedido, por exemplo:

Explique para um iniciante. Use frases curtas e palavras simples, e exemplos de oficina de computadores. Foque nas partes do projeto e na ordem em que elas trabalham.

Como o NotebookLM muda o seu resultado

• Menos erros: você sabe o que a parte deve fazer antes de pedir ao Gemini, então percebe quando ele errou.
• Menos leitura: você escuta em vez de ler.
• Menos dúvida: você pergunta em português simples e recebe resposta no seu ritmo.
• Mais autonomia: você confere o assistente, em vez de só aceitar.

Perguntas para treinar

Depois do áudio, faça estas perguntas na conversa, uma de cada vez:

1. "Quais são as 5 partes do projeto Oficina Digital? Responda em lista curta."
2. "O que é um grafo de conhecimento, em palavras simples?"
3. "Quais peças aparecem para o Dell G15?"

Compare cada resposta com a Especificação. Bateu? Ótimo. Não bateu? Diga ao professor.

Aqui você testa a IA antes de usar no trabalho de verdade. Duas ferramentas de prompt (Skills):

1. Use o Gemini do Antigravity (painel à direita) ou abra gemini.google.com.
2. Copie a Skill A e troque o relato.

O texto """COLE O RELATO AQUI""" é um espaço em branco: apague essa frase e escreva o relato no lugar, mantendo as aspas triplas em volta.

Skill A — Triagem de Sintomas

Você é atendente de oficina de informática. Leia o relato do cliente.
Responda SOMENTE neste formato, uma linha cada:
Modelo: ...
Sintoma principal: ...
Gravidade: BAIXA, MÉDIA ou ALTA
Se faltar informação, escreva "não informado". Não invente.

Relato: """COLE O RELATO AQUI"""

Skill B — Busca no histórico (GraphRAG)

Você é técnico de bancada. Use APENAS o histórico abaixo.
Dado o modelo e o sintoma, diga:
Peça provável: ...
Tempo de bancada: ...
Casos parecidos: (número da ordem de serviço)
Se o histórico não tiver caso parecido, responda "sem histórico".

Modelo: COLE_AQUI
Sintoma: COLE_AQUI
Histórico: """COLE AQUI A TABELA DO DOCUMENTO 4"""

Onde pegar o histórico da Skill B

Abra o documento 4 (Histórico de serviços) pelo link da Etapa 2. Selecione a tabela inteira, copie e cole no lugar de COLE AQUI A TABELA DO DOCUMENTO 4. Preencha também o modelo e o sintoma.

Três chamados de treino, com a resposta esperada

Teste estes três relatos. As palavras da IA mudam um pouco a cada vez. O que importa é o conteúdo.

Se algo não deu certo

Desafio de Decisão

Depois dos 3 chamados de treino, conte por áudio:

• Em qual chamado usei a Skill A? Por quê?
• Em qual usei a Skill B? Por quê?
• Em qual usei as duas juntas? Por quê?

O Obsidian guarda fichas e desenha as ligações entre elas.

1. Baixe em obsidian.md (grátis) e instale.
2. Create new vault, nome: Oficina.
3. Crie 3 notas. O texto com [[ ]] cria a ligação:

Nota "Notebook Dell G15":  #aparelho  Sintoma: [[Desliga sozinho]]
Nota "Desliga sozinho":    #sintoma   Solução: [[Troca de pasta térmica]]
Nota "Troca de pasta térmica": #solucao  Tempo de bancada: 40 minutos.

4. Menu da esquerda → ícone do grafo (bolinhas ligadas).
5. No grafo, abra Grupos e crie 3 cores: tag:#aparelho azul, tag:#sintoma laranja, tag:#solucao verde.

Se algo não funcionar no Obsidian

Ver o grafo da oficina (feito pelo Graphify)

Este grafo foi montado pelo Graphify a partir dos 3 documentos da oficina. Procure o Dell G15 e siga: aparelho → sintoma → peça.

Agora você constrói. Peça ao Gemini, parte por parte, e ele cria os arquivos na sua pasta. Você lê, aprova e testa. O Tutorial tem um pedido pronto para cada parte, com botão de copiar.

Como funciona cada parte

O jeito de trabalhar é sempre o mesmo, em quatro movimentos:

Tempo: uns 20 a 40 minutos por parte. O projeto inteiro, em várias aulas.

O que você vai criar

1. O site: o formulário do chamado.
2. A API: guarda os chamados num banco de dados.
3. A triagem com o grafo: faz o laudo.
4. A automação em Python: o robô de reserva.
5. O agente CrewAI, no Google Colab: a dupla de especialistas. Opcional.
6. O Rádio do Técnico (Telegram): avisos e comandos no celular. Opcional.

Quando o resultado não é o esperado

Como saber que terminou

• Você abre um chamado no site e recebe um número.
• Em Acompanhar, esse número mostra status, prioridade e laudo.
• A API está ligada e o terminal mostra Uvicorn running.
• As partes opcionais (CrewAI e Telegram) funcionam, ou você anotou onde travou.

O projeto de referência do professor está no gabarito. O seu pode ser diferente e estar certo: o que vale é cumprir a Especificação.

Abrir o tutorial

Só agora, no final, entra o GitHub: uma pasta compartilhada na internet. Nada se perde. Você vai levar a sua pasta oficina-digital para lá, com a ajuda do Gemini.

Criar a conta (grátis)

1. Abra github.com.
2. Clique em Sign up (canto de cima, à direita).
3. Preencha e-mail, senha e nome de usuário.
4. Resolva o teste "não sou robô". Clique em Create account.
5. Abra seu e-mail (olhe também em Spam) e clique em Verify email address.

Instalar o Git (se faltar)

O Git guarda as versões da sua pasta e leva para o GitHub. Confira no terminal com git --version. Se não aparecer uma versão:

1. Abra git-scm.com/download/win e baixe o instalador.
2. Abra o arquivo e clique em Next até o fim. As opções padrão servem.
3. Feche e abra de novo o terminal e o Antigravity.

Levar a sua pasta para o GitHub

Peça ao Gemini, no painel do Antigravity:

Ajude-me a enviar esta pasta para o GitHub. Estamos no final do projeto.
1) Crie um arquivo .gitignore para NÃO enviar chaves, tokens, o ambiente virtual (.venv), o banco de dados e arquivos .env.
2) Confira se algum arquivo tem chave ou token escrito. Se tiver, me avise e NÃO envie.
3) Explique, em passos curtos, o que são git init, commit e push.
4) Diga como instalar o Git no Windows, se faltar, e como criar o repositório no GitHub.
5) Peça minha permissão antes de cada comando. Eu faço o login no GitHub. NUNCA peça nem aceite que eu cole senha ou token no chat.

Depois do envio: confira no GitHub

1. Abra github.com e entre na sua conta.
2. Clique no seu repositório.
3. Veja se as pastas site e api aparecem.
4. Confira que o arquivo .env NÃO aparece. Se aparecer, chame o professor agora: a chave vazou e precisa ser trocada.

Se algo der errado no envio

Vídeos em português

Canal Curso em Vídeo, do Prof. Gustavo Guanabara. É um curso grátis que ensina Git e GitHub sem digitar comandos.

O que é GitHub? Pra que ele serve? (37 min) Curso completo (13 vídeos)