Implementaciones y extremos

Los modelos de Google y de socios, y las funciones de IA generativa en Gemini Enterprise Agent Platform se exponen como extremos regionales específicos y un extremo global. Los extremos globales abarcan todo el mundo y proporcionan mayor disponibilidad y confiabilidad que las regiones individuales.

Especifica un extremo

Para los extremos regionales estándar (como us-central) y el extremo global, haz lo siguiente:

# google-cloud-aiplatform >= 1.79.0 is required
import vertexai
from vertexai.generative_models import GenerativeModel

vertexai.init(project='GOOGLE_CLOUD_PROJECT', location='GOOGLE_CLOUD_LOCATION')

client = genai.Client(
    enterprise=True,
    project='GOOGLE_CLOUD_PROJECT',
    location='GOOGLE_CLOUD_LOCATION'
)

GOOGLE_CLOUD_PROJECT="GOOGLE_CLOUD_PROJECT"
GOOGLE_CLOUD_LOCATION="GOOGLE_CLOUD_LOCATION"
MODEL_ID="MODEL_ID"

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://${GOOGLE_CLOUD_LOCATION}$-aiplatform.googleapis.com/v1/projects/${GOOGLE_CLOUD_PROJECT}/locations/${GOOGLE_CLOUD_LOCATION}/publishers/google/models/${MODEL_ID}:generateContent" \
  -d '{
    "contents": {
      "role": "user",
      "parts": {
        "text": "Explain how AI works in a few words."
      }
    }
  }'

Extremos multirregionales

Los extremos multirregionales te permiten garantizar que el procesamiento de aprendizaje automático de los Datos del Cliente por parte del servicio permanezca dentro de un límite jurisdiccional específico, como Estados Unidos o la Unión Europea.

En la siguiente tabla, se enumeran los nombres de host para los extremos multirregionales:

import vertexai
from google.adk.agents import Agent

# Set the multi-region location on the client
client = vertexai.Client(
    project='GOOGLE_CLOUD_PROJECT',
    location='GOOGLE_CLOUD_LOCATION'
)

# The agent will use this configuration
agent = Agent(
    model="gemini-2.5-flash",
    name='my_agent'
)

from google import genai

# location must be set to 'us' or 'eu' for multi-region routing
client = genai.Client(
    enterprise=True,
    project='GOOGLE_CLOUD_PROJECT',
    location='GOOGLE_CLOUD_LOCATION'
)

GOOGLE_CLOUD_PROJECT="GOOGLE_CLOUD_PROJECT"
MODEL_ID="MODEL_ID"
GOOGLE_CLOUD_LOCATION="GOOGLE_CLOUD_LOCATION" # Must be 'us' or 'eu'
# Explicitly use the .rep. hostname for multi-region endpoints
API_ENDPOINT="https://aiplatform.${GOOGLE_CLOUD_LOCATION}.rep.googleapis.com"

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "${API_ENDPOINT}/v1/projects/${GOOGLE_CLOUD_PROJECT}/locations/${GOOGLE_CLOUD_LOCATION}/publishers/google/models/${MODEL_ID}:generateContent" \
  -d '{
    "contents": {
      "role": "user",
      "parts": {
        "text": "Explain how AI works in a few words"
      }
    }
  }'

Extremo global

Seleccionar un extremo global para tus solicitudes puede mejorar la disponibilidad general y reducir los errores de recursos agotados (429). No uses el extremo global si tienes requisitos de procesamiento de AA, ya que no puedes controlar ni saber a qué región se envían tus solicitudes de procesamiento de AA cuando se realiza una solicitud.

Modelos compatibles

El uso del extremo global es compatible con los siguientes modelos de Google en las regiones especificadas. Para obtener detalles sobre qué modelos admiten el extremo global, consulta la pestaña Global en la tabla de ubicaciones de extremos de modelos de Google.

• Gemini 3.5 Flash
• Gemini 3.1 Flash-Lite
• Imagen de Gemini 3.1 Flash (versión preliminar)
• Gemini 3.1 Pro (versión preliminar)
• Gemini 3 Flash (versión preliminar)
• Gemini 3 Pro Image (versión preliminar)
• Gemini 2.5 Pro
• Gemini 2.5 Flash (versión preliminar)
• Gemini 2.5 Flash-Lite (versión preliminar)
• Gemini 2.5 Flash Image
• Gemini 2.5 Flash
• Gemini 2.5 Flash-Lite

Para obtener información sobre la disponibilidad global de extremos para los modelos de socios, consulta la pestaña Global en la Google Cloud tabla de ubicaciones de extremos de modelos de socios.

Limitaciones

Las siguientes capacidades no están disponibles cuando se usa el extremo global:

• Ajuste
• Predicción por lotes para modelos de Anthropic y OpenMaaS
• Corpus de generación mejorada por recuperación (RAG) (se admiten solicitudes de RAG)

El uso del extremo global con la capacidad de procesamiento aprovisionada solo está disponible para los siguientes modelos:

Ubicaciones de los extremos de los modelos de Google

Los modelos de Google en Gemini Enterprise Agent Platform están disponibles para los siguientes extremos:

Ubicaciones de extremos de modelos de sociosGoogle Cloud

Google atiende las solicitudes desde la región que especificaste. En el caso de algunos modelos, Google también ofrece un endpoint global para mejorar la disponibilidad general y reducir las tasas de error. El endpoint global puede tener un conjunto independiente de cuotas del endpoint regional y no admite requisitos de residencia de datos. Para obtener más información, consulta la sección "Extremo regional y global" en Modelos de socios de plataforma de Gemini Enterprise para MaaS.

Los extremos de los modelos de socios para Agent Platform están disponibles en las siguientes regiones:

Google Cloud ubicaciones de extremos de modelos abiertos

Google atiende las solicitudes desde la región que especificaste. En el caso de algunos modelos, Google también ofrece un endpoint global para mejorar la disponibilidad general y reducir las tasas de error. El endpoint global puede tener un conjunto independiente de cuotas del endpoint regional y no admite requisitos de residencia de datos. Para obtener más información, consulta la sección “Extremos regionales y globales” en Modelos abiertos de Gemini Enterprise Agent Platform para MaaS.

Los extremos de modelos abiertos para Agent Platform están disponibles en las siguientes regiones: