為 Microsoft Foundry（經典版）建立專案

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

目前正在觀看：Foundry（經典）入口版本 - 切換到新 Foundry 入口網站版本

本文說明如何在 Microsoft Foundry 中建立 Foundry 專案。專案讓你能組織工作——例如代理人、評估和檔案——同時建立有狀態的應用程式並探索新點子。

Foundry 專案 由 Microsoft Foundry 資源管理。它是一個用於存取管理、資料上傳與整合，以及監控的容器。這樣你就能在不同使用情境間分隔工作，而不需要額外建立 Azure 資源。
如果你需要使用開源模型或 PromptFlow，請建立一個中心專案類型。
欲了解更多不同專案類型的資訊，請參閱專案類型。

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

先決條件

一個有有效訂閱的 Azure 帳號。如果你還沒有，請建立一個free Azure帳號，其中包含免費試用訂閱。
存取可讓您建立 Foundry 資源的角色，例如訂用帳戶或資源群組上的 Foundry 帳戶擁有者或 Foundry 擁有者。欲了解更多權限資訊，請參閱 Microsoft Foundry 的基於角色的存取控制。

重要

Foundry RBAC 角色最近已重新命名。 Foundry 用戶、Foundry 擁有者、Foundry Account Owner 以及 Foundry Project Manager 先前分別被稱為 Azure AI 使用者、Azure AI 擁有者、Azure AI 帳戶擁有者及 Azure AI Project 管理者。在更名期間，你可能還會在某些地方看到之前的名字。角色 ID 與核心權限不會因命名而改變。

如果你沒有這個角色，請你的訂閱管理員建立一個 Foundry 資源，然後跳過「在同一資源上建立多個專案」。

請使用以下分頁選擇您想使用的方法來建立 Foundry 專案：

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

建立你的開發環境。
在執行程式碼前，先在你的環境中執行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 Government - US 或由 21Vianet 運營的 Azure 地區工作，請指定你想驗證的地區。此範例認證至 Azure Government - 美國區域：
```
from azure.identity import AzureAuthorityHosts
DefaultAzureCredential(authority=AzureAuthorityHosts.AZURE_GOVERNMENT)
```

安裝 Azure CLI。
設定預設值為 subscription。

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

建立鑄造廠專案

請使用以下其中一種方法。

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

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

登入 Microsoft Foundry。確定 新鑄造廠 的切換開關是關閉的。這些步驟指的是Foundry (classic)。
接下來你要做什麼，取決於你所在的位置：
- 如果你還沒在專案中，或還沒有任何專案：在右上角選擇 「建立新」 以建立新的 Foundry 專案
- 如果你正在專案中：選擇專案的路徑導航，然後選擇建立新資源。
選取 Foundry 資源，然後選取 下一步。
請為你的專案提供名稱並選擇 「建立」。或參考下一節了解進階選項。

進階選項

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

提示

尤其是剛開始時，為你的專案建立一個新的資源群組。資源群組讓管理專案及其所有資源變得簡單。
選擇地點或使用預設位置。地點是指專案資源存放的區域。
選擇 「建立」。你可以看到資源創造的進展。當流程完成時，專案即被建立。

要建立 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。

建立一個資源小組或使用現有的。例如，在 my-foundry-rg中建立eastus：
```
az group create --name my-foundry-rg --location eastus
```

建立 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 旗標可在此資源內建立專案。

為該資源建立自訂子網域。自訂網域名稱必須是全球唯一的。如果 my-foundry-resource 已經被用了，試著用一個比較獨特的名字。
```
az cognitiveservices account update \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --custom-domain my-foundry-resource
```

創建專案。例如，在 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

確認專案是被創建的：

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

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

參考：az cognitiveservices 帳戶

在同一資源上建立多個專案

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

圖示顯示團隊如何在 Foundry 資源上與多個專案共享資源存取權。

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

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

特色	預設專案	其他計畫
模型推論	✅	✅
遊樂場	✅	✅
代理人	✅	✅
評估	✅	✅
追蹤	✅	✅
資料集	✅	✅
索引	✅	✅
Foundry SDK 與 API	✅	✅
內容理解	✅	✅
OpenAI SDK 與 API	✅	回應、檔案、對話
OpenAI 批處理、微調、儲存生成內容	✅	-
語言微調	✅	✅
語音微調	✅	-
連接	✅	✅

要將專案加入 Foundry 資源：
提示

因為你可以在 Microsoft Foundry 入口網站中自訂左側窗格，所以你可能會看到與這些步驟中顯示的不同物品。如果你找不到你想要的，選擇 ⋯⋯更多選項 在左側窗格底部。
1. 登入 Microsoft Foundry。確定 新鑄造廠 的切換開關是關閉的。這些步驟指的是Foundry (classic)。
2. 選擇 Foundry 專案或其相關資源。
3. 在左側窗格，選擇 管理中心。
4. 在資源區塊，選擇 「概覽」。
5. 選擇 新專案 並輸入名稱。
將這段程式碼加入你的腳本，在現有資源上建立新專案：
```
# 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": {}
    }
)
```
新增專案至 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 資源的預設專案，下一個建立的專案就會變成預設專案。

查看專案設定

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

名稱：專案名稱顯示在左上角。
訂閱：承載該專案資源的訂閱。
資源群組：承載該專案所承載資源的資源群組。

# 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。

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

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

刪除專案

登入 Microsoft Foundry。確定 新鑄造廠 的切換開關是關閉的。這些步驟指的是Foundry（經典版）。
打開你的專案。
選擇 管理中心。
在 資源中，選擇概覽。
選擇你不想再保留的專案。
選擇 刪除專案。

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

在管理中心，從概覽區選資源名稱，前往 Azure 入口網站。
在Azure入口網站中，選擇 Delete 以刪除該資源及其所有相關的專案。

這段程式碼使用了前置條件中的變數和 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。

執行以下指令：

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

參考：az cognitiveservices 帳戶專案刪除。

重要

請小心使用。專案被刪除後就無法恢復。

建立你的第一個連結

意見反應

此頁面對您有幫助嗎？

Last updated on 2026-05-20

為 Microsoft Foundry（經典版）建立專案

先決條件

建立鑄造廠專案

進階選項

在同一資源上建立多個專案

查看專案設定

刪除專案

相關內容

意見反應

其他資源