Claude no Google Cloud

A API para acessar o Claude no Agent Platform do Google Cloud é quase idêntica à Messages API, com duas diferenças principais no formato da requisição:

• No Agent Platform, model não é passado no corpo da requisição. Em vez disso, é especificado na URL do endpoint do Google Cloud.
• No Agent Platform, anthropic_version é passado no corpo da requisição (em vez de como um cabeçalho), e deve ser definido com o valor vertex-2023-10-16.

O Agent Platform também é compatível com os SDKs de cliente oficiais da Anthropic. Este guia orienta você a fazer uma requisição ao Claude no Agent Platform usando um dos SDKs de cliente da Anthropic.

Observe que este guia pressupõe que você já tenha um projeto do Google Cloud habilitado para usar o Agent Platform. Consulte Modelos Claude da Anthropic no Agent Platform para obter mais informações sobre a configuração necessária e um passo a passo completo.



Instalar um SDK para acessar o Agent Platform

Primeiro, instale o SDK de cliente da Anthropic para a linguagem de sua escolha.

pip install -U "anthropic[vertex]"



Acessando o Agent Platform



Disponibilidade de modelos

Observe que a disponibilidade dos modelos da Anthropic varia por região. Pesquise por "Claude" no Model Garden ou acesse Modelos Claude da Anthropic para obter as informações mais recentes.



IDs de modelo da API

Os termos de ciclo de vida (Descontinuado, Desativado) são definidos em Descontinuações de modelos. As datas de ciclo de vida em plataformas operadas por parceiros são definidas pelo parceiro e podem diferir do cronograma da API do Claude. Para a data atual de desativação de qualquer modelo no Agent Platform, consulte a documentação do Google Cloud para modelos Claude no Agent Platform.



Fazendo requisições

Antes de executar requisições, talvez seja necessário executar gcloud auth application-default login para autenticar com o Google Cloud.

Os exemplos a seguir mostram como gerar texto a partir do Claude no 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-5",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

Consulte os SDKs de cliente e a documentação oficial do Agent Platform para obter mais detalhes.

O Claude também está disponível através do Amazon Bedrock, Claude Platform na AWS e Microsoft Foundry.



Retenção de dados

O tratamento de dados para esta oferta é regido pelo Google Cloud. Para obter detalhes, consulte Agent Platform e retenção zero de dados.



Registro de atividades

O Agent Platform fornece um serviço de registro de requisição-resposta que permite registrar os prompts e as conclusões associados ao seu uso.

A Anthropic recomenda que você registre sua atividade em uma base contínua de pelo menos 30 dias para entender sua atividade e investigar qualquer possível uso indevido.



Suporte a recursos

Para a lista completa de recursos com disponibilidade no Google Cloud, consulte Visão geral de recursos.



Destaques de recursos suportados

• Messages API
• Cache de prompt
• Pensamento
• Uso de ferramentas, incluindo a ferramenta Bash, ferramenta de uso de computador, ferramenta de memória e ferramenta de editor de texto
• Ferramenta de busca na web
• Citações
• Saídas estruturadas



Recursos não suportados

• Fontes de entrada (fontes de URL para imagens e documentos, Files API)
• Ferramentas do lado do servidor (execução de código, busca na web, advisor)
• Infraestrutura de agentes (Agent Skills, conector MCP, chamada programática de ferramentas)
• Endpoints de API (Message Batches, Models, Admin, Compliance, Usage and Cost)
• Claude Managed Agents
• Fallback do lado do servidor (o parâmetro fallbacks; use o padrão de fallback do lado do cliente em vez disso)



Janela de contexto

Claude Fable 5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 5 e Claude Sonnet 4.6 têm uma janela de contexto de 1M de tokens no Agent Platform. Outros modelos Claude, incluindo Sonnet 4.5 e Sonnet 4 (descontinuado), têm uma janela de contexto de 200k tokens.

O Agent Platform limita os payloads de requisição a 30 MB. Ao enviar documentos grandes ou muitas imagens, você pode atingir esse limite antes do limite de tokens.



Endpoints globais, multirregionais e regionais

O Agent Platform oferece três tipos de endpoint:

• Endpoints globais: roteamento dinâmico para máxima disponibilidade
• Endpoints multirregionais: roteamento dinâmico dentro de uma área geográfica (por exemplo, Estados Unidos ou União Europeia) para residência de dados com alta disponibilidade
• Endpoints regionais: roteamento de dados garantido através de regiões geográficas específicas

Endpoints regionais e multirregionais incluem um acréscimo de 10% no preço em relação aos endpoints globais.



Quando usar cada opção

Endpoints globais (recomendado):

• Fornecem máxima disponibilidade e tempo de atividade
• Roteiam requisições dinamicamente para regiões com capacidade disponível
• Sem acréscimo de preço
• Ideal para aplicações em que a residência de dados é flexível
• Suporta apenas tráfego pay-as-you-go (throughput provisionado requer endpoints regionais)

Endpoints multirregionais:

• Roteiam requisições dinamicamente entre regiões dentro de uma área geográfica (atualmente us e eu)
• Útil quando você precisa de residência de dados dentro de uma geografia ampla, mas deseja maior disponibilidade do que uma única região
• Acréscimo de 10% no preço em relação aos endpoints globais
• Suporta apenas tráfego pay-as-you-go (throughput provisionado requer endpoints regionais)

Endpoints regionais:

• Roteiam tráfego através de regiões geográficas específicas
• Necessários para residência de dados em uma única região, mandatos rigorosos de conformidade ou throughput provisionado
• Suportam tanto pay-as-you-go quanto throughput provisionado
• O acréscimo de 10% no preço reflete os custos de infraestrutura para capacidade regional dedicada



Implementação

Usando endpoints globais (recomendado):

Defina o parâmetro region como "global" ao inicializar o 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-5",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

Usando endpoints multirregionais:

Defina o parâmetro region como um identificador multirregional: "us" para os Estados Unidos ou "eu" para a União Europeia. O SDK roteia as requisições para o endpoint multirregional correspondente (https://aiplatform.us.rep.googleapis.com ou https://aiplatform.eu.rep.googleapis.com), que balanceia dinamicamente o tráfego entre as regiões dentro dessa geografia.

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-5",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

Usando endpoints regionais:

Especifique uma região específica, como "us-east5" ou "europe-west1":

from anthropic import AnthropicVertex

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

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

message = client.messages.create(
    # Endpoints regionais específicos suportam Claude Sonnet 4.6 e anteriores; modelos mais recentes usam os endpoints globais ou multirregionais
    model="claude-sonnet-4-6",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)



Recursos adicionais

• Preços do Agent Platform: Preços de IA generativa em cloud.google.com
• Documentação dos modelos Claude: Claude no Agent Platform
• Postagem no blog do Google: Endpoint global para modelos Claude
• Detalhes de preços da Anthropic: Preços de plataformas de nuvem