與 Microsoft Foundry for Visual Studio Code 擴充功能（預覽版）協作

Microsoft Foundry 提供企業 AI 作業、模型建置及應用程式開發的統一平台。 此基礎結合了生產等級的基礎結構與易記的介面，確保組織能夠自信地建置及作 AI 應用程式。

透過 Foundry，你可以：

• 使用強固的模型目錄，從 Microsoft、OpenAI、Meta、DeepSeek 等部署最新的語言模型

• 在模型遊樂場中測試已部署的模型

• 使用 Azure 策劃的程式代碼範本集合，快速開始開發產生 AI 應用程式

• 使用 Foundry Agent Service 配置並部署代理程式

透過 Foundry for Visual Studio Code 擴充功能，你可以直接從 Visual Studio Code 完成大部分工作流程。 它也隨附其他功能，例如程式代碼範本、遊樂場，以及與其他 VS Code 延伸模組和功能的整合。

本文將教你如何快速開始使用 Foundry for Visual Studio Code 擴充功能。

這很重要

本文中標示為 (預覽) 的項目目前處於公開預覽狀態。 此預覽版本沒有服務等級協定，不建議將其用於生產工作負載。 可能不支援特定功能，或可能已經限制功能。 如需詳細資訊，請參閱 Microsoft Azure 預覽版增補使用條款。

先決條件

在使用 Foundry for Visual Studio Code 擴充功能之前，您必須：

• 下載、安裝及設定 Visual Studio Code。 更多資訊：下載 Visual Studio Code

• 您的訂用帳戶必須低於 配額限制 ， 才能在本快速入門中部署新的模型。 否則，您必須已經具有已部署的聊天模型。

• 請設定適當的 RBAC 權限，使用 Visual Studio Code 擴充功能來建立和管理 Foundry 資源。 欲了解更多資訊，請參閱 Foundry 的角色基礎存取控制。

安裝

安裝 Visual Studio Code 後，你需要安裝 Foundry for Visual Studio Code 擴充功能。

要安裝 Foundry for Visual Studio Code 擴充功能，你可以使用 Visual Studio Code Marketplace，或直接在 Visual Studio Code 內安裝。

從 Visual Studio Code Marketplace 安裝

要從 Visual Studio Code 市集安裝 Foundry for Visual Studio Code 擴充功能，請依照以下步驟操作：

1. 打開 Foundry for Visual Studio Code 擴充功能頁面。
2. 選取 [安裝] 按鈕。
3. 請遵循提示，在 Visual Studio Code 中安裝延伸模組。
4. 安裝之後，請開啟 Visual Studio Code，並確認延伸模組已成功從狀態消息安裝。
5. 延伸模組現在應該會顯示在 Visual Studio Code 左側的主要導覽列中。

從 Visual Studio Code 內安裝

要在 Visual Studio Code 中安裝 Foundry for Visual Studio Code 擴充功能，請依照以下步驟操作：

1. 開啟 Visual Studio Code。

2. 從左窗格選取延伸模組。

3. 選取延伸模組窗格右上方的設定圖示。

4. 搜尋並選擇 Foundry。

5. 選取安裝。

6. 從狀態訊息確認已成功安裝延伸模組。

開始

請依照以下步驟開始使用 Foundry 擴充功能。

備註

如需擴充功能的完整清單，請使用命令選擇區。 選擇 F1 開啟指令面板並搜尋 Foundry。 以下截圖展示了 Foundry 的一些操作。

登入您的資源

使用下列步驟登入您的 Azure 訂用帳戶以存取您的資源：

1. 選取 VS Code 導覽列上的 Azure 圖示。

2. 在 Sign in to Azure... 檢視中選取 專案以登入。

   

3. 在 [資源] 區段底下，選取您的 Azure 訂用帳戶和資源群組。

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

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

   

探索鑄造廠擴建區

Foundry 擴充套件會在獨立的檢視中開啟，而 Foundry 圖示現在顯示在 VS Code 的操作列上。 延伸模組有三個主要區段：資源、工具和說明與意見反應。

• 資源：本區包含您在 Foundry 專案中可使用的資源。 資源區塊是與鑄造服務互動的主要介面。 包含下列子區段：

  • 模型：本節包含可用來建置和部署 AI 應用程式的模型。 在 Foundry 專案中，模型檢視 是您可以找到已部署模型的地方。
  • 代理人：本區包含你在 Foundry 專案中部署的代理人。
  • 資產：本區包含您在 Foundry 專案中擁有的資產。
    • 連結：本小節包含您在 Foundry 專案中擁有的連結。 例如，Bing Grounding 連線。
    • 向量儲存：本小節包含你 Foundry 專案中的向量儲存。
  • 執行緒：此區段包含在 Foundry 專案中由已部署代理執行的執行緒。

• 工具：本節包含可用來建置和部署 AI 應用程式的工具。 [工具] 檢視可讓您找到可用來部署的工具，然後與已部署的模型和代理程式搭配使用。 包含下列子區段：

  • 模型目錄：可用來探索和部署模型之模型目錄的連結。
  • 模型遊樂場：用於與 Foundry 專案中部署模型互動的模型遊樂場連結。
  • 代理遊樂場：代理遊樂場的連結，以便與你在 Foundry 專案中部署的代理互動。

• 幫助與回饋：本區包含 Foundry 文件、回饋、支援及 Microsoft 隱私聲明的連結。 包含下列子區段：

  • 文件：Foundry 擴充功能文件的連結。
  • GitHub：指向 Foundry 擴充套件 GitHub 倉庫的連結。
  • Microsoft隱私聲明：Microsoft隱私聲明的連結。
  • 加入 Foundry 社群：Discord + 論壇：Foundry 社群 Discord 伺服器的連結。

備註

想了解更多關於在 Foundry 擴充套件中使用代理與執行緒的資訊，請參閱《 Visual Studio Code 中的代理服務工作 》文章。

建立專案

你可以透過以下步驟從 Foundry 擴充視窗建立新的 Foundry 專案：

1. 在 Foundry 擴充視窗的資源區塊中，選擇資源旁邊的加號圖示。

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

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

   1. 在頂端中心，選取 [建立新的資源群組 ]，然後按 Enter。

      

   2. 在頂端中心，輸入 [輸入 新的資源群組 ] 文本框中要使用的 Azure 資源組名，然後按 Enter。

   3. 在頂端中心，從可用位置清單中選取您想要使用的位置，然後按 Enter。

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

   • 在頂端中心，從可用的資源群組清單中選取您想要使用的資源群組，然後按 Enter 鍵。

4. 在頁面中央上方的輸入專案名稱文字框中輸入 Foundry 專案名稱，然後按 Enter 鍵。

   

在專案部署之後，會出現一個彈出視窗，並顯示成功 部署 Project 的訊息。

若要將模型部署到新建立的專案，請選取彈出視窗中的 [ 部署模型 ] 按鈕。 此動作會在 Foundry 擴充檢視中開啟 模型目錄 頁面，選擇想要部署的模型 。

預設的鑄造廠專案

當你在 Foundry 擴充套件中開啟專案時，該專案會被設定為你的預設專案。

請遵循下列步驟來切換您的預設專案：

1. 右鍵點擊 Foundry 專案，選擇 Azure 擴充套件中的 Switch 預設專案 選項。

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

您選取的項目現在會顯示 [預設 ] 之後的項目名稱。

與模型合作

Foundry for Visual Studio Code 擴充功能讓您能在 Visual Studio Code 內建立、互動並部署大型語言模型。

使用模型目錄探索所有模型

Foundry 入口網站中的 模型目錄 是發現並使用各種模型以建構生成式 AI 應用的樞紐。

從數種不同的方式存取模型目錄：

• Foundry：開放模型目錄指令面板命令。
• 在 Foundry 擴充檢視的資源區塊中，選擇模型旁的加號圖示。
• 在 Foundry 擴充檢視中的工具區塊中選擇模型目錄連結。

從命令選擇區開啟模型目錄

從指令面板存取模型目錄，探索並部署 Foundry 中精選的模型，直接在 VS Code 內部使用。

1. 選取 F1 以開啟命令選擇區。

2. 進入 Foundry：Open Model 目錄 並按下 Enter 鍵。

3. [ 模型目錄 ] 頁面隨即顯示。

   

4. 使用頁面左上角的下拉式清單，依 和/或Publisher篩選Task。

5. 使用頁面頂端中心的搜尋列來搜尋特定模型。

從 [資源] 區段開啟模型目錄

模型目錄也可在鑄造廠擴充檢視的資源區段取得。

在 Foundry 擴充視窗中，選取模型旁的加號圖示即可開啟模型目錄。

小提示

您也可以以滑鼠右鍵按兩下 [模型 ]，然後選取 [ 部署新的 AI 模型] 選項，以開啟 [模型目錄] 以開始部署程式。

從 [工具] 區段開啟模型目錄

模型目錄也可在 Foundry 擴充檢視的「工具」區段取得。 按兩下 [模型目錄 ] 連結以開啟模型目錄。

從模型目錄部署模型

使用下列步驟在模型目錄中部署選取的模型：

1. 在選取的模型名稱之後，選取 [ 在 Azure 中部署 ]。

   

2. [ 模型部署] 頁面隨即顯示。

   

3. 在 [輸入部署名稱] 文本框中輸入要使用的模型 部署名稱 ，然後按 Enter。

   

4. 選取 [ 部署類型 ] 下拉式清單中要使用的部署類型，然後按 Enter。

   

5. 選取 [ 模型版本 ] 下拉式清單中要使用的模型版本，然後按 Enter。

   

6. 如果需要，選擇要在「每分鐘令牌」滑桿中使用的令牌數量，然後按 Enter 鍵。

7. 在左下角，選擇 「部署於 Foundry 」按鈕來部署模型。

8. 確認對話框隨即出現。 選取 [ 部署] 按鈕，將模型部署至您的專案。

   

9. 成功部署之後，您的模型將會依部署名稱與專案中 [ 模型 ] 區段下的其他已部署模型一起列出。

   

檢視已部署的模型

在 [Azure 資源延伸模組] 檢視中，選取 [模型] 區段前面的插入點圖示，以檢視已部署的模型清單。

展開的 [模型] 區段會顯示已部署的模型清單。

檢視模型卡片資訊

選取已部署的模型會開啟提供一些基本資訊的面板：

• 部署資訊：本節包含模型的相關信息：
  • 名稱
  • 佈建狀態
  • 部署類型
  • 速率限制資訊
  • 版本資訊
  • 模型名稱
  • 模型版本
• 端點資訊：本節包含目標 URI 鏈接、驗證類型和金鑰。
• 有用的連結：本節包含程式碼範例存放庫和教學課程連結，以開始使用 AI 應用程式開發。

更新模型

若要更新模型卡片資訊，請選取模型卡片右上方的 [ 編輯 ] 按鈕。

直接在 VS Code 中更新所需的可編輯欄位，例如速率限制。

若要儲存變更，請選取模型卡片右上方的 [ 儲存 ] 按鈕。

探索模型範例程序代碼

使用下列步驟建立範例程式代碼檔案。

1. 以滑鼠右鍵按兩下已部署的模型，然後選取 [ 開啟程式代碼檔案 ] 選項。

   

2. 在頂端中心，選取您在 [選擇慣用 SDK ] 下拉式清單中要使用的慣用 SDK，然後按 Enter。

   

3. 在頂端中心，選取您在 [選擇語言 ] 下拉式清單中要使用的慣用語言，然後按 Enter。

   

4. 在頂端中心，選取您在 [選擇驗證方法 ] 下拉式清單中要使用的慣用驗證方法，然後按 Enter。

   

範例程式代碼檔案

這個 Python 範例程式代碼檔案示範對聊天完成 API 的基本呼叫。 呼叫是同步的：

使用模型遊樂場與模型互動

使用 模型遊樂場以互動方式與模型、變更設定和系統指示聊天。

模型遊樂場可在 Foundry 擴充檢視的工具區段中使用。 按兩下 模型遊樂場 連結，以開啟模型遊樂場。

您也可以使用下列步驟來開啟模型遊樂場：

1. 以滑鼠右鍵按兩下已部署的模型，然後選取 [ 在遊樂場中開啟 ] 選項。

   

2. [遊樂場] 頁面隨即顯示。

   

3. 輸入您的提示，並查看輸出。

4. 此外，您可以使用右上角的 檢視程序代碼 ，查看如何以程序設計方式存取模型部署的詳細數據。

5. 選取遊樂場左上角的 [ 歷程記錄 ] 連結，以檢視聊天記錄。

清理資源

您在本文中建立的 Azure 資源會向您 Azure 訂用帳戶收費。 如果您預計未來不需要這些資源，請將其刪除，以避免產生更多費用。

刪除您的模型

1. 在 VS Code 導覽列中，重新整理 Foundry 擴充套件。 在 [ 資源] 區段中，展開 [ 模型 ] 子區段以顯示已部署的模型清單。

2. 以滑鼠右鍵按兩下已部署的模型以刪除，然後選取 [ 刪除] 選項。

   

刪除您的工具

使用下列步驟刪除連線的工具：

1. 開啟 Azure 入口網站
2. 選取包含此工具的 Azure 資源群組。
3. 選取 [刪除] 按鈕。

後續步驟

• 了解如何使用這個 Visual Studio Code 擴充功能 來操作代理服務 。