Os modelos Claude no Google Cloud (gerenciados pela Anthropic) são um serviço que permite usar a plataforma de desenvolvedor Claude da Anthropic no Cloud de Confiance by S3NS. Use-o para acessar os recursos mais recentes da Anthropic, incluindo novos modelos e pré-lançamentos de pesquisa, além do console do Claude.
Nesta página, abordamos os seguintes tópicos:
- Os principais benefícios dos modelos Claude no Google Cloud (gerenciados pela Anthropic)
- Uma comparação entre os modelos Claude gerenciados pela Anthropic e pelo Google
- Como começar
- Como fazer chamadas de API
Principais vantagens
Os principais benefícios de usar os modelos do Claude no Google Cloud (gerenciados pela Anthropic) incluem:
- Acesso às inovações mais recentes: tenha acesso imediato aos modelos, recursos, pré-lançamentos de pesquisa e versões Beta mais recentes da Anthropic assim que forem lançados.
- Integração de faturamento e identidade doCloud de Confiance by S3NS : aproveite seu investimento atual noCloud de Confiance by S3NS . O serviço se integra ao Cloud Billing e ao Identity and Access Management e reduz seu compromisso do Cloud de Confiance by S3NS sujeito à Política de desconto por compromisso de uso do Google Cloud Marketplace.
- Suporte unificado: receba suporte de primeira linha do Cloud de Confiance by S3NS Suporte em problemas relacionados à plataforma de agentes, com suporte especializado de segunda linha fornecido pela Anthropic no serviço gerenciado.
- Experiência integrada da Anthropic: acesse o console do Claude para gerenciar recursos e conhecer novos recursos.
Comparar os modelos Claude gerenciados pela Anthropic e pelo Google
Os modelos Claude no Google Cloud (gerenciados pela Anthropic) e os modelos Claude (gerenciados pelo Google) na plataforma de agentes diferem em quem opera a pilha, na superfície da API, na disponibilidade de recursos e no operador de dados.
Com os modelos do Claude no Google Cloud (gerenciados pela Anthropic) (claude.googleapis.com), a API e a plataforma
subjacente são gerenciadas pela Anthropic nos próprios sistemas e são regidas
pelos Termos de Serviço Comerciais da Anthropic, incluindo os termos de tratamento de dados, em que a Anthropic é o operador de dados.
Use um modelo Claude gerenciado pelo Google se precisar de um dos seguintes:
- Inferência operada pelo Google em que o Cloud de Confiance by S3NS é o único operador de dados
- Dados e inferências que permanecem dentro do limite de segurança do Cloud de Confiance by S3NS(com VPC Service Controls, chaves de criptografia gerenciadas pelo cliente e residência de dados regional)
- Cobertura de programas de conformidade do Cloud de Confiance by S3NS (incluindo qualificação para FedRAMP High, IL4, IL5, SOC, ISO e HIPAA)
- Cotas e faturamento Cloud de Confiance by S3NS integrados
- Integrações integradas com serviços do Cloud de Confiance by S3NS , como BigQuery, Model Armor e Agent Engine.
Resumo comparativo
A tabela a seguir descreve as principais diferenças entre os modelos do Claude gerenciados pela Anthropic e pelo Google:
| Tipo de modelo | Gerenciado pela Anthropic | Gerenciada pelo Google |
|---|---|---|
| Quem opera a pilha | Anthropic | |
| Superfície da API | /v1/messages usando claude.googleapis.com |
Endpoints de previsão da Agent Platform, /v1/messages |
| Disponibilidade do recurso | Destinado a corresponder à API Claude própria | De acordo com o cronograma de lançamento da Agent Platform e do Model Garden |
| Recursos Beta | Transmitir com cabeçalhos anthropic-beta |
O suporte ao cabeçalho anthropic-beta varia de acordo com a versão do Model Garden |
| Autenticação | Cloud de Confiance by S3NS IAM. Application Default Credentials, uma conta de serviço ou gcloud auth print-access-token. Não x-api-key |
Cloud de Confiance by S3NS IAM (mesmo modelo de credencial) |
| Faturamento | Google Cloud Marketplace (em CCUs) | Cloud de Confiance by S3NS (faturamento da Agent Platform) |
| URL de base | claude.googleapis.com |
REGION-aiplatform.googleapis.com |
| Cliente do SDK | Classe de cliente específica da plataforma (AnthropicGoogleCloud) |
Cliente da Agent Platform |
| Console | Console doCloud de Confiance para IAM, métricas e monitoramento, e console do Claude (platform.claude.com, acessado por Cloud de Confiance by S3NS) |
Console doCloud de Confiance (Agent Platform e Model Garden) |
| Limites de taxa e cotas | As solicitações de cota podem ser enviadas diretamente pelo console, mas os limites de taxa e as cotas são gerenciados pela Anthropic. | Gerenciado por Cloud de Confiance by S3NS (cotas da Agent Platform) |
Comparar recursos de API compatíveis
A tabela a seguir compara o nível de suporte de vários recursos da API para os modelos do Claude gerenciados pela Anthropic e pelo Google:
| Recurso | Descrição | Gerenciado pela Anthropic | Gerenciada pelo Google |
|---|---|---|---|
| Raciocínio (estendido, adaptativo) | Raciocinar sobre um problema antes de responder, melhorando a precisão em tarefas complexas. | ||
| Armazenamento em cache de comandos (automático e explícito) | Reutilize o conteúdo repetido do comando em vez de reprocessá-lo, reduzindo custos e latência. Aplique-o automaticamente ou escolha o que será armazenado em cache. | ||
| Orçamentos de tarefas (Beta) | Gerencie os gastos com agentes de longa duração, ao Claude uma franquia de tokens para tarefas. O Claude pode priorizar e concluir o trabalho de forma mais eficiente. | ||
| Uso de ferramentas (definido pelo cliente) | Conectar-se a ferramentas externas, chamando as próprias funções, APIs e sistemas do cliente. | ||
| Citações | Retorne os trechos exatos que embasam cada afirmação para verificar as respostas e as fontes. | ||
| Um milhão de contextos, imagem/PDF (modelos compatíveis) | Processar até um milhão de tokens por solicitação (o suficiente para bases de código inteiras ou centenas de documentos). Lê imagens e PDFs. | ||
| Armazenamento em cache de comandos (cinco minutos, uma hora, automático) | Defina por quanto tempo o conteúdo em cache é mantido (5 minutos, 1 hora) para reduzir o tempo de processamento e os custos de tarefas repetitivas. | ||
| Respostas estruturadas | Garante que as respostas do Claude sempre correspondam aos esquemas JSON especificados ou às definições de ferramentas personalizadas, sem novas tentativas ou erros de análise. | ||
| Processamento em lote | Envie várias solicitações juntas para processamento assíncrono. Útil para grandes volumes de dados, otimização de custo-benefício e quando respostas imediatas não são necessárias. | Como usar a inferência em lote da Agent Platform | |
| Níveis de serviço | Oferecem diferentes níveis de serviço que permitem equilibrar disponibilidade, desempenho e custos previsíveis, com base nas necessidades do aplicativo. | Prioritário, padrão, em lote | Capacidade de Processamento Provisionada, lote |
| Edição de contexto (Beta) | Otimize custos, respeite os limites e ajude os agentes a manter o foco e funcionar por mais tempo, limpando conteúdo específico do histórico de conversas à medida que ele cresce. | ||
| Ferramentas definidas pela Anthropic | |||
| Pesquisa Google na Web | Dê acesso à Web em tempo real para pesquisar informações atuais. As respostas incluem citações. | ||
| Busca na Web | Dê acesso à Web em tempo real para extrair conteúdo de páginas da Web e PDFs específicos. | ||
| MCP remoto (Beta) | Conectar-se a ferramentas e dados externos por servidores MCP remotos, diretamente da API. | ||
| Memória | Salve e recupere informações em várias conversas para que os agentes acumulem conhecimento ao longo do tempo. | ||
| API de arquivos | Faça upload e gerencie arquivos uma vez para usar com a API, em vez de reenviar o mesmo conteúdo todas as vezes. | ||
| Uso de computador | Dê ao Claude o controle de captura de tela, mouse e teclado de um ambiente de área de trabalho para interação autônoma. | ||
| Habilidades | Recursos reutilizáveis que dão ao Claude experiência específica de domínio: fluxos de trabalho, contexto e práticas recomendadas que transformam um agente de uso geral em um especialista. | ||
| execução de código | Permita que o Claude escreva e execute códigos em um ambiente de sandbox para analisar dados, gerar arquivos e iterar soluções. | ||
| Agentes gerenciados (Beta) | Use uma estrutura de agentes pré-criada e configurável que é executada em uma infraestrutura gerenciada. Ideal para tarefas de longa duração e trabalho assíncrono. | ||
| Ferramenta Consultor (Beta) | Permita que um modelo executor mais rápido e de menor custo (Haiku, Sonnet) consulte um modelo consultor de maior inteligência (Opus) no meio da geração para receber orientação estratégica, antes que o modelo executor retome a tarefa. | ||
Primeiros passos
Para começar a usar os modelos do Claude no Google Cloud (gerenciados pela Anthropic), siga estas etapas para ativar os modelos do Claude no Google Cloud (gerenciados pela Anthropic) no seu projeto:
No console do Cloud de Confiance , acesse a página Modelos do Claude:
Na lista de opções de gerenciador, selecione Gerenciado pela Anthropic.
Se você ainda não ativou a API Claude para seu projeto, na seção Ativar a API Claude, clique em Ativar API e siga as instruções.
Na seção Comprar o produto, clique em Comprar pelo Marketplace. Você vai ser redirecionado para a página do Marketplace. É possível comprar o produto pelo preço de tabela, com desconto negociado ou por oferta privada. Depois de comprar o produto, clique em Gerenciar no Console para voltar à página do Model Garden.
Na seção Ativar o console do Claude, clique em Ativar para provisionar uma nova organização da Anthropic para seu projeto do Cloud de Confiance by S3NS . Insira um endereço de e-mail para contato único para receber o link de configuração, abra o link nessa caixa de entrada, preencha o formulário de detalhes da organização (nome da organização, tipo de entidade, país e uso pretendido) e aceite os Termos de Serviço Comerciais e a Política de Uso da Anthropic. Isso cria uma organização separada da Anthropic: chaves de API, espaços de trabalho, controles da HIPAA, retenção de dados zero (ZDR) e configurações de uma organização própria da Anthropic não são transferidos.
Usar modelos do Claude no Google Cloud (gerenciados pela Anthropic)
Depois de ativar a API Claude e comprar o produto, use os modelos do Claude no Google Cloud (gerenciados pela Anthropic) pelo console do Claude ou usando a API Claude.
Console do Claude
Para usar o console do Claude:
Conceder o papel
roles/claude.admin(administrador da plataforma Claude): para usar o console do Claude, primeiro é necessário conceder o papel do Identity and Access Management (IAM)roles/claude.admin(administrador da plataforma Claude) para o projeto.No console do Cloud de Confiance , acesse a página Modelos do Claude no Google Cloud (gerenciados pela Anthropic):
Na seção Ativar o console do Claude, clique em Abrir o console do Claude.
API Claude
É possível interagir com os modelos do Claude no Google Cloud (gerenciados pela Anthropic) usando a autenticação padrão do Cloud de Confiance by S3NS. O endpoint de API é https://claude.googleapis.com/.
Conceder o papel
roles/claude.user(Usuário da plataforma Claude): para fazer chamadas de API, primeiro é necessário conceder o papel do Identity and Access Management (IAM)roles/claude.user(Usuário da plataforma Claude) para o projeto.Autenticar com Cloud de Confiance by S3NS: se você estiver usando uma biblioteca de cliente ou a Google Cloud CLI, a autenticação será processada automaticamente. Para chamadas de API diretas, verifique se você se autenticou e pode receber um token do OAuth 2.0. É possível receber um token usando a Google Cloud CLI:
gcloud auth print-access-tokenChamar a API Messages: a estrutura da API espelha a API Messages da Anthropic. É possível fazer solicitações usando os SDKs do cliente Cloud de Confiance by S3NS da Anthropic (
AnthropicGoogleCloud) ou diretamente para endpoints com escopo de espaço de trabalho emhttps://claude.googleapis.com/v1/projects/PROJECT_ID/locations/global/workspaces/ANTHROPIC_WORKSPACE_ID/invoke/v1/messages.Veja um exemplo usando curl:
curl -X POST "https://claude.googleapis.com/v1/projects/${PROJECT_ID}/locations/global/workspaces/${ANTHROPIC_WORKSPACE_ID}/invoke/v1/messages" \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{ "model": "claude-haiku-4-5", "max_tokens": 1024, "messages": [ {"role": "user", "content": "Hello, Claude"} ] }'
Referência da API
Para uma Referência da API detalhada para mensagens, arquivos e habilidades, consulte a documentação da API Anthropic.
Para chamadas REST diretas para endpoints com escopo de espaço de trabalho (como /v1/messages,
/v1/files ou /v1/skills), use https://claude.googleapis.com/v1/projects/PROJECT_ID/locations/global/workspaces/ANTHROPIC_WORKSPACE_ID/invoke
como o URL de base antes do caminho da API Anthropic (por exemplo,
.../invoke/v1/files). Para endpoints no nível da organização (como
/v1/organizations/workspaces), use
https://claude.googleapis.com/v1/projects/PROJECT_ID/locations/global/claudeOrganization/invoke
como o URL de base.