為 Microsoft Foundry 建立專案

備註

本文件指的是 Microsoft Foundry（經典版） 入口網站。

🔄如果你正在使用新的入口網站，請切換至 Microsoft Foundry（新版）文件。

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

• Foundry 專案由 Microsoft Foundry 資源管理。 它是用於存取管理、資料上傳和整合以及監控的容器。 這可讓您將工作分隔在使用案例之間，而不需要建立額外的 Azure 資源。

• 此專案類型讓您能使用Foundry最新的生成式AI功能，包括：

  • 代理人
  • Foundry SDK 和 API 可構建代理並在模型之間輕鬆切換
  • Azure 直接銷售的模型 - Azure OpenAI、Mistral、xAI、DeepSeek 等。
  • 透過 Marketplace 銷售的合作夥伴和社群模型 - Stability、Cohere 等。
  • 內容理解
  • 評估
  • 微調
  • OpenAI SDK 和 API，包括批次和預存完成
  • 鑄造工具

• 您需要存取開源模型或 PromptFlow 嗎？ 請改為建立中樞專案類型。

• 如需不同專案類型的詳細資訊，請參閱專案類型。

如果您的組織需要自訂的 Azure 設定，例如替代名稱、安全性控制或成本標籤，您可能需要使用 Azure 入口網站 或 範本選項 來符合組織的 Azure 原則需求。

先決條件

使用下列索引標籤來選取您要用來建立 Foundry 專案的方法：

Foundry 入口網站

• 具有有效訂閱的 Azure 帳戶。 如果您沒有，請建立 免費的 Azure 帳戶，其中包含免費試用訂用帳戶。

• 你必須是訂閱 的擁有者 ，才能擁有建立 Foundry 資源所需的適當存取權限，該資源是專案的母資源。 如果你沒有這個權限，請你的管理員 幫你建立一個 Foundry 資源 供你使用。 然後跳至 在相同資源上建立多個專案 ，以建立您的專案。

Python SDK

• 具有有效訂閱的 Azure 帳戶。 如果您沒有，請建立 免費的 Azure 帳戶，其中包含免費試用訂用帳戶。
• 您必須是訂用帳戶的 擁有者 ，才能取得使用專案所需的適當存取控制。
• 設定開發環境
• 在執行程式碼之前，先在您的環境中執行 az login 或 az login --use-device-code 。

• 完成下列步驟以啟動 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 租用戶識別碼新增至 DefaultAzureCredential。

     DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
     

  5. （選用）如果您在 Azure 政府 - 美國 或 21Vianet 區域營運的 Azure 中工作，請指定您要驗證的區域。 此範例會向 Azure Government - 美國區域進行驗證：

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

Azure CLI

• 具有有效訂閱的 Azure 帳戶。 如果您沒有，請建立 免費的 Azure 帳戶，其中包含免費試用訂用帳戶。

• 您必須是訂用帳戶的 擁有者 ，才能接收使用專案所需的適當訪問控制。

• 安裝 Azure CLI

• 設定subscription和resource group的預設值。

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

建立 Foundry 專案

Foundry 入口網站

這些步驟提供使用基本預設設定建立新 Azure 資源的方法。

若要建立 Foundry 專案，請遵循下列步驟：

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

   

2. 接下來要做什麼取決於您的位置：

   • 如果你沒有現有專案：請依照 快速入門的步驟：開始使用 Microsoft Foundry 建立你的第一個專案。

   • 如果您位於專案中：選取專案階層連結，然後選取 [建立新資源]。

     

   • 如果你不在專案中：請選擇右上角的 「建立新」 以建立新的 Foundry 專案

     

3. 選取 Foundry 資源，然後選取 下一步。

4. 提供項目的名稱，然後選取 [ 建立]。 或者請參閱下一節以了解高級選項。

進階選項

1. Foundry 專案是在 Foundry 資源上建立的。 當您建立專案時，系統會自動為您建立此資源。 選取您想要使用的現有 資源群組 ，或保留預設值以建立新的資源群組。

   小提示

   特別是在開始使用時，建議您為專案建立新的資源群組。 資源群組可讓您輕鬆地同時管理專案及其所有資源。

2. 選取 [ 位置 ] 或使用預設值。 位置是託管專案中資源的區域。

3. 選取 ，創建。 您可以查看資源建立的進度。 專案會在程式完成時建立。

Python SDK

若要建立 Foundry 專案：

• 新增此程式碼，以使用client」中的變數和連線來建立 Foundry 專案。

  # 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. 請用以下指令從 Azure CLI 驗證你的 Azure 訂閱：

   az login
   

   如需有關驗證的詳細資訊，請參閱驗證方法。

2. 建立一個資源團體，例如在美國東部：

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

3. 建立 Foundry 資源

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

4. 建立一個專案：

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

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

在現有 Foundry 資源上建立多個 Foundry 專案，以促進團隊協作與資源共享存取，包括安全性、部署及連網工具。 此設定非常適合受限制的 Azure 訂用帳戶，其中開發人員需要在預先設定環境的設定中進行自助式探索功能。

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

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

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

• 若要將專案新增至 Foundry 資源：

  Foundry 入口網站

  小提示

  因為你可以自訂 Microsoft Foundry 入口網站的 左側窗格 ，你可能會看到與這些步驟中顯示不同的項目。 如果您沒有看到您要尋找的內容，請選取左窗格底部的 ... 更多。

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

     

  2. 選擇 Foundry 專案或其相關資源。

  3. 在左窗格中，選取 [ 管理中心]。

  4. 在資源區段中，選取 [ 概觀]。

  5. 選取 [新增專案 ] 並提供名稱。

     

  Python SDK

  將此程式代碼新增至您的文稿，以在現有的資源上建立新專案：

  # 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_resource_name} 值，將另一個專案加入資源：

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

• 如果您刪除 Foundry 資源的預設專案，則建立的下一個專案將會成為預設專案。

檢視項目設定

Foundry 入口網站

在專案 首頁 上，您可以找到專案的相關資訊。

• 名稱：專案的名稱會顯示在左上角。
• 訂用帳戶：裝載中樞的訂用帳戶，而該中樞會裝載此專案。
• 資源群組：包含專案所在中樞的資源群組。

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

若要檢視專案的設定，請使用 az cognitiveservices account connection show 命令。 例如：

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

刪除專案

Foundry 入口網站

1. 登入 Microsoft Foundry。 確定新鑄造廠的開關是關閉的。 這些步驟指的是Foundry (classic)。
2. 開啟您的專案。
3. 選取 [管理中心]。
4. 在 資源下，選取 概觀。
5. 選取您不想再保留的任何專案。
6. 選取 [刪除專案]。

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

1. 在 管理中心 中，從 概觀 區段中選取資源名稱，以移至 Azure 入口網站。
2. 在 Azure 入口網站中，選取 [刪除] 以刪除資源及其所有相關聯的專案。

Python SDK

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

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

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

Azure CLI

執行以下命令：

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

相關內容

• 快速入門：開始使用 Foundry
• 什麼是 Foundry？