Vytvoření projektu pro Azure AI Foundry (projekty Foundry)

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

• Projekt Azure AI Foundry se spravuje v rámci prostředku Azure AI 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 AI 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ě dalších funkcí. Dávkové a uložené dokončování
  • Služby AI

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

• Další informace o různých typech projektů najdete v tématu Typy projektů .

Požadavky

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

Portál Azure AI 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 Azure AI Foundry, který je nadřazeným objektem projektu, musíte být vlastníkem předplatného, abyste měli odpovídající řízení přístupu potřebné k vytvoření prostředku Azure AI Foundry. Pokud tento přístup nemáte, požádejte správce, aby vytvořil prostředek AI 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 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.
• Nastavení vývojového prostředí
• Než spustíte kód, ověřte se v prostředí az login nebo az login --use-device-code ve vašem 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 `.

  2. Použijte pip show azure-mgmt-cognitiveservices k ověření, že je vaše verze 13.7 nebo vyšší.

  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. Id tenanta najdete na webu Azure Portal v části Microsoft Entra ID a externí identity.

     DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
     

  5. (Volitelné) Pokud pracujete ve službě Azure Government – USA nebo Azure provozované oblastmi 21Vianet , zadejte oblast, do které chcete provést ověření. Region můžete určit pomocí DefaultAzureCredential. Následující příklad se autentizuje do Azure Government - USA regionu:

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

Vytvoření projektu Foundry

Portál Azure AI Foundry

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

Návod

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ů, použijte místo toho jednu z těchto metod k dodržování předpisů azure Policy vaší organizace:

• Vytvořte svůj první prostředek AI Foundry
• Vytvořte prostředek Azure AI Foundry pomocí souboru Bicep

Pokud chcete vytvořit projekt Foundry v Azure AI Foundry, postupujte takto:

1. Přihlaste se k Azure AI Foundry.

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 Azure AI 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 Azure AI Foundry.

     

3. Vyberte prostředek Azure AI 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

Na AI Foundry zdroji se vytvoří projekt Foundry. Tento zdroj se vytvoří automaticky při vytváření projektu.

Pokud chcete přizpůsobit nastavení projektu, postupujte takto:

1. Ve formuláři Vytvořit projekt vyberte Upřesnit možnosti.

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

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

3. Vyberte umístění nebo použijte výchozí nastavení. Umístění je oblast, ve které je centrum hostované. Dostupnost služeb Azure AI se liší v jednotlivých oblastech. Některé modely například nemusí být dostupné v určitých oblastech.

4. Vyberte Vytvořit. Uvidíte průběh vytváření zdrojů a po dokončení procesu se projekt vytvoří.

Python SDK

Vytvoření projektu Foundry:

1. Přidejte tento kód pro vytvoření projektu Foundry pomocí proměnných a client připojení z předpokladů.

   # 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

Příkazy rozhraní příkazového řádku nejsou aktuálně k dispozici pro vytvoření projektu Foundry.

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

Vytvořte na existujícím AI Foundry prostředku několik projektů Azure AI 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 Azure AI 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	✅	-
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 Azure AI Foundry

  Návod

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

  1. V Azure AI Foundry vyberte projekt Azure AI Foundry nebo přidružený prostředek.

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

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

  4. 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říkazy rozhraní příkazového řádku aktuálně nejsou k dispozici pro vytvoření projektu Azure AI Foundry.

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

Zobrazení nastavení projektu

Portál Azure AI 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é hostí centrum, které 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ů

1. Na portálu Azure AI Foundry otevřete projekt.
2. Vyberte Centrum pro správu.
3. V části Zdroj vyberte Přehled.
4. Vyberte všechny projekty, které už nechcete zachovat.
5. Vyberte Odstranit projekt.

Odstranění zdroje AI Foundry spolu se všemi jeho projekty:

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 přidružené projekty.

Související obsah

• Rychlý start: Začínáme s Azure AI Foundry
• Další informace o Azure AI Foundry