Guida introduttiva: Configura le risorse di Microsoft Foundry

• Installare il interfaccia della riga di comando di Azure versione 2.80.0 o successiva. Controllare la versione con az versioned eseguire az upgrade se è necessaria una versione più recente.

  La versione 2.80.0 ha aggiunto i az cognitiveservices account project comandi usati da questi passaggi. In una versione precedente, i comandi hanno esito negativo con unrecognized arguments o 'project' is misspelled or not recognized by the system.

• Accedere a Azure:

  az login
  

• Accesso al portale Microsoft Foundry.

1. Creare un gruppo di risorse o usarne uno esistente. Ad esempio, creare my-foundry-rg in eastus:

   az group create --name my-foundry-rg --location eastus
   

   Verificare che il gruppo di risorse esista:

   az group show --name my-foundry-rg --query properties.provisioningState --output tsv
   

   L'output mostra Succeeded.

2. Creare la risorsa Foundry con la gestione dei progetti abilitata. Ad esempio, creare my-foundry-resource nel my-foundry-rg gruppo di risorse:

   az cognitiveservices account create \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --kind AIServices \
       --sku S0 \
       --location eastus \
       --custom-domain my-foundry-resource \
       --assign-identity \
       --allow-project-management true
   

   Usare questi valori:

   Parametro	Finalità
   --assign-identity	Crea l'identità gestita richiesta dalla gestione del progetto. Senza di esso, la creazione del progetto ha esito negativo con un errore che indica che è necessario abilitare un'identità gestita nella risorsa.
   --allow-project-management	Abilita la gestione dei progetti. Non è possibile modificare questa impostazione dopo aver creato la risorsa.
   --custom-domain	Deve essere univoco a livello globale. Se my-foundry-resource viene eseguita, il comando ha esito negativo con CustomDomainInUse. Scegliere un nome diverso ed eseguire di nuovo il comando.

3. Creare un progetto. Ad esempio, creare my-foundry-project in my-foundry-resource:

   az cognitiveservices account project create \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --project-name my-foundry-project \
       --location eastus
   

4. Verificare che sia stato effettuato il provisioning della risorsa:

   az cognitiveservices account show \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --query properties.provisioningState --output tsv
   

   L'output deve mostrare Succeeded. Se l'output mostra uno stato diverso, controllare le autorizzazioni, la disponibilità dell'area e le quote delle risorse. Per altre informazioni, vedere Creare una risorsa multiservizio.

5. Verificare che il progetto sia stato creato:

   az cognitiveservices account project show \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --project-name my-foundry-project \
       --query properties.provisioningState --output tsv
   

   L'output deve mostrare Succeeded. Se il comando non va a buon fine e viene visualizzato un messaggio che indica che è necessario abilitare un'identità gestita, verifica di aver creato la risorsa con --assign-identity.

Riferimento: az cognitiveservices account project

1. Accedere a Microsoft Foundry. Assicurarsi che l'interruttore New Foundry sia attivato. Questi passaggi fanno riferimento a Foundry (nuovo).These steps refer to Foundry (new).

   

2. Creare un progetto.

   • Se si tratta del primo uso di Foundry, verrà chiesto di creare o cercare un progetto per continuare. Selezionare Crea un nuovo progetto nell'elenco a discesa. Screenshot del portale Foundry che mostra l'elenco a discesa per la selezione del progetto con l'opzione Crea nuovo progetto evidenziata.
   • Se è già stato caricato un progetto, selezionarne il nome nell'angolo superiore sinistro e quindi selezionare Crea nuovo progetto.

3. Immettere un nome di progetto, ad esempio my-foundry-project.

4. Selezionare Opzioni avanzate per configurare il gruppo di risorse e il percorso:

   • Gruppo di risorse: creare un nuovo gruppo di risorse o selezionarne uno esistente. Se si crea un nuovo gruppo di risorse, è possibile gestire più facilmente il progetto e tutte le relative risorse insieme.
   • Località: selezionare l'area più vicina al team.

5. Selezionare Crea progetto.

   Attendere la creazione del progetto. Quando viene visualizzata la pagina di panoramica del progetto, il progetto è pronto.

1. Elencare i modelli disponibili nell'area in modo da poter confermare il nome e la versione del modello:

   az cognitiveservices model list \
       --location eastus \
       --query "[?model.name=='gpt-5-mini'].{version:model.version,skus:join(',',model.skus[].name)}" \
       --output table
   

2. Distribuisci il modello:

   az cognitiveservices account deployment create \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --deployment-name gpt-5-mini \
       --model-name gpt-5-mini \
       --model-version "2025-08-07" \
       --model-format OpenAI \
       --sku-capacity 10 \
       --sku-name GlobalStandard
   

   Se il comando non riesce con DeploymentModelNotSupported, il modello, la versione o lo SKU non è disponibile nell'area. Usare l'output del passaggio precedente per scegliere una combinazione supportata.

3. Verificare che la distribuzione sia riuscita:

   az cognitiveservices account deployment show \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --deployment-name gpt-5-mini \
       --query properties.provisioningState --output tsv
   

   L'output mostra Succeeded quando la distribuzione è pronta.

Riferimento: az cognitiveservices account deployment

1. Selezionare Esplora nella barra di navigazione in alto a destra, quindi Modelli nel riquadro sinistro.
2. Cerca gpt-5-mini.
3. Selezionare Distribuisci>impostazioni predefinite per aggiungerlo al progetto.
4. Prendere nota del nome della distribuzione, ad esempio gpt-5-mini. Il vostro team ha bisogno di questo nome per usare il modello.

Ottenere l'endpoint del progetto:

az cognitiveservices account project show \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --project-name my-foundry-project \
    --query 'properties.endpoints."AI Foundry API"' --output tsv

L'output è l'endpoint del progetto, nel formato https://my-foundry-resource.services.ai.azure.com/api/projects/my-foundry-project. Usa questo valore in altre guide rapide e tutorial.

1. Accedere a Microsoft Foundry usando l'account Azure.
2. Selezionare il progetto.
3. Trova l'endpoint del progetto nella schermata iniziale del progetto.
4. Copiare il valore dell'endpoint. Questo valore viene usato in altre guide introduttive ed esercitazioni.

1. Ottenere l'ID risorsa del progetto:

   PROJECT_ID=$(az cognitiveservices account project show \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --project-name my-foundry-project \
       --query id -o tsv)
   

2. Assegnare il ruolo Utente Foundry a un membro del team:

   Importante

   I ruoli di Controllo degli accessi in base al ruolo di Foundry sono stati recentemente rinominati. Foundry User, Foundry Owner, Foundry Account Owner e Foundry Project Manager erano precedentemente denominati Azure AI User, Azure AI Owner, Azure AI Account Owner e Azure AI Project Manager. È possibile che i nomi precedenti vengano visualizzati in alcune posizioni durante l'esecuzione della ridenominazione. Gli ID ruolo e le autorizzazioni di base sono invariati dalla ridenominazione.

   az role assignment create \
       --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" \
       --assignee "user@contoso.com" \
       --assignee-principal-type User \
       --scope $PROJECT_ID
   

Per aggiungere un gruppo di sicurezza anziché un singolo utente:

az role assignment create \
    --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" \
    --assignee-object-id "<security-group-object-id>" \
    --assignee-principal-type Group \
    --scope $PROJECT_ID

1. Verificare l'assegnazione di ruolo:

   az role assignment list \
       --scope $PROJECT_ID \
       --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" \
       --output table
   

Riferimento: az role assignment

1. Nel portale di Foundry, seleziona Gestisci nella barra di navigazione in alto a destra.
2. Selezionare Dettagli progetto nel riquadro sinistro.
3. Selezionare la scheda Utenti.
4. Selezionare Aggiungi utente in alto a destra.
5. Immettere l'indirizzo di posta elettronica del membro del team.
6. Selezionare Aggiungi.

Ripetere questi passaggi per ogni membro del team o gruppo di sicurezza.

az group delete --name my-foundry-rg --yes --no-wait

L'eliminazione avviene in background. Per verificare che il gruppo di risorse non sia più disponibile, eseguire:

az group exists --name my-foundry-rg

L'output mostra false al termine dell'eliminazione.

Nel portale Azure trovare e selezionare il gruppo di risorse. Selezionare Elimina e confermare per eliminare il gruppo di risorse e tutte le risorse associate.