為 Microsoft Foundry 建立一個 project

本文說明如何在 Microsoft Foundry 中建立 Foundry project。 專案可讓您在建置有狀態的應用程式和探索新想法時組織工作，例如代理程式、評估和檔案。

如果您的組織需要自訂的Azure設定，例如替代名稱、安全控制或成本標籤，您可能需要使用 Azure portal 或 template 選項以符合組織的Azure Policy要求。

先決條件

• 一個有有效訂閱的 Azure 帳號。 如果你還沒有，請建立一個free Azure帳號，其中包含免費試用訂閱。

• 具備可建立 Foundry 資源之角色的存取權，例如在訂用帳戶或資源群組上指派的 Azure Account AI 擁有者或 Azure AI 擁有者。 欲了解更多權限資訊，請參閱 Microsoft Foundry Role-based access control。

• 請使用以下分頁選擇你想使用的方法來建立 Foundry project：

  Foundry 入口網站

  • 一個有有效訂閱的 Azure 帳號。 如果你還沒有，請建立一個free Azure帳號，其中包含免費試用訂閱。

  Python SDK

  • 設定開發環境

  • 在執行程式碼之前，先在您的環境中執行 az login 或 az login --use-device-code 。

  • 快速驗證：在建立project前，先透過測試客戶端來確認你的 SDK 和認證是否正常：

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

  • 完成以下步驟開始你的 Python 腳本：

    1. 安裝套件：pip install azure-identity azure-mgmt-cognitiveservices~=13.7.0b1。 如果您在筆記本儲存格中，請改用 %pip install。

    2. 使用 pip show azure-mgmt-cognitiveservices 來檢查你的版本是否是 13.7 或更高。

    3. 使用下列程式代碼啟動您的腳本， client 以建立本文中使用的連線和變數。 此範例會在美國東部建立專案：

       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. （可選）如果你有多個帳號，請把你想用的Microsoft Entra ID的租戶 ID 加到 DefaultAzureCredential。

       DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
       

  Azure CLI

  • 安裝 Azure CLI。

  • 設定預設值為 subscription。

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

建立 Foundry 專案

Foundry 入口網站

這些步驟提供了建立一個包含基本預設設定的新 Azure 資源的方法。

要建立 Foundry project，請依照以下步驟操作：

1. 登入 Microsoft Foundry。 確定 新鑄造廠 的開關是開啟的。 這些步驟指的是 Foundry (新版)。

   

2. 你正在進行的 project 會出現在左上角。

3. 要建立新 project，請選擇 project 名稱，然後選擇 建立新 project。

4. 給你的project取個名字，選擇Create project。 或參閱下一節以取得進階選項。

進階選項

1. 你在一個 Foundry 資源上建立一個 Foundry project。 當你建立 project 時，入口網站會自動建立這個資源。 選擇一個現有 的資源群組 來使用，或保留預設以建立新的資源群組。

   小提示

   尤其是在開始時，為您的專案建立一個新的資源組。 資源群組讓管理專案及其所有資源變得更加容易。

2. 選取 [ 位置 ] 或使用預設值。 地點是指 project 資源存放的區域。

3. 選取 ，創建。 你可以看到資源創造的進展。 當流程完成時，該 project 就會被建立。

Python SDK

要建立 Foundry 計劃：

• 請加入以下程式碼，利用 Prerequisites 中的變數及 client 連線來建立 Foundry project。

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

  參考資料：CognitiveServicesManagementClient。

Azure CLI

1. 建立一個資源小組或使用現有的。 例如，在 my-foundry-rg中建立eastus：

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

2. 建立 Foundry 資源。 例如，在my-foundry-resource資源群組中建立my-foundry-rg：

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

   --allow-project-management 旗標允許在此資源中建立專案。

3. 為該資源建立自訂子網域。 自訂域名必須是全球唯一的。 如果 my-foundry-resource 已經被用了，試著用一個比較獨特的名字。

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

4. 建立這個專案。 例如，在 my-foundry-project 中建立 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. 確認該 project 是被創建的：

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

   輸出會顯示 project 屬性，包括其資源 ID。

參考資料：az cognitiveservices account

在相同的資源上建立多個專案

在現有的 Foundry 資源上建立多個 Foundry 專案，以促進團隊協作與共享資源access，包括安全性、部署及連網工具。 這種配置非常適合受限的 Azure 訂閱，當開發者需要在預設環境中自行探索時。

Foundry 專案作為 Azure 子資源，可能會被分配自己的 access 控制，但會共享來自父資源的網路安全、部署及 Azure 工具整合等共同設定。

雖然並非所有 Foundry 功能都支援以專案形式組織工作，但你的資源中的第一個「預設」專案功能更強大。 您可以使用程式碼選項時，透過UX體驗中的標籤「default」和資源屬性「is_default」來識別它。

特徵 / 功能	預設專案	其他項目
模型推斷	✅	✅
遊樂場	✅	✅
Agents	✅	✅
Evaluations	✅	✅
追蹤	✅	✅
數據集	✅	✅
索引	✅	✅
Foundry SDK 和 API	✅	✅
內容理解	✅	✅
OpenAI SDK 和 API	✅	回應、檔案、對話
OpenAI 批次處理、微調、儲存完成結果	✅	-
語言微調	✅	✅
語音微調	✅	-
連接	✅	✅

• 要將專案加入 Foundry 資源：

  Foundry 入口網站

  Foundry（新）入口網站僅顯示每個 Foundry 資源的預設專案。 你無法在 Foundry（新）入口網站中建立多個專案，也無法查看任何非預設專案。

  Python SDK

  雖然這些程式碼可以為資源新增專案，但你無法在 Foundry（新）入口網站中查看它們。 Foundry（新）入口網站中只有資源的預設專案可用。
  將這段程式碼加入你的腳本，在現有資源上建立新 project：

  # 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

  雖然這些程式碼可以為資源新增專案，但你無法在 Foundry（新）入口網站中查看它們。 在 Foundry（新）入口網站中，只有資源的預設專案可用。 要在 my-foundry-resource 中新增一個新的專案。

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

• 如果你刪除了 Foundry 資源的預設 project，下一個建立的 project 就會變成預設 project。

檢視專案設定

Foundry 入口網站

在 Home project 頁面上，你會看到project的project端點和 API 金鑰。 如果你使用 Microsoft Entra ID 認證，就不需要 API 金鑰。

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)

參考資料：CognitiveServicesManagementClient。

Azure CLI

要查看project設定，請使用 az cognitiveservices account connection show 指令。 例如：

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

刪除專案

Foundry 入口網站

1. 登入 Microsoft Foundry。 確定 新鑄造廠 的開關是開啟的。 這些步驟指的是 Foundry（新）。
2. 在右上角導覽中，選取 [操作]。
3. 在左窗格中，選取 [管理員]。
4. 選擇你的專案。
5. 在右上角，選擇垃圾桶圖示以刪除該 project。

Python SDK

這段程式碼使用了變數和先決條件中的 client connection。 首先，建立客戶端連結：

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

參考資料：CognitiveServicesManagementClient。

刪除 Foundry 資源及其所有專案：

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

參考資料：CognitiveServicesManagementClient。

Azure CLI

執行以下命令：

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

參考資料：az cognitiveservices account project delete.

這很重要

請謹慎使用。 project 被刪除後就無法恢復。

相關內容

• Microsoft Foundry 快速入門
• 什麼是 Foundry？