Vytvoření project pro Microsoft Foundry

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

Tento článek popisuje, jak vytvořit project 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ů.

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 Azure portal nebo template, abyste splnili požadavky vaší organizace na Azure Policy.

Předpoklady

• Úč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íkovi AI účtu Azure nebo vlastníkovi Azure AI v rámci předplatného nebo skupiny prostředků. Další informace o oprávněních viz Řízení přístupu na základě rolí pro Microsoft Foundry.

Pomocí následujících karet vyberte metodu, kterou chcete použít k vytvoření project 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 jste v buňce poznámkového bloku, použijte %pip install místo toho.

• Pomocí příkazu pip show azure-mgmt-cognitiveservices zkontrolujte, jestli je vaše verze 13.7 nebo vyšší.

• Rychlé ověření: Před vytvořením projektu ověřte sadu SDK a ověřování testováním 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.")
  

• 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 ve východní části 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"
  )
  

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

  DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
  

Azure CLI

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

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

Vytvořit projekt Foundry

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

Portál Foundry

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

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

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

   

2. V levém horním rohu se zobrazí project, na kterém pracujete.

3. Pokud chcete vytvořit nový project, vyberte název project a pak vyberte Vytvořit nový project.

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

Rozšířené možnosti

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

   Návod

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

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

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

Python SDK

Vytvoření project Foundry:

• Přidejte následující kód pro vytvoření projektu Foundry pomocí proměnných a client připojení z části 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

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. 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 \
      --allow-project-management
   

   Příznak --allow-project-management umožňuje vytváření project v rámci tohoto prostředku.

3. Vytvořte pro prostředek vlastní subdoménu. Název custom domain musí být globálně jedinečný. Pokud se my-foundry-resource používá, zkuste jedinečnější název.

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

4. Vytvořte project. Například v my-foundry-project vytvořte 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. Ověřte, že projekt byl vytvořen.

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

   Výstup zobrazí vlastnosti projektu, včetně ID prostředku.

Referenční informace: účet az cognitiveservices

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

Vytvořte více projektů Foundry na existujícím prostředku Foundry, abyste umožnili týmovou spolupráci a sdílený přístup k prostředkům, včetně zabezpečení, nasazení i 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é zdroje Azure můžou mít přiřazené vlastní přístupové ovládací prvky, ale sdílejí společná nastavení, jako je zabezpečení sítě, nasazení a integrace nástrojů Azure odvozená od nadřazeného prostředku.

I když ne všechny funkce Foundry zatím podporují uspořádání práce v projektech, první výchozí projekt vašeho 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ě	✅	✅
Agents	✅	✅
Evaluations	✅	✅
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	✅	-
Propojení	✅	✅

• Přidejte projekt do prostředku Foundry:

  Portál Foundry

  1. V pravém horním navigačním panelu vyberte Operace .
  2. V levém podokně vyberte Správce .
  3. Vyberte nadřazený zdroj, do kterého chcete přidat projekt.
  4. Vyberte Přidat projekt.

  Python SDK

  Přidejte tento kód do svého skriptu, abyste vytvořili nový projekt ve vašem 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řidat nový projekt do my-foundry-resource:

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

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

Zobrazení nastavení project

Portál Foundry

Na stránce Home projektu se zobrazí koncový bod projektu a klíč rozhraní API pro projekt. Klíč rozhraní API nepotřebujete, pokud používáte ověřování Microsoft Entra ID.

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í project, použijte příkaz az cognitiveservices account project show. Napří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 zapnutý přepínač New Foundry . Tyto kroky se týkají nové verze aplikace Foundry.
2. V pravém horním navigačním panelu vyberte Operace.
3. V levém podokně vyberte Správce.
4. Vyberte project.
5. V pravém horním rohu vyberte ikonu koše a odstraňte project.

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 opatrně. Po odstranění nemůžete obnovit project.

Vytvoření prvního připojení

Související obsah

• Rychlý start pro Microsoft Foundry
• Co je Foundry?
• Vytvořte prostředky pomocí šablony Bicep