Esta página foi traduzida pela API Cloud Translation.

Usar o chat autônomo como um programador em dupla

Este documento descreve como configurar e usar o modo agente do Gemini Code Assist como um programador em dupla no seu ambiente de desenvolvimento integrado (IDE).

O modo agêntico está disponível no VS Code.

Algumas maneiras de usar o Gemini Code Assist no modo agente:

Faça perguntas sobre o código.
Use ferramentas e contexto integrados no modo agente para melhorar o conteúdo gerado.
Configure servidores MCP para ampliar as habilidades do agente.
Receba soluções para tarefas complexas com várias etapas.
Gerar código de documentos de design, problemas e comentários do TODO.
Controle o comportamento do agente comentando, editando e aprovando planos e o uso de ferramentas durante a execução.

Como o modo de agente funciona

No modo agente, seu comando é enviado à API Gemini com uma lista de ferramentas disponíveis. A API Gemini processa o comando e retorna uma resposta. A resposta pode ser uma resposta direta ou um pedido para usar uma ferramenta disponível.

Quando uma ferramenta é solicitada, o agente se prepara para usá-la e verifica se tem permissão para fazer isso sem autorização explícita. Para solicitações de ferramentas que modificam o sistema de arquivos ou realizam operações de mutação em qualquer recurso, o Gemini vai pedir sua permissão, a menos que você tenha configurado o Gemini para sempre permitir a ferramenta ou as ferramentas. As solicitações de ferramentas somente leitura podem não pedir permissão antes de concluir a tarefa. Quando for solicitado a permitir o uso de uma ferramenta, você pode escolher permitir ou negar a operação. O agente também pode oferecer opções para sempre permitir uma ferramenta ou servidor ou permitir operações semelhantes.

Depois que a permissão para usar a ferramenta é concedida, o agente a usa para concluir a ação necessária, e o resultado é enviado de volta para a API Gemini. O Gemini processa o resultado da ação da ferramenta e gera outra resposta. Esse ciclo de ação e avaliação continua até que a tarefa seja concluída.

Para tarefas complexas, o Gemini pode mostrar um plano de alto nível para sua aprovação. Você pode ajustar o plano e fazer perguntas no chat antes de começar o processo. Quando o plano estiver pronto, você poderá aprová-lo. O agente começa a trabalhar na primeira tarefa e pede esclarecimentos ou permissões conforme necessário ao executar o plano.

Contexto do modo agêntico

O contexto permite que um agente gere respostas melhores para um determinado comando. O contexto pode ser extraído de arquivos no seu ambiente de desenvolvimento integrado, arquivos nas pastas do sistema local, respostas de ferramentas e detalhes do comando.

Dependendo do seu ambiente de desenvolvimento integrado (IDE) e das configurações, diferentes contextos podem estar disponíveis para o agente.

Os seguintes métodos de obtenção de contexto geralmente estão disponíveis para o Gemini Code Assist no modo de agente:

Informações no seu espaço de trabalho do ambiente de desenvolvimento integrado.
Respostas de ferramentas integradas, como grep, terminal, leitura ou gravação de arquivos.
Respostas da Pesquisa Google.
Conteúdo de um determinado URL fornecido em um comando ou por uma ferramenta.
Arquivos de contexto criados em Markdown com escopo para todos os seus projetos, um projeto específico ou instruções específicas para um componente, módulo ou subseção específica do projeto. Os arquivos de contexto podem ter instruções, diretrizes ou informações que você quer que o Gemini saiba durante as interações no modo agente.

Memória do modo agêntico

O modo de agente do Gemini Code Assist usa o serviço de descoberta de memória da CLI do Gemini para encontrar e carregar arquivos GEMINI.md que fornecem contexto para o agente. O serviço de descoberta de memória pesquisa arquivos de forma hierárquica, começando pelo diretório de trabalho atual e subindo até a raiz do projeto e o diretório inicial. Ele também pesquisa em subdiretórios.

Você pode ter arquivos de contexto global, no nível do projeto e do componente, que são combinados para fornecer ao modelo as informações mais relevantes.

É possível usar o comando /memory show para ver o conteúdo combinado de todos os arquivos GEMINI.md carregados e o comando /memory refresh para recarregá-los.

Extensões da CLI do Gemini

No VS Code, é possível usar extensões da CLI do Gemini para configurar e ampliar a funcionalidade do modo de agente do Gemini Code Assist.

O agente procura extensões em dois locais:

WORKSPACE/.gemini/extensions em que WORKSPACE é seu espaço de trabalho atual.
~/.gemini/extensions em que ~ é seu diretório principal.

O agente carrega todas as extensões dos dois locais, mas se uma extensão com o mesmo nome existir em ambos, a do diretório do espaço de trabalho terá precedência. Cada extensão é um diretório que contém um arquivo gemini-extension.json. Esse arquivo contém a configuração da extensão.

Para mais informações, consulte Extensões da CLI Gemini.

Limitações

As seguintes limitações se aplicam ao usar o modo de agente:

O agente não pode chamar as ferramentas do Gemini Code Assist. Você precisa sair do modo agente para usar essas ferramentas.
O agente não pode usar a personalização de código. Você precisa sair do modo agente para usar a personalização de código.
Projetos com várias raízes não são compatíveis com o modo de agente. Se você usar o modo de agente em um projeto com vários diretórios raiz, o agente só terá acesso ao primeiro diretório raiz encontrado.
O Gemini para Google Cloud registros não está disponível no modo agente.

Antes de começar

Configure o Gemini Code Assist.
Defina o canal de lançamento do Gemini Code Assist como a build Insiders:
1. Abra a paleta de comandos (Cmd + Shift + P) e selecione Abrir JSON de configurações do usuário.
2. Adicione a seguinte linha ao JSON das configurações do usuário:
```
"geminicodeassist.updateChannel": "Insiders",
```

Usar o modo agente

No modo agente, você pode pedir para o Gemini concluir metas de alto nível e tarefas complexas.

Para aproveitar ao máximo o modo agente, siga as práticas recomendadas de comandos e forneça o máximo de detalhes possível.

Para mudar para o modo de agente:

VS Code

Para abrir o chat do Gemini Code Assist, clique em spark Gemini Code Assist na barra de atividades do seu IDE.
Clique na chave Agente para entrar no modo de agente. O botão fica destacado quando ativado para o modo de agente e cinza quando está no chat normal.
No chat do Gemini Code Assist, insira seu comando.

O Gemini responde ao seu comando ou pede permissão para usar uma ferramenta.

Para interromper o agente, clique em Parar.

Para usar o chat padrão do Gemini Code Assist, clique em Novo chat para criar um novo chat.

O modo de agente do Gemini Code Assist é alimentado pela CLI do Gemini.

IntelliJ

Esse recurso não é compatível com o Gemini Code Assist para IntelliJ ou outros ambientes de desenvolvimento integrado do JetBrains.

Configurar ferramentas para o modo de agente

Ferramentas são uma categoria ampla de serviços que um agente pode usar para contexto e ações na resposta ao seu comando. Alguns exemplos de ferramentas são as integradas, como grep e leitura ou gravação de arquivos, servidores locais ou remotos do protocolo de contexto de modelo (MCP) ou implementações de serviços personalizados.

Configurar servidores MCP

Para controlar quais servidores estão disponíveis no modo de agente, adicione-os ao JSON de configurações do Gemini de acordo com a documentação do servidor.

VS Code

Instale as dependências necessárias para o servidor MCP.
Abra o JSON das configurações do Gemini localizado em ~/.gemini/settings.json, em que ~ é seu diretório inicial.

Adicione servidores MCP locais ou remotos ao JSON das configurações do Gemini de acordo com as instruções do servidor.

O exemplo a seguir adiciona o servidor MCP remoto do Cloudflare e instala os servidores do GitHub e do GitLab na máquina local.

{
    "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_example_personal_access_token12345"
      }
    },
    "gitlab": {
      "command": "npx",
      "args": [
          "-y",
          "@modelcontextprotocol/server-gitlab"
      ]
    },
        "cloudflare-observability": {
            "command": "npx",
            "args": ["mcp-remote", "https://observability.mcp.cloudflare.com/sse"]
        },
        "cloudflare-bindings": {
            "command": "npx",
            "args": ["mcp-remote", "https://bindings.mcp.cloudflare.com/sse"]
        }
    }
}

Abra a paleta de comandos e selecione Desenvolvedor: recarregar janela.

Os servidores MCP configurados estão disponíveis para o agente usar no modo de agente.

IntelliJ

Esse recurso não é compatível com o Gemini Code Assist para IntelliJ ou outros ambientes de desenvolvimento integrado do JetBrains.

Autenticação do servidor MCP

Para servidores MCP que exigem autenticação, adicione-os ao JSON das configurações do Gemini.

O exemplo a seguir adiciona um token de acesso pessoal para o GitHub:

{
//other settings...

"github": {
  "command": "/Users/username/code/github-mcp-server/cmd/github-mcp-server/github-mcp-server",
  "args": ["stdio"],
  "env": {
    "GITHUB_PERSONAL_ACCESS_TOKEN": "ACCESS_TOKEN"
  }
},

// other settings...
}

Em que ACCESS_TOKEN é o token de acesso do usuário.

Criar um arquivo de contexto

VS Code

Crie um arquivo chamado GEMINI.md em um local que corresponda ao escopo em que você quer que o contexto seja aplicado. A tabela a seguir detalha os locais dos arquivos de contexto para diferentes escopos:

Escopo	Local
Todos os seus projetos	`~/.gemini/GEMINI.md`
Um projeto específico	Seu diretório de trabalho ou qualquer diretório pai até a raiz do projeto (identificada por uma pasta `.git`) ou seu diretório inicial.
Um componente, módulo ou subseção específica de um projeto	Subdiretórios do seu diretório de trabalho.

O sistema de memória do agente é criado carregando arquivos de contexto de vários locais. O contexto de arquivos mais específicos, como os de componentes ou módulos específicos, substitui ou complementa o conteúdo de arquivos de contexto mais gerais, como o arquivo de contexto global em ~/.gemini/GEMINI.md.

Escreva as regras, informações do guia de estilo ou contexto que você quer que o agente use em Markdown e salve o arquivo. Para mais informações, consulte o arquivo de contexto de exemplo no GitHub.

IntelliJ

Esse recurso não é compatível com o Gemini Code Assist para IntelliJ ou outros ambientes de desenvolvimento integrado do JetBrains.

Usar comandos

Para conferir os comandos da CLI do Gemini disponíveis no modo de agente do Gemini Code Assist, digite / no chat do Gemini.

Você pode usar os seguintes comandos da CLI do Gemini no modo agente:

/tools: mostra uma lista de ferramentas disponíveis na sua sessão do modo agente. Os subcomandos incluem:
- desc ou descriptions: mostra descrições detalhadas de cada ferramenta.
- nodesc ou nodescriptions: oculta as descrições das ferramentas e mostra apenas os nomes delas.
/memory: gerencia o contexto instrucional do agente carregado dos arquivos GEMINI.md. Os subcomandos incluem:
- show: mostra o conteúdo completo e concatenado da memória atual carregada de todos os arquivos GEMINI.md disponíveis.
- refresh: recarrega a memória de todos os arquivos GEMINI.md nos locais disponíveis. Para saber como os arquivos GEMINI.md contribuem para a memória hierárquica do agente, consulte a documentação de configuração da CLI Gemini.
/mcp: lista os servidores de protocolo de contexto de modelo (MCP) configurados, o status da conexão, os detalhes do servidor e as ferramentas disponíveis. Os subcomandos incluem o seguinte:
- desc ou descriptions: mostra descrições detalhadas de servidores e ferramentas do MCP.
- nodesc ou nodescriptions: oculta as descrições do servidor MCP e mostra apenas os nomes.
- schema: mostra o esquema JSON completo dos parâmetros configurados do servidor MCP.
/stats: mostra estatísticas e a duração detalhadas da sessão no modo agente.

Para mais informações sobre os comandos da CLI Gemini, consulte Comandos da CLI Gemini. Nem todos os comandos da CLI do Gemini estão disponíveis no modo de agente.

Modo Yolo

Você pode usar o modo YOLO para permitir automaticamente todas as ações do agente.

Para configurar o modo YOLO:

Abra o arquivo JSON de configurações do usuário do VS Code:
1. Abra a paleta de comandos (ctrl/command + Shift + P).
2. Selecione Preferências: abrir configurações do usuário (JSON).

Adicione o seguinte ao arquivo JSON de configurações do usuário do VS Code:

//other settings...

"geminicodeassist.agentYoloMode": "true",
//other settings...

Abra a paleta de comandos e selecione Desenvolvedor: recarregar janela.

O modo agente usa o modo yolo e não pede permissão antes de realizar ações quando você envia um comando.

Outros comandos

Teste os comandos a seguir com suas próprias informações:

"O que esse repositório faz? Me ajude a entender a arquitetura."
"O que essa [classe/função] faz?"
"Adicione um recurso a esta base de código: [link ou caminho para a base de código]."
"Refatore as funções [A] e [B] para usar o método comum [C]."
"Corrija o problema do GitHub [link-to-github-issue]".
"Crie um aplicativo para [objetivo] com uma UI que permita ao usuário [tarefa] no [ambiente]."
"Migre as versões da biblioteca neste repositório de [X] para [Y]".
"Otimize a performance deste código Go para que ele seja executado mais rápido."
"Use [nome da API] para criar esse recurso."
"Implemente um algoritmo para fazer [x], [Y] e [Z]."

A seguir

Leia a visão geral do Gemini Code Assist.
Confira alguns exemplos de servidores MCP.
Encontre mais servidores MCP no GitHub.
Envie feedback da sua IDE.

Usar o chat autônomo como um programador em dupla Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Como o modo de agente funciona

Contexto do modo agêntico

Memória do modo agêntico

Extensões da CLI do Gemini

Limitações

Antes de começar

Usar o modo agente

VS Code

IntelliJ

Configurar ferramentas para o modo de agente

Configurar servidores MCP

VS Code

IntelliJ

Autenticação do servidor MCP

Criar um arquivo de contexto

VS Code

IntelliJ

Usar comandos

Modo Yolo

Outros comandos

A seguir

Usar o chat autônomo como um programador em dupla