Creare un progetto per Microsoft Foundry

Annotazioni

Questo documento fa riferimento al portale di Microsoft Foundry (versione classica).

🔄 Passa alla nuova documentazione di Microsoft Foundry se si usa il nuovo portale.

Questo articolo descrive come creare un progetto Foundry in Microsoft Foundry. I progetti consentono di organizzare il lavoro, come agenti, valutazioni e file, man mano che si compilano applicazioni con stato e si esplorano nuove idee.

• Un progetto Foundry viene gestito in una risorsa Microsoft Foundry. Si tratta di un contenitore per la gestione degli accessi, il caricamento e l'integrazione dei dati e il monitoraggio. In questo modo è possibile mantenere il lavoro separato tra i casi d'uso senza dover creare risorse di Azure aggiuntive.

• Questo tipo di progetto consente di accedere alle funzionalità di intelligenza artificiale generative più recenti in Foundry, tra cui:

  • Agenti
  • Foundry SDK e API per compilare agenti e passare facilmente da un modello all'altro
  • Modelli venduti direttamente da Azure - Azure OpenAI, Mistral, xAI, DeepSeek e così via.
  • I modelli di Partner e Comunità venduti tramite Marketplace - Stabilità, Cohere, ecc.
  • Comprensione del contenuto
  • Valutazioni
  • Ottimizzazione
  • OpenAI SDK e API, inclusi i completamenti in batch e quelli archiviati
  • Strumenti di fonderia

• È necessario accedere a modelli open source o PromptFlow? Creare invece un tipo di progetto hub.

• Per altre informazioni sui diversi tipi di progetto, vedere Tipi di progetti .

Se l'organizzazione richiede configurazioni personalizzate di Azure come nomi alternativi, controlli di sicurezza o tag di costo, potrebbe essere necessario usare il portale di Azure o le opzioni dei modelli per rispettare i requisiti di Criteri di Azure dell'organizzazione.

Prerequisiti

Usare le schede seguenti per selezionare il metodo che verrà usato per creare un progetto Foundry:

Portale Fonderia

• Un account Azure con una sottoscrizione attiva. Se non ne hai uno, crea un account Azure gratuito, che include una prova gratuita.

• È necessario essere Proprietario dell'abbonamento per avere il controllo degli accessi appropriato necessario per creare la risorsa Foundry che fa da padre al progetto. Se non si ha questo accesso, chiedere all'amministratore di creare una risorsa Foundry da usare. Passare quindi a Crea più progetti nella stessa risorsa per creare il progetto.

Python SDK

• Un account Azure con una sottoscrizione attiva. Se non ne hai uno, crea un account Azure gratuito, che include una prova gratuita.
• Per ottenere il controllo di accesso appropriato necessario per usare il progetto, è necessario essere proprietario della sottoscrizione.
• Configurare l'ambiente di sviluppo
• Eseguire az login o az login --use-device-code nell'ambiente prima di eseguire il codice.

• Completare questi passaggi per avviare lo script Python:

  1. Installare i pacchetti: pip install azure-identity azure-mgmt-cognitiveservices~=13.7.0b1. Se ti trovi in una cella del notebook, usa %pip install invece.

  2. Usare pip show azure-mgmt-cognitiveservices per verificare che la versione sia 13.7 o successiva.

  3. Avviare lo script con il codice seguente per creare la connessione e le client variabili usate in questo articolo. Questo esempio crea il progetto negli Stati Uniti orientali.

     from azure.identity import DefaultAzureCredential
     from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient
     
     subscription_id = 'your-subscription-id'
     resource_group_name = 'your-resource-group-name'
     foundry_resource_name = 'your-foundry-resource-name'
     foundry_project_name = 'your-foundry-project-name'
     location = 'eastus'
     
     client = CognitiveServicesManagementClient(
         credential=DefaultAzureCredential(), 
         subscription_id=subscription_id,
         api_version="2025-04-01-preview"
     )
     

  4. (Facoltativo) Se si dispone di più account, aggiungere l'ID tenant dell'ID Microsoft Entra da usare in DefaultAzureCredential.

     DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
     

  5. (Facoltativo) Se si lavora nelle aree di Azure Government - US o Azure gestito da 21Vianet, specificare la regione a cui si vuole eseguire l'autenticazione. Questo esempio esegue l'autenticazione nell'area Azure per enti pubblici - Stati Uniti:

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

Interfaccia della riga di comando di Azure

• Un account Azure con una sottoscrizione attiva. Se non ne hai uno, crea un account Azure gratuito, che include una prova gratuita.

• Per ricevere il controllo di accesso appropriato necessario per usare il progetto, è necessario essere proprietario della sottoscrizione.

• Installare l'interfaccia della riga di comando di Azure

• Impostare i valori predefiniti per subscription e resource group.

    # Set your default subscription
    az account set --subscription "{subscription-name}"
  
    # Set default resource group
    az config set defaults.group={resource-group-name}
  

Creare un progetto Foundry

Portale Fonderia

Questi passaggi consentono di creare una nuova risorsa di Azure con impostazioni predefinite di base.

Per creare un progetto Foundry, seguire questa procedura:

1. Accedere a Microsoft Foundry. Assicurarsi che l'interruttore New Foundry sia disattivato. Questi passaggi fanno riferimento a Foundry (versione classica).

   

2. Le operazioni successive dipendono dalla posizione in cui ci si trova:

   • Se non sono presenti progetti esistenti: seguire la procedura descritta in Guida introduttiva: Introduzione a Microsoft Foundry per creare il primo progetto.

   • Se sei in un progetto: selezionare la traccia del percorso del progetto, quindi selezionare Crea nuova risorsa.

     

   • Se non si è in un progetto: selezionare Crea nuovo in alto a destra per creare un nuovo progetto Foundry

     

3. Selezionare Risorsa Foundry, e quindi selezionare Avanti.

4. Specificare un nome per il progetto e selezionare Crea. In alternativa, vedere la sezione successiva per le opzioni avanzate.

Opzioni avanzate

1. Un progetto Foundry viene creato su una risorsa Foundry. Questa risorsa viene creata automaticamente quando si crea il progetto. Selezionare un gruppo di risorse esistente da usare oppure lasciare l'impostazione predefinita per creare un nuovo gruppo di risorse.

   Suggerimento

   In particolare per iniziare, è consigliabile creare un nuovo gruppo di risorse per il progetto. Il gruppo di risorse consente di gestire facilmente il progetto e tutte le relative risorse insieme.

2. Selezionare una località o utilizzare il valore predefinito. La località è l'area in cui sono ospitate le risorse nel progetto.

3. Fare clic su Crea. Viene visualizzato lo stato di avanzamento della creazione delle risorse. Il progetto viene creato al termine del processo.

Python SDK

Per creare un progetto Foundry:

• Aggiungere questo codice per creare un progetto Fonderia, usando le variabili e la connessione client indicate nei prerequisiti.

  # Create resource
  resource = client.accounts.begin_create(
      resource_group_name=resource_group_name,
      account_name=foundry_resource_name,
      account={
          "location": location,
          "kind": "AIServices",
          "sku": {"name": "S0",},
          "identity": {"type": "SystemAssigned"},
          "properties": {
              "allowProjectManagement": True,
              "customSubDomainName": foundry_resource_name
          }
      }
  )
  
  # Wait for the resource creation to complete
  resource_result = resource.result()
  
  # Create default project
  project = client.projects.begin_create(
      resource_group_name=resource_group_name,
      account_name=foundry_resource_name,
      project_name=foundry_project_name,
      project={
          "location": location,
          "identity": {
              "type": "SystemAssigned"
          },
          "properties": {}
      }
  )
  

Interfaccia della riga di comando di Azure

1. Eseguire l'autenticazione alla sottoscrizione di Azure dall'interfaccia della riga di comando di Azure con il comando seguente:

   az login
   

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

2. Creare un gruppo di risorse, ad esempio negli Stati Uniti orientali:

   az group create --name {my_resource_group} --location eastus
   

3. Creare una risorsa Foundry

   az cognitiveservices account create \
   --name {your-foundry-resource-name} \
   --kind AIServices \
   --location eastus \
   --sku s0 \
   --allow-project-management
   

4. Creare un progetto:

   az cognitiveservices account project create \
   --name {your-foundry-resource-name} \
   --project-name {your-project-name} \
   --location eastus
   

Creare più progetti nella stessa risorsa

Creare più progetti Foundry in una risorsa esistente Foundry per abilitare la collaborazione del team e l'accesso alle risorse condivise, tra cui sicurezza, distribuzioni e strumenti connessi. Questa configurazione è ideale nelle sottoscrizioni di Azure con restrizioni in cui gli sviluppatori necessitano di capacità di esplorazione self-service all'interno della configurazione di un ambiente preconfigurato.

I progetti Foundry in quanto risorse figlio di Azure possono avere i propri controlli di accesso, ma condividono impostazioni comuni quali la sicurezza di rete, le distribuzioni e l'integrazione degli strumenti di Azure dalla risorsa padre.

Anche se non tutte le funzionalità foundry supportano ancora l'organizzazione del lavoro nei progetti, il primo progetto "predefinito" della risorsa è più potente. È possibile identificarlo in base al tag "default" nelle esperienze UX e alla proprietà della risorsa "is_default" quando si usano le opzioni di codice.

Caratteristica / Funzionalità	Progetto predefinito	Altri progetti
Inferenza del modello	✅	✅
Parchi giochi	✅	✅
Agenti	✅	✅
Valutazioni	✅	✅
Traccia	✅	✅
Insiemi di dati	✅	✅
Indexes	✅	✅
FOUNDRY SDK e API	✅	✅
Comprensione del contenuto	✅	✅
OpenAI SDK e API	✅	Risposte, file, conversazioni
Batch OpenAI, Fine-tuning, Completamenti archiviati	✅	-
Ottimizzazione della lingua	✅	✅
Ottimizzazione della sintesi vocale	✅	-
Connessioni	✅	✅

• Per aggiungere un progetto a una risorsa Foundry:

  Portale Fonderia

  Suggerimento

  Poiché è possibile personalizzare il riquadro sinistro nel portale di Microsoft Foundry, è possibile che vengano visualizzati elementi diversi rispetto a quelli illustrati in questi passaggi. Se non viene visualizzato ciò che si sta cercando, selezionare ... Altro nella parte inferiore del riquadro sinistro.

  1. Accedere a Microsoft Foundry. Assicurarsi che l'interruttore New Foundry sia disattivato. Questi passaggi fanno riferimento a Foundry (versione classica).

     

  2. Selezionare il progetto Foundry o la risorsa associata.

  3. Nel riquadro sinistro selezionare Centro gestione.

  4. Nella sezione della risorsa selezionare Panoramica.

  5. Selezionare Nuovo progetto e specificare un nome.

     

  Python SDK

  Aggiungere questo codice allo script per creare un nuovo progetto nella risorsa esistente:

  # Create additional project
  new_project_name = 'your-new-project-name'
  
  project = client.projects.begin_create(
      resource_group_name=resource_group_name,
      account_name=foundry_resource_name,
      project_name=new_project_name,
      project={
          "location": location,
          "identity": {
              "type": "SystemAssigned"
          },
          "properties": {}
      }
  )
  

  Interfaccia della riga di comando di Azure

  Usare i valori esistenti per {foundry_resource_name} per aggiungere un altro progetto alla risorsa:

   az cognitiveservices account project create \
   --name {foundry_resource_name} \
   --project-name {my_project_name} \
   --location {location}
  

• Se si elimina il progetto predefinito della risorsa Foundry, il progetto successivo creato diventerà il progetto predefinito.

Visualizzare le impostazioni del progetto

Portale Fonderia

Nella home page del progetto sono disponibili informazioni sul progetto.

• Nome: il nome del progetto viene visualizzato nell'angolo superiore sinistro.
• Sottoscrizione: sottoscrizione che ospita l'hub che ospita il progetto.
• Gruppo di risorse: gruppo di risorse che ospita l'hub che ospita il progetto.

Python SDK

# Get project
project = client.projects.get(
    resource_group_name=resource_group_name,
    account_name=foundry_resource_name,
    project_name=foundry_project_name
)
print(project)

Interfaccia della riga di comando di Azure

Per visualizzare le impostazioni per il progetto, usare il comando az cognitiveservices account connection show. Per esempio:

az cognitiveservices account connection show \
--name <my_project_name> \
--resource-group <my_resource_group>

Eliminare progetti

Portale Fonderia

1. Accedere a Microsoft Foundry. Assicurarsi che l'interruttore New Foundry sia disattivato. Questi passaggi fanno riferimento a Foundry (versione classica).
2. Aprire il progetto.
3. Selezionare Centro gestione.
4. In Risorsa selezionare Panoramica.
5. Selezionare tutti i progetti che non si vuole più mantenere.
6. Selezionare Elimina progetto.

Per eliminare la risorsa Foundry e tutti i relativi progetti:

1. Nel Centro gestione selezionare il nome della risorsa nella sezione Panoramica per passare al portale di Azure.
2. Nel portale di Azure selezionare Elimina per eliminare la risorsa e tutti i progetti associati.

Python SDK

Questo codice usa le variabili e client connection dai prerequisiti. Creare prima di tutto la connessione client:

client.projects.begin_delete(
    resource_group_name, foundry_resource_name, foundry_project_name
)

Eliminare una risorsa Foundry e tutti i relativi progetti:

# Delete projects
projects = client.projects.list(resource_group_name, foundry_resource_name)

for project in projects: 
    print("Deleting project:", project.name)
    client.projects.begin_delete(resource_group_name, foundry_resource_name,
        project_name=project.name.split('/')[-1]
    ).wait()

# Delete resource
print("Deleting resource:", foundry_resource_name)
client.accounts.begin_delete(resource_group_name, foundry_resource_name).wait()

Interfaccia della riga di comando di Azure

Esegui questo comando:

az cognitiveservices account project delete \
--name {foundry_resource_name} \
--project-name {my_project_name}

Contenuti correlati

• Guida introduttiva: Introduzione a Foundry
• Che cos'è fonderia?