Claude models on Google Cloud (Anthropic managed) è un servizio che ti consente di utilizzare la piattaforma per sviluppatori Claude di Anthropic in Cloud de Confiance by S3NS. Utilizzalo per accedere alle funzionalità più recenti di Anthropic, inclusi i nuovi modelli e le anteprime di ricerca, nonché alla console Claude.
Questa pagina tratta i seguenti argomenti:
- I vantaggi principali dei modelli Claude su Google Cloud (gestiti da Anthropic)
- Un confronto tra i modelli Claude gestiti da Anthropic e quelli gestiti da Google
- Come iniziare
- Come effettuare chiamate API
Vantaggi principali
I vantaggi principali dell'utilizzo dei modelli Claude su Google Cloud (gestiti da Anthropic) includono:
- Accesso alle ultime innovazioni: ottieni l'accesso immediato ai modelli, alle funzionalità, alle anteprime di ricerca e alle versioni beta più recenti di Anthropic non appena vengono rilasciati.
- Integrazione di fatturazione e identità diCloud de Confiance by S3NS : sfrutta il tuo investimento esistente inCloud de Confiance by S3NS . Il servizio si integra con la fatturazione Cloud e Identity and Access Management e riduce il tuo impegno Cloud de Confiance by S3NS in base alle norme relative al drawdown degli impegni in Google Cloud Marketplace.
- Assistenza unificata: ricevi assistenza di prima linea dall'assistenza Cloud de Confiance by S3NS per i problemi relativi alla piattaforma Agent, con assistenza di seconda linea specializzata fornita da Anthropic sul servizio gestito.
- Esperienza integrata di Anthropic: accedi alla console Claude per gestire le risorse ed esplorare nuove funzionalità.
Confronta i modelli Claude gestiti da Anthropic e da Google
I modelli Claude su Google Cloud (gestiti da Anthropic) e i modelli Claude (gestiti da Google) su Agent Platform differiscono per chi gestisce lo stack, la superficie dell'API, la disponibilità delle funzionalità e il responsabile del trattamento dei dati.
Con i modelli Claude su Google Cloud (gestiti da Anthropic) (claude.googleapis.com), l'API e la piattaforma sottostante sono gestite da Anthropic sui propri sistemi e sono regolate dai Termini di servizio commerciali di Anthropic, inclusi i termini per il trattamento dei dati, in cui Anthropic è il responsabile del trattamento dei dati.
Dovresti utilizzare un modello Claude gestito da Google se hai bisogno di una delle seguenti funzionalità:
- Inferenza gestita da Google in cui Cloud de Confiance by S3NS è l'unico responsabile del trattamento dei dati
- Dati e inferenze che rimangono all'interno del perimetro di sicurezza di Cloud de Confiance by S3NS(con Controlli di servizio VPC, chiavi di crittografia gestite dal cliente e residenza dei dati regionale)
- Copertura nell'ambito dei programmi di conformità di Cloud de Confiance by S3NS (tra cui idoneità a FedRAMP High, IL4, IL5, SOC, ISO e HIPAA)
- Quote e fatturazione Cloud de Confiance by S3NS integrate
- Integrazioni integrate con servizi Cloud de Confiance by S3NS come BigQuery, Model Armor e Agent Engine.
Confronto riepilogativo
La seguente tabella illustra le principali differenze tra i modelli Claude gestiti da Anthropic e quelli gestiti da Google:
| Tipo di modello | Anthropic-managed | Gestita da Google |
|---|---|---|
| Chi gestisce lo stack | Anthropic | |
| Piattaforma API | /v1/messages utilizzando claude.googleapis.com |
Endpoint di previsione Agent Platform, /v1/messages |
| Disponibilità della funzionalità | Progettata per corrispondere all'API Claude proprietaria | In base al programma delle pubblicazioni di Agent Platform e Model Garden |
| Funzionalità beta | Pass-through con intestazioni anthropic-beta |
Il supporto dell'intestazione anthropic-beta varia in base alla release di Model Garden |
| Autenticazione | Cloud de Confiance by S3NS IAM. Credenziali predefinite dell'applicazione, un account di servizio o gcloud auth print-access-token. Nessuna x-api-key |
Cloud de Confiance by S3NS IAM (stesso modello di credenziali) |
| Fatturazione | Google Cloud Marketplace (in CCU) | Cloud de Confiance by S3NS (Fatturazione di Agent Platform) |
| URL di base | claude.googleapis.com |
REGION-aiplatform.googleapis.com |
| Client SDK | Classe client specifica per la piattaforma (AnthropicGoogleCloud) |
Client Agent Platform |
| Console | ConsoleCloud de Confiance per IAM, metriche e monitoraggio e console Claude (platform.claude.com, accessibile tramite Cloud de Confiance by S3NS) |
ConsoleCloud de Confiance (Agent Platform e Model Garden) |
| Limiti di frequenza e quote | Le richieste di quota possono essere inviate direttamente utilizzando la console, ma i limiti di frequenza e le quote sono gestiti da Anthropic | Gestito da Cloud de Confiance by S3NS (quote di Agent Platform) |
Confronta le funzionalità delle API supportate
La tabella seguente mette a confronto il livello di assistenza per varie funzionalità dell'API per i modelli Claude gestiti da Anthropic e da Google:
| Funzionalità | Descrizione | Anthropic-managed | Gestita da Google |
|---|---|---|---|
| Ragionamento (esteso, adattivo) | Ragionare su un problema prima di rispondere, migliorando l'accuratezza nelle attività complesse. | ||
| Memorizzazione nella cache dei prompt (automatica ed esplicita) | Riutilizza i contenuti dei prompt ripetuti anziché rielaborarli, riducendo costi e latenza. Applica l'impostazione automaticamente o scegli i contenuti da memorizzare nella cache. | ||
| Budget delle attività (beta) | Gestisci la spesa per gli agenti a lunga esecuzione, assegnando a Claude un'indennità di token per le attività. Claude può stabilire meglio le priorità e concludere il lavoro. | ||
| Utilizzo degli strumenti (definito dal client) | Connettersi a strumenti esterni, chiamando funzioni, API e sistemi del cliente. | ||
| Citazioni | Restituisce i passaggi esatti che supportano ogni affermazione, per verificare le risposte e mostrare le fonti. | ||
| Contesto di un milione, immagini/PDF (modelli supportati) | Gestisci fino a un milione di token per richiesta (sufficienti per interi codebase o centinaia di documenti). Legge immagini e PDF. | ||
| Prompt caching (5 minuti, 1 ora, automatico) | Definisci per quanto tempo i contenuti memorizzati nella cache vengono conservati (5 minuti, 1 ora) per ridurre i tempi di elaborazione e i costi per le attività ripetitive. | ||
| Output strutturati | Garantisci che le risposte di Claude corrispondano sempre agli schemi JSON specificati o alle definizioni degli strumenti personalizzati, senza tentativi ripetuti o errori di analisi. | ||
| Elaborazione batch | Invia più richieste contemporaneamente per l'elaborazione asincrona. Utile per grandi volumi di dati, per ottimizzare l'efficienza in termini di costi e quando non sono richieste risposte immediate. | Utilizzo dell'inferenza batch di Agent Platform | |
| Livelli di servizio | Offri diversi livelli di servizio che consentono di bilanciare disponibilità, prestazioni e costi prevedibili, in base alle esigenze dell'applicazione. | Priority, Standard, Batch | Throughput riservato, batch |
| Modifica del contesto (beta) | Ottimizza i costi, rispetta i limiti e aiuta gli agenti a rimanere concentrati e a funzionare più a lungo, cancellando contenuti specifici dalla cronologia delle conversazioni man mano che cresce. | ||
| Strumenti definiti da Anthropic | |||
| Ricerca Google | Fornisci l'accesso al web in tempo reale per cercare informazioni aggiornate. Le risposte includono citazioni. | ||
| Web Fetch | Fornisci l'accesso al web in tempo reale per estrarre contenuti da pagine web e PDF specifici. | ||
| MCP remoto (beta) | Connettiti a strumenti e dati esterni tramite server MCP remoti, direttamente dall'API. | ||
| Memoria | Salva e recupera le informazioni tra le conversazioni, in modo che gli agenti acquisiscano conoscenze nel tempo. | ||
| API Files | Carica e gestisci i file una sola volta per utilizzarli con l'API, invece di inviare nuovamente gli stessi contenuti ogni volta. | ||
| Uso del computer | Consenti a Claude di controllare screenshot, mouse e tastiera di un ambiente desktop per un'interazione autonoma. | ||
| Skill | Risorse riutilizzabili che forniscono a Claude competenze specifiche per il dominio: workflow, contesto e best practice che trasformano un agente per uso generico in uno specialista. | ||
| esegui il codice | Consenti a Claude di scrivere ed eseguire codice in un ambiente sandbox per analizzare i dati, generare file e ripetere le soluzioni. | ||
| Managed Agents (beta) | Utilizza un agent harness predefinito e configurabile che viene eseguito in un'infrastruttura gestita. Ideale per attività di lunga durata e lavoro asincrono. | ||
| Strumento Advisor (beta) | Consenti a un modello esecutore più veloce e a basso costo (Haiku, Sonnet) di consultare un modello advisor con un'intelligenza superiore (Opus) a metà generazione per ricevere indicazioni strategiche, prima che il modello esecutore riprenda l'attività. | ||
Inizia
Per iniziare a utilizzare i modelli Claude su Google Cloud (Anthropic managed), segui questi passaggi per abilitare i modelli Claude su Google Cloud (Anthropic managed) per il tuo progetto:
Nella console Cloud de Confiance , vai alla pagina Modelli Claude:
Nell'elenco delle opzioni di gestione, seleziona Gestito da Anthropic.
Se non hai ancora abilitato l'API Claude per il tuo progetto, nella sezione Abilita l'API Claude, fai clic su Abilita API e segui le istruzioni.
Nella sezione Acquista il prodotto, fai clic su Acquista tramite Marketplace. Si aprirà la pagina del Marketplace. Puoi scegliere di acquistare il prodotto al prezzo di listino o tramite uno sconto negoziato o un'offerta privata. Dopo aver acquistato il prodotto, fai clic su Gestisci nella console per tornare alla pagina di Model Garden.
Nella sezione Attiva la console Claude, fai clic su Attiva per eseguire il provisioning di una nuova organizzazione Anthropic per il tuo progetto Cloud de Confiance by S3NS . Inserisci un indirizzo email di contatto una tantum per ricevere il link di configurazione, apri il link dalla posta in arrivo, compila il modulo con i dettagli dell'organizzazione (nome dell'organizzazione, tipo di persona giuridica, paese e utilizzo previsto) e accetta i Termini di servizio commerciali e le norme di utilizzo di Anthropic. Tieni presente che in questo modo viene creata un'organizzazione Anthropic separata: le chiavi API, gli spazi di lavoro, i controlli HIPAA, la conservazione dei dati zero (ZDR) e le impostazioni di un'organizzazione Anthropic proprietaria esistente non vengono trasferiti.
Utilizza i modelli Claude su Google Cloud (gestiti da Anthropic)
Dopo aver abilitato l'API Claude e acquistato il prodotto, puoi utilizzare i modelli Claude su Google Cloud (gestito da Anthropic) tramite la console Claude o l'API Claude.
Console Claude
Per utilizzare la console Claude:
Concedi il ruolo
roles/claude.admin(Claude Platform Admin): per utilizzare la console Claude, devi prima concedere il ruolo IAM (Identity and Access Management)roles/claude.admin(Claude Platform Admin) per il progetto.Nella console Cloud de Confiance , vai alla pagina Modelli Claude su Google Cloud (gestiti da Anthropic):
Nella sezione Attiva la console Claude, fai clic su Apri la console Claude.
API Claude
Puoi interagire con i modelli Claude su Google Cloud (gestiti da Anthropic) utilizzando l'autenticazione Cloud de Confiance by S3NS
standard. L'endpoint API è https://claude.googleapis.com/.
Concedi il ruolo
roles/claude.user(Claude Platform User): per effettuare chiamate API, devi prima concedere il ruolo Identity and Access Management (IAM)roles/claude.user(Claude Platform User) per il progetto.Esegui l'autenticazione con Cloud de Confiance by S3NS: se utilizzi una libreria client o Google Cloud CLI, l'autenticazione viene gestita automaticamente. Per le chiamate API dirette, assicurati di aver eseguito l'autenticazione e di poter ottenere un token OAuth 2.0. Puoi ottenere un token utilizzando Google Cloud CLI:
gcloud auth print-access-tokenChiama l'API Messages: la struttura dell'API rispecchia l'API Anthropic Messages. Puoi effettuare richieste utilizzando gli SDK client di Anthropic Cloud de Confiance by S3NS(
AnthropicGoogleCloud) o direttamente agli endpoint con ambito workspace inhttps://claude.googleapis.com/v1/projects/PROJECT_ID/locations/global/workspaces/ANTHROPIC_WORKSPACE_ID/invoke/v1/messages.Ecco un esempio di utilizzo di 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"} ] }'
Riferimento API
Per un riferimento API dettagliato per messaggi, file e skill, consulta la documentazione dell'API Anthropic.
Per le chiamate REST dirette agli endpoint con ambito workspace (come /v1/messages,
/v1/files o /v1/skills), utilizza https://claude.googleapis.com/v1/projects/PROJECT_ID/locations/global/workspaces/ANTHROPIC_WORKSPACE_ID/invoke
come URL di base prima del percorso dell'API Anthropic (ad esempio,
.../invoke/v1/files). Per gli endpoint a livello di organizzazione (come
/v1/organizations/workspaces), utilizza
https://claude.googleapis.com/v1/projects/PROJECT_ID/locations/global/claudeOrganization/invoke
come URL di base.