Claude in Microsoft Foundry

​

Anteprima

​

Prerequisiti

• Un abbonamento Azure attivo
• Accesso a Foundry
• L’Azure CLI installata (facoltativo, per la gestione delle risorse)

​

Installa un SDK

# Python
pip install -U "anthropic"

# Typescript
npm install @anthropic-ai/foundry-sdk

​

Provisioning

​

Provisioning delle risorse Foundry

1. Accedi al portale Foundry
2. Crea una nuova risorsa Foundry o selezionane una esistente
3. Configura la gestione dell’accesso utilizzando chiavi API emesse da Azure o Entra ID per il controllo dell’accesso basato su ruoli
4. Facoltativamente, configura la risorsa per far parte di una rete privata (Rete virtuale di Azure) per una sicurezza migliorata
5. Annota il nome della tua risorsa: lo utilizzerai come {resource} negli endpoint API (ad es. https://{resource}.services.ai.azure.com/anthropic/v1/*)

​

Creazione di distribuzioni Foundry

1. Nel portale Foundry, accedi alla tua risorsa
2. Vai a Modelli + endpoint e seleziona + Distribuisci modello > Distribuisci modello base
3. Cerca e seleziona un modello Claude (ad es. claude-sonnet-4-5)
4. Configura le impostazioni di distribuzione:
   • Nome della distribuzione: Per impostazione predefinita corrisponde all’ID del modello, ma puoi personalizzarlo (ad es. my-claude-deployment). Il nome della distribuzione non può essere modificato dopo la creazione.
   • Tipo di distribuzione: Seleziona Global Standard (consigliato per Claude)
5. Seleziona Distribuisci e attendi il completamento del provisioning
6. Una volta distribuito, puoi trovare l’URL dell’endpoint e le chiavi in Chiavi e Endpoint

​

Autenticazione

​

Autenticazione con chiave API

1. Accedi alla tua risorsa nel portale Foundry
2. Vai alla sezione Chiavi e Endpoint
3. Copia una delle chiavi API fornite
4. Utilizza l’intestazione api-key o x-api-key nelle tue richieste

import os
from anthropic import AnthropicFoundry

client = AnthropicFoundry(
    api_key=os.environ.get("ANTHROPIC_FOUNDRY_API_KEY"),
    resource_name="{resource}",
)

message = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}]
)
print(message.content)

​

Autenticazione Microsoft Entra

1. Abilita l’autenticazione Entra per la tua risorsa Foundry
2. Ottieni un token di accesso da Entra ID
3. Utilizza il token nell’intestazione Authorization: Bearer {TOKEN}

import os
from anthropic import AnthropicFoundry
from azure.identity import DefaultAzureCredential, get_bearer_token_provider

# Ottieni il token Azure Entra ID utilizzando il pattern del provider di token
token_provider = get_bearer_token_provider(
    DefaultAzureCredential(),
    "https://cognitiveservices.azure.com/.default"
)

# Crea il client con autenticazione Entra ID
client = AnthropicFoundry(
    resource_name="{resource}",  # Il tuo nome di risorsa Azure
    azure_ad_token_provider=token_provider  # Utilizza il provider di token per l'autenticazione Entra ID
)

# Effettua la richiesta
message = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}]
)
print(message.content)

​

Installa un SDK

# Python
pip install -U "anthropic"

# Typescript
npm install @anthropic-ai/foundry-sdk

​

Parametro del modello e distribuzioni

# Se hai creato una distribuzione personalizzata denominata "my-claude-deployment"
message = client.messages.create(
    model="my-claude-deployment",  # Il tuo nome di distribuzione personalizzato
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}]
)

​

ID di richiesta di correlazione

​

Funzionalità supportate

​

Funzionalità non supportate

• Admin API (endpoint /v1/organizations/*)
• Models API (/v1/models)
• Message Batch API (/v1/messages/batches)

​

Risposte API

​

ID modello API e distribuzioni

​

Monitoraggio e registrazione

• Azure Monitor: Traccia l’utilizzo dell’API, la latenza e i tassi di errore
• Azure Log Analytics: Interroga e analizza i log di richiesta/risposta
• Gestione dei costi: Monitora e prevedi i costi associati all’utilizzo di Claude

​

Risoluzione dei problemi

​

Errori di autenticazione

• Soluzione: Verifica che la tua chiave API sia corretta. Puoi ottenere una nuova chiave API dal portale Azure in Chiavi e Endpoint per la tua risorsa Claude.
• Soluzione: Se utilizzi Azure Entra ID, assicurati che il tuo token di accesso sia valido e non sia scaduto. I token in genere scadono dopo 1 ora.

• Soluzione: Il tuo account Azure potrebbe non avere i permessi necessari. Assicurati di avere il ruolo Azure RBAC appropriato assegnato (ad es. “Cognitive Services OpenAI User”).

​

Limitazione della velocità

• Soluzione: Hai superato il tuo limite di velocità. Implementa la logica di backoff esponenziale e retry nella tua applicazione.
• Soluzione: Considera di richiedere aumenti del limite di velocità tramite il portale Azure o il supporto Azure.

​

Header del limite di velocità

​

Errori di modello e distribuzione

• Soluzione: Verifica di utilizzare il nome di distribuzione corretto. Se non hai creato una distribuzione personalizzata, utilizza l’ID del modello predefinito (ad es. claude-sonnet-4-5).
• Soluzione: Assicurati che il modello/distribuzione sia disponibile nella tua regione Azure.

• Soluzione: Il parametro del modello deve contenere il tuo nome di distribuzione, che può essere personalizzato nel portale Foundry. Verifica che la distribuzione esista e sia configurata correttamente.

​

Risorse aggiuntive

• Documentazione di Foundry: ai.azure.com/catalog
• Prezzi di Azure: azure.microsoft.com/en-us/pricing
• Dettagli sui prezzi di Anthropic: Documentazione sui prezzi
• Guida all’autenticazione: Consulta la sezione autenticazione sopra
• Portale Azure: portal.azure.com