Skapa ett projekt för Microsoft Foundry

Anmärkning

Det här dokumentet refererar till Microsoft Foundry-portalen (klassisk).

🔄 Växla till dokumentationen för Microsoft Foundry (ny) om du använder den nya portalen.

I den här artikeln beskrivs hur du skapar ett Foundry-projekt i Microsoft Foundry. Med projekt kan du organisera ditt arbete , till exempel agenter, utvärderingar och filer, när du skapar tillståndskänsliga appar och utforskar nya idéer.

• Ett Foundry-projekt hanteras under en Microsoft Foundry-resurs. Det är en container för åtkomsthantering, dataöverföring och integrering samt övervakning. På så sätt kan du hålla ditt arbete åtskilt mellan användningsfall utan att behöva skapa extra Azure-resurser.

• Den här projekttypen ger dig åtkomst till de senaste generativa AI-funktionerna i Foundry, inklusive:

  • Agenter
  • Foundry SDK och API för att skapa agenter och enkelt växla mellan modeller
  • Modeller som säljs direkt av Azure – Azure OpenAI, Mistral, xAI, DeepSeek osv.
  • Partner- och communitymodeller som säljs via Marketplace – stabilitet, kohere osv.
  • Innehållstolkning
  • Recensioner
  • Finjustering
  • OpenAI SDK och API inklusive Batch och lagrade slutföranden
  • Gjuteriverktyg

• Behöver du åtkomst till modeller med öppen källkod eller PromptFlow? Skapa en hubbprojekttyp i stället.

• Mer information om de olika projekttyperna finns i Typer av projekt .

Om din organisation behöver anpassade Azure-konfigurationer som alternativa namn, säkerhetskontroller eller kostnadstaggar kan du behöva använda Azure-portalen eller mallalternativen för att uppfylla organisationens Azure Policy-krav.

Förutsättningar

Använd följande flikar för att välja den metod som du ska använda för att skapa ett Foundry-projekt:

Foundry-portalen

• 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 den nödvändiga åtkomstkontrollen som krävs för att skapa Foundry-resursen som är förälder till projektet. Om du inte har den här åtkomsten måste administratören skapa en Foundry-resurs som du kan använda. Gå sedan vidare till Skapa flera projekt på samma resurs för att skapa projektet.

Python SDK

• 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å rätt åtkomstkontroll som krävs för att använda projektet.
• Konfigurera din utvecklingsmiljö
• Kör 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änder du %pip install i stället.

  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.

     DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
     

  5. (Valfritt) Om du arbetar i Azure Government – USA eller Azure som drivs av 21Vianet-regioner anger du den region som du vill autentisera till. Det här exemplet autentiserar till Azure Government – USA-regionen:

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

Azure CLI

• 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.

• Installera Azure CLI

• Ange standardvärden för subscription och resource group.

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

Skapa ett Foundry-projekt

Foundry-portalen

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:

1. Logga in på Microsoft Foundry. Kontrollera att växlingsknappen New Foundry är inaktiverad. De här stegen refererar till Foundry (klassisk).

   

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 Microsoft 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 i ett projekt: Välj Skapa nytt längst upp till höger för att skapa ett nytt Foundry-projekt

     

3. Välj 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

1. Ett Foundry-projekt skapas på en Foundry resurs. Den här resursen skapas automatiskt när du skapar projektet. 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.

2. Välj en plats eller använd standardinställningen. Platsen är den region där resurserna i projektet finns.

3. Välj Skapa. Du ser framsteg med resursers skapande. Projektet skapas när processen är klar.

Python SDK

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

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

Azure CLI

1. Autentisera till din Azure-prenumeration från Azure CLI med följande kommando:

   az login
   

   Mer information om autentisering finns i Autentiseringsmetoder.

2. Skapa en resursgrupp, till exempel i Östra USA.

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

3. Skapa en Foundry-resurs

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

4. Skapa ett projekt:

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

Skapa flera projekt på samma resurs

Skapa flera Foundry-projekt på en befintlig Foundry resurs för att aktivera teamsamarbete och delad resursåtkomst, inklusive säkerhet, distributioner och anslutna verktyg. Den här konfigurationen är idealisk i begränsade Azure-prenumerationer där utvecklare behöver möjlighet till självbetjäningsexploration för en förkonfigurerad miljö.

Foundry-projekt som Azure-underresurser kan få sina egna åtkomstkontroller, men delar vanliga inställningar, såsom nätverkssäkerhet, distributioner och integration av Azure-verktyg, från sin överordnade resurs.

Även om inte alla Foundry-funktioner stöder organisering av arbete i projekt ännu, är resursens första "standardprojekt" kraftfullare. Du kan identifiera det med taggen "default" i UX-upplevelser och resursegenskapen "is_default" när du använder kodalternativ.

Funktion	Standardprojekt	Andra projekt
Modellslutsatsdragning	✅	✅
Lekplatser	✅	✅
Agenter	✅	✅
Recensioner	✅	✅
Spårning	✅	✅
Datauppsättningar	✅	✅
Indexen	✅	✅
Foundry SDK och API	✅	✅
Innehållstolkning	✅	✅
OpenAI SDK och API	✅	Svar, filer, konversationer
OpenAI Batch, Finjustering, Lagrade slutföranden	✅	-
Finjustering av språk	✅	✅
Finjustering av tal	✅	-
Anslutningar	✅	✅

• Så här lägger du till ett projekt i en Foundry-resurs:

  Foundry-portalen

  Tips/Råd

  Eftersom du kan anpassa det vänstra fönstret i Microsoft Foundry-portalen kan du se andra objekt än vad som visas i de här stegen. Om du inte ser det du letar efter väljer du ... Mer längst ned i det vänstra fönstret.

  1. Logga in på Microsoft Foundry. Kontrollera att växlingsknappen New Foundry är inaktiverad. De här stegen refererar till Foundry (klassisk).

     

  2. Välj antingen Foundry-projektet eller dess associerade resurs.

  3. I den vänstra rutan väljer du Hanteringscenter.

  4. I resursavsnittet väljer du Översikt.

  5. Välj Nytt projekt och ange ett namn.

     

  Python SDK

  Lägg till den här koden i skriptet för att skapa ett nytt projekt på din befintliga resurs:

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

  Azure CLI

  Använd dina befintliga värden för {foundry_resource_name} för att lägga till ett annat projekt i resursen:

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

• Om du tar bort foundry-resursens standardprojekt blir nästa projekt som skapas standardprojektet.

Visa projektinställningar

Foundry-portalen

På projektets startsida hittar du information om projektet.

• Namn: Namnet på projektet visas i det övre vänstra hörnet.
• Prenumeration: Prenumerationen som värdar hubben som värdar projektet.
• Resursgrupp: Resursgruppen som är värd för den hubb som är värd för projektet.

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)

Azure CLI

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>

Ta bort projekt

Foundry-portalen

1. Logga in på Microsoft Foundry. Kontrollera att växlingsknappen New Foundry är inaktiverad. De här stegen refererar till Foundry (klassisk).
2. Öppna projektet.
3. Välj Hanteringscenter.
4. Under Resurs väljer du Översikt.
5. Välj projekt som du inte längre vill behålla.
6. Välj Ta bort projekt.

Så här tar du bort Foundry-resursen och alla dess projekt:

1. I hanteringscentret väljer du resursnamnet i avsnittet Översikt för att gå till Azure-portalen.
2. I Azure-portalen väljer du Ta bort för att ta bort resursen och alla dess associerade projekt.

Python SDK

Den här koden använder variablerna och client connection från förutsättningar. Skapa först klientanslutningen:

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

Ta bort en Foundry-resurs och alla dess projekt:

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

Azure CLI

Kör följande kommando:

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

Relaterat innehåll

• Snabbstart: Kom igång med Foundry
• Vad är Foundry?