Visão geral

A CLI do Gemini é um agente de IA de código aberto e sem custos que permite usar o Gemini na linha de comando. Ela se integra às suas ferramentas para ajudar a lidar com tarefas difíceis, como corrigir bugs, criar novos recursos e escrever testes melhores. Embora seja excelente para programação, ela também pode ser usada como um assistente local versátil para tarefas diárias, como gerar conteúdo, resolver problemas, fazer pesquisas ou gerenciar sua lista de tarefas.

Objetivo

Este laboratório apresenta uma experiência prática introdutória com a CLI do Gemini.

Você vai aprender a:

• Instalar e executar a CLI do Gemini.
• Usar a CLI do Gemini para explicar o código.
• Configurar a CLI do Gemini e entregar contexto para receber respostas personalizadas.
• Criar um comando de barra personalizado para reutilizar um comando.
• Usar as ferramentas da CLI do Gemini para fazer mudanças com segurança no sistema de arquivos local.
• Criar e modificar um app com a CLI do Gemini.

Configuração e requisitos

Antes de clicar no botão "Começar o laboratório"

Este laboratório prático do Google Skills permite que você realize as atividades em um ambiente real de nuvem, não em uma simulação ou demonstração. Você vai receber novas credenciais temporárias para fazer login e acessar o Google Cloud durante o laboratório.

O que é necessário

Veja os requisitos para concluir o laboratório:

• Acesso a um navegador de Internet padrão (recomendamos o Chrome).
• Tempo disponível para concluir as atividades

Como começar o laboratório e fazer login no console

1. Clique no botão Começar o laboratório. Se for preciso pagar pelo laboratório, você verá um pop-up para selecionar a forma de pagamento. Um painel aparece à esquerda contendo as credenciais temporárias que você precisa usar no laboratório.

   

2. Copie o nome de usuário e clique em Abrir console do Google. O laboratório ativa os recursos e depois abre a página Escolha uma conta em outra guia.

   Observação: abra as guias em janelas separadas, lado a lado.

3. Na página "Escolha uma conta", clique em Usar outra conta. A página de login abre.

   

4. Cole o nome de usuário que foi copiado do painel "Detalhes da conexão". Em seguida, copie e cole a senha.

5. Acesse as próximas páginas:

• Aceite os Termos e Condições.
• Não adicione opções de recuperação nem autenticação de dois fatores (porque essa é uma conta temporária).
• Não se inscreva em testes sem custo financeiro.

Depois de alguns instantes, o console do Cloud abre nesta guia.

Observação: para acessar a lista dos produtos e serviços do Google Cloud, clique no Menu de navegação no canto superior esquerdo.

Ative o Google Cloud Shell

O Google Cloud Shell é uma máquina virtual com ferramentas de desenvolvimento. Ele tem um diretório principal permanente de 5 GB e é executado no Google Cloud.

O Cloud Shell oferece acesso de linha de comando aos recursos do Google Cloud.

1. No console do Cloud, clique no botão "Abrir o Cloud Shell" na barra de ferramentas superior direita.

   

2. Clique em Continuar.

O provisionamento e a conexão do ambiente podem demorar um pouco. Quando você estiver conectado, já estará autenticado, e o projeto estará definido com seu PROJECT_ID. Exemplo:

A gcloud é a ferramenta de linha de comando do Google Cloud. Ela vem pré-instalada no Cloud Shell e aceita preenchimento com tabulação.

• Para listar o nome da conta ativa, use este comando:

Saída:

Exemplo de saída:

• Para listar o ID do projeto, use este comando:

Saída:

Exemplo de saída:

Tarefa 1: Instalar e executar a CLI do Gemini

Nesta tarefa, você vai instalar e executar a CLI do Gemini.

Testar a CLI do Gemini no Cloud Shell

A CLI do Gemini está disponível no Cloud Shell, sem precisar de configuração adicional.

1. Para iniciar a CLI do Gemini, no Cloud Shell, execute o seguinte comando:

   gemini

   Uma versão da CLI do Gemini já está instalada no Cloud Shell.

   

   Ao executar a CLI do Gemini pela primeira vez, ela pode atualizar automaticamente a versão para a versão estável mais recente.

2. Se perguntarem como autenticar este projeto, use a seta para baixo para selecionar Usar credenciais de usuário do Cloud Shell e pressione Enter ou Return.

3. Para ver os comandos disponíveis, na CLI do Gemini, execute o comando a seguir e pressione Enter ou Return:

   /help

   Os comandos na CLI do Gemini que começam com uma barra ('/') são chamados de comandos de barra. Para executar um comando de barra, pressione Enter ou Return.

   O comando /help fornece uma lista dos comandos que você pode enviar para a CLI do Gemini. Ele também mostra como executar comandos de shell ou fornecer arquivos para contexto.

   A CLI do Gemini precisa ser autenticada para se comunicar com o Gemini.

4. Para conferir o método de autenticação atual, execute o seguinte comando de barra:

   /auth

   O método de autenticação atual é usar as credenciais de usuário do Cloud Shell. A CLI do Gemini usa automaticamente as credenciais do usuário logado.

5. Para sair da caixa de diálogo de autenticação, pressione a tecla ESC (escape).

6. Para sair da CLI do Gemini, execute o comando de barra a seguir:

   /quit

Instalar a CLI do Gemini em um terminal de VM

Desta vez, você vai fazer login em uma VM e instalar a CLI do Gemini na linha de comando da VM. Uma VM chamada já foi criada para você.

1. No Cloud Shell, abra uma conexão SSH com a VM:

   gcloud compute ssh {{{project_0.startup_script.vm_name | VM_NAME}}} --zone={{{project_0.default_zone | ZONE}}}

2. Se necessário, pressione Enter ou Return para especificar o valor padrão de cada entrada.

   Sua sessão do Cloud Shell agora está sendo executada na VM.

3. Execute este comando:

   gemini

   A CLI do Gemini não está instalada na VM por padrão, então não foi possível encontrar o comando.

   Há várias maneiras de executar a CLI do Gemini:

   • É possível executar a partir de uma instalação padrão, usando npm para instalar globalmente ou npx para executar uma versão do NPM sem uma instalação global.
   • É possível executar a CLI do Gemini em um sandbox, dentro de um contêiner.
   • É possível clonar o repositório e executar o código-fonte, o que é útil se quiser contribuir com a base de código da CLI do Gemini.
   • É possível usar o npx para executar o commit mais recente do repositório do GitHub.

   Para usar o npm ou o npx, é necessário instalar o Node.js. Para controlar a versão usada do Node.js, também é possível instalar o nvm.

4. Para instalar o nvm, execute os seguintes comandos:

   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash source ~/.bashrc

   O script de instalação instala o nvm e adiciona as configurações necessárias ao arquivo .bashrc. A origem do arquivo .bashrc adiciona essas configurações à sessão atual do shell.

5. Para instalar a versão estável mais recente do Node usando o nvm, execute o seguinte comando:

   nvm install node

   Ao instalar o Node, o npm também é instalado.

   Agora que a versão estável mais recente do Node e do npm está instalada, é possível instalar a CLI do Gemini.

6. Para instalar a CLI do Gemini, execute o seguinte comando:

   npm install -g @google/gemini-cli@0.9.0

Executar a CLI do Gemini instalada

Quando a CLI do Gemini é executada pela primeira vez, ela mostra as opções de autenticação. A opção de credenciais de usuário do Cloud Shell não está mais disponível, porque estamos executando na linha de comando dentro da VM.

É possível usar a variável de ambiente GEMINI_API_KEY para executar o Gemini com uma chave de API do Google AI Studio.

Para fazer login com uma Conta do Google, você precisa especificar o projeto que está usando fornecendo uma variável de ambiente GOOGLE_CLOUD_PROJECT e a CLI do Gemini vai pedir para você fazer login.

Para usar a Vertex AI, você pode conseguir uma chave de API do Google Cloud e transmiti-la em uma variável de ambiente chamada GOOGLE_API_KEY ou usar as credenciais padrão do aplicativo no lugar da chave de API e exportar as variáveis GOOGLE_CLOUD_PROJECT e GOOGLE_CLOUD_LOCATION.

1. Para executar a CLI do Gemini em um diretório de projeto usando a Vertex AI, execute os comandos a seguir:

   export GOOGLE_CLOUD_PROJECT={{{project_0.project_id | PROJECT_ID}}} export GOOGLE_CLOUD_LOCATION={{{project_0.default_region | REGION}}} export GEMINI_MODEL=gemini-2.5-flash echo "export GOOGLE_CLOUD_PROJECT={{{project_0.project_id | PROJECT_ID}}}" >> ~/.bashrc echo "export GOOGLE_CLOUD_LOCATION={{{project_0.default_region | REGION}}}" >> ~/.bashrc echo "export GEMINI_MODEL=gemini-2.5-flash" >> ~/.bashrc mkdir ~/project1 cd ~/project1 gemini

   Esses comandos fazem o seguinte:

   • Exportam as variáveis necessárias para fazer login com a Vertex AI.
   • Exportam a variável que define o modelo usado pelo Gemini.
   • Adicionam essas instruções de exportação ao arquivo .bashrc para que as variáveis sejam exportadas automaticamente ao fazer login na VM.
   • Criam um diretório específico do projeto em que o Gemini possa ser executado.
   • Executam o Gemini.

   O Gemini pede para você escolher seu método de autenticação.

2. Selecione Vertex AI e pressione Enter ou Return.

   As variáveis de ambiente necessárias foram fornecidas e agora você se autenticou com a CLI do Gemini.

3. Para modificar as configurações da CLI do Gemini, execute o comando de barra a seguir:

   /settings

   As configurações do usuário são exibidas.

4. Use a seta para baixo para rolar até a configuração Desativar atualização automática e pressione Enter ou Return.

   A configuração "Desativar atualização automática" é definida como "true".

5. Para sair da caixa de diálogo de configurações, pressione a tecla ESC (escape).

6. Para sair da CLI do Gemini, insira o comando de barra /quit.

Clique em Verificar meu progresso para conferir os objetivos. Instalar e executar a CLI do Gemini

Tarefa 2: Conhecer a configuração da CLI do Gemini

Nesta tarefa, você vai aprender sobre a configuração da CLI do Gemini.

Os arquivos de configuração da CLI do Gemini são chamados de settings.json e podem ser especificados em três diferentes níveis:

• As configurações do usuário são especificadas em ~/.gemini/settings.json, em que ~ é seu diretório pessoal. As configurações no arquivo de configurações do usuário se aplicam a todas as sessões da CLI do Gemini para o usuário.
• As configurações do projeto são especificadas em .gemini/settings.json no diretório raiz do projeto. As configurações aqui se aplicam apenas ao executar a CLI do Gemini neste projeto específico.
• No Linux, as configurações do sistema são especificadas em /etc/gemini-cli/settings.json. Em geral, um usuário não administrador não pode modificar as configurações do sistema. Essas configurações se aplicam a todas as sessões de usuário no sistema.

As configurações são aplicadas hierarquicamente. As configurações do sistema substituem as configurações do projeto, e estas substituem as configurações do usuário. Os arquivos de configurações do sistema e do projeto não são criados até a especificação do tipo correspondente de configurações.

Conhecer os arquivos de configurações

1. Para listar o conteúdo do arquivo de configurações do usuário, execute o seguinte comando:

   cat ~/.gemini/settings.json

   O tipo de autenticação selecionado vertex-ai é especificado nas configurações do usuário.

2. Para iniciar a CLI do Gemini, execute o seguinte comando:

   cd ~/project1 gemini

3. Para modificar as configurações da CLI do Gemini, execute o comando de barra a seguir:

   /settings

4. Use as setas para cima e para baixo para rolar até a configuração Mostrar números de linha e pressione Enter ou Return.

   A configuração "Mostrar números de linha" está definida como "true" para o usuário. Os números de linha agora seriam exibidos em blocos de código na entrada da CLI.

   Também é possível gerenciar algumas configurações no nível do projeto e do sistema aqui.

5. Para sair da caixa de diálogo de configurações, pressione a tecla ESC (escape).

6. Para entrar no modo shell, pressione a tecla ! .

   O modo Shell permite interagir com o shell do sistema diretamente na CLI do Gemini. É possível ativar ou desativar o modo shell digitando um único ponto de exclamação.

7. Para conferir o novo conteúdo do arquivo de configurações, execute o seguinte comando de shell:

   cat ~/.gemini/settings.json Observação: os comandos executados no modo shell têm as mesmas permissões e o mesmo impacto que teriam se fossem executados diretamente no terminal. Por isso, tenha cuidado com comandos que podem alterar ou remover arquivos e diretórios.

   Agora você vai ver que a configuração "showLineNumbers" está no arquivo settings.json.

   É possível ver que a CLI do Gemini está no modo shell pelo comando do ponto de exclamação e pelo indicador shell mode enabled.

   

8. Para sair do modo shell, pressione a tecla ! .

9. Para sair da CLI do Gemini, insira o comando de barra /quit.

Adicionar contexto

Os arquivos de contexto definem o contexto instrucional do modelo do Gemini. Com esse recurso, você pode fornecer regras específicas do projeto, diretrizes de estilo de programação ou qualquer informação de contexto relevante para o Gemini. Isso ajuda você a receber respostas mais adaptadas às suas necessidades.

O contexto da CLI do Gemini costuma ser armazenado em arquivos chamados GEMINI.md. A seguir, você vai usar um arquivo de contexto para nos ajudar a entender uma base de código.

1. Para fazer o download da base de código da CLI do Gemini e listar o diretório raiz da base de código, execute os comandos a seguir:

   cd ~ git clone https://github.com/google-gemini/gemini-cli.git ls ~/gemini-cli

   A base de código da CLI do Gemini contém um arquivo de contexto GEMINI.md no diretório raiz. Quando sua equipe usa o Gemini para ajudar nas tarefas de desenvolvimento, um arquivo de contexto pode dar orientações ao Gemini, como padrões de codificação, bibliotecas e padrões preferidos ou padrões de build e teste.

2. Para iniciar a CLI do Gemini no diretório gemini-cli, execute os seguintes comandos:

   cd ~/gemini-cli gemini

3. Para pedir para a CLI do Gemini falar sobre a base de código, envie o seguinte comando:

   Forneça uma descrição resumida da base de código no diretório atual.

   A CLI envia ao Gemini o código, qualquer conteúdo dos arquivos de contexto GEMINI.md e seu comando.

   O Gemini pode retornar uma resposta como esta:

   ✦ Aqui está uma descrição geral da base de código da CLI do Gemini: * Finalidade: integrar a IA do Gemini do Google diretamente na linha de comando para desenvolvedores. * Tecnologias principais: criado com Node.js e TypeScript. * Interface do usuário: usa o React (Ink) para oferecer uma experiência interativa no terminal. * Principais recursos: oferece compreensão, geração, automação e depuração de código com tecnologia de IA. * Ferramentas: inclui ferramentas integradas para operações do sistema de arquivos, comandos shell e embasamento da Pesquisa Google. * Extensibilidade: ajuda nas integrações personalizadas usando o Protocolo de Contexto de Modelo (MCP). * Práticas de desenvolvimento: segue as diretrizes modernas do TypeScript, enfatizando a programação funcional, a imutabilidade e testes abrangentes com o Vitest.

   Essa descrição oferece uma boa visão geral do código. No entanto, sem especificar muitas orientações, você pode receber uma análise muito mais detalhada.

   Agora você usa seu próprio contexto para moldar a resposta do Gemini.

4. Para sair da CLI do Gemini, insira o comando de barra /quit.

5. Para criar um arquivo de contexto GEMINI.md para o usuário, execute o comando a seguir:

   cat > ~/.gemini/GEMINI.md <<EOF # Gemini CLI: Modo de Explicação Você é a CLI do Gemini, operando em um **modo de explicação** detalhado. Sua função é atuar como engenheiro sênior e arquiteto de sistemas virtual. Sua missão é servir como um guia interativo, ajudando os usuários a entender bases de código complexas por meio de um processo de descoberta conversacional. Seu principal objetivo é agir como uma ferramenta de inteligência e descoberta. Você desmembra a forma e o motivo da base de código para ajudar os engenheiros a se atualizarem rapidamente. Você precisa operar em uma capacidade restrita de coleta de informações somente leitura. Em vez de criar o que fazer, você explica como as coisas funcionam e por que foram criadas dessa forma. Seu ciclo principal é **definir o escopo, investigar, explicar e oferecer a próxima etapa lógica**, permitindo que o usuário acesse a complexidade da base de código tendo você como guia. # Princípios básicos do modo de explicação - **Descoberta guiada**: você não fornece uma explicação única e massiva. Você divide assuntos complexos em partes gerenciáveis e pergunta ao usuário por onde ele quer começar. Seu objetivo é conduzir um tour interativo, não dar uma aula. - **Acesso somente leitura rigoroso**: você pode realizar uma análise detalhada do sistema mapeando dependências, rastreando caminhos de execução e fazendo comparações do código com a documentação externa. - **Absolutamente nenhuma modificação**: você é fundamentalmente uma ferramenta de análise. É proibido a você realizar qualquer ação que altere o projeto ou o sistema. - **Acompanhamento contextualizado**: toda explicação precisa terminar com a sugestão de próximas etapas lógicas e específicas para análise mais aprofundada, de acordo com as informações que você acabou de apresentar. # Etapas interativas 1. **Reconheça e decomponha**: confirme que você está no **modo de explicação**. Analise a consulta inicial do usuário. Se a consulta for ampla (por exemplo, "explique o sistema de autenticação", "como o banco de dados funciona?"), sua **primeira resposta precisa ser decompor o tópico em uma lista de subtópicos específicos**. Em seguida, peça para o usuário escolher qual área investigar primeiro. Não prossiga até que o usuário dê instruções. 2. **Faça uma investigação focada**: com base na escolha do usuário, faça uma investigação direcionada. Antes de apresentar a explicação completa, resuma brevemente seu caminho de investigação (o "rastro da investigação"). 3. **Sintetize a narrativa técnica**: formule uma explicação clara e estruturada para o *subtópico específico* que o usuário selecionou. Conecte conceitos, explique padrões de projeto e esclareça as responsabilidades do código relevante. 4. **Apresente a explicação e proponha as próximas etapas**: apresente sua explicação direcionada. Termine sua resposta oferecendo uma lista de novas perguntas contextuais que representem as próximas etapas lógicas. Isso guia o usuário mais profundamente no sistema. Por exemplo, depois de explicar uma rota de API específica, você pode perguntar se ele quer ver o serviço que ela chama, o modelo de dados que usa ou o middleware de autenticação. EOF

   Esse arquivo de contexto define um modo chamado Modo de explicação, que transforma a CLI do Gemini em um engenheiro sênior virtual e arquiteto de sistemas. Ele foi criado para ajudar o usuário a entender a base de código usando um processo interativo e para ser somente leitura.

6. Para iniciar a CLI do Gemini, execute os seguintes comandos:

   cd ~/gemini-cli gemini

7. Para pedir à CLI do Gemini que fale sobre a base de código usando o modo de explicação, insira o comando a seguir:

   Fale sobre a base de código no diretório atual.

   O Gemini responde diferente do que quando você usou o mesmo comando sem o contexto do modo de explicação. A nova resposta pode ser parecida com esta:

   ✦ Estou no modo de explicação. Essa base de código parece ser um monorepo que contém vários pacotes, além da documentação, configuração e fluxos de trabalho de CI/CD. Para ajudar você a entender melhor, posso explicar as seguintes áreas gerais: 1. Configuração do projeto: como o projeto está configurado (por exemplo, inspeção, formatação, configurações de build). 2. Documentação: a estrutura e o conteúdo da documentação do projeto. 3. CI/CD e fluxos de trabalho do GitHub: os processos automatizados para integração contínua, implantação e outras ações do GitHub. 4. Scripts: os vários scripts de utilitários e de build usados no projeto. 5. Pacotes/módulos principais: os principais componentes funcionais do monorepo (por exemplo, a2a-server, cli, core, vscode-ide-companion). 6. Testes de integração: como os testes de integração são estruturados e executados. 7. Extensão de exemplo: a extensão de exemplo "Hello World". Qual área você quer investigar primeiro?

8. Para dar continuidade à resposta, mencione uma das principais áreas que o Gemini destacou.

   Por exemplo, você pode responder assim:

   pacotes principais

   O Gemini continua usando o contexto do modo de explicação, porque ele também recebe o histórico de chat como contexto. A resposta pode ser parecida com esta:

   ✦ Você escolheu analisar os pacotes principais. No diretório "packages/", vejo os seguintes subpacotes: 1. a2a-server/: provavelmente um componente de servidor de aplicativo para aplicativo. 2. cli/: o aplicativo da interface de linha de comando. 3. core/: funcionalidades principais ou utilitários compartilhados usados em outros pacotes. 4. test-utils/: utilitários criados especificamente para testes. 5. vscode-ide-companion/: um componente complementar para integração com o Visual Studio Code. Qual desses pacotes principais você gostaria de analisar primeiro?

   A CLI do Gemini agora usa o contexto dos dois arquivos GEMINI.md, combinando o contexto geral do modo de explicação com as informações específicas do projeto no diretório gemini-cli.

   Você também pode adicionar contexto usando o comando de barra /memory.

9. Para ver o contexto usado, execute o seguinte comando de barra:

   /memory show

   É exibido o conteúdo do contexto no nível do usuário em ~/.gemini/GEMINI.md e do contexto no nível do projeto em ./GEMINI.md.

10. Para adicionar ao contexto no nível do usuário, execute o seguinte comando:

    /memory add Ao listar subtópicos para o usuário, marque um deles como RECOMENDADO para indicar que é o melhor próximo tópico para o usuário.

    A CLI do Gemini mostra o texto que será adicionado ao contexto no nível do usuário.

11. Para aplicar a mudança, pressione Enter ou Return.

12. Para sair da CLI do Gemini, insira o comando de barra /quit.

13. Para ver o conteúdo do contexto no nível do usuário, execute o comando a seguir:

    cat ~/.gemini/GEMINI.md

    O novo contexto adicionado deve aparecer na parte de baixo do arquivo.

14. Para iniciar a CLI do Gemini, execute os seguintes comandos:

    cd ~/gemini-cli gemini

15. Para pedir uma explicação de código, use o comando a seguir:

    Fale sobre a base de código no diretório atual.

    O Gemini vai marcar um dos subtópicos como RECOMENDADO.

16. Para sair da CLI do Gemini, insira o comando de barra /quit.

Clique em Verificar meu progresso para conferir os objetivos. Conhecer a configuração da CLI do Gemini

Tarefa 3: Criar um comando de barra personalizado

Nesta tarefa, você vai conhecer os comandos de barra personalizados.

Com os comandos personalizados, é possível salvar e reutilizar seus comandos favoritos ou mais usados como atalhos pessoais na CLI do Gemini. Os comandos personalizados são armazenados em arquivos TOML localizados em diretórios específicos.

É possível criar comandos disponíveis globalmente em ~/.gemini/commands/ e em um projeto específico em .gemini/commands/ no diretório do projeto.

Você cria um comando de barra de explicação para substituir o conteúdo de explicação no arquivo de contexto.

1. Para remover o arquivo de contexto no nível do usuário, execute o comando a seguir:

   rm ~/.gemini/GEMINI.md

   O contexto do modo de explicação não está mais disponível na CLI do Gemini.

2. Para criar um arquivo de comando, execute os comandos a seguir:

   mkdir ~/.gemini/commands cat > ~/.gemini/commands/explain.toml <<EOF description = "use Explain Mode" prompt = ''' # Gemini CLI: Modo de Explicação Você é a CLI do Gemini operando em um **modo de explicação** especializado. Sua função é atuar como engenheiro sênior e arquiteto de sistemas virtual. Sua missão é servir como um guia interativo, ajudando os usuários a entender bases de código complexas por meio de um processo de descoberta conversacional. Seu principal objetivo é agir como uma ferramenta de inteligência e descoberta. Você desmembra a forma e o motivo da base de código para ajudar os engenheiros a se atualizarem rapidamente. Você precisa operar em uma capacidade restrita de coleta de informações somente leitura. Em vez de criar o que fazer, você explica como as coisas funcionam e por que foram criadas dessa forma. Seu ciclo principal é **definir o escopo, investigar, explicar e oferecer a próxima etapa lógica**, permitindo que o usuário acesse a complexidade da base de código tendo você como guia. # Princípios básicos do modo de explicação - **Descoberta guiada**: você não fornece uma explicação única e massiva. Você divide assuntos complexos em partes gerenciáveis e pergunta ao usuário por onde ele quer começar. Seu objetivo é conduzir um tour interativo, não dar uma aula. - **Acesso somente leitura rigoroso**: você pode realizar uma análise detalhada do sistema mapeando dependências, rastreando caminhos de execução e fazendo comparações do código com a documentação externa. - **Absolutamente nenhuma modificação**: você é fundamentalmente uma ferramenta de análise. É proibido a você realizar qualquer ação que altere o projeto ou o sistema. - **Acompanhamento contextualizado**: toda explicação precisa terminar com a sugestão de próximas etapas lógicas e específicas para análise mais aprofundada, de acordo com as informações que você acabou de apresentar. # Etapas interativas 1. **Reconheça e decomponha**: confirme que você está no **modo de explicação**. Analise a consulta inicial do usuário. Se a consulta for ampla (por exemplo, "explique o sistema de autenticação", "como o banco de dados funciona?"), sua **primeira resposta precisa ser decompor o tópico em uma lista de subtópicos específicos**. Em seguida, peça para o usuário escolher qual área investigar primeiro. Não prossiga até que o usuário dê instruções. 2. **Faça uma investigação focada**: com base na escolha do usuário, faça uma investigação direcionada. Antes de apresentar a explicação completa, resuma brevemente seu caminho de investigação (o "rastro da investigação"). 3. **Sintetize a narrativa técnica**: formule uma explicação clara e estruturada para o *subtópico específico* que o usuário selecionou. Conecte conceitos, explique padrões de projeto e esclareça as responsabilidades do código relevante. 4. **Apresente a explicação e proponha as próximas etapas**: apresente sua explicação direcionada. Termine sua resposta oferecendo uma lista de novas perguntas contextuais que representem as próximas etapas lógicas. Isso guia o usuário mais profundamente no sistema. Por exemplo, depois de explicar uma rota de API específica, você pode perguntar se ele quer ver o serviço que ela chama, o modelo de dados que usa ou o middleware de autenticação. ''' EOF

   O comando de barra criado (/explain) corresponde ao prefixo do arquivo explain.toml. O texto do comando entre as aspas triplas é exatamente o mesmo texto usado no arquivo de contexto no nível do usuário. A descrição acima do comando contém o texto que é mostrado ao digitar o comando de barra.

3. Para iniciar a CLI do Gemini, execute os seguintes comandos:

   cd ~/gemini-cli gemini

4. Para receber uma descrição sem o modo de explicação, use o seguinte comando:

   quero saber mais sobre o código

   O Gemini responde sem o contexto do modo de explicação.

5. Para usar o modo de explicação, use o seguinte comando de barra personalizado:

   /explain quero saber mais sobre o código

   O Gemini responde no modo de explicação. Agora você pode continuar a conversa interativa como antes.

6. Para perguntar ao Gemini sobre o modo, use o comando a seguir:

   Em qual modo você está?

   O Gemini responde que ainda está no modo de explicação.

7. Para sair da CLI do Gemini, insira o comando de barra /quit.

Clique em Verificar meu progresso para conferir os objetivos. Criar um comando de barra personalizado

Tarefa 4: Usar as ferramentas da CLI do Gemini

Nesta tarefa, você vai conhecer as ferramentas da CLI do Gemini.

A CLI do Gemini conta com ferramentas integradas que permitem que o modelo do Gemini interaja com seu ambiente local, recupere informações e execute tarefas. Com essa funcionalidade, a CLI do Gemini pode ajudar você em várias atividades.

As ferramentas incluem:

• Ferramentas do sistema de arquivos para listar diretórios, ler e gravar arquivos, pesquisar arquivos com caracteres curinga, pesquisar e atualizar texto em arquivos.
• Uma ferramenta de shell para interagir com o sistema, executar scripts e realizar operações de linha de comando.
• Ferramentas de pesquisa e busca na web.
• Uma ferramenta de memória para salvar e recuperar informações em várias sessões.

O Gemini usa ferramentas integradas para recuperar informações da internet e criar arquivos com essas informações.

Checkpoint da CLI do Gemini

A CLI do Gemini tem um recurso de checkpoint que cria automaticamente um snapshot Git do estado do seu projeto antes que as ferramentas com tecnologia de IA façam modificações nos arquivos. Dessa forma, é possível fazer experimentos com a CLI do Gemini, criando mudanças com a segurança de poder reverter as alterações instantaneamente, se necessário.

Cada checkpoint é feito em um repositório Git especial e oculto localizado no diretório pessoal dentro do diretório ~/.gemini. O snapshot captura o estado completo dos arquivos do projeto naquele momento e não tem efeito no repositório Git do projeto. Também são capturadas toda a conversa que você teve com o agente até aquele momento e a chamada de ferramenta específica que estava prestes a ser executada.

Para restaurar um checkpoint, use o comando de barra /restore. Isso vai reverter os arquivos para o estado capturado, restaurar o histórico da conversa e propor novamente a chamada da ferramenta original. Você pode executar o comando de novo, modificá-lo ou simplesmente ignorá-lo.

Você pode ativar o checkpoint para uma sessão usando a flag --checkpointing ou ativando o checkpoint no arquivo settings.json.

Recuperar informações atuais da internet

1. Para iniciar a CLI do Gemini, execute os seguintes comandos:

   cd ~/project1 gemini

2. Para ativar o modo shell, pressione o botão ! .

   A CLI do Gemini vai executar o texto inserido como comandos do shell até que o modo shell seja desativado.

3. Para recuperar o feed RSS do Google Cloud da internet, execute o comando de shell a seguir:

   wget -O ~/project1/rss.xml "https://cloudblog.withgoogle.com/rss/"

   O XML do feed é armazenado no diretório ~/project1 em um arquivo chamado rss.xml.

   Observação: a CLI do Gemini também pode recuperar se você pedir com um comando normal, mas o laboratório usa um comando do shell para garantir que o feed seja recuperado de forma consistente,

4. Para desativar o modo shell, pressione !.

5. Para resumir as informações no feed, envie o comando a seguir:

   resuma o conteúdo do arquivo XML RSS

   Se você recuperou o arquivo do feed RSS, as informações retornadas podem ser parecidas com o seguinte:

   ✦ O feed RSS do blog do Google Cloud contém vários artigos recentes que abordam avanços e atualizações nas ofertas do Google Cloud. Os principais tópicos incluem: * AI Security: o Model Armor é apresentado como uma solução para proteger aplicativos de IA contra injeções de comandos, jailbreaks, exposição de dados sensíveis e outras ameaças, com detalhes de integração para o Apigee. * Migração para várias arquiteturas: a jornada do Google para um ambiente de várias arquiteturas (x86 e Arm) para serviços de produção é detalhada, destacando o papel da IA e de ferramentas de automação como o CogniPort nessa migração em grande escala. * Melhorias na segurança da nuvem: o Cloud Armor recebe novos recursos, como políticas de segurança hierárquicas, inspeção aprimorada de WAF, técnicas de impressão digital de rede JA4 e inteligência contra ameaças de rede para Media CDN, reforçando sua posição como um agente de forte desempenho em soluções de firewall de aplicativos da web. * Linhagem de dados para confiança na IA: o Dataplex agora oferece linhagem no nível da coluna para dados do BigQuery, proporcionando visibilidade granular da jornada dos dados para gerar confiança e contexto para sistemas de IA. * Atualizações do Hipercomputador de IA: algumas das atualizações significativas no Hipercomputador de IA são vLLM na TPU para melhorar a inferência de LLM, um XProf Profiler aprimorado e novas receitas para NVIDIA Dynamo e NeMo RL. * Melhorias nas GPUs: anunciamos a disponibilidade geral das VMs G4 com tecnologia das GPUs RTX PRO 6000 Blackwell da NVIDIA, oferecendo ganhos significativos de desempenho para a IA, computação visual e simulação, além de uma estrutura P2P personalizada para cargas de trabalho com várias GPUs. No geral, o feed destaca a inovação contínua do Google Cloud em IA, machine learning, segurança e infraestrutura para entregar soluções de alto desempenho, seguras e escalonáveis para as empresas. Observação: se a CLI do Gemini não conseguir resumir os detalhes do feed, você vai precisar recuperar uma versão preparada do arquivo.

6. Se o arquivo XML RSS não foi recuperado, ative o modo shell e use este comando para recuperar uma versão preparada do arquivo de feed:

   wget -O ~/project1/rss.xml "https://storage.googleapis.com/cloud-training/CBL547/rss.xml"

   Na próxima tarefa, o arquivo de feed será usado como fonte de dados para um web app. A CLI do Gemini pode mover e renomear o arquivo para você.

7. Se você estiver no modo shell, pressione ! para desativar esse modo.

8. Para modificar a estrutura de arquivos e diretórios, envie o comando a seguir:

   Crie um diretório chamado "data", mova o arquivo RSS para lá e renomeie o arquivo para "feed.xml".

9. Sempre que a CLI do Gemini perguntar se você quer continuar, pressione Enter para permitir o uso da ferramenta.

   Observação: embora este laboratório peça para você sempre aceitar as mudanças, no uso real, geralmente é melhor analisar as mudanças propostas antes de aceitar ou rejeitar.

10. Para conferir a estrutura de diretórios resultante, envie o comando a seguir:

    retorne uma listagem longa do conteúdo de todos os diretórios e subdiretórios

11. Para sair da CLI do Gemini, insira o comando de barra /quit.

12. Para sair da sessão SSH, digite exit e pressione Enter ou Return.

Clique em Verificar meu progresso para conferir os objetivos. Usar as ferramentas da CLI do Gemini

Tarefa 5: Criar um web app com a CLI do Gemini

Nesta tarefa, você vai criar um web app com vibe coding (programação assistida por IA) da CLI do Gemini.

Vibe coding é uma prática de desenvolvimento de software que usa inteligência artificial para gerar código funcional partindo de comandos em linguagem natural. Ela acelera o desenvolvimento de apps para desenvolvedores e permite que pessoas com pouca experiência em programação criem apps funcionais.

1. No Cloud Shell, abra uma conexão SSH com a VM:

   gcloud compute ssh {{{project_0.startup_script.vm_name | VM_NAME}}} --zone={{{project_0.default_zone | ZONE}}} -- -L 8080:localhost:5000 Observação: este comando SSH é diferente do que você usou antes. O final do comando configura um túnel de encaminhamento de portas local, em que o tráfego local na porta 8080 é encaminhado automaticamente para a porta 5000 na VM. Ele é usado para testar o web app que você vai criar nesta tarefa.

2. Para iniciar a CLI do Gemini, execute os seguintes comandos:

   cd ~/project1 gemini

   A primeira etapa é investigar o arquivo feed.xml baixado.

3. Para saber quais itens estão no feed, envie o comando a seguir:

   @data/feed.xml quais campos de dados uma entrada de feed tem?

   O comando @ inclui o conteúdo do arquivo data/feed.xml como parte do seu comando para o Gemini.

   A resposta da CLI do Gemini pode ser semelhante a esta:

   ✦ Uma entrada de feed (<item>) no arquivo feed.xml tem os seguintes campos de dados: * title * link * description * pubDate * guid * category * og:type * og:title * og:description * og:site_name * og:url * author:name * author:title * author:department * author:company

   Em seguida, você vai criar um web app em Python Flask que mostra informações desse feed.

4. Para pedir à CLI do Gemini que crie o app, envie o comando a seguir:

   Antes de fazer qualquer mudança, crie um plano e peça minha aprovação. 1. Use um ambiente virtual (venv) para Python3. 2. Crie um web app em Python que usa a biblioteca Flask e o feed.xml como fonte de dados. 3. A página index.html deve ler o arquivo feed.xml e mostrar uma lista das entradas do blog, da mais recente para a mais antiga. 4. Cada entrada deve mostrar a data da postagem do blog e um link, sendo que o texto do link é o título do blog e o URL abre o URL da entrada do blog em uma nova guia. 5. O app deve ser hospedado na porta 5000. 6. Inicie o servidor da web para mim.

   A primeira instrução pede para a CLI do Gemini elaborar o plano e solicitar aprovação. Essa é uma prática recomendada para fazer mudanças no sistema usando ferramentas de IA.

   A lista numerada fornece à CLI do Gemini alguns requisitos para o app.

   A CLI do Gemini deve criar um plano para o app e você deve revisá-lo.

   A resposta pode ser parecida com esta:

   ✦ Este é meu plano para criar o web app Flask: 1. Configurar o ambiente virtual Python: * Criar um ambiente virtual chamado venv. * Ativar o ambiente virtual. * Instalar o Flask e o feedparser (para facilitar a análise XML) no ambiente virtual. 2. Desenvolver o aplicativo Flask (app.py): * Criar um arquivo Python app.py. * Inicializar um aplicativo Flask. * Definir uma rota para o URL raiz (/). * Dentro da função de rota: * Ler e analisar o arquivo feed.xml usando o feedparser. * Classificar as postagens do blog por data de publicação em ordem decrescente (as mais recentes primeiro). * Renderizar um modelo HTML (index.html) passando as entradas de blog classificadas para ele. 3. Criar o modelo HTML (templates/index.html): * Criar um diretório chamado "templates". * Em "templates", criar o arquivo index.html. * Este modelo vai: * Exibir um cabeçalho para as postagens do blog. * Iterar a lista de postagens. * Para cada entrada, mostrar a data de publicação e um título clicável que leva ao URL da postagem, abrindo em uma nova guia. 4. Executar o servidor da web Flask: * Definir a variável de ambiente FLASK_APP como app.py. * Iniciar o servidor de desenvolvimento do Flask na porta 5000. Você aprova este plano?

5. Quando a CLI do Gemini pedir para você aprovar o plano, digite sim e pressione Enter ou Return.

   A CLI do Gemini vai começar a implementar as mudanças. Neste laboratório, aceite todas as solicitações da CLI do Gemini.

6. Sempre que a CLI do Gemini perguntar se você quer continuar, pressione Enter para permitir o uso da ferramenta.

   Depois de várias etapas que você vai precisar confirmar, a CLI do Gemini vai criar e iniciar o aplicativo.

   Observação: se a ferramenta Shell indicar que o app Flask está sendo veiculado, você pode seguir para a próxima etapa, mesmo que o comando ainda não tenha retornado.

7. Para executar o aplicativo no navegador da web, clique em Visualização da web e selecione Visualizar na porta 8080.

   

   Uma nova guia é aberta no navegador e o aplicativo é executado. Você pode clicar em um link e a postagem vai abrir em uma nova guia.

   O app provavelmente é bem simples. Você pode pedir para a CLI do Gemini melhorá-lo.

8. Se a ferramenta Shell ainda estiver em execução, pressione ESC para cancelar.

9. Para pedir para a CLI do Gemini modificar o app, volte a ela e envie o seguinte comando:

   Aqui estão algumas mudanças que eu gostaria de fazer. Como antes, quero aprovar seu plano primeiro. 1. Os links em index.html agora abrem uma nova página chamada entry.html. 2. A nova página, entry.html, usa um parâmetro de consulta que contém uma versão codificada em URL do identificador exclusivo da entrada e mostra todas as informações da entrada do blog do feed em um formato legível. 3. Um link na parte superior da entry.html deve abrir a postagem do blog em uma nova guia. 4. Adicionar um botão "Voltar" na página entry.html para voltar a index.html. 5. Adicionar CSS para deixar o app mais agradável e usar as cores azul e verde do logotipo do Google.

   O Gemini vai pensar sobre a solicitação e criar um plano. Analise o plano da CLI do Gemini.

   A resposta pode ser parecida com esta:

   ✦ Aqui está um plano para implementar as mudanças solicitadas: 1. Atualizar o app.py: * Adicionar uma nova rota /entry: essa rota vai cuidar das solicitações de entradas individuais do blog. * Ela vai esperar um parâmetro de consulta guid, que será o identificador exclusivo da entrada do blog. * Ela vai analisar o feed.xml novamente para encontrar a entrada correspondente ao guid fornecido. * Se a entrada for encontrada, ela vai renderizar um novo modelo entry.html, passando os dados da entrada encontrada. * Se a entrada não for encontrada, ela será redirecionada para a página inicial ou exibirá um erro. * Garantir que a lógica de análise do feed.xml seja robusta: a rota de índice vai continuar analisando o feed.xml e classificando as entradas para a listagem principal. 2. Modificar templates/index.html: * Atualizar os links de entrada: mude o href do título de cada entrada do blog para apontar para a nova rota /entry, transmitindo o guid da entrada como um parâmetro de consulta codificado por URL. * Link para CSS: adicionar uma tag <link> na seção <head> para adicionar o novo arquivo style.css. 3. Criar templates/entry.html: * Novo arquivo HTML: criar entry.html no diretório "templates". * Exibir detalhes da entrada: esta página vai mostrar todos os detalhes da entrada de blog selecionada, incluindo: * Título * Data de publicação * Autor (se disponível) * Descrição (será exibido o conteúdo HTML bruto, já que ele já está em HTML no feed) * Link para a postagem original: inclua um link em destaque (por exemplo, "Leia o artigo original") que usa entry.link e target="_blank" para abrir o post original em uma nova guia. * Botão "Voltar": adicionar um link ou botão que volte para index.html usando url_for('index'). * Link para CSS: adicionar uma tag <link> na seção <head> para adicionar o novo arquivo style.css. 4. Criar static/style.css: * Novo arquivo CSS: criar um diretório estático e style.css dentro dele. * Estilização: aplicar regras de CSS aos arquivos index.html e entry.html para criar uma estética agradável. Vou usar as cores da marca do Google: * Azul do Google: #4285F4 * Verde do Google: #34A853 * Serão definidos o layout geral, a tipografia, os estilos de link e os modelos de caixa para as entradas. 5. Reiniciar o aplicativo Flask: * O servidor Flask vai precisar ser reiniciado para selecionar as mudanças em app.py e os novos arquivos de modelo/estáticos. Você aprova este plano detalhado?

10. Quando a CLI do Gemini pedir para você aprovar o plano, digite sim e pressione Enter ou Return.

11. Sempre que a CLI do Gemini perguntar se você quer continuar, pressione Enter para permitir o uso da ferramenta.

    A CLI do Gemini vai trabalhar nas atualizações e reiniciar o servidor da web.

12. Atualize a página do web app ou abra uma nova guia usando a visualização da web.

    O app atualizado agora deve contar com uma página para cada postagem e usar as cores azul e verde do Google.

    Observação: se o app não tiver mudado, a CLI do Gemini pode não ter encerrado o servidor da web. Use um comando como "desative e reinicie o servidor da web" para ajudar a CLI do Gemini a reiniciá-lo.

    Este é um exemplo da página do blog gerada pela CLI do Gemini:

    

Clique em Verificar meu progresso para conferir os objetivos. Criar um web app com a CLI do Gemini

Opcional: depois de verificar seu progresso na etapa 5, você pode usar a CLI do Gemini para fazer outras mudanças ou correções no app.

Parabéns!

Você instalou a CLI do Gemini, configurou e forneceu contexto para receber respostas personalizadas às suas necessidades e usou a ferramenta para explicar o código e criar um app.

Manual atualizado em 22 de outubro de 2025

Laboratório testado em 22 de outubro de 2025

Copyright 2026 Google LLC. Todos os direitos reservados. Google e o logotipo do Google são marcas registradas da Google LLC. Todos os outros nomes de empresas e produtos podem ser marcas registradas das empresas a que estão associados.