Descripción general de Gemini Enterprise Agent Platform en modo Express

Vista previa

Esta función está sujeta a las "Condiciones de la oferta previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de la fase previa a la DG están disponibles “sin modificaciones” y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Con Gemini Enterprise Agent Platform en modo Express, puedes registrarte y comenzar a crear aplicaciones de IA generativa en Google Cloud. Esta experiencia de configuración simplificada optimiza el acceso a las APIs de Google Cloud al simplificar la organización, la facturación y la administración de proyectos.

Para obtener más información sobre Agent Platform en el modo Exprés, consulta las preguntas frecuentes sobre el modo Exprés de Google Cloud.

Regístrate en el modo Exprés

Agent Platform está disponible en modo exprés para los desarrolladores que tienen una @gmail.com Cuenta de Google:

• Usuarios nuevos: Los usuarios nuevos de Google Cloud pueden registrarse para obtener una cuenta en modo exprés en un nivel gratuito y probar Agent Platform sin costo durante un máximo de 90 días, dentro de las cuotas especificadas. No es necesario que proporciones información de facturación para registrarte en el nivel gratuito. Para actualizar a un nivel pagado, agrega una cuenta de facturación.

  Agent Platform en modo exprés es independiente del Google Cloud Programa Gratuito y no está disponible a través de él. Si estás en el Google Cloud Programa gratuito, consulta las otras guías de inicio rápido en la sección Cómo comenzar.

Para registrarte en Agent Platform en modo Exprés, abre Modo Exprés en la consola de Google Cloud :

Ir al modo Exprés

Una vez que hayas completado la configuración, puedes comenzar a usar Agent Platform en modo exprés siguiendo uno de los siguientes instructivos:

• Instructivo: Agent Studio en modo exprés
• Instructivo: API de Agent Platform en modo Express

Información sobre Agent Platform en modo Exprés

Cuando te registras en el modo exprés, Google Cloud se habilitan las APIs en tu nombre. Este proceso se ejecuta en segundo plano, por lo que puedes comenzar a usar Agent Platform sin necesidad de configurar recursos manualmente.

Cuando te registras en el modo exprés, obtienes acceso a lo siguiente:

• Funciones principales de Agent Studio Prueba y personaliza instrucciones para diferentes modelos de IA generativa, y obtén el código correspondiente para usarlo en tu aplicación.
• Una clave de API Autentica las solicitudes de tu aplicación.
• Nivel gratuito para usuarios nuevos de Google Cloud durante 90 días. Durante el límite de 90 días del nivel gratuito para usuarios Google Cloud nuevos, puedes usar las APIs de Agent Platform que admiten el modo Exprés de forma gratuita, hasta sus cuotas. No es necesario que proporciones información de facturación. Puedes aumentar los límites de tu cuota en cualquier momento habilitando la facturación.

Si ya eres usuario de Google Cloud o después de habilitar la facturación, se quitará el nivel gratuito de 90 días. Pasas a un nivel pagado para acceder a límites de cuota extendidos y funciones Google Cloud adicionales. A medida que aumentan tus cuotas, solo pagas por lo que usas. En cualquier momento, puedes finalizar el modo exprés y comenzar a usar todos los Google Cloud servicios y las capacidades.

En la siguiente tabla, se enumeran las diferencias entre las experiencias del modo exprés y la experiencia completa de la Plataforma de agentes:

Elemento	Modo Express de Agent Platform en el nivel gratuito	Agent Platform completa
Límite de tiempo	90 días	Ilimitado
Servicios disponibles	Servicios básicos de IA generativa	Todos los servicios de Google Cloud , incluida Agent Platform.
Fuentes de datos	Google Drive	Todas las fuentes de datos disponibles en Google Cloud.
Cuota	Límites del nivel gratuito Consulta Modelos disponibles y límites de frecuencia en el modo exprés.	Límites estándar de pago por uso Consulta los límites de frecuencia.
Formato estándar de los endpoints de API	Usa el extremo global sin un ID del proyecto ni una ubicación, y pasa tu clave de API en el encabezado HTTP x-goog-api-key (o el parámetro de consulta key). Por ejemplo: https://aiplatform.googleapis.com/v1/publishers/google/models/MODEL_ID:streamGenerateContent	Especifica un ID y una ubicación del proyecto. Por ejemplo: https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:streamGenerateContent

Modelos disponibles y límites de frecuencia en el modo exprés

Puedes probar varios modelos en el modo Exprés, incluidos los modelos de Gemini Flash. En la siguiente tabla, se enumeran los modelos disponibles en el modo Exprés, junto con sus límites de frecuencia:

Categoría del modelo	Modelos disponibles	Cantidad máxima de solicitudes por minuto
Gemini	gemini-3-pro-image	Dinámico
	gemini-3.1-flash-image	Dinámico
	gemini-3.1-pro-preview	Dinámico
	gemini-3-flash-preview	Dinámico
	gemini-2.5-pro	10
	gemini-2.5-flash-image	10
	gemini-2.5-flash	10
	gemini-2.5-flash-lite	10

Solo se admiten los modelos que se indican en la tabla anterior en el modo exprés. Los modelos de la API de Gemini Live dedicados, como Gemini 3.8 Live (gemini-3.8-live) y Gemini 2.5 Flash Live API Native Audio (gemini-live-2.5-flash-native-audio), no se admiten en el modo express, y la API de Gemini Live no está disponible en la consola deGoogle Cloud en el modo express. Para usar los modelos compatibles de la API de Gemini Live, actualiza tu cuenta del modo express a una cuenta estándar de Google Cloud.

Flujo de trabajo de Agent Platform en modo Express

Puedes comenzar a enviar solicitudes desde tu aplicación a las APIs de Agent Platform en tres pasos:

1. Después de registrarte en el modo exprés, usa Agent Studio para probar las funciones de Agent Platform:

   Ir a Agent Studio

   Por ejemplo, selecciona Agent Studio > Crear instrucción para crear y optimizar instrucciones multimodales con una variedad de modelos de Gemini.

2. Obtén el código de lo que implementaste con la IU.

   En la página de instrucciones, haz clic en Build with code > Get code. Se abre un panel que muestra el código que envía de forma programática las mismas solicitudes que implementaste en la IU. Puedes obtener el código para un lenguaje de programación o curl. Puedes usar Google Colab para probar el código de Python.

3. Usa tu clave de API para autenticarte en la API de Agent Platform.

   En la consola de Google Cloud en modo express, abre APIs y servicios > Credenciales:

   Ir a Credenciales

   Luego, copia tu clave de API de Generative Language en el código donde dice "YOUR_API_KEY". Por ejemplo:

   Python

   El SDK de IA generativa de Google para Python está disponible en PyPI y GitHub:

   • google-genai en PyPI
   • python-genai en GitHub

   Para obtener más información, consulta la referencia del SDK de Python (se abre en una pestaña nueva).

   from google import genai
   
   # TODO(developer): Update below line
   API_KEY = "YOUR_API_KEY"
   
   client = genai.Client(vertexai=True, api_key=API_KEY)
   
   response = client.models.generate_content(
       model="gemini-3.5-flash",
       contents="Explain bubble sort to me.",
   )
   
   print(response.text)
   # Example response:
   # Bubble Sort is a simple sorting algorithm that repeatedly steps through the list

Qué diferencias hay en el modo Exprés

Agent Platform en modo Express proporciona un subconjunto de las funciones de IA generativa. Por lo tanto, parte de la documentación de Agent Platform no es pertinente si te registraste en el modo exprés. Para obtener detalles sobre los endpoints de API disponibles en el modo Exprés, consulta la referencia de la API de REST de Agent Platform en el modo Exprés.

Además, los clientes de Google Cloud suelen usar organizaciones y proyectos para trabajar con recursos (por ejemplo, para llamar a un extremo de API). Cuando usas Agent Platform en modo Express, no tienes que preocuparte por las organizaciones ni los proyectos. Sin embargo, es posible que las veas mencionadas en parte de la documentación de Google Cloud a la que haces referencia mientras usas Agent Platform en modo express. Aún puedes usar la documentación, pero ignora los conceptos y las instrucciones que se refieran a organizaciones y proyectos. Además, la ubicación que seleccionaste cuando te registraste en el modo exprés se usa en toda tu experiencia.

Cuando llames a los endpoints de API de REST en modo exprés, usa el formato de endpoint global para el modo exprés y autentícate con tu clave de API:

URL del extremo estándar	https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:streamGenerateContent
URL del extremo en modo Express	https://aiplatform.googleapis.com/v1/publishers/google/models/MODEL_ID:streamGenerateContent

Ten en cuenta los siguientes detalles de autenticación y extremos cuando envíes solicitudes de REST en el modo exprés:

• Ruta de acceso del modelo de publicador ({model}): En la referencia de la API de REST de Agent Platform en modo exprés, las plantillas de extremos, como https://aiplatform.googleapis.com/v1/{model}:streamGenerateContent y https://aiplatform.googleapis.com/v1beta1/{model}:streamGenerateContent, usan {model} para representar la ruta de acceso completa del recurso del modelo de publicador (publishers/google/models/MODEL_ID). Ambas se resuelven en la misma URL del extremo.
• Encabezado de autenticación de clave de API: No es necesario pasar tu clave de API como parámetro de consulta. Pasa tu clave de API en el encabezado HTTP x-goog-api-key (por ejemplo, -H "x-goog-api-key: API_KEY"). Si tu entorno de cliente no te permite establecer encabezados HTTP, puedes pasar el parámetro de consulta del sistema key en su lugar (?key=API_KEY). Para obtener más información, consulta Usa claves de API.

Cómo ver y administrar claves de API

Para autenticarte con los endpoints de API de Agent Platform que admiten el modo Exprés, usa la clave de API que se creó para ti durante el registro o cualquier clave que hayas creado en el modo Exprés. Una clave de API es una cadena encriptada que se genera de forma automática cuando te registras en el modo Exprés. Estas claves de API se pueden ver y administrar en la página APIs y servicios.

Para obtener más información sobre las prácticas recomendadas para administrar las claves de API, consulta Prácticas recomendadas para administrar las claves de API.

Para ver y administrar tus claves de API, haz lo siguiente:

1. En la consola de Google Cloud , ve a la página Claves de API:

   Ir a Claves de API

Habilita y administra la facturación

Puedes aumentar tus cuotas y quitar el límite de 90 días habilitando la facturación.

Después de habilitar la facturación, solo pagas por lo que usas. También puedes guardar tus instrucciones y usar parámetros de configuración adicionales en la consola Google Cloud que aparecen en gris cuando la facturación no está habilitada.

Para administrar la facturación, haz lo siguiente:

1. Ve a la página Resumen de Agent Studio en el modo Exprés.

   Ir a Agent Studio

2. En la consola de Google Cloud en modo exprés, abre Facturación:

   Ir a Facturación

3. Administra tus cuentas de facturación.

Comienza a usar todas las capacidades y los servicios de Google Cloud

El modo Express está diseñado para ayudarte a comenzar. Cuando esté todo listo para usar otros servicios deGoogle Cloud o necesites más control sobre tu entorno, puedes cambiar tu cuenta de modo exprés a una cuenta estándar de Google Cloud . Este proceso a veces se denomina actualización.

Puedes comenzar a usar todas las capacidades y los servicios disponibles enGoogle Cloud en tu proyecto actualizando tu cuenta del modo Exprés.

Para actualizar desde el modo exprés, haz lo siguiente:

1. Ve a la página Resumen de Agent Studio en el modo Exprés.

   Ir a Agent Studio

2. Haz clic en Activar ahora y sigue las instrucciones.

Después de actualizar desde el modo Exprés, especifica el ID del proyecto y la ubicación en lugar de la clave de API cuando llames a los endpoints de API de REST. Por ejemplo:

https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:streamGenerateContent