為 Microsoft Foundry 建立專案

利用本文建立 Foundry 專案，並在開始建立代理、評估與檔案前，確認您的環境已準備好。

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

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

先決條件

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

• 如果你是為自己創作這個專案：

  • 可使用一個角色，讓你在訂閱或資源群組中建立 Foundry 資源，例如 Azure Account AI Owner或 Azure AI Owner。 欲了解更多權限資訊，請參閱 Microsoft Foundry 的 基於角色的存取控制。

• 如果你是為團隊創建專案：

  • 你可以訪問允許你完成角色指派的角色，例如Owner。 欲了解更多權限資訊，請參閱 Microsoft Foundry 的 基於角色的存取控制。
  • 一份需要存取權限的團隊成員的電子郵件地址或 Microsoft Entra 安全群組 ID 清單。

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

Foundry 入口網站

• 使用入口網站時不需要其他先決條件。

Python SDK

• 建立你的開發環境。

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

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

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

• 快速驗證：在建立專案前，先透過測試客戶端來驗證你的 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.")
  

• 使用下列程式代碼啟動您的腳本， 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"
  )
  

• （可選）如果你有多個帳號，請將你想用的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 計劃：

• 請使用前置條件部分的變數與 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": {}
      }
  )
  

  參考資料：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 子資源，可能會被分配自己的存取控制，但會共享來自其父資源的網路安全、部署及 Azure 工具整合等共同設定。

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

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

• 要將專案加入 Foundry 資源：

  Foundry 入口網站

  1. 選取右上角導覽中的 [操作]。
  2. 選取左窗格中的 管理員 。
  3. 選擇你想新增專案的父資源。
  4. 選擇 新增專案。

  Python SDK

  將這段程式碼加入你的腳本，在現有資源上建立新 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

  要在 my-foundry-resource 中新增一個新的專案。

   az cognitiveservices account project create \
   --name my-foundry-resource \
   --resource-group my-foundry-rg \
   --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 project show 指令。 例如：

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

允許團隊成員訪問

如果你是為團隊創建專案，請將 Azure AI User 角色分配給團隊成員，讓他們能使用專案及其資源。 此職務提供建置與測試 AI 應用程式所需的最低權限。 關於其他可能需要指派的角色，請參見 Microsoft Foundry 的角色型存取控制。

這很重要

要完成角色分配，你需要像是專案 負責人 這樣的角色。 欲了解更多資訊，請參閱 Microsoft Foundry 的 基於角色的存取控制。

Foundry 入口網站

1. 在 Foundry 入口網站中，請在右上角的導覽中選擇 「操作 」。
2. 選取左窗格中的 管理員 。
3. 在表格中選擇你的專案名稱。
4. 在右上角選擇 新增使用者 。
5. 輸入該團隊成員的電子郵件地址。
6. 選取 ，然後新增。

對每位團隊成員或安全團隊重複這些步驟。

小提示

要同時新增多個使用者，請使用 Microsoft Entra 安全群組，而非個別電子郵件地址。

Python SDK

使用 Azure CLI 或 Foundry 入口網站來管理角色分配。 Python SDK 不支援角色指派操作。

Azure CLI

1. 取得專案資源ID：

   PROJECT_ID=$(az cognitiveservices account project show \
     --name my-foundry-resource \
     --resource-group my-foundry-rg \
     --project-name my-foundry-project \
     --query id -o tsv)
   

2. 將 Azure AI 使用者角色指派給團隊成員：

   az role assignment create \
       --role "Azure AI User" \
       --assignee "user@contoso.com" \
       --scope $PROJECT_ID
   

   要新增安全群組而非個別使用者：

   az role assignment create \
       --role "Azure AI User" \
       --assignee-object-id "<security-group-object-id>" \
       --assignee-principal-type Group \
       --scope $PROJECT_ID
   

3. 確認角色分配：

   az role assignment list \
       --scope $PROJECT_ID \
       --role "Azure AI User" \
       --output table
   

參考文獻：az 角色分配

驗證團隊成員存取權限

請團隊成員登入 Microsoft Foundry，並從專案列表中選擇專案來驗證存取權限。

如果團隊成員無法存取專案，請確認角色指派是否成功完成。 請確認你使用了正確的電子郵件地址或安全群組 ID。 請確保團隊成員的 Azure 帳號在同一個 Microsoft Entra 租戶中。

刪除專案

Foundry 入口網站

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

Python SDK

這段程式碼使用了前置條件中的變數和 client 連結。 要刪除單一專案：

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-resource \
--resource-group my-foundry-rg \
--project-name my-foundry-project

參考資料：az cognitiveservices account project delete.

這很重要

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

建立你的第一個連結

相關內容

• Microsoft Foundry 快速入門
• 什麼是 Foundry？
• 使用 Bicep 模板建立資源