Vytvoření projektu pro Microsoft Foundry

Poznámka:

Tento dokument se týká portálu Microsoft Foundry (Classic).

🔄 Pokud používáte nový portál, přepněte na dokumentaci Microsoft Foundry (nová).

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ší prostředky Azure.

• Tento typ projektu poskytuje přístup k nejnovějším funkcím generující umělé inteligence v Foundry, mezi které patří:

  • Agenti
  • Sada Foundry SDK a rozhraní API pro sestavování agentů a snadné přepínání mezi modely
  • Modely prodané přímo v Azure – Azure OpenAI, Mistral, xAI, DeepSeek atd.
  • Modely partnerů a komunity prodané prostřednictvím Marketplace – Stabilita, Cohere atd.
  • Porozumění obsahu
  • Hodnocení
  • Jemné doladění
  • OpenAI SDK a rozhraní API, včetně dávkových a uložených dokončování
  • Slévárenské nástroje

• Potřebujete přístup k opensourcovým modelům nebo PromptFlow? Místo toho vytvořte typ projektu centra .

• Další informace o různých typech projektů najdete v tématu Typy 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 možnosti webu Azure Portal nebo šablony , aby vyhovovaly požadavkům azure Policy vaší organizace.

Požadavky

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

Portál Foundry

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

• Abyste mohli vytvořit prostředek Foundry, který je nadřazený projektu, musíte být vlastníkem předplatného, abyste měli odpovídající řízení přístupu. Pokud tento přístup nemáte, požádejte správce , aby vám vytvořil prostředek Foundry , který můžete použít. Pak přejděte k vytvoření více projektů na stejném zdroji a vytvořte projekt.

Python SDK

• Účet Azure s aktivním předplatným. Pokud ho nemáte, vytvořte si bezplatný účet Azure, který zahrnuje bezplatné zkušební předplatné.
• Abyste získali odpovídající řízení přístupu potřebné k používání projektu, musíte být vlastníkem předplatného.
• Nastavení vývojového prostředí
• Před spuštěním kódu spusťte az login nebo az login --use-device-code v prostředí.

• Spuštěním skriptu Pythonu proveďte následující kroky:

  1. Instalační balíčky: pip install azure-identity azure-mgmt-cognitiveservices~=13.7.0b1. Pokud jste v buňce poznámkového bloku, použijte %pip install místo toho.

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

  3. Začněte svůj skript následujícím kódem k vytvoření client připojení a proměnných používaných v celém 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"
     )
     

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

  5. (Volitelné) Pokud pracujete ve službě Azure Government – USA nebo Azure provozované oblastmi 21Vianet , zadejte oblast, pro kterou chcete provést ověření. Tento příklad autentizuje k oblasti Azure Government – US:

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

Azure CLI

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

• Abyste mohli získat odpovídající řízení přístupu potřebné k používání projektu, musíte být vlastníkem předplatného.

• Nainstalujte Azure CLI

• Nastavte výchozí hodnoty pro subscription a resource group.

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

Vytvoření projektu Foundry

Portál Foundry

Tyto kroky poskytují způsob, jak vytvořit nový prostředek Azure se základními výchozími nastaveními.

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 nemáte žádné existující projekty: Postupujte podle kroků v rychlém startu: Začněte se službou Microsoft Foundry a vytvořte svůj první projekt.

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

     

   • Pokud nejste v projektu: Výběrem možnosti Vytvořit nový v pravém horním rohu vytvořte nový projekt Foundry.

     

3. Vyberte Prostředek Foundry 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.

Rozšířené možnosti

1. Na Foundry zdroji se vytvoří projekt Foundry. Tento zdroj se vytvoří automaticky při vytváření projektu. Vyberte existující skupinu prostředků, kterou chcete použít, nebo ponechte výchozí možnost pro vytvoření nové skupiny prostředků.

   Návod

   Zejména pro začátek doporučujeme vytvořit novou skupinu prostředků pro váš projekt. Skupina prostředků umožňuje snadnou správu projektu a všech jejích prostředků společně.

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

3. Vyberte Vytvořit. Uvidíte průběh vytváření prostředků. Projekt se vytvoří po dokončení procesu.

Python SDK

Vytvoření projektu Foundry:

• Přidejte tento kód k vytvoření projektu Foundry pomocí proměnných a připojení client uvedených v požadavcích.

  # 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. Pomocí následujícího příkazu se ověřte ve svém předplatném Azure z Azure CLI:

   az login
   

   Další informace o ověřování najdete v tématu Metody ověřování.

2. Vytvořte skupinu prostředků, například v regionu východní USA:

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

3. Vytvoření prostředku Foundry

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

4. Vytvoření projektu:

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

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í v omezených předplatných Azure, kde vývojáři potřebují samoobslužné zkoumání v rámci nastavení předem nakonfigurované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 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.

Vlastnost	Výchozí projekt	Jiné projekty
Odvozování modelů	✅	✅
Hřiště	✅	✅
Agenti	✅	✅
Hodnocení	✅	✅
Trasování	✅	✅
Datové sady	✅	✅
Indexes	✅	✅
Soubor 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

  Návod

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

  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

  Pomocí existujících hodnot pro {foundry_resource_name} přidejte do zdroje další projekt:

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

• 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é hostí centrum, jež hostí projekt.
• Skupina prostředků: Skupina prostředků, která je hostitelem centra, 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)

Azure CLI

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

az cognitiveservices account connection show \
--name <my_project_name> \
--resource-group <my_resource_group>

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 web Azure Portal.
2. Na webu Azure Portal vyberte Odstranit a odstraňte prostředek a všechny jeho přidružené projekty.

Python SDK

Tento kód používá proměnné a client connection z předpokladů. Nejprve vytvořte připojení klienta:

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

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

Azure CLI

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

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

Související obsah

• Rychlý start: Začínáme s Foundry
• Co je Foundry?