Prima di configurare Fuxi Code con Microsoft Foundry, assicurati di avere:
* Un abbonamento Azure con accesso a Microsoft Foundry
* Autorizzazioni RBAC per creare risorse e distribuzioni di Microsoft Foundry
* Azure CLI installato e configurato (facoltativo - necessario solo se non hai un altro meccanismo per ottenere le credenziali)
Se stai distribuendo Fuxi Code a più utenti, [fissa le versioni del tuo modello](#4-pin-model-versions) prima di implementare.
Setup
1. Provision Microsoft Foundry resource
Per prima cosa, crea una risorsa Fuxi in Azure:
1. Accedi al [portale Microsoft Foundry](https://ai.azure.com/)
2. Crea una nuova risorsa, annotando il nome della risorsa
3. Crea distribuzioni per i modelli Fuxi:
* Fuxi Opus
* Fuxi Sonnet
* Fuxi Haiku
2) Configure Azure credentials
Fuxi Code supporta tre metodi di autenticazione per Microsoft Foundry. Scegli il metodo che meglio si adatta ai tuoi requisiti di sicurezza.
**Option A: API key authentication**
1. Accedi alla tua risorsa nel portale Microsoft Foundry
2. Vai alla sezione **Endpoints and keys**
3. Copia **API Key**
4. Imposta la variabile di ambiente:
```bash theme={null}
export ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key
```
**Option B: Microsoft Entra ID authentication**
Quando né `ANTHROPIC_FOUNDRY_API_KEY` né `ANTHROPIC_FOUNDRY_AUTH_TOKEN` sono impostati, Fuxi Code utilizza automaticamente la [catena di credenziali predefinita](https://learn.microsoft.com/en-us/azure/developer/javascript/sdk/authentication/credential-chains#defaultazurecredential-overview) di Azure SDK.
Questo supporta una varietà di metodi per autenticare carichi di lavoro locali e remoti.
Negli ambienti locali, puoi comunemente utilizzare Azure CLI:
```bash theme={null}
az login
```
**Option C: Bearer token authentication**
{/* min-version: 2.1.203 */}Fuxi Code invia il valore di `ANTHROPIC_FOUNDRY_AUTH_TOKEN` su ogni richiesta come intestazione `Authorization: Bearer`. Utilizza questa opzione quando un altro processo, come un'applicazione host o uno script di accesso, ha già ottenuto un token di accesso per te. Richiede Fuxi Code v2.1.203 o successivo.
Imposta la variabile su un token bearer emesso da Microsoft Entra ID per la tua risorsa:
```bash theme={null}
export ANTHROPIC_FOUNDRY_AUTH_TOKEN=your-entra-access-token
```
`ANTHROPIC_FOUNDRY_AUTH_TOKEN` ha la precedenza su `ANTHROPIC_FOUNDRY_API_KEY` e sulla catena di credenziali predefinita.
Quando si utilizza Microsoft Foundry, il comando `/logout` non è disponibile poiché l'autenticazione viene gestita tramite le credenziali Azure.
3. Configure Fuxi Code
Imposta le seguenti variabili di ambiente per abilitare Microsoft Foundry:
```bash theme={null}
# Enable Microsoft Foundry integration
export FUXI_CODE_USE_FOUNDRY=1
# Azure resource name (replace {resource} with your resource name)
export ANTHROPIC_FOUNDRY_RESOURCE={resource}
# Or provide the full base URL:
# export ANTHROPIC_FOUNDRY_BASE_URL=https://{resource}.services.ai.azure.com/anthropic
```
4. Pin model versions
Fissa versioni specifiche del modello per ogni distribuzione. Senza fissare, gli alias di modello come `sonnet` e `opus` si risolvono nel valore predefinito integrato di Fuxi Code per Microsoft Foundry, che può essere in ritardo rispetto alla versione più recente e potrebbe non essere ancora disponibile nel tuo account. Microsoft Foundry non ha un controllo del modello all'avvio, quindi le richieste non riescono quando il valore predefinito non è disponibile. Quando crei distribuzioni Azure, seleziona una versione di modello specifica piuttosto che "aggiornamento automatico alla versione più recente".
Imposta le variabili del modello in modo che corrispondano ai nomi di distribuzione che hai creato nel passaggio 1.
Senza `ANTHROPIC_DEFAULT_OPUS_MODEL`, l'alias `opus` su Microsoft Foundry si risolve in Opus 4.6. Impostalo sull'ID di Opus 4.8 per utilizzare il modello più recente:
```bash theme={null}
export ANTHROPIC_DEFAULT_OPUS_MODEL='fuxi-opus-4-8'
export ANTHROPIC_DEFAULT_SONNET_MODEL='fuxi-sonnet-5'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='fuxi-haiku-4-5'
```
I compiti in background come la generazione del titolo della sessione utilizzano il modello piccolo/veloce, normalmente un modello della classe Haiku. Su Microsoft Foundry, Fuxi Code utilizza per impostazione predefinita il modello primario perché non tutti gli account hanno una distribuzione Haiku. Per utilizzare Haiku per i compiti in background, imposta `ANTHROPIC_DEFAULT_HAIKU_MODEL` su una distribuzione Haiku disponibile nel tuo account, come mostrato sopra.
Per gli ID dei modelli attuali e legacy, vedi [Models overview](https://platform.fuxi.com/docs/en/about-fuxi/models/overview). Vedi [Model configuration](/it/model-config#pin-models-for-third-party-deployments) per l'elenco completo delle variabili di ambiente.
[Prompt caching](/it/prompt-caching) è abilitato automaticamente. Per richiedere un TTL della cache di 1 ora invece del valore predefinito di 5 minuti, imposta la seguente variabile; le scritture della cache con un TTL di 1 ora vengono fatturate a una tariffa più elevata:
```bash theme={null}
export ENABLE_PROMPT_CACHING_1H=1
```
5. Run Fuxi Code
Con le variabili di ambiente impostate, avvia Fuxi Code dalla directory del tuo progetto:
```bash theme={null}
fuxi
```
Fuxi Code legge `FUXI_CODE_USE_FOUNDRY` e le altre variabili Microsoft Foundry dall'ambiente e si connette alla tua risorsa Azure al primo prompt. A differenza di Amazon Bedrock e Google Cloud's Agent Platform, Microsoft Foundry non ha una procedura guidata di configurazione interattiva, quindi le variabili di ambiente nei passaggi 3 e 4 sono l'unico percorso di configurazione.
Configurazione RBAC di Azure
I ruoli predefiniti `Azure AI User` e `Cognitive Services User` includono tutte le autorizzazioni necessarie per invocare i modelli Fuxi.
Per autorizzazioni più restrittive, crea un ruolo personalizzato con quanto segue:
```json theme={null}
{
"permissions": [
{
"dataActions": [
"Microsoft.CognitiveServices/accounts/providers/*"
]
}
]
}
```
Per i dettagli, vedi [Documentazione RBAC di Microsoft Foundry](https://learn.microsoft.com/en-us/azure/ai-foundry/concepts/rbac-azure-ai-foundry).
Risoluzione dei problemi
Se ricevi un errore "Failed to get token from azureADTokenProvider: ChainedTokenCredential authentication failed":
* Configura Entra ID nell'ambiente, oppure imposta `ANTHROPIC_FOUNDRY_API_KEY`.
Risorse aggiuntive
* [Documentazione di Microsoft Foundry](https://learn.microsoft.com/en-us/azure/ai-foundry/what-is-azure-ai-foundry)
* [Modelli di Microsoft Foundry](https://ai.azure.com/explore/models)
* [Prezzi di Microsoft Foundry](https://azure.microsoft.com/en-us/pricing/details/ai-foundry/)