使用適用於 Visual Studio Code 的 Microsoft Foundry Toolkit 擴充功能

在本文中，學習如何安裝及使用 Microsoft Foundry Toolkit for Visual Studio Code 擴充功能。 建立專案、部署 Foundry 模型目錄中的模型，並從 VS Code 內與模型遊樂場互動。

先決條件

安裝擴充功能

要在 VS Code 中使用 Foundry 功能，請安裝 Microsoft Foundry Toolkit for Visual Studio Code 擴充功能。 可從 Visual Studio Code 市集安裝，或直接在 VS Code 內安裝。

從 Visual Studio Code 市集安裝

在市集安裝擴充功能時，不用先打開 VS Code。

  1. 打開 Microsoft Foundry Toolkit for Visual Studio Code 擴充功能頁面。
  2. 選擇 安裝 按鈕。
  3. 依照指示在 Visual Studio Code 安裝擴充功能。
  4. 安裝後，打開 Visual Studio Code，並從狀態訊息確認擴充功能是否安裝成功。
  5. Foundry 工具包圖示會出現在 VS Code 左側的主導航列中。

從 Visual Studio Code 中安裝

或者，也可以直接從 VS Code 擴充功能檢視中搜尋該擴充功能。

  1. Open VS Code。

  2. 從左側窗格選擇 「擴充功能 」。

  3. 從擴充功能面板右上角選擇 設定 圖示。

  4. 搜尋並選擇 Foundry Toolkit for VS Code。

  5. 選擇 安裝。

  6. 安裝完成後，會跳出狀態訊息確認擴充功能已安裝。 Foundry 工具包圖示會出現在左側導覽列。

連接你的 Azure 資源

安裝擴充功能後，登入你的 Azure 訂閱，並開啟 Foundry 專案，開始操作模型、代理程式和遊樂場。

註

欲查看擴充功能的完整功能清單，請使用指令面板。 選擇 F1 開啟指令面板並搜尋 Foundry Toolkit。 以下截圖展示了部分可用的指令。 VS Code 指令調色盤的截圖，顯示可用的 Foundry Toolkit 指令，如 Open Model Catalog 和 Open Playground。

登入您的資源

登入你的 Azure 訂閱，讓擴充套件能存取你的 Foundry 專案和已部署的模型。

  1. 在 VS Code 導航列中選擇 Azure 圖示。

  2. 在 Azure 資源檢視中選取登入 Azure...

  3. 在Resources區塊中，選擇您的Azure訂閱與資源群組。

  4. 選擇 Foundry ，然後右鍵點擊你的專案。

  5. 選擇 在 Foundry 工具包擴充功能中開啟。

    你的 Foundry 專案資源會出現在擴充功能檢視中，Foundry 圖示會顯示在 VS Code 導航列上。

Microsoft Foundry Visual Studio Code 擴充套件將您的工作空間組織成三個主要區塊。

Microsoft Foundry 工具包Visual Studio Code擴充介面截圖，顯示資源、工具、說明與回饋區塊。

章節 內容 何時使用它
我的資源 已部署的模型、宣告式代理、託管代理、連線以及向量儲存庫，適用於你的 Foundry 專案。 檢視並管理您的專案資源。
開發人員工具 模型目錄、模型遊樂場、代理遊樂場（遠端與本地）、本地視覺化工具，以及部署託管代理。 部署新模型、測試提示詞，並與代理互動。
求助與回饋 文件、GitHub 倉庫、Microsoft 隱私聲明及社群連結。 尋求幫助或提供回饋。

建立一個專案

直接從擴充功能建立一個新的 Foundry 專案，來組織你的模型和資源。

  1. 在 Microsoft Foundry Toolkit for Visual Studio Code 擴充功能檢視的 我的資源 區段中，選取 + 建立專案。

    你可以建立新的資源群組，或選擇現有的。

  2. 要建立新的資源群組：

    1. 選擇 建立新資源群組 並按下 Enter 鍵。

    2. 在Enter new resource group文字框輸入Azure資源群組名稱，並按下Enter鍵。

    3. 從可用地點列表中選擇你想使用的地點，然後按下 Enter。

  3. 若要使用現有的資源群組：

    • 從可用資源群組列表中選擇你想使用的資源群組，然後按下 Enter。

  4. 在 「輸入專案名稱 」文字框中輸入 Foundry 專案名稱，並按下 Enter。

部署project後，會跳出一個訊息，顯示Project已成功部署。

要將模型部署到新建立的專案，請在彈窗中選擇 「部署模型 」按鈕。 此操作會開啟 模型目錄 頁面，您可以選擇想要 部署的模型。

切換預設專案

當你在 Microsoft Foundry Toolkit for Visual Studio Code 擴充套件中開啟專案時，該專案會被設定為你的預設專案。 要切換預設專案：

  1. 在 Foundry 專案上右鍵點擊，然後選擇 在 Azure 擴充功能中切換預設專案 選項。

  2. 從可用專案列表中選擇你想使用的 Foundry 專案，然後按下 Enter 鍵。

選取的專案現在會在專案名稱後顯示 預設狀態 。

提示

右鍵點擊你的專案名稱即可存取專案端點或專案 API 金鑰。

與模型合作

Microsoft Foundry 工具包用於 Visual Studio Code 擴充功能，讓你能直接在 VS Code 中發現、部署並互動 Foundry 模型目錄的模型。

瀏覽模型型錄

模型目錄提供來自 Microsoft、OpenAI、Meta、Deepseek 及其他供應商的模型存取。 你可以用幾種方式開啟模型目錄：

  • 執行 Foundry 工具包：從指令面板中顯示模型目錄 指令。
  • 在 Visual Studio Code 的 Microsoft Foundry Toolkit 擴充功能檢視中，選取 我的資源 區段內 模型 旁的 加號 圖示。
  • 請在Microsoft Foundry Toolkit 的 Developer Tools 區塊中選擇 Model Catalog 連結以瀏覽擴充檢視Visual Studio Code。

從指令調色盤開啟模型目錄

使用指令調色盤開啟模型目錄，無需瀏覽擴充視圖。

  1. 選擇 F1 開啟指令面板。

  2. 進入 Foundry Toolkit：顯示模型目錄 並按下 Enter 鍵。

  3. 型號 目錄 頁面開啟。

    VS Code 模型目錄頁面的截圖，顯示模型卡片並有出版商和模型類型的篩選器。

  4. 請使用頁面頂部的下拉選單，依Hosted by、Publisher、Feature或Model type來篩選Model Catalog。 選擇 微調支持 的切換開關來篩選支持微調的模型。

  5. 請使用頁面頂端中央的搜尋欄搜尋特定型號。

從資源區塊開啟模型目錄

在 Visual Studio Code 的 Microsoft Foundry Toolkit 擴充功能檢視中，選取 Models 旁邊的 plus 圖示，以開啟模型目錄。

提示

你也可以右鍵點選 模型 ，選擇 部署新 AI 模型 ，直接進入部署流程。

從工具區開啟模型目錄

在 Microsoft Foundry Toolkit for Visual Studio Code 擴充功能檢視的 Developer Tools 區段中，按兩下 Model Catalog 連結。

從模型目錄中部署模型

在目錄中找到模型後，部署到你的 Foundry 專案，這樣你就能在應用程式中使用。

  1. 選擇選定型號名稱旁的 部署 按鈕。

  2. 模型 部署 頁面開啟。

  3. 在 「輸入部署名稱 」文字框中輸入模型部署名稱並按下 Enter。

  4. 請在「 部署類型 」下拉選單中選擇部署類型。

  5. 在 型號版本 下拉選單中選擇型號版本。

  6. （可選）使用每分鐘代幣量滑桿調整代幣數量。

  7. 選擇左下角的 「在 Foundry 部署 」按鈕。

  8. 在確認對話框中，選擇 部署。

  9. 部署完成後，模型會依部署名稱出現在您的專案中的 模型 區塊中。

檢視並管理已部署的模型

在 Visual Studio Code 擴充功能檢視中的 Microsoft Foundry Toolkit 裡展開 Models 區段，即可查看專案中所有已部署的模型。

查看型號卡資訊

選擇已部署的模型以開啟包含以下細節的面板：

  • 部署資訊：名稱、配置狀態、部署類型、速率限制、版本資訊、模型名稱及模型版本。
  • 端點資訊：目標 URI 連結、認證類型與金鑰。
  • 實用連結：AI 應用開發的程式碼範例庫與教學連結。

更新模型部署設定

要更新部署設定，例如速率限制：

  1. 選擇模型卡片右上角的 編輯 按鈕。
  2. 更新可編輯欄位。
  3. 選擇 儲存 按鈕以套用變更。

產生模型範例程式碼

為已部署的模型產生一個起始程式碼檔，以加速應用程式開發。

  1. 右鍵點擊你已部署的模型，選擇 開啟程式碼檔案。

  2. 在 「選擇首選 SDK 」下拉選單中選擇你偏好的 SDK。

  3. 在 「選擇語言 」下拉選單中選擇您偏好的語言。

  4. 在 「選擇認證方式 」下拉選單中選擇您偏好的認證方式。

  5. 一個範例程式碼檔案會在 VS Code 的新分頁中開啟。

以下截圖展示了一個產生的 Python 範例，該範例會同步呼叫回應 API：

產生的Python範例程式碼截圖，顯示 VS Code 中同步回應 API 呼叫。

在操場上與模型互動

利用模型遊樂場與已部署的模型互動對話、調整設定及修改系統指令。

要開啟遊樂場，請雙擊Microsoft Foundry 工具包中 Developer Tools 區塊中的 Model Playground 連結，即可查看擴充功能檢視Visual Studio Code。 或者，右鍵點選你已部署的模型，選擇 「在 Playground 開啟」。

  1. 遊樂場 頁面已開啟。

  2. 輸入你的提示詞並檢視結果。

  3. 在右上角選擇 「檢視程式碼 」，以查看如何以程式化方式存取模型部署。

  4. 請選擇遊樂場左上角的 「瀏覽紀錄 」連結，查看你的聊天紀錄。

排除常見問題

如果您在使用 Microsoft Foundry Toolkit for Visual Studio Code 擴充功能時遇到問題，請檢查以下常見問題：

問題 解決方法
安裝後擴充套件不出現 重新啟動 VS Code，並在 擴充功能 檢視中確認擴充功能是否啟用。
登入失敗或訂閱無法載入 請確認你的 Azure 帳號有正確的權限。 試著從Azure資源檢視中登出再登入。
模型部署因配額錯誤而失敗 檢查你的訂閱配額，然後申請增加或刪除未使用的部署。

清理資源

你在這篇文章中建立的 Azure 資源會被計入你的 Azure 訂閱。 如果你未來不打算用到這些資源，請刪除以免產生更多費用。

刪除你的模型

  1. 在 VS Code 的導覽列中，重新整理 Microsoft Foundry Toolkit for Visual Studio Code 擴充功能。 在 「我的資源 」區塊中，展開「 模型 」子區塊。

  2. 右鍵點擊你想移除的已部署模型，然後選擇 刪除。

刪除 Azure 資源

要刪除資源群組及所有資源，方法如下：

警告

刪除資源群組會永久移除該群組內的所有資源，包括你的 Foundry 專案和已部署的模型。 這個行動無法撤銷。

  1. 開啟Azure傳送門。
  2. 請導覽到包含你 Foundry 專案的資源群組。
  3. 選擇 刪除資源群組 並確認刪除。

下一步

  • Last updated on