快速入門—設定你的第一個 Foundry 資源

在這個快速入門中，您將建立一個 Microsoft Foundry 資源並驗證其存取權。

學習如何建立和管理 Foundry 資源。 它是建立、部署和管理生成式 AI 模型與應用程式（包括Azure代理）的 主要Azure資源類型。

使用和管理 Azure 服務需要 Azure 資源。 它定義了設定存取、網路安全性、計費和監控等範圍。

Foundry 資源是先前「Foundry Tools」的下一版本與重新命名。 它提供應用程式環境來代管代理程式、模型部署、評估等。

Foundry 資源可為多種使用情境組織工作，通常由一組開發者 共享 ，這些開發團隊在類似的業務或資料領域中負責使用案例。 專案可作為資料夾來分組相關工作。

備註

Foundry 新入口網站中只有預設的專案。 使用 Foundry（經典版）入口網站與 Foundry 資源上的所有其他專案互動。

想用進階安全設定來設定 Foundry？ 請參閱 進階鑄造廠創建選項

建立您的第一個資源

要建立你的第一個資源，使用基本的 Azure 設定，請依照以下步驟使用 Azure portal、Azure CLI 或 PowerShell。

先決條件

• 有效的Azure訂閱 - 免費建立。
• Azure RBAC 角色用於創建資源。 你需要在 Azure 訂閱或資源群組上指派以下其中一個角色：
  • Contributor
  • 所有者
  • 指定具有 Microsoft.CognitiveServices/accounts/write 權限的自訂角色

建立新的 Microsoft Foundry 資源

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

Foundry 資源在 Azure portal 中列於 Foundry>Foundry。 API 種類為 AIServices。 尋找標誌，如下所示：

秘訣

Foundry 入口 提供一種使用基本預設設定建立新 Foundry 資源的方法。

要在 Azure portal 建立 Foundry 資源，請遵循以下指示：

1. 請選擇此 Foundry 資源連結：https://portal.azure.com/#create/Microsoft.CognitiveServicesAIFoundry

2. 在 [建立] 頁面上，提供下列資訊：

   專案詳情	描述
   訂用帳戶	請選擇您可用的 Azure 訂閱之一。
   資源群組	Azure 資源群組會包含你的 Foundry 資源。 您可以建立新的群組，或將其新增至預先存在的群組。
   區域	你的 Foundry 工具實例所在位置。 位置不同可能會造成延遲，但不會影響您資源執行階段的可用性。
   名稱	一個描述你的 Foundry 資源的名稱。 例如，MyAIServicesResource。

3. 視需要設定資源的其他設定，閱讀並接受條件 (若適用的話)，然後選取 [檢閱 + 建立]。

秘訣

如果你的訂閱無法建立 Foundry 資源，可能需要啟用該 Azure 資源提供者的權限，使用Azure portal、PowerShell 指令或 Azure CLI 指令。 如果您不是訂用帳戶的擁有者，請要求具有擁有者或系統管理員角色的人員為您完成註冊，或要求將 /register/action 權限授與您的帳戶。

清除資源

如果你想清理並移除 Foundry 資源，可以刪除該資源或資源群組。 刪除資源群組也會刪除與群組中的任何其他資源。

1. 在Azure portal中，展開左側選單以開啟服務選單，並選擇資源群組以顯示你的資源群組清單。
2. 找出要刪除的資源位於哪一個資源群組。
3. 如果您想要刪除整個資源群組，請選取資源群組名稱。 在下一個頁面上，選取 [刪除資源群組] 並且確認。
4. 如果你只想刪除 Foundry 資源，請選擇資源群組以查看該群組內的所有資源。 在下一個頁面上，選取您想要刪除的資源，選取該資料列的省略符號功能表，然後選取 [刪除]。

使用此快速入門指南，使用 Azure Command-Line 介面（CLI）指令建立 Foundry 資源。

先決條件

• 有效的Azure訂閱 - 免費創建一個。
• Azure CLI 版本 2.0 或更新版本。
• Azure RBAC 角色用於創建資源。 你需要在 Azure 訂閱或資源群組上指派以下其中一個角色：
  • Contributor
  • 所有者
  • 指定具有 Microsoft.CognitiveServices/accounts/write 權限的自訂角色

安裝 Azure CLI 並登入

安裝 Azure CLI。 要登入你本地安裝的 CLI，請執行 az login 指令：

az login

建立新的資源群組

在建立 Foundry 資源之前，你必須先有一個 Azure 資源群組來包含該資源。 當您建立新資源時，可以建立新的資源群組，或使用現有的資源群組。 本文說明如何建立新資源群組。

要建立資源，您需要使用針對您的訂閱可用的 Azure 位置之一。 你可以使用 az account list-locations 指令取得可用位置清單。 大多數 Foundry 工具可從多個地點存取。 選擇最接近您的位置，或查看可供服務使用的位置。

重要事項

• 請記得你的 Azure 位置，因為你在呼叫 Microsoft Foundry 資源時會需要它。
• 部分鑄造工具的供應情況會因地區而異。 欲了解更多資訊，請參閱Azure產品按地區分類。

az account list-locations --query "[].{Region:name}" --out table

確定Azure位置後，使用 az 群組 create 指令在Azure CLI中建立新的資源群組。 在下方範例中，將 Azure 位置 westus2 替換為你訂閱可用的 Azure 位置之一。

az group create --name ai-services-resource-group --location westus2

建立 Foundry 資源

要建立並訂閱新的 Foundry 資源，請使用 az cognitiveservices account create 指令。 此命令會將新的可計費資源新增至您稍早建立的資源群組。 當你建立新資源時，你需要知道你想使用的服務類型，以及它的定價層級（或 SKU）和 Azure 地點。

重要事項

Azure 提供多種 Foundry 工具的資源類型。 請務必使用 kind 的 AIServices 建立一個。

你可以用以下指令建立一個 foundry-multi-service-resource Foundry 資源。

az cognitiveservices account create --name foundry-multi-service-resource --resource-group ai-services-resource-group  --kind AIServices --sku S0 --location westus2 --yes

秘訣

如果你的訂閱無法建立 Foundry 資源，可能需要啟用該 Azure 資源提供者的權限，使用Azure portal、PowerShell 指令或 Azure CLI 指令。 如果您不是訂用帳戶的擁有者，請要求具有擁有者或系統管理員角色的人員為您完成註冊，或要求將 /register/action 權限授與您的帳戶。

取得資源的目前配額使用量

使用 az cognitiveservices account list-usage 指令來取得你資源的使用情況。

az cognitiveservices account list-usage --name foundry-multi-service-resource --resource-group ai-services-resource-group --subscription subscription-name

清除資源

如果你想清理並移除 Foundry 資源，可以刪除它或資源群組。 刪除資源群組也會刪除與群組中的任何其他資源。

若要移除資源群組及其相關聯的資源，請使用 az group delete command。

az group delete --name ai-services-resource-group

利用這個快速入門工具，使用 Azure PowerShell 指令建立 Foundry 資源。

先決條件

• 有效的Azure訂閱 - 免費創建一個。
• Azure PowerShell 版本 5.0 或更新版本。
• Azure RBAC 角色用於創建資源的目的。 你需要在 Azure 訂閱或資源群組上指派以下其中一個角色：
  • Contributor
  • 所有者
  • 指定具有 Microsoft.CognitiveServices/accounts/write 權限的自訂角色

安裝 Azure PowerShell 並登入

安裝 Azure PowerShell。 若要登入，請執行 Connect-AzAccount 命令：

Connect-AzAccount

建立一個新的 Microsoft Foundry 資源群組

在建立 Foundry 資源之前，你必須先有一個 Azure 資源群組來包含該資源。 當您建立新資源時，可以建立新的資源群組，或使用現有的資源群組。 本文說明如何建立新資源群組。

若要建立資源，您需要選擇您訂閱中可用的 Azure 區域之一。 您可以使用 Get-AzLocation 命令擷取可用位置的清單。 大多數 Foundry 工具可從多個地點存取。 選擇最接近您的位置，或查看可供服務使用的位置。

重要事項

• 記得你的 Azure 位置，因為你在呼叫 Foundry 資源時會需要它。
• 部分鑄造工具的供應情況會因地區而異。 欲了解更多資訊，請參閱Azure產品按地區分類。

Get-AzLocation | Select-Object -Property Location, DisplayName

確定Azure位置後，使用 New-AzResourceGroup 指令在Azure PowerShell建立新的資源群組。 在下方範例中，將 Azure 位置 westus2 替換為你訂閱可用的 Azure 位置之一。

New-AzResourceGroup -Name ai-services-resource-group -Location westus2

建立 Foundry 資源

要建立並訂閱新的 Foundry 資源，請使用 New-AzCognitive ServicesAccount 指令。 此命令會將新的可計費資源新增至您稍早建立的資源群組。 當你建立新資源時，你需要知道你想使用的「服務類型」、價格層級（或 SKU）以及 Azure 位置：

重要事項

Azure 提供多種 Foundry 工具的資源類型。 請務必使用 Type 的 AIServices (種類) 建立一個。

你可以用以下指令建立一個 foundry-multi-service-resource Foundry 資源。

New-AzCognitiveServicesAccount -ResourceGroupName ai-services-resource-group -Name foundry-multi-service-resource -Type AIServices -SkuName S0 -Location westus2

秘訣

如果你的訂閱無法建立 Foundry 資源，可能需要啟用該 Azure 資源提供者的權限，使用Azure portal、PowerShell 指令或 Azure CLI 指令。 如果您不是訂用帳戶的擁有者，請要求具有擁有者或系統管理員角色的人員為您完成註冊，或要求將 /register/action 權限授與您的帳戶。

取得資源的目前配額使用量

使用 Get-AzCognitiveServicesAccountUsage 命令來取得資源的使用量。

Get-AzCognitiveServicesAccountUsage -ResourceGroupName ai-services-resource-group -Name foundry-multi-service-resource

清除資源

如果你想清理並移除 Foundry 資源，可以刪除它或資源群組。 刪除資源群組也會刪除與群組中的任何其他資源。

若要移除資源群組及其相關聯的資源，請使用 Remove-AzResourceGroup 命令。

Remove-AzResourceGroup -Name ai-services-resource-group

存取你的資源

當你建立第一個資源後，可以透過 Foundry 入口網站進行 UX 原型設計，Foundry SDK 進行開發，或透過 Azure portal 進行管理。

驗證您的設定

你可以透過使用 Azure AI 專案 SDK 來連結並列出專案，來驗證你的資源是否正確設定。 這個簡單的例子證實了認證與存取權限。

# Install the SDK: pip install azure-ai-projects azure-identity
from azure.ai.projects import AIProjectClient
from azure.identity import DefaultAzureCredential

# Replace with your actual values from Azure portal
client = AIProjectClient(
    subscription_id="<your-subscription-id>",
    resource_group_name="<your-resource-group>",
    project_name="<your-project-name>",
    credential=DefaultAzureCredential()
)

# List projects to verify connection
projects = client.projects.list()
print(f"Successfully connected. Found {len(list(projects))} projects.")

預期輸出：Successfully connected. Found X projects.其中 X 是資源中的專案數目。

參考：

• AIProjectClient class
• DefaultAzureCredential class

授與或取得開發人員權限

Azure 角色為基礎的存取控制（RBAC）區分管理動作與開發動作的權限。 若要使用 Foundry 進行建置，必須為您的使用者帳戶指派開發人員權限 （「資料動作」）。 您可以使用其中一個內建 RBAC 角色，或使用自訂 RBAC 角色。

Foundry 內建的 Azure RBAC 開發者角色包括：

Role	描述
Azure AI Project Manager	授予開發權限及項目管理權限。 可以邀請其他使用者以「Azure AI 使用者」的身份合作開發project。
Azure AI 使用者	授與開發權限。
Azure AI 帳號擁有者	授予完整權限以管理 AI 專案和帳號。 可以邀請其他使用者以「Azure AI 使用者」的身份合作開發project。
Azure AI 擁有者	授權使用者對受管理的 AI 專案和帳戶進行完整的訪問，並利用這些專案進行建構與開發。

備註

Azure AI 擁有者角色即將在 Azure 與 Foundry 入口網站上開放指派。

對於有嚴格角色基礎 access 要求的大型企業，我們建議使用 Azure AI 使用者角色作為開發者權限最低的權限。 對於希望開發者在組織內自行服務的小型企業，我們建議利用 Azure AI 擁有者角色來取得開發權限及資源創建權限。

只有授權使用者，通常是 Azure 訂閱或資源群組擁有者，才能透過 [Azure portal]（連結至 Azure portal）或 [Foundry portal via Admin]（連結至 Foundry 入口）來指派角色。 了解更多關於角色為基礎的存取控制。

重要事項

Azure 擁有者與貢獻者角色只包含管理權限，不包含開發權限。 需要開發權限才能使用 Foundry 中的所有功能進行建置。

開始在你的第一個 project 裡建構

設定權限後，您現在就可以開始建置 Foundry。 在 Foundry 入口開啟或建立你的第一個專案。 專案會在 Foundry 中組織您的代理程式和模型自訂工作，您可以在 相同的資源下建立多個。

探索與您的資源捆綁在一起的一些服務：

服務	描述
Foundry 代理服務	結合生成式 AI 模型的力量與讓客服人員能access並互動真實世界數據來源的工具。
Azure 模型推論	為 Foundry 模型目錄中的旗艦型號進行模型推論。
Azure OpenAI	執行各式各樣的自然語言工作。
Content Safety	一個能偵測不想要內容的 Foundry 工具。
文件智慧	將檔案轉換成智慧型資料驅動解決方案。
語言	打造具備業界領先自然語言理解能力的應用程式。
Speech	語音轉文字、text to speech、翻譯和說話者辨識。
Translator	使用 AI 支援的翻譯技術來翻譯超過 100 種使用中、高風險和瀕危的語言和方言。

後續步驟

• 建立一個project來組織你的工作。
• 連接工具 以構建更豐富的應用程序。
• 了解 Foundry 中的存取控制，以邀請他人加入你的工作環境。
• 使用專用網路保護您的資源