Vytvoření projektu pro Microsoft Foundry (classic)

V tomto článku můžete vytvořit projekt Foundry a před zahájením vytváření agentů, vyhodnocení a souborů ověřit, že je vaše prostředí připravené.

Momentálně zobrazujete:Verze portálu Foundry (classic) - Přechod na verzi nového portálu Foundry

Tento článek popisuje, jak vytvořit projekt Foundry v Microsoft Foundry. Projekty umožňují organizovat svou práci – například agenty, hodnocení a soubory – při vytváření stavových aplikací a prozkoumání nových nápadů.

• Projekt Foundry se spravuje v rámci zdroje Microsoft Foundry. Jedná se o kontejner pro správu přístupu, nahrávání dat a integraci a monitorování. Díky tomu budete mít práci oddělenou mezi případy použití, aniž byste museli vytvářet další Azure prostředky.

• Pokud potřebujete přístup k open-source modelům nebo PromptFlow, vytvořte místo toho projekt typu hub.

• Další informace o různých typech projektů naleznete v Tyto typech projektů.

Pokud vaše organizace vyžaduje přizpůsobené konfigurace Azure, jako jsou alternativní názvy, kontrolní mechanismy zabezpečení nebo značky nákladů, možná budete muset použít Azure portal nebo template, abyste vyhověli požadavkům vaší organizace na Azure Policy.

Požadavky

• Účet Azure s aktivním předplatným. Pokud ho nemáte, vytvořte si účet free Azure, který zahrnuje bezplatné zkušební předplatné.

• Přístup k roli, která umožňuje vytvořit prostředek Foundry, například Vlastník účtu Foundry nebo Vlastník foundry v předplatném nebo skupině prostředků. Další informace o oprávněních najdete v tématu Řízení přístupu na základě oprávnění pro Microsoft Foundry.

  Důležité

  Nedávno byly přejmenovány role Foundry RBAC. Foundry User, Foundry Owner, Foundry Account Owner a Foundry Project Manager se dříve nazývaly Uživatel Azure AI, Vlastník Azure AI, Vlastník účtu Azure AI a Správce projektů Azure AI. Během zavádění přejmenování se stále můžou zobrazovat předchozí názvy na některých místech. ID rolí a základní oprávnění se při přejmenování nezmění.

  Pokud tuto roli nemáte, požádejte správce předplatného, aby vytvořil prostředek Foundry , a pak přeskočte na Vytvoření více projektů na stejném prostředku.

Pomocí následujících karet vyberte metodu, kterou chcete použít k vytvoření projektu Foundry:

Portál Foundry

• Při používání portálu nejsou potřeba žádné další požadavky.

Python SDK

• Nastavte vývojové prostředí.

• Před spuštěním kódu spusťte az login nebo az login --use-device-code v prostředí.

• Instalační balíčky: pip install azure-identity azure-mgmt-cognitiveservices~=13.7.0. Pokud se nacházíte v buňce notebooku, použijte %pip install místo toho.

• Zkontrolujte pip show azure-mgmt-cognitiveservices , jestli je vaše verze 13.7 nebo novější.

• Rychlé ověření: Před vytvořením projektu zkontrolujte vaši sadu SDK a ověřte pravost tím, že otestujete klienta.

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

• Spusťte svůj skript tímto kódem pro vytvoření client připojení a proměnných používaných v tomto článku. Tento příklad vytvoří projekt v oblasti USA – východ:

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

• (Volitelné) Pokud máte více účtů, přidejte ID tenanta Microsoft Entra ID, které chcete použít, do DefaultAzureCredential:

  DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
  

• (Volitelné) Pokud pracujete v Azure Government – USA nebo Azure provozované společností 21Vianet oblasti, zadejte oblast, pro kterou chcete provést ověření. Tento příklad se ověřuje v oblasti Azure Government – USA:

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

Azure CLI

• Nainstalujte Azure CLI.
• Nastavte výchozí hodnotu pro subscription.

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

Vytvoření projektu Foundry

Použijte jednu z následujících metod.

Portál Foundry

Tento postup poskytuje způsob, jak vytvořit nový prostředek Azure se základním výchozím nastavením.

Chcete-li vytvořit projekt Foundry, postupujte takto:

1. Přihlaste se k Microsoft Foundry. Ujistěte se, že je přepínač New Foundry vypnutý. Tyto kroky odkazují na Foundry (classic).

   

2. Co budete dělat dál, závisí na tom, kde jste:

   • Pokud nejste v projektu nebo ještě nemáte žádné projekty: Výběrem možnosti Vytvořit nový v pravém horním rohu vytvořte nový projekt Foundry.

     

   • Pokud jste v projektu: Vyberte popis cesty k projektu a pak vyberte Vytvořit nový zdroj.

     

3. Vyberte Foundry resource a pak vyberte Další.

4. Zadejte název projektu a vyberte Vytvořit. Nebo se podívejte na další část s rozšířenými možnostmi.

Pokročilé možnosti

1. Vytvoříte projekt Foundry na zdroji Foundry. Portál automaticky vytvoří tento zdroj při vytváření projektu. Vyberte existující skupinu prostředků , která se má použít, nebo ponechte výchozí možnost pro vytvoření nové skupiny prostředků.

   Tip

   Zejména pro začátek vytvořte pro svůj projekt novou skupinu prostředků. Skupina prostředků usnadňuje společnou správu projektu a všech jeho prostředků.

2. Vyberte umístění nebo použijte výchozí nastavení. Umístění je oblast, ve které jsou hostovány prostředky projektu.

3. Vyberte Vytvořit. Uvidíte postup vytváření zdrojů. Projekt se vytvoří po dokončení procesu.

Python SDK

Vytvoření projektu Foundry:

• Přidejte následující kód pro vytvoření projektu Foundry pomocí proměnných a client připojení uvedených v sekci Požadavky.

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

  Odkazy: CognitiveServicesManagementClient.

Azure CLI

Note

Tyto kroky vyžadují Azure CLI a roli Přispěvatel nebo Vlastník ve skupině prostředků. Než začnete, spusťte az login a přihlaste se. Podporované oblasti najdete v tématu Podpora oblastí.

1. Vytvořte skupinu prostředků nebo použijte existující. Například vytvořte my-foundry-rg v eastus:

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

2. Vytvořte zdroj Foundry s povolenou správou projektů. Vytvořte například my-foundry-resource ve my-foundry-rg skupině prostředků:

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

   Nastavte příznak --allow-project-management k povolení správy projektů. Tento příznak po vytvoření prostředku nemůžete změnit. Hodnota --custom-domain musí být globálně jedinečná – pokud my-foundry-resource se už používá, zvolte jiný název.

3. Vytvořte projekt. Například vytvořte my-foundry-project v :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. Ověřte, že byl prostředek zřízen:

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

   Ve výstupu by se měl zobrazit Succeeded. Pokud výstup zobrazuje jiný stav, zkontrolujte svá oprávnění, dostupnost oblastí a kvóty prostředků. Další nápovědu najdete v tématu Vytvoření prostředku s více službami.

5. Ověřte, že byl projekt vytvořen:

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

   Ve výstupu by se měl zobrazit Succeeded.

Vytvoření více projektů na stejném zdroji

Vytvořte na existujícím Foundry prostředku více projektů Foundry, abyste umožnili týmovou spolupráci a sdílený přístup k prostředkům, včetně zabezpečení, nasazení a připojených nástrojů. Toto nastavení je ideální pro předplatná s omezenými Azure, kde vývojáři potřebují možnost samoobslužného zkoumání v rámci nastavení předkonfigurovaného prostředí.

Projekty Foundry jako podřízené prostředky Azure můžou mít přiřazené vlastní řízení přístupu, ale sdílejí společná nastavení, jako je zabezpečení sítě, nasazení a integrace nástrojů Azure, které vycházejí z nadřazeného prostředku.

I když ne všechny funkce Foundry podporují uspořádání práce v projektech, první "výchozí" projekt zdroje je výkonnější. Můžete ho identifikovat značkou "default" v prostředích uživatelského prostředí a vlastností prostředku "is_default" při použití možností kódu.

Funkce	Výchozí projekt	Jiné projekty
Odvozování modelů	✅	✅
Hřiště	✅	✅
Agenti	✅	✅
Hodnocení	✅	✅
Trasování	✅	✅
Datové sady	✅	✅
Indexy	✅	✅
Sada Foundry SDK a rozhraní API	✅	✅
Porozumění obsahu	✅	✅
OpenAI SDK a rozhraní API	✅	Odpovědi, soubory, konverzace
OpenAI Batch, jemné ladění, uložené dokončování	✅	-
Vyladění jazyka	✅	✅
Vyladění řeči	✅	-
Připojení	✅	✅

• Přidání projektu do zdroje Foundry:

  Portál Foundry

  Tip

  Vzhledem k tomu, že na portálu Microsoft Foundry můžete usouložit levé podokno, může se zobrazit jiné položky, než je znázorněno v tomto postupu. Pokud nevidíte, co hledáte, vyberte ... Další v dolní části levého podokna.

  1. Přihlaste se k Microsoft Foundry. Ujistěte se, že je přepínač New Foundry vypnutý. Tyto kroky odkazují na Foundry (classic).

     

  2. Vyberte buď projekt Foundry, nebo jeho přidružený zdroj.

  3. V levém podokně vyberte Centrum pro správu.

  4. V části zdroje vyberte Přehled.

  5. Vyberte Nový projekt a zadejte název.

     

  Python SDK

  Přidejte tento kód do skriptu a vytvořte nový projekt ve stávajícím prostředku:

  # 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

  Přidání nového projektu do my-foundry-resource:

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

• Pokud odstraníte výchozí projekt zdroje Foundry, stane se dalším vytvořeným projektem výchozí projekt.

Zobrazení nastavení projektu

Portál Foundry

Na domovské stránce projektu najdete informace o projektu.

• Název: Název projektu se zobrazí v levém horním rohu.
• Předplatné: Předplatné, které hostuje prostředek, který je hostitelem projektu.
• Skupina prostředků: Skupina prostředků, která je hostitelem prostředku, který je hostitelem projektu.

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)

Odkazy: CognitiveServicesManagementClient.

Azure CLI

Pokud chcete zobrazit nastavení projektu, použijte az cognitiveservices account project show příkaz. Příklad:

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

Odstranění projektů

Portál Foundry

1. Přihlaste se k Microsoft Foundry. Ujistěte se, že je přepínač New Foundry vypnutý. Tyto kroky odkazují na Foundry (classic).
2. Otevřete projekt.
3. Vyberte Centrum pro správu.
4. V části Zdroj vyberte Přehled.
5. Vyberte všechny projekty, které už nechcete zachovat.
6. Vyberte Odstranit projekt.

Odstranění zdroje Foundry a všech jeho projektů:

1. V Centru pro správu vyberte název prostředku v části Přehled a přejděte na portál Azure.
2. Na portálu Azure vyberte Delete a odstraňte zdroj a všechny přidružené projekty.

Python SDK

Tento kód používá proměnné a client připojení z požadavků. Odstranění jednoho projektu:

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

Odkazy: CognitiveServicesManagementClient.

Odstraňte zdroj Foundry a všechny jeho projekty:

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

Odkazy: CognitiveServicesManagementClient.

Azure CLI

Spusťte následující příkaz:

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

Odkazy: az cognitiveservices account project delete.

Důležité

Používejte s opatrností. Po odstranění se projekt nedá obnovit.

Vytvoření prvního připojení

Související obsah

• Stručný úvod k platformě Microsoft Foundry
• Co je Foundry?
• Vytvořte prostředky pomocí šablony Bicep