Neste documento, descrevemos o modo agente no Gemini Code Assist.
O modo agente está disponível nos ambientes de desenvolvimento integrado (IDEs) do VS Code e do IntelliJ. Para começar a usar o modo agente, consulte Usar o chat agêntico como um parceiro de programação.
O modo agente no VS Code é alimentado pela CLI do Gemini.
O modo agente no IntelliJ não usa a CLI do Gemini.
Com o modo agente, você pode fazer o seguinte e muito mais:
- Faça perguntas sobre o código.
- Use o contexto e as 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.
- Gere 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.
Como o modo 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 ela pode ser utilizada com ou sem permissão explícita:
- Para solicitações de ferramentas que modificam o sistema de arquivos ou realizam operações de mutação em recursos, o Gemini vai pedir sua permissão, exceto se você tiver configurado para sempre permitir as ferramentas.
- As solicitações de ferramentas somente leitura podem não pedir permissão antes de concluir a tarefa.
Quando sua autorização for solicitada para o uso de uma ferramenta, é possível permitir ou negar a operação. O agente também pode oferecer opções para sempre permitir uma ferramenta, servidor ou operações semelhantes. Para mais informações, consulte Sempre permitir ações do agente.
Depois que a permissão para usar a ferramenta é concedida ou autoatribuída, o agente usa a ferramenta para concluir a ação necessária, e o resultado dessa ação é 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 geral para sua aprovação. Você pode ajustar o plano e fazer perguntas no chat antes de começar o processo, e quando ele estiver pronto, você poderá aprová-lo. Depois da sua aprovação, o agente vai começar a trabalhar na primeira tarefa e pedir esclarecimentos ou permissões conforme necessário durante a execução.
Contexto do modo agente
O contexto permite que um agente gere respostas melhores para um determinado comando. Ele 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 IDE e das configurações, é possível que haja diferentes contextos disponíveis para o agente.
As guias a seguir detalham como o contexto é coletado para diferentes IDEs.
VS Code
Os seguintes métodos 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 no Markdown.
Memória do agente
O modo agente do Gemini Code Assist no VS Code 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 esses arquivos de maneira hierárquica, começando pelo diretório de trabalho atual e subindo até a raiz do projeto, diretório inicial e subdiretórios.
É possível criar arquivos de contexto globais, no projeto e no componente, que são combinados para fornecer ao modelo as informações mais relevantes.
Use 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.
IntelliJ
Os seguintes métodos de contexto geralmente estão disponíveis para o Gemini Code Assist no modo de agente:
- Informações no projeto do ambiente de desenvolvimento integrado, incluindo arquivos, símbolos indexados e uso de símbolos no projeto.
- Respostas de ferramentas integradas, como grep, leitura ou gravação de arquivos.
- Controle de versões do IntelliJ.
- Servidores e ferramentas MCP configurados
- Arquivos de contexto criados no Markdown.
É possível conferir o contexto disponível para o agente no painel de contexto na área de comando do chat do modo agente.
Ferramentas
Ferramentas são uma categoria ampla de serviços que um agente pode usar para contexto e ações na resposta ao seu comando. Com as ferramentas, os agentes podem acessar informações atualizadas usando chamadas de função para endpoints de API ou outros agentes. As ferramentas podem oferecer apenas uma função ou várias funções relacionadas.
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, além de chamadas de API RESTful.
Ferramentas integradas
No modo agente, o Gemini tem acesso às ferramentas integradas do sistema. Selecione seu ambiente de desenvolvimento integrado para conferir uma lista de ferramentas integradas disponíveis para o Gemini no modo agente.
VS Code
Todas as ferramentas integradas da CLI do Gemini estão disponíveis para o modo agente no Gemini Code Assist.
IntelliJ
read_file- Recupera o conteúdo de texto de um arquivo usando o caminho absoluto dele.
write_file- Grava o texto especificado em um arquivo especificado, criando o arquivo se ele não existir.
analyze_current_file- Analisa o arquivo aberto no editor para encontrar erros e avisos.
find_files- Encontra o caminho absoluto para arquivos com base em um nome de arquivo ou parte do caminho.
grep- Encontra todos os arquivos dentro do projeto que contêm um determinado padrão de texto ou expressão regular.
list_files- Lista todos os arquivos e diretórios em um determinado caminho absoluto.
resolve_symbol- Resolve uma referência de símbolo específica para a declaração original.
find_usages- Pesquisa no projeto todas as referências a uma determinada declaração de símbolo.
git- Executa um comando da interface de linha de comando (CLI) do Git e retorna o resultado.
list_vcs_roots- Retorna todas as raízes do sistema de controle de versões (VCS, na sigla em inglês), como repositórios Git, no projeto atual.
Limitações
Alguns recursos do chat padrão do Gemini Code Assist podem não estar disponíveis no modo agente ou funcionar de maneira diferente do que no chat padrão.
A recitação não está disponível no modo agente. No modo agente, o Gemini não cita fontes, e não é possível desativar as sugestões de código que correspondem às fontes citadas.