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 IDE do VS Code.

Com o modo agente, você pode fazer o seguinte e muito mais:

Faça perguntas sobre o código.
Use contexto e ferramentas integradas 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 com base em 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.

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.
Os registros do Gemini para Google Cloud não são compatíveis com o modo de agente.

Antes de começar

Configure a edição do Gemini Code Assist que você quer usar no seu ambiente de desenvolvimento integrado:
- Gemini Code Assist para pessoas físicas
- Gemini Code Assist Standard ou Enterprise
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 está no modo 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) e as funções executáveis deles 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

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. Para mais informações, consulte Contexto do modo de agente.

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

Com os comandos de barra /, você pode executar rapidamente comandos semelhantes aos de uma janela de terminal.

Você pode usar os seguintes comandos da CLI do Gemini no modo de 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 do 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.

Sempre permitir ações do agente

Você pode permitir automaticamente todas as ações do agente.

Para permitir automaticamente todas as ações do agente:

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.

Criar extensões da CLI do Gemini

É possível usar as extensões da CLI do Gemini para configurar e ampliar a funcionalidade do modo 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.

Outros comandos

Teste os seguintes comandos 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 interface 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.

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

Sempre permitir ações do agente

Criar extensões da CLI do Gemini

Outros comandos

A seguir

Usar o chat autônomo como um programador em dupla