Cómo configurar las herramientas de IA para desarrolladores

Usa la página de configuración de las herramientas para desarrolladores de IA en Gemini Enterprise para configurar las herramientas para desarrolladores, aplicar controles de seguridad y cumplimiento, activar o desactivar las funciones de Google Antigravity y administrar la disponibilidad del modelo para tu organización.

Antes de comenzar

Asegúrate de tener lo siguiente:

  • Cuenta de Facturación de Cloud facturada: Para usar las herramientas para desarrolladores de IA, tu proyecto debe tener habilitada la Facturación de Cloud. Las herramientas de IA para desarrolladores solo están disponibles para las cuentas con facturación. Para obtener más información, consulta Tipos de cuentas de Facturación de Cloud.

  • Ediciones compatibles: Para acceder a las herramientas para desarrolladores basadas en IA, los usuarios deben tener una suscripción a las ediciones Gemini Enterprise Standard, Plus, Standard Emerging Market o pago por uso.

  • Regiones admitidas: Para obtener más información sobre la disponibilidad regional y las limitaciones de las funciones, consulta Residencia de datos para las ediciones Gemini Enterprise Standard y Plus y Gemini Notebook.

  • Roles requeridos: Debes tener el rol de administrador de Gemini Enterprise (roles/discoveryengine.agentspaceAdmin) para configurar los parámetros de configuración de las herramientas para desarrolladores de IA.

  • APIs obligatorias: Tu proyecto debe tener habilitadas las siguientes APIs:

    • API de Discovery Engine (discoveryengine.googleapis.com): Proporciona servicios básicos de plataforma, controles de seguridad y cumplimiento, y administración de la configuración para Gemini Enterprise.

    • API de Business AI Code (businessaicode.googleapis.com): Proporciona generación de código potenciada por IA para Antigravity en Gemini Enterprise. Debes habilitar esta API en tu proyecto para permitir que las principales autorizadas accedan al servicio desde tu proyecto.

    Cuando activas el botón de activación Herramientas para desarrolladores basadas en IA en la consola de Google Cloud , el sistema verifica la configuración de tu proyecto y habilita automáticamente estas APIs requeridas si aún no lo hiciste.

Activa las herramientas para desarrolladores de IA

La disponibilidad de las herramientas para desarrolladores basadas en IA depende del tipo de suscripción a Gemini Enterprise:

  • Suscripciones nuevas a Standard, Plus o pago por uso: Las herramientas para desarrolladores con IA están habilitadas de forma predeterminada en la ubicación donde compraste la suscripción si son compatibles con esa ubicación o región.

  • Suscripciones existentes: Un administrador debe habilitar manualmente las herramientas para desarrolladores de IA en la consola de Google Cloud para cada ubicación y, así, activar las herramientas para los usuarios con licencia.

Para habilitar manualmente las herramientas para desarrolladores de IA en una suscripción existente a Gemini Enterprise, sigue estos pasos:

  1. En la consola de Google Cloud , ve a Gemini Enterprise.

    Ir a Gemini Enterprise

  2. Haz clic en Configuración y selecciona la pestaña Herramientas para desarrolladores de IA.

  3. Activa el botón de activación de las herramientas de IA para desarrolladores.

  4. Configura los parámetros en las secciones Seguridad, Cumplimiento, Funciones y Disponibilidad del modelo.

Establece la configuración de seguridad.

Como administrador, puedes evitar la exposición no autorizada de datos en las interfaces de desarrollador. Usa los parámetros de configuración de esta sección para restringir el acceso a fuentes externas y administrar los permisos de ejecución automatizada. Por ejemplo, puedes aplicar políticas de seguridad obligatorias para evitar que los usuarios anulen las reglas de seguridad y exigir aprobación antes de que los agentes de IA ejecuten comandos de terminal o seleccionen vínculos.

Administra políticas de seguridad

Puedes configurar políticas de seguridad para controlar cómo los agentes de IA acceden a los archivos locales fuera de sus carpetas de trabajo y ejecutan comandos de terminal en los espacios de trabajo de los desarrolladores.

Configuración Descripción Estado predeterminado
Fuera de la política de acceso a archivos Especifica el nivel de permiso del agente para acceder a archivos fuera de sus carpetas de trabajo designadas. Están disponibles las siguientes opciones:
  • Denegar: Impide que el agente acceda a archivos fuera de sus carpetas de trabajo.
  • Preguntar siempre: Solicita permiso al usuario antes de que el agente acceda a archivos fuera de sus carpetas de trabajo.
  • Allow: Permite que el agente acceda a archivos fuera de sus carpetas de trabajo sin solicitar permiso.
 Rechazar
Modo de ejecución automática de la terminal Habilita este parámetro de configuración para permitir que los agentes ejecuten comandos de terminal automáticamente y, de esta manera, optimizar los flujos de trabajo de varios pasos. Están disponibles las siguientes opciones:
  • Require review: Solicita la aprobación del usuario antes de ejecutar cualquier comando de la terminal.
  • Continuar en la zona de pruebas: Ejecuta automáticamente comandos en un entorno seguro y aislado.
  • Continuar siempre: Ejecuta automáticamente los comandos en el entorno actual sin preguntar.
 Continuar siempre
Modo de zona de pruebas Habilita este parámetro de configuración para restringir las herramientas del agente a una zona de pruebas local segura y aislada. Inhabilitado

Administra el acceso web externo

Si tu política de seguridad requiere controlar el acceso del agente a sitios web externos para evitar el robo de datos, estos parámetros de configuración te permiten limitar el acceso del navegador o restringirlo a una lista de URLs permitidas.

Configuración Descripción Estado predeterminado
Acceso del navegador Habilita este parámetro de configuración para controlar el acceso web externo. Esto evita el robo de datos y define los límites de la organización. Inhabilitado
URL permitidas Especifica una lista de URLs permitidas a las que el agente puede acceder en el navegador. Cuando se configura, el sistema bloquea todas las demás URLs.

Este parámetro de configuración solo se aplica al agente del navegador Antigravity. Puedes ejecutar el agente del navegador en Antigravity escribiendo el comando /browser en el campo de chat.

 Ninguno De forma predeterminada, no se bloquea ninguna URL.
Modo de ejecución automática de JavaScript en el navegador Habilita este parámetro de configuración para permitir que los agentes ejecuten JavaScript y admitan tareas avanzadas de programación y pruebas basadas en la Web. Están disponibles las siguientes opciones:
  • Inhabilitado: Evita que el agente ejecute JavaScript.
  • Solicitar revisión: Solicita la aprobación del usuario antes de que el agente ejecute JavaScript.
  • Permitido: Permite que el agente ejecute JavaScript automáticamente.
 Inhabilitado

Administra el Protocolo de contexto del modelo (MCP)

Puedes configurar el acceso a los servidores del Protocolo de contexto del modelo (MCP), lo que permite que los agentes de IA accedan de forma segura a fuentes de datos y herramientas adicionales.

Configuración Descripción Estado predeterminado
Servidores de MCP Habilita este parámetro de configuración para administrar el acceso a los servidores del Protocolo de contexto del modelo (MCP) y ampliar de forma segura el contexto de datos de la IA.

Se requiere MCP para usar IDEs que admitan el Protocolo de cliente de agente (ACP), como Android Studio y los IDEs de JetBrains. En estos entornos, los controles del administrador operan sobre la base del mejor esfuerzo porque los IDE pueden insertar sus propias herramientas de MCP que no están sujetas a la aplicación de políticas.

Inhabilitado
Configuración del servidor permitida Este parámetro de configuración permite que los administradores definan configuraciones específicas del servidor para el acceso al servidor de MCP. Los administradores definen la lista de entidades permitidas como un objeto JSON con parámetros de configuración para servidores de MCP locales y remotos. La IU proporciona validación en tiempo real para los siguientes campos:
  • Servidores MCP locales (local_servers):
    • id (cadena): Es el identificador único del servidor de MCP.
    • command (cadena, opcional): Es el comando para ejecutar el servidor de MCP local. Si se especifica, se anula la configuración local del usuario.
    • args (array de cadenas, opcional): Son los argumentos que se pasan al comando. Si se especifican, estos parámetros anulan la configuración local del usuario.
  • Servidores de MCP remotos (remote_servers):
    • id (cadena): Es el identificador único del servidor de MCP.
    • url (cadena, opcional): Es la URL del extremo del servidor de MCP remoto. Es obligatorio para los servidores remotos personalizados y opcional para los servidores remotos preconfigurados.

Configuración de ejemplo

{
  "mcpServers": {
    "local_servers": [
      {
        "id": "gopls-mcp-server",
        "command": "go",
        "args": [
          "run",
          "golang.org/x/tools/gopls@latest",
          "mcp"
        ]
      }
    ],
    "remote_servers": [
      {
        "id": "bigquery"
      },
      {
        "id": "custom-remote-server",
        "url": "https://mcp.example.com/mcp"
      }
    ]
  }
}
No configurada

Establece la configuración de cumplimiento

Si tu organización opera en una industria regulada o tiene políticas internas específicas, es posible que debas mantener registros de auditoría de las interacciones con la IA para cumplir con las reglamentaciones. La configuración de esta sección te permite configurar las políticas de registro y retención de datos para cumplir con tus requisitos legales y reglamentarios.

Configuración Descripción Estado predeterminado
Registro de instrucciones y respuestas Habilita este parámetro de configuración para registrar las interacciones entre los desarrolladores y la IA, calcular las métricas de uso y mantener un registro de auditoría para las revisiones de seguridad. El sistema almacena los registros de forma segura en el proyecto de tu organización, y Google nunca accede a ellos para entrenamiento de modelos ni realizar revisiones manuales. Inhabilitado
Registro de metadatos Habilita este parámetro de configuración para registrar los metadatos del producto y ayudarte a hacer un seguimiento del uso y las estadísticas en toda tu organización, incluido el consumo de tokens de modelos de terceros. El sistema almacena los registros de forma segura en el proyecto de tu organización y Google nunca accede a ellos para entrenamiento de modelos ni realizar revisiones manuales. Inhabilitado

Establece la configuración de las funciones

Algunas funciones de Antigravity ofrecen capacidades avanzadas de varios agentes para ayudar a los desarrolladores a abordar tareas complejas. Debido a que estas funciones pueden aumentar el uso de tokens y los costos, usa la configuración de esta sección para controlar el acceso de los usuarios de tu organización. Para acceder a las funciones habilitadas, los usuarios deben usar la versión 2.18.0 o posterior de la app de Antigravity, o la versión 1.2.10 o posterior de la CLI de Antigravity.

Para activar o desactivar una función, sigue estos pasos:

  1. En la consola de Google Cloud , ve a Gemini Enterprise.

    Gemini Enterprise

  2. Haz clic en Configuración y selecciona la pestaña Herramientas para desarrolladores de IA.

  3. En la sección Características, haz clic en Editar.

  4. Para cada función, activa o desactiva el botón de activación.

    Configuración Descripción Estado predeterminado
    Comando /boost Habilita este parámetro de configuración para permitir que los usuarios ejecuten una jerarquía multiagente estratificada para resolver desafíos algorítmicos complejos y tareas de depuración profunda. Para obtener más información, consulta Potencia el razonamiento profundo. Habilitado
    Comando /teamwork-preview Habilita este parámetro de configuración para permitir que los usuarios implementen un framework coordinado de subagentes autónomos para ejecutar proyectos a gran escala y a largo plazo (versión preliminar). Para obtener más información, consulta Equipos de agentes de Teamwork. Habilitado

  5. Haz clic en Guardar.

Configura la disponibilidad del modelo

Usa los parámetros de configuración de esta sección para autorizar modelos de IA específicos y administrar los niveles de acceso. Esto garantiza que los desarrolladores solo usen modelos de IA que cumplan con las políticas de seguridad y uso de tu organización. Por ejemplo, puedes otorgar a los desarrolladores acceso a modelos de vista previa para experimentos o restringir las herramientas para que usen solo modelos autorizados.

Consideraciones clave antes de configurar los modelos

Antes de configurar los modelos, ten en cuenta lo siguiente:

  • Alineación de políticas: Habilitar un modelo en Gemini Enterprise no anula las políticas de la organización de Gemini Enterprise Agent Platform. Para evitar que fallen las solicitudes de pago por uso que superen tu cuota estándar, asegúrate de que los modelos permitidos coincidan en ambas plataformas.

  • Residencia de datos: Los modelos de versión preliminar y el modelo Gemini 3 Pro Image solo están disponibles en la región global. Por lo tanto, no admiten compromisos de residencia de datos (DRZ) ni de procesamiento regional de aprendizaje automático (AA) en las multirregiones de EE.UU. o la UE.

  • Inferencia de modelos y manejo de datos de terceros: Los modelos de terceros solo están disponibles después de que un administrador los habilita y acepta las condiciones del proveedor. Cuando un desarrollador selecciona un modelo de terceros habilitado, Gemini Enterprise envía la instrucción y el contexto del código necesarios para esa solicitud al modelo, con el mismo procesamiento y las mismas protecciones que los modelos de Gemini. Las instrucciones y las respuestas no se usan para entrenar modelos. La inferencia de modelos de terceros está disponible en las ubicaciones global, us y eu. No se admiten las regiones dentro del país. Para ver la lista de países y regiones que pueden acceder al modelo, consulta los países y regiones admitidos de Anthropic. Para obtener más información sobre la residencia de datos, consulta Residencia de datos para las ediciones Standard y Plus de Gemini Enterprise y Gemini Notebook.

  • Divulgaciones sobre la ejecución y la facturación híbridas: Los modelos de Gemini utilizan los créditos de puestos de la edición agrupada de tu organización, mientras que los modelos de terceros habilitados por el administrador se facturan como uso de pago por uso en tu cuenta de Facturación de Cloud. Cuando un desarrollador selecciona un modelo de terceros habilitado (como Anthropic Claude Opus 5.5 o Anthropic Claude Sonnet 5.5) para las tareas principales de razonamiento, planificación, organización de herramientas y generación de código, Antigravity sigue usando modelos de Gemini livianos en segundo plano para la coordinación del cliente, como la administración de contexto y los resúmenes, y Gemini 3 Pro Image para la generación de imágenes. El uso de estos modelos puede generar cargos. Para obtener más información, consulta Cuotas y excedentes y Realiza un seguimiento del uso de tokens de modelos de terceros.

Configura modelos autorizados

Puedes configurar modelos autorizados para controlar qué modelos de IA están disponibles para tus herramientas para desarrolladores de IA.

El parámetro de configuración Modelos autorizados de Antigravity funciona como una lista de entidades permitidas:

  • Selección predeterminada (vacía): Cuando el campo está vacío, se permiten todos los modelos de Gemini compatibles. Los modelos de Google recién lanzados están disponibles automáticamente para los usuarios con licencia.
  • Lista de modelos personalizados: Cuando seleccionas uno o más modelos específicos, solo se permiten los modelos seleccionados. Los modelos no seleccionados y los modelos lanzados recientemente no están disponibles para los desarrolladores hasta que un administrador los selecciona manualmente.

Para configurar modelos autorizados, sigue estos pasos:

  1. En la consola de Google Cloud , ve a Gemini Enterprise.

    Ir a Gemini Enterprise

  2. Haz clic en Configuración y, luego, selecciona la pestaña Herramientas para desarrolladores de IA.

  3. En la sección Disponibilidad del modelo, haz clic en Editar.

  4. En el campo Modelos autorizados de Antigravity, selecciona los modelos que quieres permitir. Para permitir todos los modelos compatibles, deja el campo vacío.

  5. Haz clic en Guardar.

Configuración Descripción Estado predeterminado
Modelos autorizados de Antigravity Especifica qué modelos de IA tiene autorización para usar la herramienta Antigravity dentro del proyecto. Deja el campo vacío para permitir todos los modelos de Gemini compatibles. Si especificas una lista personalizada de modelos, el parámetro de configuración actúa como una lista de entidades permitidas, y los modelos recién lanzados o no seleccionados se deben agregar de forma manual para que estén disponibles. Además de los modelos de Gemini creados por Google, los administradores pueden habilitar modelos de terceros, incluidos Anthropic Claude Opus 5.5 y Anthropic Claude Sonnet 5.5. Para obtener información sobre las capacidades, las limitaciones y las evaluaciones de seguridad de cada modelo, consulta las tarjetas de modelo de Anthropic Claude Opus 5.5 y Anthropic Claude Sonnet 5.5. Vacío (se permiten todos los modelos de Gemini). Los modelos de terceros están desactivados de forma predeterminada y requieren el consentimiento del administrador.

Modelos compatibles

Las herramientas de IA para desarrolladores (app de Antigravity, la CLI de Antigravity y Antigravity para IDEs) admiten los siguientes modelos de Gemini y de socios. Un usuario con licencia es un desarrollador al que se le asignó una licencia de Gemini Enterprise activa (Standard, Plus o de pago por uso). Para obtener más información, consulta Administra licencias.

Nombre visible del modelo Proveedor Disponibilidad en Gemini Enterprise
Gemini 4 Argon Google Está habilitado de forma predeterminada para los usuarios con licencia cuando la selección del modelo predeterminado está activa (lista vacía). Si se configura una lista de modelos personalizada, el modelo se debe seleccionar de forma manual.
Gemini 3.8 Flash Google Está habilitado de forma predeterminada para los usuarios con licencia cuando la selección del modelo predeterminado está activa. Si se configura una lista de modelos personalizada, el modelo se debe seleccionar de forma manual.
Gemini 3.7 Flash Google Está habilitado de forma predeterminada para los usuarios con licencia cuando la selección del modelo predeterminado está activa. Si se configura una lista de modelos personalizada, el modelo se debe seleccionar de forma manual.
Gemini 3.6 Flash Google Está habilitado de forma predeterminada para los usuarios con licencia cuando la selección del modelo predeterminado está activa. Si se configura una lista de modelos personalizada, el modelo se debe seleccionar de forma manual.
Gemini 3.1 Pro (versión preliminar) Google Está habilitado de forma predeterminada para los usuarios con licencia cuando la selección del modelo predeterminado está activa. Si se configura una lista de modelos personalizada, el modelo se debe seleccionar de forma manual.
Claude Opus 5.5 de Anthropic Anthropic Está desactivada de forma predeterminada. Requiere la aceptación del administrador (consulta Habilita o desactiva los modelos de terceros).
Claude Sonnet 5.5 de Anthropic Anthropic Está desactivada de forma predeterminada. Requiere la aceptación del administrador (consulta Cómo habilitar o inhabilitar modelos de terceros).

Para obtener información sobre las cuotas y los créditos de edición agrupados, consulta Cuotas y excedentes y Cómo configurar los excedentes. Para conocer los precios de los modelos de terceros, consulta los SKU de Facturación de Cloud para Claude Opus 5.5 de Anthropic y Claude Sonnet 5.5 de Anthropic.

Nivel de pensamiento para modelos de terceros

Los desarrolladores pueden usar Anthropic Claude Opus 5.5 y Anthropic Claude Sonnet 5.5 con un nivel de pensamiento Bajo, Medio, Alto o Máximo. Cada nivel aparece como una entrada independiente en el selector de modelos, por ejemplo, Anthropic Claude Opus 5.5 (Alto). La opción Media es la predeterminada. Cuando habilitas un modelo de terceros, todos sus niveles de razonamiento están disponibles para los desarrolladores. No puedes restringir los niveles de pensamiento individuales.

Habilita o desactiva los modelos de terceros

Los modelos de terceros se facturan como uso de pago por uso y requieren excedentes. Antes de habilitar un modelo de terceros, activa los excedentes. Si los excedentes se desactivan más adelante, los desarrolladores no podrán usar modelos de terceros hasta que se vuelvan a activar. Para controlar los costos, puedes establecer un límite de inversión mensual para tu proyecto. El límite se aplica a todos los modelos, incluidos los de terceros.

Para habilitar o administrar modelos de terceros (como Anthropic Claude Opus 5.5 y Anthropic Claude Sonnet 5.5) en la consola de Google Cloud , haz lo siguiente:

  1. En la consola de Google Cloud , ve a Gemini Enterprise.

    Ir a Gemini Enterprise

  2. Haz clic en Configuración y, luego, selecciona la pestaña Herramientas para desarrolladores de IA.

  3. En el parámetro de configuración Modelos autorizados de Antigravity, activa el botón de activación del modelo de terceros que quieras habilitar.

  4. En el cuadro de diálogo Condiciones del Servicio incorporado que aparece, revisa y acepta las condiciones de terceros.

Si desactivas un modelo de terceros, los desarrolladores perderán el acceso a él poco después.

Si el proveedor del modelo restringe el acceso a un modelo de terceros para tu organización, los desarrolladores no podrán usar ese modelo. Para resolver el problema, comunícate con el equipo de Atención al cliente de Google Cloud.

Para obtener instrucciones para desarrolladores sobre cómo acceder a Antigravity y seleccionar modelos, consulta la documentación de Antigravity para empresas.

Consideraciones de seguridad para modelos de terceros

Los modelos de IA, incluidos los de terceros, pueden seguir instrucciones ocultas en el contenido que procesan, como archivos, páginas web o resultados de herramientas. Esto se conoce como inyección de instrucciones. Antigravity proporciona las siguientes protecciones cuando los desarrolladores usan modelos de terceros:

  • Habilitación por parte del administrador: Los modelos de terceros están desactivados de forma predeterminada. Los desarrolladores pueden usar un modelo de terceros solo después de que un administrador lo habilite.
  • Protecciones de seguridad del proveedor: Los modelos de terceros incluyen las protecciones de seguridad integradas del proveedor. Para obtener más información, consulta Seguridad de Claude.
  • Tus políticas de seguridad: La configuración de las políticas de seguridad y el acceso web externo que configures se aplica a los agentes, independientemente del modelo que seleccione un desarrollador.

Prácticas recomendadas

  • Habilita solo los modelos de terceros que necesiten tus desarrolladores.
  • Establece el Modo de ejecución automática de la terminal en Requerir revisión o Continuar en la zona de pruebas para que los desarrolladores aprueben los comandos antes de que se ejecuten.
  • Mantén la opción Fuera de la política de acceso a archivos configurada como Rechazar.
  • Activa Acceso al navegador y limita los agentes a una lista de URLs permitidas.
  • Activa el modo de zona de pruebas para los proyectos que funcionan con código, dependencias o contenido web no confiables.
  • Anima a los desarrolladores a revisar los comandos y los cambios de código que proponen los agentes antes de aprobarlos.
  • Establece un límite de inversión mensual para tu proyecto.

¿Qué sigue?