Eseguire la migrazione da progetti basati su hub a progetti Foundry (versione classica)

Si applica solo a:Portale di Foundry (versione classica). Questo articolo non è disponibile per il nuovo portale foundry. Altre informazioni sul nuovo portale.

Operazioni da eseguire: creare un nuovo progetto Foundry ed eventualmente eseguire la migrazione degli agenti e delle connessioni da progetti basati su hub.

Stima del tempo: 5-10 minuti.

Prerequisiti:

• Un progetto basato su hub esistente
• Ruolo Azure: ruolo di Owner nella sottoscrizione o nel gruppo di risorse per creare risorse e progetti e assegnare ruoli al nuovo progetto.

Questa guida consente ai clienti esistenti con progetti basati su hub di eseguire la migrazione ai nuovi progetti Foundry per accedere alle funzionalità della piattaforma più recenti.

Microsoft Foundry sta passando a una piattaforma unificata distribuita come servizio, sostituendo il modello di risorse precedente che richiedeva la gestione di più servizi Azure. Man mano che i carichi di lavoro di intelligenza artificiale aumentano di più, il progetto Foundry:

• Semplifica la configurazione e la governance della piattaforma
• Migliora i flussi di lavoro che si estendono su più modelli e strumenti Foundry
• Rafforza le funzionalità di governance

Altre informazioni.

Panoramica dei nuovi progetti Foundry

I progetti foundry unificano e semplificano la composizione dei flussi di lavoro degli sviluppatori e la gestione dei blocchi predefiniti di base delle applicazioni di intelligenza artificiale. Questi blocchi predefiniti includono:

• Modelli
• Agenti e loro strumenti
• Osservabilità, sicurezza e fiducia

In precedenza, le funzionalità del progetto Foundry richiedevano la gestione di più risorse e SDK Azure per i flussi di lavoro nel back-end per comporre questi componenti.

Le nuove funzionalità includono:

• Accesso all'API Foundry progettata per creare e valutare applicazioni API-first agentiche che compongono Agenti, Valutazioni, Indici di Modelli e Dati in un'esperienza integrata e con un contratto uniforme con i fornitori di modelli.

• Microsoft Foundry SDK esegue il wrapping dell'API Foundry semplificando l'integrazione delle funzionalità nel codice indipendentemente dal fatto che l'applicazione sia incorporata in Python, C#, JavaScript/TypeScript o Java.

• Gli agenti, i modelli e le connessioni degli strumenti vengono gestiti insieme in Foundry per la gestione delle autorizzazioni, la rete, l'analisi dei costi e la configurazione dei criteri. In precedenza, alcuni strumenti e modelli erano accessibili tramite l'hub di Azure Machine Learning, richiedendo anche il provisioning di risorse aggiuntive di archiviazione e set di chiavi di sicurezza.

• Projects sono ora risorse figlio; potrebbero avere i propri controlli di amministrazione, come Azure RBAC, ma per impostazione predefinita condividono le impostazioni comuni della risorsa padre. Questo principio mira a portare gli amministratori IT fuori dal ciclo quotidiano. Dopo aver stabilito la sicurezza, la connettività e la governance delle risorse a livello di risorsa, in quanto sviluppatore è possibile creare un progetto personalizzato come cartella per organizzare il lavoro.

Come passare al progetto Foundry

Crea nuovi progetti Foundry nella risorsa di modelli Foundry a partire dal tuo progetto basato su hub. Questo processo consente ai nuovi progetti di accedere al lavoro eseguito originariamente nel progetto basato su hub

Cosa viene trasferito nei progetti Foundry

• Implementazioni di modelli
• File di dati
• Modelli ottimizzati
• Assistenti
• Archivi vettoriali

Cosa non trasferisce

• Stato dell'agente di anteprima (messaggi, thread, file) - È possibile ricreare l'agente usando il codice nel nuovo progetto
• Distribuzioni di modelli open source: i progetti Foundry non supportano attualmente questi
• Accesso al progetto hub: i progetti basati su hub non hanno accesso a nessuno dei nuovi progetti creati nella risorsa dei modelli Foundry

Nelle sezioni seguenti si apprenderà come passare da progetti basati su hub a progetti Foundry:

1. Trova la risorsa Foundry esistente
2. Creare un nuovo progetto Foundry nella risorsa di intelligenza artificiale.

Dopo aver creato il nuovo progetto, è possibile:

• (Facoltativo) Ricreare le connessioni
• (Facoltativo) Eseguire la migrazione degli agenti

1. Trova la risorsa Foundry esistente

La maggior parte degli utenti di Foundry ha già una risorsa Foundry (in precedenza denominata Servizi di intelligenza artificiale), creata in precedenza insieme al progetto basato su hub per accedere alle distribuzioni dei modelli.

2. Creare il nuovo progetto

Le nuove funzionalità, incluso il servizio Agent, sono accessibili solo tramite progetti. Ogni progetto organizza il lavoro di sviluppo come cartella per ogni caso d'uso. È possibile creare più progetti per organizzare il lavoro per i casi d'uso con requisiti di configurazione e connettività simili.

A questo punto è possibile iniziare a creare agenti con disponibilità generale e con le funzionalità più recenti. Introduzione all'uso dell'SDK o del playground di Agent.

(Facoltativo) Ricreare le connessioni

Se il progetto basato su hub usa le connessioni per accedere a strumenti, origini dati o modelli, è possibile ricreare tali connessioni nella risorsa Foundry, senza l'uso di un hub.

(Facoltativo) Eseguire la migrazione degli agenti di codice

Per passare dall'anteprima del servizio Agent al servizio Agent nella disponibilità generale nei progetti Foundry, aggiornare gli agenti di codice apportando le modifiche seguenti:

1. Installare la versione più recente del client SDK preferito.

2. Aggiornare il client del progetto per usare l'API Foundry. Anziché un stringa di connessione, si usa ora l'endpoint del progetto Foundry. Ad esempio, in Python:

   from azure.identity import DefaultAzureCredential
   from azure.ai.projects import AIProjectClient
   
   project = AIProjectClient(
     endpoint="your_project_endpoint",  # Replace with your endpoint
     credential=DefaultAzureCredential())
   

   Questo frammento di codice esegue l'autenticazione al progetto Foundry usando la libreria identity Azure e crea un'istanza client del progetto. Il endpoint è l'endpoint del progetto Foundry; il DefaultAzureCredential usa le credenziali di Azure per l'autenticazione.

   Riferimento: AIProjectClient, DefaultAzureCredential, SDK migration guide

3. Aggiornare lo script in modo da riflettere le modifiche apportate alla struttura delle classi tra i pacchetti SDK in anteprima e stabili.

Per altre informazioni, vedere la guida alla migrazione SDK.

(Facoltativo) Pulire i progetti basati su hub

Se non è più necessario accedere ai progetti basati su hub, eliminarli dalla sottoscrizione Azure.

È possibile mantenere gli hub e i progetti basati su hub nella sottoscrizione per alcuni motivi:

• Accesso alle funzionalità selezionate che non sono ancora supportate nei progetti Foundry. Vedere questa matrice di supporto.

• Casi d'uso incentrati sul training del modello di Machine Learning personalizzato. Un progetto basato su hub si basa sullo stack di Azure Machine Learning e rimane accessibile tramite Azure Machine Learning Studio, interfaccia della riga di comando o SDK.

Ulteriori informazioni

• Implementazione di Foundry nell'organizzazione

• Modelli di esempio di Bicep

• Modelli Terraform di esempio

• Guida alla migrazione di SDK