Claude in Amazon Bedrock

Questa guida ti guida attraverso la configurazione e l'esecuzione di chiamate API a Claude in Amazon Bedrock. Claude in Amazon Bedrock viene eseguito su infrastruttura gestita da AWS con accesso zero dell'operatore (il personale di Anthropic non ha accesso all'infrastruttura di inferenza), permettendoti di creare applicazioni sensibili interamente all'interno del confine di sicurezza AWS mentre utilizzi la stessa forma di Messages API che usi con l'API di prima parte di Anthropic.

Anteprima di ricerca

Claude in Amazon Bedrock è in anteprima di ricerca, disponibile nella regione US East (N. Virginia) us-east-1 al lancio. Contatta il tuo dirigente account Anthropic per richiedere l'accesso.

Prerequisiti

Prima di iniziare, assicurati di avere:

• Un nuovo account AWS in us-east-1. L'anteprima di ricerca richiede un account dedicato per l'isolamento. Il tuo dirigente account Anthropic invierà il tuo ID account al team Bedrock Marketplace per l'inserimento nella whitelist (in genere elaborato entro 24 ore).
• L'AWS CLI installata e configurata (facoltativo, per la gestione delle credenziali)
• Dopo l'inserimento nella whitelist, AWS invia un'email di benvenuto con il tuo ID modello e ulteriori dettagli di configurazione.

Autenticazione

Claude in Amazon Bedrock supporta tre percorsi di autenticazione. Scegli quello che meglio si adatta ai tuoi requisiti di sicurezza.

Ruolo del servizio Bedrock (consigliato)

Utilizza un ruolo del servizio Bedrock con chiavi gestite da AWS per l'accesso più sicuro e di lunga durata:

Ruoli IAM assunti

Per l'accesso federato all'identità con una sessione massima di 12 ore:

Token Bearer

Per l'accesso a breve termine senza ruoli IAM (massimo 12 ore, meno preferito):

Installa un SDK

Gli SDK client di Anthropic supportano Claude in Amazon Bedrock tramite un pacchetto o modulo specifico di Bedrock.

Effettuare la tua prima richiesta

L'endpoint segue il modello https://bedrock-mantle.{region}.api.aws/anthropic/v1/messages. A differenza dell'integrazione Bedrock legacy, questo endpoint utilizza lo streaming SSE standard e la stessa forma di corpo della richiesta dell'API di prima parte di Anthropic.

L'SDK risolve le credenziali e la regione utilizzando la precedenza standard di AWS: argomenti del costruttore, quindi variabili di ambiente (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN, AWS_REGION), quindi il file di configurazione AWS e la catena di credenziali (SSO, ruoli assunti, ruolo attività ECS, IMDS).

Modelli supportati

Gli ID modello in Claude in Amazon Bedrock portano un prefisso del provider anthropic.. Le capacità e i comportamenti del modello sono documentati nella pagina Panoramica dei modelli. Consulta la tua email di benvenuto AWS per l'ID modello esatto abilitato per il tuo account.

Disponibilità delle funzionalità

Claude in Amazon Bedrock supporta funzionalità che vengono eseguite all'interno del modello. Le funzionalità che richiedono infrastruttura gestita da Anthropic non sono disponibili.

Supportate:

• API Messages (/v1/messages)
• Prompt caching
• Extended thinking
• Tool use (strumenti definiti dal client)
• Citations
• Structured outputs
• Inferenza in-region (le richieste rimangono in una singola regione AWS)

Non supportate:

• Strumenti definiti da Anthropic (Web Search, Web Fetch, Remote MCP, Memory, Files API, Computer Use, Skills, Code Execution)
• Agent API
• Message Batches API
• Endpoint /v1/users

Regioni

L'anteprima di ricerca è disponibile solo in us-east-1 (IAD).

Quote

La quota predefinita è di 2 milioni di token di input al minuto (TPM). Puoi richiedere fino a 4 milioni di TPM di input senza approvazione aggiuntiva di Anthropic. AWS applica limiti di richieste al minuto (RPM) dal lato Bedrock; contatta il supporto AWS per gli adeguamenti RPM.

Conservazione dei dati

Tutti i dati di inferenza vengono conservati per 30 giorni nell'archiviazione AWS. Non esiste un'opzione di rinuncia alla conservazione zero-dati su questa offerta. Per i clienti standard, Anthropic può ispezionare i dati archiviati per la revisione di sicurezza e abuso. Per i clienti di livello Select, solo AWS può ispezionare i dati; Anthropic può eseguire operazioni automatizzate ma non revisioni manuali. Per i dettagli sull'idoneità al livello Select, contatta il tuo dirigente account Anthropic.

Osservabilità

Claude in Amazon Bedrock emette log sia a CloudWatch che a CloudTrail. Anthropic consiglia di conservare i log di attività su almeno una base mobile di 30 giorni per comprendere i modelli di utilizzo e investigare i potenziali problemi.

Supporto

Per il supporto dell'anteprima di ricerca, contatta [email protected]. Includi il tuo ID account AWS e l'request-id da qualsiasi risposta API non riuscita.