Esta página foi traduzida pela API Cloud Translation.

Use o chat com agentes como programador em pares

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

Com o modo de agente, pode fazer qualquer uma das seguintes ações e muito mais:

Fazer perguntas sobre o seu código.
Use contexto e ferramentas integradas para melhorar o conteúdo gerado.
Configure servidores MCP para expandir as capacidades do agente.
Receba soluções para tarefas complexas com vários passos.
Gerar código a partir de documentos de design, problemas e TODO comentários.
Controle o comportamento do agente comentando, editando e aprovando planos e a utilização de ferramentas durante a execução.

Limitações

Algumas funcionalidades do chat padrão do Gemini Code Assist podem não estar disponíveis no modo de agente ou podem funcionar de forma diferente do que no chat padrão.

A recitação não está disponível no modo de agente. No modo de agente, o Gemini não cita fontes e não pode desativar as sugestões de código que correspondem a fontes citadas.

Antes de começar

VS Code

Configure o Gemini Code Assist.

IntelliJ

Configure o Gemini Code Assist.

Use o modo agente

No modo de agente, pode pedir ao Gemini para concluir objetivos de alto nível e tarefas complexas.

Para tirar o máximo partido do modo de agente, siga as práticas recomendadas para a criação 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, na barra de atividade do IDE, clique em spark Gemini Code Assist.
Clique no botão ativar/desativar Agente para entrar no modo de agente. O botão para ativar/desativar está realçado quando está no modo de agente e cinzento quando está no chat normal.
No chat do Gemini Code Assist, introduza o seu comando.

O Gemini dá-lhe uma resposta ao seu comando ou pede autorização para usar uma ferramenta.

Para parar 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

Clique em spark Gemini na barra da janela de ferramentas. Inicie sessão se lhe for pedido.
Selecione o separador Agente.
Descreva a tarefa que quer que o agente execute.
À medida que o agente segue os passos para concluir a tarefa, tem a opção de rever e aprovar as alterações.
Opcional: para aprovar automaticamente as alterações, selecione definições Opções do agente e clique na caixa de verificação junto a Aprovar automaticamente as alterações.

Aviso: o agente tem acesso ao sistema de ficheiros e às ações do terminal da sua máquina, bem como a todas as ferramentas que configurou para utilização. Tenha muito cuidado onde e quando aprova automaticamente as alterações.

Configure ferramentas para o modo de agente

As ferramentas são uma categoria ampla de serviços que um agente pode usar para contexto e ações na respetiva resposta ao seu comando. Algumas ferramentas de exemplo são ferramentas incorporadas, como grep e leitura ou escrita de ficheiros, servidores de protocolo de contexto do modelo (MCP) locais ou remotos e as respetivas funções executáveis, ou implementações de serviços personalizadas.

Controle a utilização de ferramentas integradas

O modo de agente tem acesso às suas ferramentas incorporadas, como a pesquisa de ficheiros, a leitura de ficheiros, a escrita de ficheiros, os comandos de terminal e muito mais.

VS Code

Pode usar as definições coreTools e excludeTools para controlar as ferramentas às quais o Gemini tem acesso no modo de agente.

coreTools: Permite-lhe especificar uma lista de ferramentas que quer que estejam disponíveis para o modelo. Também pode especificar restrições específicas de comandos para ferramentas que o suportem. Por exemplo, se adicionar o seguinte ao JSON das definições do Gemini, só vai permitir que o comando ls -l shell seja executado:"coreTools": ["ShellTool(ls -l)"].
excludeTools: Permite-lhe especificar uma lista de ferramentas que não quer que estejam disponíveis para o modelo. Também pode especificar restrições específicas de comandos para ferramentas que o suportem. Por exemplo, adicionar o seguinte ao JSON das definições do Gemini bloqueia a utilização do comando rm -rf: "excludeTools": ["ShellTool(rm -rf)"].

Uma ferramenta listada em excludeTools e coreTools é excluída.

Para configurar as ferramentas incorporadas disponíveis no modo de agente, faça o seguinte:

Abra o JSON das definições do Gemini localizado em ~/.gemini/settings.json, onde ~ é o seu diretório principal.
Para restringir a utilização de ferramentas do agente a uma lista de ferramentas aprovadas, adicione a seguinte linha ao JSON das definições do Gemini:
```
"coreTools": ["TOOL_NAME_1,TOOL_NAME_2"]
```
Substitua TOOL_NAME_1 e TOOL_NAME_2 pelos nomes das ferramentas incorporadas às quais quer que o agente tenha acesso.

Pode indicar todas as ferramentas integradas que quiser. Por predefinição, todas as ferramentas incorporadas estão disponíveis para o agente.
Para restringir a utilização de ferramentas de agente a comandos de ferramentas específicos, adicione a linha seguinte ao JSON das definições do Gemini:
```
"coreTools": ["TOOL_NAME(COMMAND)"]
```
Substitua o seguinte:
- TOOL_NAME: o nome da ferramenta integrada
- COMMAND: o nome do comando da ferramenta incorporada que quer que o agente possa usar.
Para excluir uma ferramenta da utilização do agente, adicione a seguinte linha ao JSON das definições do Gemini:
```
"excludeTools": ["TOOL_NAME_1,TOOL_NAME_2"]
```
Substitua TOOL_NAME_1 e TOOL_NAME_2 pelos nomes das ferramentas incorporadas que quer excluir da utilização do agente.
Para excluir um comando de ferramenta da utilização do agente, adicione a seguinte linha ao JSON das definições do Gemini:
```
"excludeTools": ["TOOL_NAME(COMMAND)"]
```
Substitua o seguinte:
- TOOL_NAME: o nome da ferramenta integrada
- COMMAND: o nome do comando da ferramenta integrada que quer excluir da utilização do agente.

Para mais informações sobre as definições de configuração coreTools e excludeTools, consulte a documentação de configuração da CLI Gemini.

IntelliJ

Esta funcionalidade não é suportada no Gemini Code Assist para IntelliJ nem noutros IDEs da JetBrains.

Configure servidores MCP

VS Code

Para disponibilizar os servidores MCP para utilização no modo de agente, adicione a configuração de cada servidor no ficheiro JSON das definições do Gemini, de acordo com a documentação de cada servidor.

Instale todas as dependências necessárias pelos servidores MCP que está a adicionar.
Abra o ficheiro JSON das definições do Gemini, localizado em ~/.gemini/settings.json, onde ~ é o seu diretório principal.

Configure cada servidor MCP local ou remoto no ficheiro JSON das definições do Gemini, de acordo com as instruções de cada servidor.

O ficheiro JSON de definições do Gemini de exemplo seguinte configura dois servidores MCP do Cloudflare remotos, um servidor MCP do GitLab remoto e um servidor MCP do GitHub local para utilização com o Gemini Code Assist no VS Code.

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_example_personal_access_token12345"
      }
    },
    "gitlab": {
      "command": "npx",
      "args": ["mcp-remote", "https://your-gitlab-instance.com/api/v4/mcp"]
    },
    "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 Developer: Reload Window (Programador: recarregar janela).

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

IntelliJ

Para disponibilizar os servidores MCP para utilização no modo de agente, adicione a configuração de cada servidor num ficheiro mcp.json e coloque o ficheiro mcp.json no diretório de configuração do seu IDE.

Instale todas as dependências necessárias pelos servidores MCP que está a adicionar.
Crie um ficheiro denominado mcp.json no diretório de configuração do IDE.

Configure cada servidor MCP local ou remoto no ficheiro mcp.json, de acordo com as instruções de cada servidor.

O ficheiro de configuração do exemplo seguinte configura dois servidores MCP do Cloudflare remotos, um servidor MCP do GitLab remoto e um servidor MCP do GitHub local para utilização com o Gemini Code Assist no IntelliJ.mcp.json

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_example_personal_access_token12345"
      }
    },
    "gitlab": {
      "command": "npx",
      "args": ["mcp-remote", "https://your-gitlab-instance.com/api/v4/mcp"]
    },
    "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"]
    }
  }
}

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

Autenticação do servidor MCP

Alguns servidores MCP requerem autenticação. Siga a documentação do servidor para criar todos os tokens de utilizador necessários e, em seguida, especifique-os adequadamente. Normalmente, especifica tokens de autenticação para servidores locais através da variável de ambiente específica do servidor adequada e especifica tokens de autenticação para servidores remotos através do cabeçalho HTTP Authorization.

VS Code

Para servidores de MCP que requerem autenticação, pode adicioná-los ao seu JSON de definições do Gemini.

O exemplo seguinte mostra como especificar um token de acesso pessoal para os servidores MCP locais e remotos do GitHub:

{
  "mcpServers": {
    "github-remote": {
      "httpUrl": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer ACCESS_TOKEN"
      }
    },
    "github-local": {
      "command": "/Users/username/code/github-mcp-server/cmd/github-mcp-server/github-mcp-server",
      "args": ["stdio"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ACCESS_TOKEN"
      }
    }
  }
}

Em que ACCESS_TOKEN é o token de acesso do utilizador.

IntelliJ

Para servidores MCP que requerem autenticação, pode adicioná-los ao ficheiro mcp.json.

O exemplo seguinte adiciona um token de acesso pessoal para o servidor local do GitHub:

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

Em que ACCESS_TOKEN é o token de acesso do utilizador.

Crie um ficheiro de contexto

O contexto permite que um agente gere melhores respostas para um determinado comando. O contexto pode ser retirado de ficheiros no seu IDE, ficheiros nas pastas do sistema local, respostas de ferramentas e detalhes do comando. Para mais informações, consulte o artigo Contexto do modo de agente.

VS Code

Crie um ficheiro com o nome GEMINI.md numa localização que corresponda ao âmbito ao qual quer que o contexto se aplique. A tabela seguinte detalha as localizações dos ficheiros de contexto para diferentes âmbitos:

Âmbito	Location
Todos os seus projetos	`~/.gemini/GEMINI.md`
Um projeto específico	O seu diretório de trabalho ou quaisquer diretórios principais até à raiz do projeto (identificada por uma pasta `.git`) ou ao seu diretório inicial.
Um componente, um módulo ou uma subsecção específicos de um projeto	Subdiretórios do seu diretório de trabalho.

O sistema de memória do agente é criado através do carregamento de ficheiros de contexto de várias localizações. O contexto de ficheiros mais específicos, como os de componentes ou módulos específicos, substitui ou complementa o conteúdo de ficheiros de contexto mais gerais, como o ficheiro de contexto global em ~/.gemini/GEMINI.md.

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

O agente inclui as informações no seu ficheiro de contexto juntamente com quaisquer comandos que lhe enviar.

IntelliJ

Crie um ficheiro com o nome GEMINI.md ou AGENT.md na raiz do seu projeto.
Escreva todas as regras, informações do guia de estilo ou contexto que quer que o agente use em Markdown e guarde o ficheiro.

O agente inclui as informações no seu ficheiro de contexto juntamente com quaisquer comandos que lhe enviar. Também pode adicionar contexto incluindo um ficheiro manualmente com a sintaxe @FILENAME, em que FILENAME é o nome do ficheiro com as informações contextuais que quer incluir.

Use comandos

Os comandos com barra / permitem-lhe executar rapidamente comandos semelhantes aos comandos numa janela de terminal.

VS Code

Pode usar os seguintes comandos da Gemini CLI incorporados no modo de agente:

/tools: apresenta uma lista de ferramentas disponíveis na sua sessão do modo de agente.
/mcp: lista os servidores do protocolo Model Context Protocol (MCP) configurados, o respetivo estado de ligação, os detalhes do servidor e as ferramentas disponíveis.

/deploy: Implementa uma aplicação Web no Cloud Run. Este comando personalizado baseado na CLI Gemini usa o servidor do protocolo de contexto do modelo (MCP) do Cloud Run para criar, colocar em contentores, enviar, configurar e devolver um URL público para a sua aplicação. Tem de ter o Cloud Run ativado no seu Google Cloud projeto e instalar o servidor MCP do Cloud Run como uma extensão do Gemini para usar este comando.

Para mais informações sobre os comandos da CLI do Gemini, consulte os artigos Comandos da CLI do Gemini e Comandos personalizados do Gemini. Tenha em atenção que nem todos os comandos da CLI do Gemini estão disponíveis no modo de agente.

IntelliJ

Esta funcionalidade não é suportada no Gemini Code Assist para IntelliJ nem noutros IDEs da JetBrains.

Permitir sempre ações do agente

Pode permitir automaticamente todas as ações do agente.

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

VS Code

Use o modo YOLO para permitir automaticamente todas as ações do agente. O modo Yolo só pode ser usado num espaço de trabalho fidedigno.

Para configurar o modo YOLO:

Abra o ficheiro JSON de definições do utilizador do VS Code:
1. Abra a paleta de comandos (ctrl/command + Shift + P).
2. Selecione Preferências: abrir definições do utilizador (JSON).

Adicione o seguinte ao ficheiro JSON de definições do utilizador do VS Code:

//other settings...

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

Abra a paleta de comandos e selecione Developer: Reload Window (Programador: recarregar janela).

O modo de agente usa o modo YOLO e não pede autorização antes de realizar ações quando lhe envia um comando. Quando usa um espaço de trabalho restrito, o agente pede confirmação antes de tomar medidas, independentemente desta definição.

IntelliJ

Para aprovar automaticamente as alterações, no separador do agente do Gemini Chat, selecione definições Opções do agente e, de seguida, clique na caixa de verificação junto a Aprovar automaticamente alterações.

O modo de agente aprova automaticamente todos os pedidos e não pede autorização antes de realizar ações quando lhe envia um comando.

Comandos adicionais

Experimente os seguintes comandos com as suas próprias informações:

"O que faz este repositório? Ajuda-me a compreender a arquitetura."
"O que faz esta [classe/função]?"
"Adiciona uma funcionalidade a esta base de código: "[link-or-path-to-codebase]"."
"Refatora as funções [A] e [B] para usar o método comum [C]."
"Fix the GitHub issue [link-to-github-issue]." (Corrigir o problema do GitHub [link-to-github-issue].)
"Cria uma aplicação para fazer [objetivo] com uma IU que permita ao utilizador fazer [tarefa] no [ambiente]."
"Migrate library versions in this repository from [X] to [Y]." (Migra as versões da biblioteca neste repositório de [X] para [Y].)
"Otimiza o desempenho deste código Go para que seja executado mais rapidamente."
"Use [name-of-API] para desenvolver esta funcionalidade."
"Implementa um algoritmo para fazer [x], [Y] e [Z]."

O que se segue?

Leia a vista geral do Gemini Code Assist.
Explore alguns servidores MCP de exemplo.
Encontre mais servidores MCP no GitHub.
Envie feedback a partir do seu IDE.

Use o chat com agentes como programador em pares 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

VS Code

IntelliJ

Use o modo agente

VS Code

IntelliJ

Configure ferramentas para o modo de agente

Controle a utilização de ferramentas integradas

VS Code

IntelliJ

Configure servidores MCP

VS Code

IntelliJ

Autenticação do servidor MCP

VS Code

IntelliJ

Crie um ficheiro de contexto

VS Code

IntelliJ

Use comandos

VS Code

IntelliJ

Permitir sempre ações do agente

VS Code

IntelliJ

Comandos adicionais

O que se segue?

Use o chat com agentes como programador em pares