Skapa ett projekt för Microsoft Foundry

Använd den här artikeln om du vill skapa ett Foundry-projekt och bekräfta att din miljö är klar innan du börjar skapa agenter, utvärderingar och filer.

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.

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

Förutsättningar

• Ett Azure konto med en aktiv prenumeration. Om du inte har ett skapar du ett fritt Azure konto, som innehåller en kostnadsfri utvärderingsprenumeration.

• Om du skapar projektet själv:

  • Åtkomst till en roll som gör att du kan skapa en Foundry-resurs, till exempel Azure konto-AI-ägare eller Azure AI-ägare i prenumerationen eller resursgruppen. Mer information om behörigheter finns i Role-baserad åtkomstkontroll för Microsoft Foundry.

• Om du skapar projektet för ett team:

  • Åtkomst till en roll som gör att du kan slutföra rolltilldelningar, till exempel Owner. Mer information om behörigheter finns i Role-baserad åtkomstkontroll för Microsoft Foundry.
  • En lista över användarens e-postadresser eller Microsoft Entra säkerhetsgrupp-ID:t för teammedlemmar som behöver åtkomst.

Använd följande flikar för att välja den metod som du vill använda för att skapa en Foundry-project:

Foundryportal

• Inga andra krav krävs när du använder portalen.

Python SDK

• Konfigurera utvecklingsmiljön.

• Kör az login eller az login --use-device-code i din miljö innan du kör kod.

• Installera paket: pip install azure-identity azure-mgmt-cognitiveservices~=13.7.0. Om du är i en notebook-cell använder du %pip install i stället.

• Använd pip show azure-mgmt-cognitiveservices för att kontrollera att din version är 13,7 eller högre.

• Snabbvalidering: Kontrollera SDK:et och autentiseringen innan du skapar ett projekt genom att testa klienten:

  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.")
  

• 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"
  )
  

• (Valfritt) Om du har flera konton lägger du till klient-ID:t för den Microsoft Entra ID som du vill använda i DefaultAzureCredential:

  DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
  

Azure CLI

• Installera Azure CLI.
• Ange standardvärdet för subscription.

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

Skapa ett Foundry-projekt

Använd någon av följande metoder.

Foundryportal

Med de här stegen kan du skapa en ny Azure resurs med grundläggande standardinställningar.

Följ dessa steg för att skapa en Foundry-project:

1. Logga in på Microsoft Foundry. Kontrollera att växlingsknappen New Foundry är aktiverad. Dessa steg hänvisar till Foundry (ny).

   

2. Det projektet du arbetar med visas i det övre vänstra hörnet.

3. För att skapa ett nytt projekt ska du välja projektnamnet och sedan Skapa nytt projekt.

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

Avancerade alternativ

1. Du skapar ett Foundry-projekt på en Foundry resurs. Portalen skapar automatiskt den här resursen när du skapar project. Välj en befintlig resursgrupp som ska användas eller låt standardvärdet vara att skapa en ny resursgrupp.

   Tips/Råd

   Särskilt för att komma igång, skapar du en ny resursgrupp för ditt projekt. Resursgruppen gör det enkelt att hantera project och alla dess resurser tillsammans.

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

3. Välj Skapa. Du ser hur resursskapandet fortskrider. Project skapas när processen är klar.

Python SDK

Så här skapar du en Foundry-project:

• Lägg till följande kod för att skapa ett Foundry-projekt med hjälp av variablerna och client anslutningen från avsnittet 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": {}
      }
  )
  

  Referenser: CognitiveServicesManagementClient.

Azure CLI

1. Skapa en resursgrupp eller använd en befintlig. Skapa till exempel my-foundry-rg i eastus:

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

2. Skapa Foundry-resursen. Skapa till exempel my-foundry-resource i my-foundry-rg resursgruppen:

   az cognitiveservices account create \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --kind AIServices \
       --sku s0 \
       --location eastus \
      --allow-project-management
   

   Med flaggan --allow-project-management kan projekt skapas inom den här resursen.

3. Skapa en anpassad underdomän för resursen. Namnet på custom domain måste vara globalt unikt. Om my-foundry-resource tas kan du prova ett mer unikt namn.

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

4. Skapa projektet. Skapa till exempel my-foundry-project i 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. Kontrollera att project har skapats:

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

   Utdata visar projektets egenskaper, inklusive dess resurs-ID.

Referens: az cognitiveservices account

Skapa flera projekt på samma resurs

Skapa flera Foundry-projekt på en befintlig Foundry resurs för att aktivera teamsamarbete och delad resurs access inklusive säkerhet, distributioner och anslutna verktyg. Den här konfigurationen är idealisk i Azure-prenumerationer med begränsade åtkomsträtter där utvecklare behöver möjlighet till självständig utforskning inom ramen för en förkonfigurerad miljö.

Foundry-projekt som Azure-underordnade resurser kan tilldelas sina egna åtkomstkontroller, men delar gemensamma inställningar såsom nätverkssäkerhet, distributioner och Azure-verktygsintegration från den överordnade resursen.

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

Egenskap	Förvalt projekt	Andra projekt
Modellslutsatsdragning	✅	✅
Lekplatser	✅	✅
Agents	✅	✅
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	✅	-
Connections	✅	✅

• Så här lägger du till en project till en Foundry-resurs:

  Foundryportal

  1. Välj Använd i det övre högra navigeringsfältet.
  2. Välj Administratör i den vänstra rutan.
  3. Välj den överordnade resurs som du vill lägga till ett projekt i.
  4. Välj Lägg till projekt.

  Python SDK

  Lägg till den här koden i skriptet för att skapa en ny project 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

  För att lägga till ett nytt projekt i my-foundry-resource:

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

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

Visa project inställningar

Foundryportal

På projektsidan Home ser du projektets slutpunkt och API-nyckel för projektet. Du behöver inte API-nyckeln om du använder Microsoft Entra ID autentisering.

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)

Referenser: CognitiveServicesManagementClient.

Azure CLI

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

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

Bevilja åtkomst till gruppmedlemmar

Om du har skapat projektet för ett team tilldelar du rollen Azure AI-användare till gruppmedlemmar så att de kan använda projektet och dess resurser. Den här rollen ger de minsta behörigheter som krävs för att skapa och testa AI-program. Andra roller som du kan behöva tilldela finns i Role-baserad åtkomstkontroll för Microsoft Foundry.

Viktigt!

För att slutföra rolltilldelningar behöver du en roll, till exempel Ägare i projektet. Mer information finns i Role-baserad åtkomstkontroll för Microsoft Foundry.

Foundryportal

1. I Foundry-portalen väljer du Arbeta i det övre högra navigeringsfältet.
2. Välj Administratör i den vänstra rutan.
3. Välj projektnamnet i tabellen.
4. Välj Lägg till användare i det övre högra hörnet.
5. Ange e-postadressen till gruppmedlemmen.
6. Välj Lägg till.

Upprepa de här stegen för varje gruppmedlem eller säkerhetsgrupp.

Tips/Råd

Om du vill lägga till flera användare samtidigt använder du en Microsoft Entra säkerhetsgrupp i stället för enskilda e-postadresser.

Python SDK

Använd Azure CLI- eller Foundry-portalen för att hantera rolltilldelningar. Python SDK stöder inte rolltilldelningsåtgärder.

Azure CLI

1. Hämta projektets resurs-ID:

   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. Tilldela rollen Azure AI User till en gruppmedlem:

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

   Så här lägger du till en säkerhetsgrupp i stället för en enskild användare:

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

3. Kontrollera rolltilldelningen:

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

Referens: az rolltilldelning

Verifiera åtkomst till gruppmedlem

Be en gruppmedlem att verifiera sin åtkomst genom att logga in på Microsoft Foundry och välja projektet i projektlistan.

Om gruppmedlemmen inte kan få åtkomst till projektet, kontrollera att rolltilldelningen har slutförts. Kontrollera att du har använt rätt e-postadress eller säkerhetsgrupps-ID. Kontrollera att gruppmedlemmens Azure konto finns i samma Microsoft Entra klientorganisation.

Ta bort projekt

Foundryportal

1. Logga in på Microsoft Foundry. Kontrollera att växlingsknappen New Foundry är aktiverad. De här stegen hänvisar till Foundry (ny).
2. I det övre högra navigeringsfältet väljer du Använd.
3. I den vänstra rutan väljer du Admin.
4. Välj din project.
5. I det övre högra hörnet väljer du papperskorgsikonen för att ta bort projekt.

Python SDK

Den här koden använder variablerna och client anslutningen från förutsättningarna. Så här tar du bort ett enskilt projekt:

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

Referenser: CognitiveServicesManagementClient.

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

Referenser: CognitiveServicesManagementClient.

Azure CLI

Kör följande kommando:

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

Referenser: az cognitiveservices account project delete.

Viktigt!

Använd med försiktighet. Du kan inte återställa en project när den har tagits bort.

Skapa din första anslutning

Relaterat innehåll

• snabbstart för Microsoft Foundry
• Vad är Foundry?
• Skapa resurser med Bicep mall