Microsoft Foundry 經歷了多次命名與架構變更。 如果你是從傳統入口網站體驗轉換，本文將協助你規劃並執行過渡過程，並附上術語、功能、SDK 及入口網站導航的參考映射。
註
產品命名：Microsoft 的 AI 平台已從 AI Studio → Azure AI Foundry → Azure演變為現行的 Microsoft Foundry。 同樣地，我們的 AI 服務組合也隨平台演變，從 Azure Cognitive Services → Azure AI Services → 發展到 Foundry Tools（目前）。 儘管平台演進，Azure資源類型仍維持Microsoft.CognitiveServices/accounts。 本文件中的所有名稱均指同一不斷演進的平台。
先決條件
- 一個有有效訂閱的 Azure 帳號。 免費創建一個。
- Foundry 專案。
-
SDK 遷移時： Python 3.9+ 或 .NET 8+，並安裝
azure-ai-projects2.x 和openai套件。 - 針對資源升級：您計畫升級之 Azure OpenAI 資源上的 Owner 或 Contributor 角色。
重要
主要遷徙日期：
-
2026 年 5 月 30 日 —
azure-ai-inference套件淘汰。 遷移到套件openai。 - 2026年8月26日 — 助理API終止。 請使用一般提供的 Microsoft Foundry Agents 服務。 請依照 遷移指南 更新你的工作負載。 了解更多。
規劃你的遷移
請依照以下步驟從經典入口網站體驗轉換到目前的 Foundry 入口網站：
- 檢視術語變更。 掃描 術語映射 ，以理解重新命名的概念和新的資源類型。
- 請查看功能比較。 使用 功能比較 表來識別新功能、增強功能或僅限經典功能。
- 更新你的 SDK 套件。 使用 SDK 映射 表替換已棄用的套件。
- 將代理遷移到 Responses API。 在 2026 年 8 月淘汰之前，請將使用 Assistants API 的 Agent 改寫為使用 Responses API。
- 確認你的 Foundry 資源區域支援回應 API。 回應 API 和 Foundry 代理服務並非在每個 Azure 區域都能使用。 如果你的 Foundry 資源位於不支援的區域，代理程式和其他回應 API 功能在目前的入口網站中無法使用。 遷移前請先查看 Responses API 區域可用性 清單。
- 請在新的入口網站驗證。 使用 入口網站導航 參考來驗證你目前的工作流程。
重要
回應 API 並非所有 Azure 區域都能使用。 如果你的 Foundry 資源位於不支援的區域，你就無法在目前的 Foundry 入口網站中建立或執行代理。 遷移前，請確認你的資源是否位於 支援區域。 如果沒有，就在支援區域建立一個新的 Foundry 資源。
術語映射
下表將經典概念對應於其現今對應概念。
| 概念 | 經典術語 | 現任任期 | 註釋 |
|---|---|---|---|
| 入口（主要） | Foundry（舊版）入口 | 鑄造廠入口 | 入口網站橫幅中的切換按鈕可在兩者之間切換。 |
| 傳送門設定 | 管理中心 | 操作區段 | 導覽重新整理。 |
| 資源類型 | Azure OpenAI + Hub | Foundry 資源 | 單一 AIServices 種類，具子專案。 |
| AI 服務 | Azure AI 服務 | 鑄造工具 | 語言、視覺、語言、內容安全、內容理解。 |
| 模特兒計費 | Model-as-a-Service （MaaS） | Foundry 直交模型 | 第一方模型直接透過 Azure 電表計費。 |
| RBAC 角色 | 認知服務 OpenAI 使用者 | Foundry 使用者、Foundry 專案經理、Foundry 擁有者 | 新職位需要控制平面與資料平面分離。 |
| API 線路協定 | 助理 API | 回應 API | 助理 API 終止日期：2026 年 8 月 26 日。 |
| API 版本管理 | 每月參數api-version |
V1 穩定路由 | 不需要版本參數。 |
| 對話狀態 | 線程 | 對話 | 對話儲存的是項目（訊息、工具呼叫、輸出），而不只是訊息。 |
| 聊天訊息 | 訊息 | 物品 | 項目是訊息的超集。 |
| 處決 | Runs (非同步、輪詢) | 回應（預設同步） | 不需要輪詢循環。 |
| 代理人定義 | 助理/代理人 | 代理版本 | 已版本化，並明確標明種類（提示、工作流程、託管）。 |
| 代理程式建立 | create_agent() |
create_version() |
使用 PromptAgentDefinition。 |
| 端點 | 多重（OpenAI、azureml、cognitiveservices、search、speech） | 單一專案端點 + OpenAI v1端點 | 簡化的端點管理。 |
| 文件 | 經典紀錄片 | 當前文件 | 內容分成兩個不同的文件集。 |
重要
Foundry RBAC 角色最近已重新命名。 Foundry 用戶、Foundry 擁有者、Foundry Account Owner 以及 Foundry Project Manager 先前分別被稱為 Azure AI 使用者、Azure AI 擁有者、Azure AI 帳戶擁有者及 Azure AI Project 管理者。 在更名期間，你可能還會在某些地方看到之前的名字。角色 ID 與核心權限不會因命名而改變。
SDK 映射
請參考下表，辨識哪些 SDK 套件對應到目前的 Foundry 體驗，以及它們會取代哪些。
| SDK 套件 | 經典對應 | 現況 | 註釋 |
|---|---|---|---|
openai |
azure-ai-inference |
用於模型推論 |
azure-ai-inference 將於2026年5月30日退休。 |
OpenAI() 和 base_url |
AzureOpenAI() |
使用標準客戶端 | Azure專用程式碼已移除。 |
azure-ai-projects 2.x |
azure-ai-projects 1.x |
穩定版 — 目標為新入口網站 | 1.x 版本的目標是經典的傳送門體驗。 |
azure-ai-projects 2.x |
azure-ai-generative |
穩定 | 功能整合到專案客戶端。 |
azure-ai-projects 2.x |
azure-ai-ml |
穩定 | 適用於中樞到專案的移轉案例。 |
azure-ai-projects （遠端） + azure-ai-evaluation （本地） |
azure-ai-evaluation （獨立系統） |
穩定 | 透過專案客戶遠端評估;當地評價未變。 |
azure-search-documents （資料來源：Project Connections） |
azure-search-documents |
穩定 | 獨立套件，可透過專案客戶端發現。 |
警告
確保 SDK 版本符合你的入口網站體驗。 使用 2.x SDK 範例搭配 1.x 設定（或反過來）會出錯。
以下範例展示了最常見的 SDK 遷移方式——將專屬Azure的 AzureOpenAI 用戶端替換為標準的 OpenAI 用戶端。
經典（之前）：
from openai import AzureOpenAI
client = AzureOpenAI(
azure_endpoint="https://my-resource.openai.azure.com",
api_key="my-key",
api_version="2024-12-01-preview"
)
目前（之後）：
from openai import OpenAI
from azure.identity import DefaultAzureCredential, get_bearer_token_provider
client = OpenAI(
base_url="https://my-project.services.ai.azure.com/openai/v1",
default_headers={"Authorization": f"Bearer {get_bearer_token_provider(DefaultAzureCredential(), 'https://cognitiveservices.azure.com/.default')()}"}
)
功能比較
以下表格比較了經典與現行入口網站體驗的功能可用性。
兩個入口網站皆可取得
| 特色 | 經典 | 現況 | 註釋 |
|---|---|---|---|
| 鑄造廠專案 | ✅ | ✅ | |
| 聊天完成 | ✅ | ✅ | |
| 微調 | ✅ | ✅ | |
| 評估 | ✅ | ✅ | 在現有平台中強化 |
| 車型目錄 | ✅ | ✅ | 在目前入口網站中擴充 |
目前入口網站新增內容
以下功能僅在目前的 Foundry 入口網站中提供：
| 特色 | 現況 |
|---|---|
| 回應 API | GA |
| Agents v2（回應 API） | GA |
| 工具目錄（1,400+工具） | GA（請檢查目錄中各工具標籤，以判斷它們是 GA 還是預覽） |
| 多代理工作流程 | 預覽 |
| 代理記憶體 | 預覽 |
| Agent 發佈至 M365/Teams | GA |
| Foundry IQ | 預覽 |
| 託管代理 | 預覽 |
| A2A 協定 | 預覽 |
| 鑄造廠控制平面 | 預覽 |
僅限經典版（需遷移）
| 特色 | 經典 | 現況 | 遷徙行動 |
|---|---|---|---|
| Azure OpenAI 資源 | ✅ | 使用 Foundry 資源 | 升級至 Foundry 平台資源 |
| 樞紐式專案 | ✅ | 看不見 | 切換到經典入口網站或遷移到 Foundry 專案 |
操作入口
經典入口網站使用單一可自訂的左側面板進行所有導航，管理 中心 位於底部。 目前的入口網站將特色分為五個頂層區域，每個區域都有自己的左側窗格。
| 章節 | Scope | 你在那裡會發現什麼 |
|---|---|---|
| 首頁 | 精選計畫 | 專案概述與快速動作 |
| 探索 | 精選計畫 | 模型目錄與模型基準測試 |
| 建造 | 精選計畫 | 代理人、模型、遊樂場、評估、微調 |
| 操作 | 所有專案 | 管理、配額、合規、車隊健康、追蹤 |
| 文件 | 無 | 文件連結 |
下表將常用的傳統入口網站位置對應到其現行對等位置。
| 任務 | 經典入口位置 | 目前入口位置 |
|---|---|---|
| 查看模型部署 | 左側窗格中的模型 + 端點 | 建置>模型 |
| 開放遊樂場 | 左側窗格的遊樂場 | 生成>模型> 選擇一個模型 |
| 組建代理程式 | 左側窗格中的代理 | 建置>代理程式 |
| 瀏覽模型型錄 | 左側窗格的模型目錄 | 探索>車型目錄 |
| 查看評價 | 左側面板評估 | 構建>評估 |
| 微調模型 | 左側窗格的微調 | 建造>微調 |
| 追蹤與監控 | 左側窗格中的追蹤 | 操作>追蹤 |
| 管理配額 | 管理中心>配額 | 操作>配額 |
| 管理使用者與權限 | 管理中心>使用者 | 操作>管理 |
| 查看所有專案與資源 | 管理中心>所有資源 | 操作>管理 |
| 連結資源 | 管理中心>連結資源 | 操作>管理>選擇專案 |
| 護欄與內容過濾器 | 左側面板的防護欄與控制項 | 操作>合規 |
切換入口介面體驗
你可以隨時在經典與現行的傳送門體驗間切換。 切換鍵會保留你目前的情境，例如你正在進行的專案。
提示
目前的入口網站僅顯示鑄造廠專案。 如果你需要存取樞紐專案或其他資源類型，請切回經典入口網站。
- 在頂部橫幅尋找 新鑄造廠 的切換開關。
- 選擇切換開關，在經典與現代體驗間切換。
- 頁面會重新載入並呈現所選的入口介面。
排除常見遷移問題
| 症狀 | 成因 | 解決方法 |
|---|---|---|
ModuleNotFoundError 或是 API 出現意外行為 |
SDK 版本與你的入口網站目標不符 | 檢查 SDK 映射 表並安裝正確的套件版本 |
| 新入口網站中缺少的專案 | 目前的入口網站中看不到以樞紐為基礎的專案 | 切換到經典入口網站以存取基於樞紐的專案，或 遷移到 Foundry 專案（文章可見於經典文件中） |
| 端點連線失敗 | 舊的多端點 URL 不再解析 | 更新至單一專案端點格式（https://<project>.services.ai.azure.com） |
AuthenticationError 與新客戶 |
API 金鑰搭配 OpenAI() 用戶端使用時，未附上正確標頭 |
請使用 DefaultAzureCredential 搭配 Bearer 權杖提供者，如 SDK 移轉範例所示 |
代理代碼回傳 404 或 MethodNotAllowed |
助理功能的 API 呼叫被發送到回應 API 端點 | 重寫代理程式以使用 Responses API（create_version() 而非 create_agent()） |
| 目前入口網站中無法使用 Agent | Foundry 資源位於不支援 Responses API 的區域 | 在支援區域建立 Foundry 資源 |