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

Con Gemini Enterprise Agent Platform en el modo exprés, puedes registrarte y comenzar a crear aplicaciones de IA generativa en Cloud de Confiance by S3NS. Esta experiencia de configuración simplificada agiliza el acceso a las APIs de Cloud de Confiance , ya que facilita la organización, la facturación y la administración de proyectos.

Para obtener más información sobre Agent Platform en modo exprés, consulta las preguntas frecuentes sobre el modo exprés deCloud de Confiance.

Regístrate para usar el modo Exprés

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

• Usuarios nuevos: Los usuarios nuevos de Cloud de Confiance pueden registrarse para obtener una cuenta en modo rápido en un nivel gratuito y probar Agent Platform sin costo durante un máximo de 90 días, dentro de las cuotas especificadas. No necesitas proporcionar datos de facturación para registrarte en el nivel gratuito. Puedes actualizar a un nivel pagado agregando una cuenta de facturación.

  Agent Platform en el modo Exprés es independiente del Programa gratuito deCloud de Confiance y no está disponible a través de él. Si estás en el Cloud de Confiance programa gratuito, consulta las otras guías de inicio rápido en la sección Comienza.

Para registrarte en Agent Platform en el modo Exprés, abre el modo Exprés desde la consola de Cloud de Confiance :

Ir al modo Exprés

Después de completar la configuración, puedes comenzar a usar Agent Platform en el modo Exprés siguiendo uno de los instructivos:

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

Más información sobre Agent Platform en el modo exprés

Cuando te registras en el modo exprés, Cloud de Confiance habilita las APIs en tu nombre. Este proceso se realiza en segundo plano, por lo que puedes comenzar a usar Agent Platform sin necesidad de configurar los recursos de forma manual.

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 Cloud de Confiance nuevos durante 90 días. Durante el límite de 90 días del nivel gratuito para los usuarios nuevos de Cloud de Confiance , puedes usar las APIs de Agent Platform que admiten el modo exprés de forma gratuita, hasta sus cuotas. No es necesario que proporciones datos de facturación. Puedes aumentar los límites de tu cuota en cualquier momento habilitando la facturación.

Si ya eres usuario de Cloud de Confiance 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 adicionales de Cloud de Confiance . A medida que aumentan tus cuotas, solo pagas por lo que usas. En cualquier momento, puedes elegir finalizar el modo exprés y comenzar a usar todos los servicios y las capacidades de Cloud de Confiance .

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

Modelos y límites de frecuencia disponibles 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 que están disponibles en el modo Exprés, junto con sus límites de frecuencia:

Solo los modelos que se indican en la tabla anterior son compatibles con el modo Exprés. Los modelos dedicados de la API de Gemini Live, 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 exprés, y la API de Gemini Live no está disponible en la consola deCloud de Confiance en el modo exprés. Para usar los modelos de la API de Gemini Live compatibles, actualiza del modo exprés a una cuenta estándar de Cloud de Confiance.

Flujo de trabajo de Agent Platform en modo Exprés

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 abrirá un panel con 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 Cloud de Confiance consola en modo Exprés, abre APIs y servicios > Credenciales:

   Ir a Credenciales

   Luego, copia tu clave de API de Generative Language en tu 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 el modo express proporciona un subconjunto de las funciones para la IA generativa. Por lo tanto, parte de la documentación de Agent Platform no es relevante 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 la Agent Platform en el modo Exprés.

Además, los clientes de Cloud de Confiance suelen usar organizaciones y proyectos para trabajar con recursos (por ejemplo, para llamar a un extremo de API). Cuando usas Agent Platform en el modo exprés, no necesitas preocuparte por las organizaciones ni los proyectos. Sin embargo, es posible que los veas mencionados en parte de la documentación de Cloud de Confiance a la que hagas referencia mientras usas Agent Platform en el modo Exprés. Puedes seguir usando la documentación, pero ignora los conceptos y las instrucciones que se refieren 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 la API de REST en el modo express, usa el formato de endpoint global para el modo express y autentícate con tu clave de API:

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

• 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 de extremo.
• Encabezado de autenticación de la clave de API: No es necesario pasar la clave de API como un 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 (?key=API_KEY). Para obtener más información, consulta Usa claves de API.

Visualiza y administra 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 Cloud de Confiance , 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 de Cloud de Confiance que están inhabilitados 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 Cloud de Confiance en el modo exprés, abre Facturación:

   Ir a Facturación

3. Administra tus cuentas de facturación.

Comienza a usar todas las funciones y los servicios de Cloud de Confiance by S3NS

El modo rápido está diseñado para ayudarte a comenzar. Cuando estés listo para usar otros servicios deCloud de Confiance o necesites más control sobre tu entorno, puedes cambiar tu cuenta de modo exprés a una cuenta de Cloud de Confiance estándar. A veces, este proceso se denomina actualización.

Puedes comenzar a usar todas las capacidades y los servicios disponibles en Cloud de Confiance 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 rápido, especifica el ID y la ubicación del proyecto en lugar de la clave de API cuando llames a los extremos de la API de REST. Por ejemplo:

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