Implementaciones y extremos

En esta página, se enumeran las ubicaciones admitidas para los modelos de Google y de socios, y las funciones potenciadas por IA generativa en Gemini Enterprise Agent Platform.

Para ver las ubicaciones compatibles con los agentes de Google y las funciones de infraestructura de agentes, consulta Ubicaciones compatibles con los agentes.

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-3.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="gemini-3.5-flash"
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"
      }
    }
  }'

Conectividad privada a extremos multirregionales

El Acceso privado a Google no se admite para los extremos multirregionales. Si intentas conectarte a un extremo multirregional con el Acceso privado a Google, es posible que experimentes problemas de conectividad, errores de protocolo de enlace SSL/TLS o advertencias de discrepancia de certificados.

Para establecer conectividad privada con extremos multirregionales, debes configurar extremos de Private Service Connect para las APIs de Google regionales.

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 Pro Image
• Imagen de Gemini 3.1 Flash
• 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 los extremos para los modelos de socios, consulta la pestaña Global en la tabla de ubicaciones de extremos de modelos de socios.Google Cloud

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 (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:

Google Cloud ubicaciones de extremos de modelos de socios

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 Gemini Enterprise Agent Platform 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 “Extremo regional y global” 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: