Creare un progetto per Microsoft Foundry

• Non sono necessari altri prerequisiti quando si usa il portale.

• Configurare l'ambiente di sviluppo.

• Eseguire az login o az login --use-device-code nell'ambiente prima di eseguire il codice.

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

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

• Convalida rapida: prima di creare un progetto, verificare l'SDK e l'autenticazione testando il client:

  from azure.identity import DefaultAzureCredential
  from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient
  
  # Test authentication by instantiating the client
  credential = DefaultAzureCredential()
  subscription_id = "<your-subscription-id>"  # Replace with your subscription ID
  client = CognitiveServicesManagementClient(credential, subscription_id)
  print("✓ Authentication successful! Ready to create a project.")
  

• Avviare lo script con il codice seguente per creare la connessione e le client variabili usate in questo articolo. Questo esempio crea il progetto nella regione degli 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"
  )
  

• (Facoltativo) Se si dispone di più account, aggiungere l'ID tenant del Microsoft Entra ID da usare in DefaultAzureCredential:

  DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
  

• Installare il interfaccia della riga di comando di Azure.
• Impostare il valore predefinito per subscription.

# Set your default subscription
az account set --subscription "{subscription-name}"

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

Per creare un project Foundry, seguire questa procedura:

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. Il project su cui si sta lavorando viene visualizzato nell'angolo superiore sinistro.

3. Per creare un nuovo progetto, selezionare il nome del progetto e quindi selezionare Crea nuovo progetto.

4. Assegnare al project un nome e selezionare Crea project. In alternativa, vedere la sezione successiva per le opzioni avanzate.

Opzioni avanzate

1. Crea un progetto Foundry su una risorsa Foundry. Il portale crea automaticamente questa risorsa quando si crea il project. Selezionare un gruppo di risorse esistente da usare o lasciare l'impostazione predefinita per creare un nuovo gruppo di risorse.

   Suggerimento

   In particolare, per iniziare, creare un nuovo gruppo di risorse per il progetto. Il gruppo di risorse semplifica la gestione del progetto e di tutte le risorse correlate.

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

3. Fare clic su Crea. Viene visualizzato lo stato di avanzamento della creazione di risorse. Il progetto viene creato quando il processo è completo.

Per creare un project Foundry:

• Aggiungi il codice seguente dalla sezione prerequisiti per creare un progetto Foundry usando le variabili e la connessione client.

  # 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": {}
      }
  )
  

  Riferimenti: CognitiveServicesManagementClient.

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
   

2. Creare la risorsa Fonderia. 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 \
      --allow-project-management
   

   Il flag --allow-project-management abilita la creazione di project all'interno di questa risorsa.

3. Creare un sottodominio personalizzato per la risorsa. Il nome custom domain deve essere univoco a livello globale. Se il nome my-foundry-resource è già in uso, provare un nome più univoco.

   az cognitiveservices account update \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --custom-domain my-foundry-resource
   

4. Creare il project. Ad esempio, creare my-foundry-project nel my-foundry-resource:

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

5. Verificare che il project sia stato creato:

   az cognitiveservices account project show \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --project-name my-foundry-project
   

   L'output visualizza le proprietà del progetto, incluso il relativo ID risorsa.

Riferimento: az cognitiveservices account

Nella pagina del progetto Home, sono visibili l'endpoint del progetto e la chiave API. Non hai bisogno della chiave API se usi l'autenticazione di Microsoft Entra ID.

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

Riferimenti: CognitiveServicesManagementClient.

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

az cognitiveservices account project show \
--name my-foundry-resource \
--resource-group my-foundry-rg \
--project-name my-foundry-project

1. Nel portale di Foundry, selezionare Opera nella barra di navigazione in alto a destra.
2. Selezionare Amministratore nel riquadro sinistro.
3. Seleziona il nome del progetto nella tabella.
4. Selezionare Aggiungi utente in alto a destra.
5. Immettere l'indirizzo di posta elettronica del membro del team.
6. Seleziona Aggiungi.

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

Usare il portale di interfaccia della riga di comando di Azure o Foundry per gestire le assegnazioni di ruolo. L'SDK di Python non supporta le operazioni di assegnazione di ruolo.

1. Ottieni 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 di Azure AI a un membro del team:

   az role assignment create \
       --role "Azure AI User" \
       --assignee "user@contoso.com" \
       --scope $PROJECT_ID
   

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

   az role assignment create \
       --role "Azure AI User" \
       --assignee-object-id "<security-group-object-id>" \
       --assignee-principal-type Group \
       --scope $PROJECT_ID
   

3. Verificare l'assegnazione di ruolo:

   az role assignment list \
       --scope $PROJECT_ID \
       --role "Azure AI User" \
       --output table
   

Riferimento: az role assignment

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. Nel riquadro di spostamento in alto a destra selezionare Opera.
3. Nel riquadro sinistro selezionare Amministratore.
4. Selezionare il progetto.
5. In alto a destra selezionare l'icona del cestino per eliminare il project.

Questo codice usa le variabili e la connessione client dai prerequisiti. Per eliminare un singolo progetto:

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

Riferimenti: CognitiveServicesManagementClient.

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()

Riferimenti: CognitiveServicesManagementClient.

Esegui questo comando:

az cognitiveservices account project delete \
--name my-foundry-resource \
--resource-group my-foundry-rg \
--project-name my-foundry-project

Riferimenti: az cognitiveservices account project delete.