In questo articolo
Dove: Impostazioni → Contenuti e pubblicazione → I tuoi account AI
Apri questa pagina: admin.<your-site>/settings/ai/providers (sostituisci <your-site> con l'indirizzo del tuo sito)
Prima di iniziare
- Un account Azure con una risorsa Azure OpenAI attiva.
- Almeno un modello distribuito (deployment) in quella risorsa. Azure esegue un modello solo dopo aver creato il deployment.
- I permessi necessari per visualizzare le chiavi della risorsa in Azure.
- L'accesso è riservato ai membri che gestiscono l'AI, con un accesso recente effettuato.
Procedura
- Apri il portale Azure ed entra nella tua risorsa Azure OpenAI.
- Vai su Gestione delle risorse, poi su Chiavi ed endpoint.
- Copia l'Endpoint. Ha un formato simile a
https://my-resource.openai.azure.come deve terminare con.openai.azure.como.cognitiveservices.azure.com. - Copia CHIAVE 1 (puoi tenere la CHIAVE 2 come riserva). Il sistema accetta chiavi di 32 caratteri (lettere a–f e numeri) o di 84 caratteri.
- Trova i nomi dei tuoi deployment. Nel portale Azure AI Foundry, apri la sezione Deployments della tua risorsa. Il nome del deployment è quello che hai scelto al momento della distribuzione del modello. Può essere diverso dal nome del modello stesso, come
gpt-4o-mini. - Nel pannello di amministrazione del tuo sito, apri Impostazioni → Contenuti e pubblicazione → I tuoi account IA e individua la scheda Azure OpenAI.
- Incolla l'Endpoint Azure. Aggiungi ogni deployment sotto Nomi deployment toccando Aggiungi dopo ciascuno. Inseriscine almeno uno.
- Incolla la chiave e tocca Testa e collega. Vedrai il messaggio "Controllo della chiave in corso..." e subito dopo Connesso ✓.
Da sapere
- Puoi collegare fino a due risorse Azure.
- Poiché Azure non fornisce un elenco automatico dei modelli per una chiave, il pannello mostrerà solo i deployment che inserisci a mano. Se distribuisci altri modelli, potrai aggiungerli in seguito.
- L'inserimento dei prezzi è facoltativo: serve per monitorare le spese nel pannello. Se non imposti i prezzi, l'AI non passerà automaticamente a questo account se un altro provider smette di funzionare.
- I costi vengono fatturati direttamente da Azure. Puoi controllare spese e soglie dal portale Azure. Limiti e budget per l'AI
- La chiave resta salvata esclusivamente sul tuo server: Keynate non vi ha mai accesso.
Problemi frequenti
Usa il tuo endpoint Azure OpenAI
L'endpoint deve terminare con .openai.azure.com o .cognitiveservices.azure.com. Copialo direttamente da Chiavi ed endpoint. Non puoi utilizzare un dominio personalizzato né un indirizzo IP.
Questo modello o deployment non è disponibile sul tuo account Azure OpenAI
Il nome del deployment non corrisponde. I nomi devono coincidere esattamente, incluse lettere maiuscole e minuscole. Controlla la sezione Deployments in Foundry, correggi il nome nella scheda e riprova.
Azure OpenAI ha rifiutato questa chiave
Copia nuovamente l'intera chiave. Ogni chiave appartiene a una risorsa specifica: assicurati di usare una chiave associata allo stesso endpoint che hai inserito.
Impossibile raggiungere questo indirizzo
Verifica che non ci siano errori di digitazione nell'endpoint. Se la tua risorsa limita l'accesso solo a determinate reti, il test di connessione potrebbe non riuscire. Consenti l'accesso pubblico alla risorsa o inserisci l'indirizzo del tuo server tra quelli autorizzati, poi riprova.
Azure segnala che la quota o il limite di frequenza sono stati superati
Attendi un minuto, oppure aumenta la quota del deployment direttamente su Azure.
Domande frequenti
Domande frequenti
Quale chiave devo usare, CHIAVE 1 o CHIAVE 2?
È indifferente. Ti consigliamo di usare CHIAVE 1. Se in seguito decidi di rigenerare le chiavi su Azure, puoi aggiornare il valore con Sostituisci chiave.
Perché devo inserire a mano i nomi dei deployment?
Azure permette di assegnare un nome personalizzato a ogni deployment. Il pannello di amministrazione non può individuarli in automatico, quindi è necessario indicare quali modelli utilizzare.