Se usó la API de Cloud Translation para traducir esta página.

Usar el chat con agente como programador par

En este documento, se describe cómo configurar y usar el modo de agente de Gemini Code Assist como programador en pareja en tu entorno de desarrollo integrado (IDE).

Con el modo de agente, puedes hacer lo siguiente y mucho más:

Haz preguntas sobre tu código.
Usa el contexto y las herramientas integradas para mejorar el contenido generado.
Configura servidores de MCP para extender las capacidades del agente.
Obtén soluciones para tareas complejas con varios pasos.
Genera código a partir de documentos de diseño, problemas y comentarios de TODO.
Controla el comportamiento del agente comentando, editando y aprobando planes y el uso de herramientas durante la ejecución.

Limitaciones

Es posible que algunas funciones del chat estándar de Gemini Code Assist no estén disponibles en el modo de agente o que funcionen de manera diferente a como lo hacen en el chat estándar.

La recitación no está disponible en el modo agente. En el modo de agente, Gemini no cita fuentes y no puedes inhabilitar las sugerencias de código que coinciden con las fuentes citadas.

Antes de comenzar

VS Code

Configura Gemini Code Assist.

IntelliJ

Configura Gemini Code Assist.

Cómo usar el modo de agente

En el modo de agente, puedes pedirle a Gemini que complete objetivos de alto nivel y tareas complejas.

Para aprovechar al máximo el modo de agente, sigue las prácticas recomendadas para la creación de instrucciones y proporciona la mayor cantidad de detalles posible.

Para cambiar al modo de agente, haz lo siguiente:

VS Code

Para abrir el chat de Gemini Code Assist, en la barra de actividad de tu IDE, haz clic en spark Gemini Code Assist.
Haz clic en el botón de activación Agente para ingresar al modo de agente. El botón de activación se destaca cuando se cambia al modo de agente y se muestra en gris cuando se usa el chat normal.
En el chat de Gemini Code Assist, ingresa tu instrucción.

Gemini te da una respuesta a tu instrucción o solicita permiso para usar una herramienta.

Para detener el agente, haz clic en Detener.

Para usar el chat estándar de Gemini Code Assist, haz clic en Nuevo chat para crear un chat nuevo.

El modo de agente de Gemini Code Assist se basa en la CLI de Gemini.

IntelliJ

Haz clic en spark Gemini en la barra de la ventana de herramientas. Accede a tu cuenta si se te solicita.
Selecciona la pestaña Agente.
Describe la tarea que quieres que realice el agente.
A medida que el agente siga los pasos para completar la tarea, tendrás la opción de revisar y aprobar los cambios.
Opcional: Para aprobar los cambios automáticamente, selecciona Configuración Opciones del agente y haz clic en la casilla de verificación junto a Aprobar cambios automáticamente.

Precaución: El agente tiene acceso al sistema de archivos y a las acciones de la terminal de tu máquina, así como a cualquier herramienta que hayas configurado para usar. Ten mucho cuidado con dónde y cuándo apruebas los cambios automáticamente.

Configura herramientas para el modo de agente

Las herramientas son una amplia categoría de servicios que un agente puede usar para obtener contexto y realizar acciones en su respuesta a tu instrucción. Algunas herramientas de ejemplo son las integradas, como grep y la lectura o escritura de archivos, los servidores locales o remotos de Model Context Protocol (MCP) y sus funciones ejecutables, o las implementaciones de servicios personalizadas.

Controla el uso de herramientas integradas

El modo de agente tiene acceso a tus herramientas integradas, como búsqueda de archivos, lectura de archivos, escritura de archivos, comandos de terminal y mucho más.

VS Code

Puedes usar la configuración de coreTools y excludeTools para controlar a qué herramientas tiene acceso Gemini en el modo de agente.

coreTools: Te permite especificar una lista de herramientas que deseas que estén disponibles para el modelo. También puedes especificar restricciones específicas para los comandos de las herramientas que lo admiten. Por ejemplo, si agregas lo siguiente a la configuración de Gemini en formato JSON, solo se permitirá la ejecución del comando de shell ls -l:"coreTools": ["ShellTool(ls -l)"].
excludeTools: Te permite especificar una lista de herramientas que no quieres que estén disponibles para el modelo. También puedes especificar restricciones específicas para los comandos de las herramientas que lo admiten. Por ejemplo, si agregas lo siguiente a la configuración de Gemini en formato JSON, se bloqueará el uso del comando rm -rf: "excludeTools": ["ShellTool(rm -rf)"].

Se excluye una herramienta que aparece en excludeTools y coreTools.

Para configurar las herramientas integradas disponibles en el modo de agente, haz lo siguiente:

Abre la configuración de Gemini en formato JSON ubicada en ~/.gemini/settings.json, donde ~ es tu directorio principal.
Para restringir el uso de herramientas del agente a una lista de herramientas aprobadas, agrega la siguiente línea al JSON de la configuración de Gemini:
```
"coreTools": ["TOOL_NAME_1,TOOL_NAME_2"]
```
Reemplaza TOOL_NAME_1 y TOOL_NAME_2 por los nombres de las herramientas integradas a las que deseas que tenga acceso el agente.

Puedes enumerar todas las herramientas integradas que quieras. De forma predeterminada, todas las herramientas integradas están disponibles para el agente.
Para restringir el uso de herramientas del agente a comandos de herramientas específicos, agrega la siguiente línea a la configuración de Gemini en formato JSON:
```
"coreTools": ["TOOL_NAME(COMMAND)"]
```
Reemplaza lo siguiente:
- TOOL_NAME: el nombre de la herramienta integrada
- COMMAND: Es el nombre del comando de herramienta integrado que deseas que el agente pueda usar.
Para excluir una herramienta del uso del agente, agrega la siguiente línea a la configuración de Gemini en formato JSON:
```
"excludeTools": ["TOOL_NAME_1,TOOL_NAME_2"]
```
Reemplaza TOOL_NAME_1 y TOOL_NAME_2 por los nombres de las herramientas integradas que deseas excluir del uso del agente.
Para excluir un comando de herramienta del uso del agente, agrega la siguiente línea a la configuración de Gemini en formato JSON:
```
"excludeTools": ["TOOL_NAME(COMMAND)"]
```
Reemplaza lo siguiente:
- TOOL_NAME: el nombre de la herramienta integrada
- COMMAND: Es el nombre del comando de herramienta integrado que deseas excluir del uso del agente.

Para obtener más información sobre la configuración de coreTools y excludeTools, consulta la documentación de configuración de la CLI de Gemini.

IntelliJ

Esta función no es compatible con Gemini Code Assist para IntelliJ ni otros IDE de JetBrains.

Configura servidores de MCP

VS Code

Para controlar qué servidores están disponibles en el modo de agente, agrégalos a la configuración de Gemini en formato JSON según la documentación del servidor.

Instala las dependencias que requiera tu servidor de MCP.
Abre la configuración de Gemini en formato JSON ubicada en ~/.gemini/settings.json, donde ~ es tu directorio principal.

Agrega servidores de MCP locales o remotos a la configuración de Gemini en formato JSON según las instrucciones del servidor.

En el siguiente ejemplo, se agrega el servidor MCP remoto de Cloudflare y se instalan los servidores de GitHub y GitLab en la 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"]
        }
    }
}

Abre la paleta de comandos y selecciona Developer: Reload Window.

Los servidores de MCP que configuraste están disponibles para que el agente los use en el modo de agente.

IntelliJ

Para controlar qué servidores están disponibles en el modo de agente, agrégalos a un archivo mcp.json y colócalo en el directorio de configuración de tu IDE.

Instala las dependencias que requiera tu servidor de MCP.
Crea un archivo mcp.json en el directorio de configuración de tu IDE.

Agrega servidores de MCP locales o remotos a la configuración de Gemini en formato JSON según las instrucciones del servidor.

En el siguiente ejemplo, se agrega el servidor MCP remoto de Cloudflare y se instalan los servidores de GitHub y GitLab en la 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"]
        }
    }
}

Los servidores de MCP que configuraste están disponibles para que el agente los use en el modo de agente.

Autenticación del servidor de MCP

Algunos servidores de MCP requieren autenticación. Sigue la documentación del servidor para crear los tokens de usuario necesarios.

VS Code

En el caso de los servidores de MCP que requieren autenticación, puedes agregarlos a la configuración de Gemini en formato JSON.

En el siguiente ejemplo, se agrega un token de acceso personal para 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...
}

Aquí ACCESS_TOKEN es el token de acceso del usuario.

IntelliJ

En el caso de los servidores de MCP que requieren autenticación, puedes agregarlos a tu archivo mcp.json.

En el siguiente ejemplo, se agrega un token de acceso personal para 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...
}

Aquí ACCESS_TOKEN es el token de acceso del usuario.

Crea un archivo de contexto

El contexto permite que un agente genere mejores respuestas para una instrucción determinada. El contexto se puede obtener de los archivos de tu IDE, los archivos de las carpetas del sistema local, las respuestas de las herramientas y los detalles de tu instrucción. Para obtener más información, consulta Contexto del modo de agente.

VS Code

Crea un archivo llamado GEMINI.md en una ubicación que coincida con el alcance al que deseas que se aplique el contexto. En la siguiente tabla, se detallan las ubicaciones de los archivos de contexto para diferentes alcances:

Alcance	Ubicación
Todos tus proyectos	`~/.gemini/GEMINI.md`
Un proyecto específico	Tu directorio de trabajo o cualquier directorio principal hasta la raíz de tu proyecto (identificado por una carpeta `.git`) o tu directorio principal
Un componente, módulo o subsección específico de un proyecto	Subdirectorios de tu directorio de trabajo

El sistema de memoria del agente se crea cargando archivos de contexto desde varias ubicaciones. El contexto de los archivos más específicos, como los de componentes o módulos específicos, anula o complementa el contenido de los archivos de contexto más generales, como el archivo de contexto global en ~/.gemini/GEMINI.md.

Escribe las reglas, la información de la guía de estilo o el contexto que quieras que use el agente en Markdown y guarda el archivo. Para obtener más información, consulta el archivo de contexto de ejemplo en GitHub.

El agente incluye la información de tu archivo de contexto junto con las instrucciones que le envías.

IntelliJ

Crea un archivo llamado GEMINI.md o AGENT.md en la raíz de tu proyecto.
Escribe las reglas, la información de la guía de estilo o el contexto que quieras que use el agente en Markdown y guarda el archivo.

El agente incluye la información de tu archivo de contexto junto con las instrucciones que le envías. También puedes agregar contexto incluyendo un archivo de forma manual con la sintaxis @FILENAME, en la que FILENAME es el nombre del archivo con la información contextual que deseas incluir.

Cómo usar comandos

Los comandos de barra / te permiten ejecutar rápidamente comandos similares a los de una ventana de terminal.

VS Code

Puedes usar los siguientes comandos de Gemini CLI en el modo de agente:

/tools: Muestra una lista de las herramientas disponibles en la sesión del modo de agente.
/mcp: Enumera los servidores del Protocolo de contexto del modelo (MCP) configurados, su estado de conexión, los detalles del servidor y las herramientas disponibles.

Para obtener más información sobre los comandos de Gemini CLI, consulta Comandos de Gemini CLI. Ten en cuenta que no todos los comandos de la CLI de Gemini están disponibles en el modo de agente.

IntelliJ

Esta función no es compatible con Gemini Code Assist para IntelliJ ni otros IDE de JetBrains.

Permitir siempre las acciones del agente

Puedes permitir automáticamente todas las acciones del agente.

Para permitir automáticamente todas las acciones del agente, sigue estos pasos:

VS Code

Usa el modo YOLO para permitir automáticamente todas las acciones del agente. Para configurar el modo Yolo, haz lo siguiente:

Abre el archivo JSON de configuración del usuario de VS Code:
1. Abre la paleta de comandos (ctrl/command + Shift + P).
2. Selecciona Preferences: Open User Settings (JSON).

Agrega lo siguiente a tu archivo JSON de configuración del usuario de VS Code:

//other settings...

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

Abre la paleta de comandos y selecciona Developer: Reload Window.

El modo Agente usa el modo YOLO y no te pedirá permiso antes de realizar acciones cuando le envíes una instrucción. Cuando se usa un espacio de trabajo restringido, el agente mostrará un mensaje antes de realizar acciones, independientemente de este parámetro de configuración.

IntelliJ

Para aprobar los cambios automáticamente, en la pestaña del agente de Gemini Chat, selecciona Configuración Opciones del agente y, luego, haz clic en la casilla de verificación junto a Aprobar cambios automáticamente.

El modo de agente aprueba automáticamente todas las solicitudes y no pedirá permiso antes de realizar acciones cuando le envíes una instrucción.

Instrucciones adicionales

Prueba las siguientes instrucciones con tu propia información:

"¿Qué hace este repositorio? Ayúdame a comprender la arquitectura".
"¿Qué hace esta [clase/función]?"
"Agrega una función a esta base de código: "[vínculo-o-ruta-a-base-de-código]"".
"Refactoriza las funciones [A] y [B] para que usen el método común [C]".
"Corrige el problema de GitHub [vínculo al problema de GitHub]".
"Crea una aplicación para [objetivo] con una IU que le permita al usuario [tarea] en el [entorno]".
"Migra las versiones de la biblioteca en este repositorio de [X] a [Y]".
"Optimiza el rendimiento de este código de Go para que se ejecute más rápido".
"Usa [nombre de la API] para desarrollar esta función".
"Implementa un algoritmo para hacer [X], [Y] y [Z]".

¿Qué sigue?

Lee la descripción general de Gemini Code Assist.
Explora algunos servidores de MCP de ejemplo.
Encuentra más servidores de MCP en GitHub.
Envía comentarios desde tu IDE.

Usar el chat con agente como programador par Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Limitaciones

Antes de comenzar

VS Code

IntelliJ

Cómo usar el modo de agente

VS Code

IntelliJ

Configura herramientas para el modo de agente

Controla el uso de herramientas integradas

VS Code

IntelliJ

Configura servidores de MCP

VS Code

IntelliJ

Autenticación del servidor de MCP

VS Code

IntelliJ

Crea un archivo de contexto

VS Code

IntelliJ

Cómo usar comandos

VS Code

IntelliJ

Permitir siempre las acciones del agente

VS Code

IntelliJ

Instrucciones adicionales

¿Qué sigue?

Usar el chat con agente como programador par