Fornitori di IA
Registrare i servizi di IA del tenant e scegliere i modelli che le app possono usare, con le credenziali cifrate sul server.
Gli script delle app chiamano modelli di intelligenza artificiale tramite l'SDK degli script. Prima, un amministratore registra i fornitori: il servizio di IA, le credenziali di accesso e i modelli che le app possono usare.
Le credenziali restano cifrate sul server. Non arrivano mai al browser, al codice degli script, né al pacchetto di un'app esportata.
Nota
I fornitori sono del tenant: valgono per tutte le app. Ogni app sceglie, nelle sue impostazioni, quali modelli usa tra quelli autorizzati qui (vedi Modelli di IA dell'app).
Dove si trovano
Apri Impostazioni, in fondo alla barra laterale, e scegli Fornitori nel gruppo Intelligenza artificiale. Ci entrano solo gli account con profilo di amministratore.
L'elenco mostra il nome di ogni fornitore, il tipo, la connessione (l'indirizzo o la regione, mai una credenziale) e quanti modelli sono autorizzati.

I tipi di fornitore
| Tipo | Cosa si compila | Note |
|---|---|---|
| OpenAI | Chiave API; Organizzazione e Progetto sono facoltativi | I modelli di OpenAI. |
| Anthropic | Chiave API | I modelli Claude. Anthropic non ha modelli di embedding. |
| Microsoft Foundry | Indirizzo della risorsa e Chiave API | Il nome di ogni modello è il nome del deployment nella risorsa. I modelli Claude funzionano solo su un indirizzo services.ai.azure.com. |
| Amazon Bedrock | Regione, ID della chiave di accesso e Chiave di accesso segreta | La chiave IAM ha bisogno del permesso di invocare i modelli. Perché la prova elenchi i modelli, ha bisogno anche di bedrock:ListFoundationModels. |
| Google Cloud | Servizio: con la Gemini API, la Chiave API; con Vertex AI, il Progetto Google Cloud, la Località e l'Account di servizio (JSON) | L'account di servizio ha bisogno del ruolo Vertex AI User. I modelli Claude funzionano solo tramite Vertex AI. |
| OpenRouter | Chiave API; Nome dell'applicazione è facoltativo | Modelli di vari produttori con una sola chiave. |
| Compatibile con OpenAI | Indirizzo di base e, se il server la chiede, la Chiave API (facoltativa) | Ollama, LM Studio, vLLM e altri server con l'API di OpenAI. |
Attenzione
In un fornitore Compatibile con OpenAI, l'indirizzo deve essere
raggiungibile dal server della piattaforma, non dal computer di chi usa
l'app. localhost è il server della piattaforma stesso.
Creare un fornitore
- In Fornitori, fai clic su Nuovo fornitore.
- Scegli il Tipo. Il tipo non cambia dopo la creazione.
- Scrivi il Nome. Le app scelgono il fornitore con questo nome: lettere minuscole, cifre, trattini e trattini bassi. Anche il nome non cambia dopo la creazione.
- Compila i campi della Connessione, che dipendono dal tipo.
- Fai clic su Prova la connessione, nell'intestazione. La prova usa ciò che è scritto, senza salvare niente, e dice se la connessione e la chiave sono state accettate. Quando il fornitore ha un elenco di modelli, l'elenco compare in Modelli autorizzati.
- In Modelli autorizzati, seleziona i modelli che le app possono usare, oppure fai clic su Aggiungi modello e scrivi il nome. Scegli l'uso di ognuno: Testo, Embedding, Immagini, Trascrizione o Voce. In Microsoft Foundry, scegli anche il formato: Formato OpenAI o Formato Anthropic (Claude).
- Rivedi i Limiti e fai clic su Salva.

Le credenziali
- Si scrivono e non tornano mai sullo schermo. Il campo dice Impostata — scrivi per sostituirla o Da impostare.
- Lasciare il campo vuoto al salvataggio mantiene la credenziale salvata.
- Se cambi l'indirizzo (l'Indirizzo della risorsa di Microsoft Foundry o l'Indirizzo di base di un server compatibile), la credenziale salvata non va al nuovo indirizzo: devi scriverla di nuovo. Così nessuno può mandare una chiave che non vede a un server suo.
- Il registro di audit conserva quali credenziali sono state scritte, mai il valore.
I limiti
- Tempo massimo (s): quanto può durare una richiesta, da 5 a 600 secondi (120 per impostazione predefinita). Un modello di ragionamento può aver bisogno di più di un minuto.
- Richieste simultanee: quante richieste a questo fornitore vengono eseguite contemporaneamente, sommando tutte le app (4 per impostazione predefinita). Le altre aspettano il loro turno.
- Attivo: disattivato, nessuno script può usare il fornitore, e le credenziali restano salvate.

Modificare ed eliminare un fornitore
- Per modificare, fai clic sul nome del fornitore, oppure apri il menu ⋮ della riga e fai clic su Modifica.
- Per eliminare, apri il menu ⋮ della riga e fai clic su Rimuovi. La conferma compare sopra l'elenco. Le app che usano il fornitore non possono più chiamare l'IA finché non scelgono un altro fornitore.
Domande frequenti
La prova dice «Non è stato possibile collegarsi al fornitore» per un server locale. L'indirizzo deve essere raggiungibile dal server della piattaforma. Controlla l'indirizzo e la porta, e che il server accetti connessioni da fuori della sua macchina.
La prova di Microsoft Foundry non mostra modelli. In Foundry, i modelli che si chiamano sono i deployment della risorsa, che l'API non elenca. La prova conferma la chiave; scrivi i nomi dei deployment in Aggiungi modello.
Chi può vedere le chiavi? Nessuno. Lo schermo dice solo se ogni credenziale è impostata, gli script non le ricevono mai e l'esportazione di un'app non le porta con sé.