Claude en Google Cloud

La API para acceder a Claude en Google Cloud's Agent Platform es casi idéntica a la API de Messages, con dos diferencias clave en el formato de la solicitud:

• En Agent Platform, model no se pasa en el cuerpo de la solicitud. En su lugar, se especifica en la URL del endpoint de Google Cloud.
• En Agent Platform, anthropic_version se pasa en el cuerpo de la solicitud (en lugar de como un encabezado), y debe establecerse en el valor vertex-2023-10-16.

Agent Platform también es compatible con los SDKs de cliente oficiales de Anthropic. Esta guía te muestra cómo hacer una solicitud a Claude en Agent Platform usando uno de los SDKs de cliente de Anthropic.

Ten en cuenta que esta guía asume que ya tienes un proyecto de Google Cloud que puede usar Agent Platform. Consulta Modelos Claude de Anthropic en Agent Platform para obtener más información sobre la configuración requerida y un recorrido completo.



Instala un SDK para acceder a Agent Platform

Primero, instala el SDK de cliente de Anthropic para el lenguaje de tu elección.



Acceder a Agent Platform



Disponibilidad de modelos

Ten en cuenta que la disponibilidad de los modelos de Anthropic varía según la región. Busca "Claude" en el Model Garden o ve a Modelos Claude de Anthropic para obtener la información más reciente.



IDs de modelo de la API

Los términos del ciclo de vida (Obsoleto, Retirado) se definen en Obsolescencia de modelos. Las fechas del ciclo de vida en las plataformas operadas por socios las establece el socio y pueden diferir del calendario de la API de Claude. Para conocer la fecha de retiro actual de cualquier modelo en Agent Platform, consulta la documentación de Google Cloud para los modelos Claude en Agent Platform.



Realizar solicitudes

Antes de ejecutar solicitudes, es posible que necesites ejecutar gcloud auth application-default login para autenticarte con Google Cloud.

Los siguientes ejemplos muestran cómo generar texto desde Claude en Agent Platform:

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "global"

client = AnthropicVertex(project_id=project_id, region=region)

message = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

Consulta los SDKs de cliente y la documentación oficial de Agent Platform para obtener más detalles.

Claude también está disponible a través de Amazon Bedrock, Claude Platform en AWS y Microsoft Foundry.



Retención de datos

El manejo de datos para esta oferta está regido por Google Cloud. Para más detalles, consulta Agent Platform y retención cero de datos.



Registro de actividad

Agent Platform proporciona un servicio de registro de solicitudes y respuestas que permite a los clientes registrar los prompts y las finalizaciones asociadas con tu uso.

Anthropic recomienda que registres tu actividad al menos de forma continua durante 30 días para comprender tu actividad e investigar cualquier posible uso indebido.



Compatibilidad de funciones

Para ver la lista completa de funciones con disponibilidad en Google Cloud, consulta la Descripción general de funciones.



Funciones compatibles destacadas

• API de Messages
• Almacenamiento en caché de prompts
• Pensamiento extendido
• Uso de herramientas, incluyendo la herramienta Bash, la herramienta de uso de computadora, la herramienta de memoria y la herramienta de editor de texto
• Herramienta de búsqueda web
• Citas
• Salidas estructuradas



Funciones no compatibles

• Fuentes de entrada (fuentes URL para imágenes y documentos, Files API)
• Herramientas del lado del servidor (ejecución de código, obtención web, advisor)
• Infraestructura de agentes (Agent Skills, conector MCP, llamadas programáticas a herramientas)
• Endpoints de la API (Message Batches, Models, Admin, Compliance, Usage and Cost)
• Claude Managed Agents
• Respaldo del lado del servidor (el parámetro fallbacks; usa en su lugar el patrón de respaldo del lado del cliente)



Ventana de contexto

Claude Fable 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 5 y Claude Sonnet 4.6 tienen una ventana de contexto de 1M de tokens en Agent Platform. Otros modelos Claude, incluyendo Sonnet 4.5 y Sonnet 4 (obsoleto), tienen una ventana de contexto de 200k tokens.

Agent Platform limita las cargas útiles de las solicitudes a 30 MB. Al enviar documentos grandes o muchas imágenes, es posible que alcances este límite antes que el límite de tokens.



Endpoints globales, multirregionales y regionales

Agent Platform ofrece tres tipos de endpoints:

• Endpoints globales: Enrutamiento dinámico para máxima disponibilidad
• Endpoints multirregionales: Enrutamiento dinámico dentro de un área geográfica (por ejemplo, Estados Unidos o la Unión Europea) para residencia de datos con alta disponibilidad
• Endpoints regionales: Enrutamiento de datos garantizado a través de regiones geográficas específicas

Los endpoints regionales y multirregionales incluyen una prima de precio del 10% sobre los endpoints globales.



Cuándo usar cada opción

Endpoints globales (recomendado):

• Proporcionan máxima disponibilidad y tiempo de actividad
• Enrutan dinámicamente las solicitudes a regiones con capacidad disponible
• Sin prima de precio
• Ideal para aplicaciones donde la residencia de datos es flexible
• Solo admite tráfico de pago por uso (el rendimiento aprovisionado requiere endpoints regionales)

Endpoints multirregionales:

• Enrutan dinámicamente las solicitudes entre regiones dentro de un área geográfica (actualmente us y eu)
• Útiles cuando necesitas residencia de datos dentro de una geografía amplia pero quieres mayor disponibilidad que una sola región
• Prima de precio del 10% sobre los endpoints globales
• Solo admite tráfico de pago por uso (el rendimiento aprovisionado requiere endpoints regionales)

Endpoints regionales:

• Enrutan el tráfico a través de regiones geográficas específicas
• Requeridos para residencia de datos en una sola región, mandatos estrictos de cumplimiento o rendimiento aprovisionado
• Admiten tanto pago por uso como rendimiento aprovisionado
• La prima de precio del 10% refleja los costos de infraestructura para capacidad regional dedicada



Implementación

Uso de endpoints globales (recomendado):

Establece el parámetro region en "global" al inicializar el cliente:

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "global"

client = AnthropicVertex(project_id=project_id, region=region)

message = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

Uso de endpoints multirregionales:

Establece el parámetro region en un identificador multirregional: "us" para Estados Unidos o "eu" para la Unión Europea. El SDK enruta las solicitudes al endpoint multirregional correspondiente (https://aiplatform.us.rep.googleapis.com o https://aiplatform.eu.rep.googleapis.com), que equilibra dinámicamente el tráfico entre las regiones dentro de esa geografía.

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "us"  # Multi-region identifier: "us" or "eu"

client = AnthropicVertex(project_id=project_id, region=region)

message = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

Uso de endpoints regionales:

Especifica una región específica como "us-east1" o "europe-west1":

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "us-east1"  # Specify a specific region

client = AnthropicVertex(project_id=project_id, region=region)

message = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)



Recursos adicionales

• Precios de Agent Platform: Precios de IA generativa en cloud.google.com
• Documentación de los modelos Claude: Claude en Agent Platform
• Publicación del blog de Google: Endpoint global para los modelos Claude
• Detalles de precios de Anthropic: Precios de plataformas en la nube