Creare un progetto in Studio AI della piattaforma Azure

Questo articolo descrive come creare un progetto di Studio AI della piattaforma Azure. Un progetto viene usato per organizzare il lavoro e salvare lo stato durante la creazione di app di intelligenza artificiale personalizzate.

I progetti sono ospitati da un hub di Studio AI della piattaforma Azure che offre sicurezza di livello aziendale e un ambiente collaborativo. Per altre informazioni sui progetti e sul modello di risorse, vedere Hub di Studio AI della piattaforma Azure.

Prerequisiti

• Una sottoscrizione di Azure. Se non hai una sottoscrizione di Azure, crea un account gratuito.
• Un hub di Studio AI della piattaforma Azure. Se non si ha un hub, vedere Come creare e gestire un hub di Azure AI Studio.

Creare un progetto

Usare le schede seguenti per selezionare il metodo da usare per creare un progetto:

Studio AI della piattaforma Azure

Per creare un progetto in Studio AI della piattaforma Azure, seguire questa procedura:

1. Passare alla pagina Home di Studio AI della piattaforma Azure.

2. Selezionare + Nuovo progetto.

3. Immettere un nome per il progetto.

4. Selezionare dall'elenco a discesa un hub per ospitare il progetto. Per informazioni sulla relazione tra hub e progetti, vedere la documentazione Panoramica di hub e progetti. Se non si dispone ancora di un hub, selezionare Crea un nuovo hub.

   

   Nota

   Per creare un hub, sono necessarie le autorizzazioni di Proprietario o Collaboratore per il gruppo di risorse selezionato. È consigliabile condividere un hub con il team. In questo modo, è possibile condividere configurazioni come le connessioni dati con tutti i progetti e gestire centralmente le impostazioni di sicurezza e la spesa. Per altre opzioni relative alla creazione un hub, vedere l'articolo su come creare e gestire un hub di Studio AI della piattaforma Azure. Un nome di progetto deve essere univoco tra i progetti che condividono lo stesso hub.

5. Se si intende creare un nuovo hub, immettere un nome.

6. Selezionare la sottoscrizione di Azure nell'elenco a discesa Sottoscrizione. Scegliere una sottoscrizione di Azure specifica per il progetto per motivi di fatturazione, di accesso o amministrativi. Ad esempio, ciò concede agli utenti e alle entità servizio l'accesso a livello di sottoscrizione al progetto.

7. Per creare un nuovo gruppo di risorse, lasciare il Gruppo di risorse come predefinito. In alternativa, è possibile selezionare un gruppo di risorse esistente dall'elenco a discesa.

   Suggerimento

   Soprattutto per iniziare, è consigliabile creare un nuovo gruppo di risorse per il progetto. In questo modo, è possibile gestire facilmente il progetto e tutte le relative risorse in contemporanea. Quando si crea un progetto, nel gruppo di risorse vengono create diverse risorse, tra cui un hub, un registro contenitori e un account di archiviazione.

8. Immettere la posizione dell'hub e quindi selezionare Avanti. La posizione è l'area in cui è ospitato l'hub. La posizione dell'hub corrisponde anche a quella del progetto. La disponibilità dei Servizi di Azure AI varia in base all'area. Ad esempio, alcuni modelli potrebbero non essere disponibili in determinate aree.

9. Selezionare una risorsa di Servizi di Azure Al (incluso OpenAI di Azure) esistente nell'elenco a discesa o crearne una nuova.

   

10. Nella pagina Rivedere e completare viene visualizzato il nome della risorsa di Servizi di Azure Al, oltre ad altre impostazioni da esaminare.

    

11. Rivedere i dettagli del progetto e quindi selezionare Crea un progetto. Viene visualizzato lo stato di avanzamento dell'operazione di creazione della risorsa. Il progetto viene creato al termine di tale processo.

    

Dopo aver creato un progetto, è possibile accedere al playground, agli strumenti e ad altri asset nel riquadro di spostamento a sinistra.

Python SDK

1. Installare Python come descritto nella Guida introduttiva all'SDK.

2. Installare l'SDK di Azure Machine Learning v2.

3. Installare azure-identity: pip install azure-identity. Se si trova in una cella del notebook, usare %pip install azure-identity.

4. Fornire i dettagli della sottoscrizione:

   # Enter details of your subscription
   subscription_id = "<SUBSCRIPTION_ID>"
   resource_group = "<RESOURCE_GROUP>"

5. Ottenere un handle per la sottoscrizione. Tutto il codice Python in questo articolo usa ml_client:

   # get a handle to the subscription
   
   from azure.ai.ml import MLClient
   from azure.identity import DefaultAzureCredential
   
   ml_client = MLClient(DefaultAzureCredential(), subscription_id, resource_group)

6. (Facoltativo) Se si dispone di più account, aggiungere l'ID tenant del Microsoft Entra ID da usare in DefaultAzureCredential. Trovare l'ID tenant dal portale di Azure in Microsoft Entra ID, Identità esterne.

   DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
   

7. (Facoltativo) Se si lavora nelle aree Azure per enti pubblici - Stati Uniti o Azure Cina (21Vianet), specificare l'area in cui si desidera eseguire l'autenticazione. È possibile specificare l'area con DefaultAzureCredential. Nell'esempio seguente si illustra l'autenticazione nell'area Azure per enti pubblici - Stati Uniti:

   from azure.identity import AzureAuthorityHosts
   DefaultAzureCredential(authority=AzureAuthorityHosts.AZURE_GOVERNMENT)
   

8. Usare il codice seguente per creare un progetto da un hub creato in precedenza dall'utente o dall'amministratore. Sostituire i valori stringa di esempio con i propri valori:

   from azure.ai.ml.entities import Project
   
   my_project_name = "myexampleproject"
   my_display_name = "My Example Project"
   hub_name = "myhubname" # Azure resource manager ID of the hub
   hub_id=f"/subscriptions/{subscription_id}/resourceGroups/{resource_group}/providers/Microsoft.MachineLearningServices/workspaces/{hub_name}"
   
   my_project = Project(name=my_project_name, 
                   display_name=my_display_name,
                   hub_id=hub_id)
   
   created_project = ml_client.workspaces.begin_create(workspace=my_project).result()
   

Interfaccia della riga di comando di Azure

1. Se non è stata installata l'interfaccia della riga di comando di Azure e l'estensione Machine Learning, seguire la procedura descritta nell'articolo Installare e configurare l'estensione Machine Learning.

2. Per eseguire l'autenticazione alla sottoscrizione di Azure dall'interfaccia della riga di comando di Azure, usare il comando seguente:

   az login
   

   Per altre informazioni sull'autenticazione, vedere Metodi di autenticazione.

3. Dopo aver installato e autenticato l'estensione nella sottoscrizione di Azure, usare il comando seguente per creare un nuovo progetto di Azure AI Studio da un hub di Azure AI Studio esistente:

   az ml workspace create --kind project --hub-id {my_hub_ARM_ID} --resource-group {my_resource_group} --name {my_project_name}
   

Visualizzare le impostazioni del progetto

Studio AI della piattaforma Azure

Nella pagina Impostazioni del progetto è possibile trovare informazioni sul progetto, ad esempio il nome del progetto, la descrizione e l'hub che ospita il progetto. È anche possibile trovare l'ID progetto, usato per identificare il progetto tramite SDK o API.

• Nome: il nome del progetto corrisponde al progetto selezionato nel pannello sinistro.
• Hub: hub che ospita il progetto.
• Posizione: la posizione dell'hub che ospita il progetto. Per le posizioni supportate, vedere Aree di Studio AI della piattaforma Azure.
• Sottoscrizione: la sottoscrizione che ospita l'hub che ospita il progetto.
• Gruppo di risorse: il gruppo di risorse che ospita l'hub che ospita il progetto.

Selezionare Gestisci nel portale di Azure per passare alle risorse del progetto nel portale di Azure.

Python SDK

Per gestire o usare il nuovo progetto, includerlo in MLClient:

ml_client = MLClient(workspace_name=my_project_name, resource_group_name=resource_group, subscription_id=subscription_id,credential=DefaultAzureCredential())

Interfaccia della riga di comando di Azure

Per visualizzare le impostazioni per il progetto, usare il comando az ml workspace show. Ad esempio:

az ml workspace show --name {my_project_name} --resource-group {my_resource_group}

Accedere alle risorse del progetto

Le configurazioni comuni nell'hub vengono condivise con il progetto, incluse connessioni, istanze di calcolo e accesso alla rete, in modo da poter iniziare subito a sviluppare.

Inoltre, alcune risorse sono accessibili solo dagli utenti nell'area di lavoro del progetto:

1. Componenti tra cui set di dati, flussi, indici, endpoint API modello distribuiti (aperti e serverless).

2. Connessioni create dall'utente in "impostazioni del progetto".

3. Contenitori BLOB di Archiviazione di Azure e una condivisione file per il caricamento di dati all'interno del progetto. Accedere all'archiviazione usando le connessioni seguenti:

   Connessione dati	Posizione di archiviazione	Scopo
   workspaceblobstore	{project-GUID}-azureml-blobstore	Contenitore predefinito per i caricamenti di dati
   workspaceartifactstore	{project-GUID}-azureml	Archivia componenti e metadati per il progetto, ad esempio pesi del modello
   workspacefilestore	{project-GUID}-code	Ospita i file creati nel calcolo e usando il flusso di richiesta

Nota

Quando l'account di archiviazione ha l’accesso alla rete pubblica impostato su disabilitato, le connessioni di archiviazione non vengono create direttamente con il progetto. Queste vengono invece create quando un primo utente accede a AI Studio tramite una connessione di rete privata. Risolvere i problemi relativi alle connessioni di archiviazione

Contenuto correlato

• Distribuire un'app Web della chat aziendale
• Altre informazioni su Studio AI della piattaforma Azure
• Ulteriori informazioni sugli hub