Skapa ett projekt för Azure AI Foundry (Foundry-projekt)

• Ett Azure-konto med en aktiv prenumeration. Om du inte har ett skapar du ett kostnadsfritt Azure-konto, som innehåller en kostnadsfri utvärderingsprenumeration.
• Du måste vara Ägare till prenumerationen för att ha rätt åtkomstkontroll som krävs för att skapa den Azure AI Foundry-resurs som är projektets föräldraresurs. Om du inte har den här åtkomsten måste administratören skapa en AI Foundry-resurs som du kan använda. Gå sedan vidare till Skapa flera projekt på samma resurs för att skapa projektet.

• Ett Azure-konto med en aktiv prenumeration. Om du inte har ett skapar du ett kostnadsfritt Azure-konto, som innehåller en kostnadsfri utvärderingsprenumeration.
• Du måste vara ägare till prenumerationen för att få den åtkomstkontroll som krävs för att använda projektet.
• Konfigurera din utvecklingsmiljö
• Autentisera med az login eller az login --use-device-code i din miljö innan du kör kod.
• Slutför de här stegen för att starta Python-skriptet:

  1. Installera paket: pip install azure-identity azure-mgmt-cognitiveservices~=13.7.0b1 . Om du är i en notebook-cell, använd %pip install i stället för `.

  2. Använd pip show azure-mgmt-cognitiveservices för att kontrollera att din version är 13.7 eller senare.

  3. Starta skriptet med följande kod för att skapa anslutningen client och variablerna som används i den här artikeln. Det här exemplet skapar projektet i Östra USA.

     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. (Valfritt) Om du har flera konton lägger du till klient-ID:t för det Microsoft Entra-ID som du vill använda i DefaultAzureCredential. Hitta ditt klientorganisations-ID från Azure portal under Microsoft Entra-ID, Externa Identiteter.

     DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
     

  5. (Valfritt) Om du arbetar med i Azure Government – USA eller Azure som drivs av 21Vianet-regioner anger du i vilken region du vill autentisera. Du kan ange regionen med DefaultAzureCredential. Följande exempel autentiserar till Azure Government - USA-regionen:

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

• Ett Azure-konto med en aktiv prenumeration. Om du inte har ett skapar du ett kostnadsfritt Azure-konto, som innehåller en kostnadsfri utvärderingsprenumeration.
• Du måste vara ägare till prenumerationen för att få den åtkomstkontroll som krävs för att använda projektet.
• Azure CLI

De här stegen är ett sätt att skapa en ny Azure-resurs med grundläggande, standardinställningar.

Följ dessa steg för att skapa ett Foundry-projekt i Azure AI Foundry:

1. Logga in på Azure AI Foundry.

2. Vad du gör härnäst beror på var du befinner dig:

   • Om du inte har några befintliga projekt: Följ stegen i Snabbstart: Kom igång med Azure AI Foundry för att skapa ditt första projekt.

   • Om du är i ett projekt: Välj projektets sökväg och välj sedan Skapa ny resurs.

     

   • Om du inte är med i ett projekt: Välj Skapa nytt längst upp till höger för att skapa ett nytt Azure AI Foundry-projekt

     

3. Välj Azure AI Foundry-resurs och välj sedan Nästa.

4. Ange ett namn för projektet och välj Skapa. Eller se nästa avsnitt för avancerade alternativ.

Avancerade alternativ

Ett Foundry-projekt skapas på en AI Foundry resurs. Den här resursen skapas automatiskt när du skapar projektet.

Följ dessa steg för att anpassa inställningarna för projektet:

1. I formuläret Skapa ett projekt väljer du Avancerade alternativ.

2. Välj en befintlig resursgrupp som du vill använda eller lämna standardvärdet för att skapa en ny resursgrupp.

   Tips/Råd

   Särskilt för att komma igång rekommenderar vi att du skapar en ny resursgrupp för projektet. Med resursgruppen kan du enkelt hantera projektet och alla dess resurser tillsammans.

3. Välj en plats eller använd standardinställningen. Platsen är den region där hubben finns. Tillgängligheten för Azure AI-tjänster skiljer sig åt per region. Vissa modeller kanske till exempel inte är tillgängliga i vissa regioner.

4. Välj Skapa. Du ser förloppet för att skapa resurser och projektet skapas när processen är klar.

Så här skapar du ett Foundry-projekt:

1. Lägg till den här koden för att skapa ett Foundry-projekt med hjälp av variablerna och client anslutningen från förutsättningar.

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

CLI-kommandon är för närvarande inte tillgängliga för att skapa ett Foundry-projekt.

På projektets startsida hittar du information om projektet.

• Namn: Namnet på projektet visas i det övre vänstra hörnet.
• Prenumeration: Den prenumeration som innehåller den hubb som är värd för projektet.
• Resursgrupp: Resursgruppen som har den hubb där projektet är placerat.

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

Om du vill visa inställningar för projektet använder du az cognitiveservices account connection show kommandot . Till exempel:

az cognitiveservices account connection show --name {my_project_name} --resource-group {my_resource_group}