Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
L'API REST Progetti di intelligenza artificiale di Azure consente di usare i progetti di intelligenza artificiale, la risorsa centrale che riunisce modelli, dati, strumenti e dati di telemetria in Azure AI Foundry. Usando verbi HTTP familiari è possibile creare un progetto, configurare connessioni sicure ad altri servizi di Azure e recuperare endpoint pronti per l'uso per l'inferenza, gli agenti, la valutazione e altro ancora. Poiché ogni servizio collegato si trova dietro una singola stringa di connessione del progetto, le applicazioni devono conoscere solo una credenziale e un URL di base per raggiungere tutto ciò di cui hanno bisogno.
Authentication
L'API REST dei progetti di intelligenza artificiale di Azure supporta i token ID di Microsoft Entra per l'autenticazione. Le chiavi delle risorse di Azure non sono ancora supportate.
L'accesso è controllato dal controllo degli accessi in base al ruolo di Azure. Per altre informazioni, vedere Che cos'è il controllo degli accessi in base al ruolo di Azure e Controllo degli accessi in base al ruolo per Azure AI Foundry.
Controllo delle versioni
L'API REST di Azure AI Projects offre due tipi di controllo delle versioni:
- Versione in evoluzione: queste versioni seguono il formato v# (ad esempio, v1, v2, v3). Come suggerisce il nome, le versioni in evoluzione incorporano modifiche non di rilievo al contratto, ad esempio l'aggiunta di parametri facoltativi alle richieste o di nuove proprietà alle risposte. I client che utilizzano queste versioni devono essere progettati per gestire modifiche aggiuntive.
- Versione bloccata: si tratta di versioni basate sulla data che non includono modifiche al contratto. Nella tabella seguente viene illustrato il funzionamento di queste versioni.
| Sequenza temporale | Versione in evoluzione | Versione appuntata | Note |
|---|---|---|---|
| 25-Maggio | v1 | 5/1/2025 | I clienti che non desiderano apportare modifiche al contratto possono utilizzare la versione basata sulla data. I clienti che desiderano tutte le modifiche più recenti possono utilizzare la versione 1. |
| Modifica non di rilievo 1 | v1 | Non disponibile | I clienti che utilizzano la versione 1 saranno automaticamente in grado di utilizzare la modifica 1 di rilievo. |
| Modifica non di rilievo 2 | v1 | Non disponibile | I clienti che utilizzano la versione 1 saranno automaticamente in grado di utilizzare la modifica non di rilievo 2. |
| Modifica non di rilievo 3 | v1 | Non disponibile | I clienti che utilizzano la versione 1 saranno automaticamente in grado di utilizzare la modifica 3 di rilievo. |
| Intervallo di 3 mesi | v1 | 8/1/2025 | I clienti che necessitano di modifiche non di rilievo 1, 2 e 3 senza ulteriori modifiche possono utilizzare la versione 2025-08-01. |
| Modifica non di rilievo 4 | v1 | Non disponibile | I clienti che utilizzano la versione 1 saranno automaticamente in grado di utilizzare la modifica non di rilievo 4. |
| Modifica non di rilievo 5 | v1 | Non disponibile | I clienti che utilizzano la versione 1 saranno automaticamente in grado di utilizzare la modifica non di rilievo 5. |
| Modifica non di rilievo 6 | v1 | Non disponibile | I clienti che utilizzano la versione 1 saranno automaticamente in grado di utilizzare la modifica non di rilievo 6. |
| Intervallo di 3 mesi | v1 | 11/1/2025 | I clienti che necessitano di modifiche non di rilievo 4, 5 e 6 senza ulteriori modifiche possono utilizzare la versione 2025-11-01. |
| (ipotetico) Breaking Change nel gennaio 2025 | v2 | 1/1/2026 | Poiché è presente una modifica di rilievo, i clienti dovranno passare alla versione v2 o alla versione 2026-01-01 per accedere alle modifiche. |
| Annuncio di deprecazione | Tutte le versioni precedenti saranno contrassegnate come deprecate: * 2025-05-01 * 2025-08-01 * 2025-11-01 * v1 Saranno ritirati dopo un anno. |
||
| Modifica non di rilievo 7 | v2 | Non disponibile | I clienti che utilizzano la versione 2 saranno automaticamente in grado di utilizzare la modifica non di rilievo 7. |
| Modifica non di rilievo 8 | v2 | Non disponibile | I clienti che utilizzano la versione 2 saranno automaticamente in grado di utilizzare la modifica non di rilievo 8. |
| Modifica non di rilievo 9 | v2 | Non disponibile | I clienti che utilizzano la versione 2 saranno automaticamente in grado di utilizzare la modifica non di rilievo 9. |
| Intervallo di 3 mesi | v2 | 3/1/2026 | I clienti che necessitano di modifiche non di rilievo 7, 8 e 9 senza ulteriori modifiche possono utilizzare la versione 2026-03-01. |
Modifiche non di rilievo
Le modifiche non di rilievo sono definite come segue:
- Aggiunta di nuove risorse (URL) all'API REST e agli SDK
- Aggiunta di nuovi parametri API facoltativi
- Aggiunta di nuove proprietà agli oggetti di risposta JSON o ai dati degli eventi
- Modifica dell'ordine delle proprietà in un oggetto risposta JSON
- Modifica della lunghezza o del formato di stringhe opache, come identificatori di risorse e UUID
- Aggiunta di nuovi tipi di eventi (in streaming o nell'API in tempo reale)