Ir para o conteúdo
Antigravity: IA generativa com agentes, RAG e SkillsTurma em andamento
Encontro 01: O agente que trabalha nos seus arquivos

Exercício 01 · Encontro 01 · 15 minutos

O projeto, as permissões e o primeiro pedido

O que você vai aprender

Você vai criar o projeto vale-verde apontando para a pasta do kit, escolher o preset de permissões e fazer o primeiro pedido: um README da pasta. Você sai sabendo onde ficam o campo de conversa, o painel de artifacts, o terminal e o pedido de aprovação.

Como começar

Onde
O Antigravity, aberto e conectado à conta Gmail da formação.
Conversa
Uma conversa nova dentro do projeto vale-verde, em Local Mode. O chat da reunião é onde vão os sinais.
Pasta
vale-verde, na Área de Trabalho (a pasta que o kit descompactou). Nunca a pasta Downloads.
Vem de
Exercício 0: o Antigravity instalado e o kit descompactado.
Leva para
Exercício 2: o resumo executivo dos cinco documentos.

Baixe antes de começar

Situação

Antes de pedir qualquer trabalho ao agente, ele precisa saber em que pasta trabalha, e você precisa saber onde as coisas aparecem na tela. Este exercício é o mapa: o projeto, as permissões, a conversa e o primeiro pedido.

Quatro lugares para decorar: o campo de conversa, o painel de artifacts, o terminal e o pedido de aprovação.

Confira que a pasta vale-verde está na Área de Trabalho e tem dentro as pastas documentos e dados.

Passo a passo

3 passos · 15 min

O que este exercício monta, caixinha por caixinha

  1. O projeto vale-verde
  2. As permissões
  3. README.md

  1. Criar o projeto vale-verde

    Caixinha 1 de 3: O projeto vale-verde

    5 minutos. O projeto aponta para a pasta vale-verde da Área de Trabalho.

    Por que este passo: O projeto é a sala com a porta fechada: o agente só enxerga a pasta que você der a ele. Toda a semana acontece dentro desta pasta.

    1. Na barra lateral, clique no ícone de pasta com o sinal de mais e em New Project (projeto novo).
    2. No nome do projeto, cole:
      Nome do projeto · copiar
      vale-verde
    3. Em adicionar pasta (Add folder ou equivalente), escolha a pasta vale-verde da Área de Trabalho. Confirme.
    4. Clique em Create (criar). O projeto abre com uma conversa vazia.
    5. Se perguntar o modo, escolha Local Mode (trabalhar direto na pasta). Não escolha New Worktree Mode hoje.

    Deve aparecer: O projeto vale-verde aberto, com a conversa vazia e a pasta reconhecida (o nome dela aparece no projeto). Sinal no chat: PROJETO.

    • Escolheu a pasta Downloads ou a pasta kit-encontro-01-antigravity sem querer? Apague o projeto e crie de novo apontando para vale-verde.

    O que acabou de acontecer: Local Mode trabalha nos seus arquivos de verdade. New Worktree Mode cria uma cópia isolada, útil quando vários agentes mexem ao mesmo tempo; vemos no Encontro 3.

  2. Escolher o preset de permissões

    Caixinha 2 de 3: As permissões

    3 minutos. Uma configuração global, feita uma vez.

    Por que este passo: As permissões dizem o que o agente faz sem perguntar. Default é o equilíbrio da formação: comandos na pasta rodam direto; internet e arquivos de fora pedem a sua aprovação.

    1. Abra Settings (configurações), depois General (geral) e Permission Settings (permissões).
    2. Deixe o preset em Default (padrão). Se estiver em Turbo ou Request Review, troque para Default.
    3. Volte ao projeto vale-verde.

    Deve aparecer: O preset Default selecionado. Sinal no chat: DEFAULT.

    • No Windows pode aparecer um aviso de que o sandbox está em prévia (preview). Tudo bem: siga.

    O que acabou de acontecer: Deny, Ask, Allow: proibido, pergunta, faz sem perguntar. Default liga o sandbox e deixa em Ask o que sai da pasta ou vai para a internet.

  3. O primeiro pedido: um README da pasta

    Caixinha 3 de 3: README.md

    7 minutos. Na conversa do projeto, cole o pedido e envie. Ele já está no formato CLARO.

    Por que este passo: O primeiro pedido é pequeno de propósito: é para ver o ciclo inteiro uma vez (pedido, plano, aprovação, diff, arquivo) antes de qualquer trabalho de verdade.

    1. Cole no campo de conversa e envie:
      Pedido do README · copiar
      Contexto: esta pasta é o projeto vale-verde, da Vale Verde Distribuidora de Alimentos, uma empresa fictícia criada para uma formação. Dentro dela há a pasta documentos (cinco PDFs) e a pasta dados (planilhas de vendas em CSV e Excel).

Limites: não altere, não mova e não apague nenhum arquivo que já existe. Crie só o arquivo pedido.

Ação: leia os nomes dos arquivos (não precisa ler o conteúdo inteiro) e crie na raiz da pasta um arquivo README.md, em português, com: um título; uma frase dizendo que a Vale Verde é fictícia e que nenhum dado é real; a lista dos arquivos de documentos, um por linha, com uma frase sobre o que cada um parece ser; a lista dos arquivos de dados, do mesmo jeito.

Resultado: o arquivo README.md na raiz da pasta.

Observáveis: o README lista cinco documentos e as planilhas de dados, e diz que a empresa é fictícia.
    2. Observe o painel lateral de artifacts: para um pedido pequeno, ele pode ir direto ao diff, sem plano. Leia o diff (as linhas verdes são o que entra).
    3. Se aparecer um pedido de aprovação, leia o que ele quer fazer e aprove.
    4. Abra a pasta vale-verde no Explorador de Arquivos: o README.md está lá. Abra com dois cliques (ou com o Bloco de Notas).

    Deve aparecer: O arquivo README.md na raiz de vale-verde, em português, listando os cinco documentos e as planilhas, e dizendo que a empresa é fictícia. Sinal no chat: README.

    • Ele criou algum outro arquivo além do README? Peça: apague o que você criou além do README.md.
    • O README está em inglês? Peça: reescreva o README.md em português, sem mudar o conteúdo.

    O que acabou de acontecer: Você acabou de fazer o ciclo inteiro: pedido, artifact, aprovação, arquivo na pasta. Tudo o que vem depois é esse ciclo, com pedidos maiores.

O que você deve ver

  • O projeto vale-verde apontando para a pasta certa, em Local Mode.
  • O preset Default nas permissões.
  • O README.md na pasta, escrito pelo agente.

Checagem obrigatória

  • A pasta do projeto é vale-verde, na Área de Trabalho, e tem documentos e dados dentro.
  • O preset de permissões é Default.
  • O README.md existe, está em português e diz que a Vale Verde é fictícia.
Se travarabrir
Não acho o ícone de pasta com o sinal de mais.
A barra lateral pode estar recolhida: passe o mouse na borda esquerda ou use o menu do aplicativo. O instrutor mostra na tela; a versão do dia pode ter mudado o lugar, não a função.
Ele criou o projeto mas não vê os arquivos.
A pasta adicionada foi outra. Abra as configurações do projeto, remova a pasta e adicione vale-verde de novo. Confira no Explorador que é a que tem documentos e dados.
Ele pede aprovação para tudo, até para ler um arquivo.
O preset está em Request Review. Settings, General, Permission Settings, Default.
O README não apareceu na pasta.
Você recusou o diff sem querer, ou ele só mostrou o texto no chat. Peça: grave agora esse conteúdo no arquivo README.md, na raiz. Se ainda não gravar, o plano B tem o README pronto.
Se você terminou antesabrir

Não avance para o próximo passo. Faça um destes testes na resposta que já tem:

  • Pergunte na conversa: o que você faria se eu pedisse para apagar a pasta documentos? Ele precisa responder que pediria aprovação e avisaria do risco.
  • Leia o README em voz baixa e marque uma frase que você mudaria. Peça a mudança: só aquela frase.

Leve para o seu trabalho

  • Projeto é a pasta; conversa é a sessão
  • Default: rápido e ainda pergunta o que importa
  • Todo pedido vira artifact antes de virar arquivo
  • O ciclo: pedido, plano, aprovação, diff, arquivo

Registre o método

Complete na folha ou num bloco de notas. É o que fica quando a aula acaba.

  1. Os quatro lugares da tela, com as minhas palavras:
  2. O que o preset Default deixa o agente fazer sem perguntar:
  3. O que apareceu no painel de artifacts: