在 Visual Studio Code 中建立並管理 Foundry Classic 代理（預覽）（經典版）

備註

本文件指的是 Microsoft Foundry（經典版） 入口網站。

🔍 請參閱 Microsoft Foundry（新）文件 以了解新入口網站。

備註

本文件指的是經典版的代理 API。

Foundry Agent Service 讓你可以在不使用 Visual Studio Code（VS Code）的情況下建置、配置和部署代理程式。 在本文中，你使用設計器建立代理，新增工具，在遊樂場測試代理，產生範例程式碼，完成後整理資源。

這很重要

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

先決條件

• Azure 訂用帳戶。 免費創建一個。
• 存取 Foundry 代理服務。
• 已經安裝 Visual Studio Code。
• Microsoft Foundry for VS Code 擴充套件安裝並登入。
• 你專案中的 已部署模型 。

在設計器中建立代理人

設計器提供視覺化介面，用於配置代理人的名稱、型號、指示與工具。

1. 登入您的 Azure 資源。

2. 設定您的預設專案。

3. 在 Foundry 擴充檢視中，可以找到資源區塊中的經典子區。

4. +子區塊旁選擇加號（）圖示以建立新的代理人。

在設計器中設定代理

選擇儲存位置後，agent 的 .yaml 檔案和設計視窗會開啟。 設定下列設定：

1. 在提示中，輸入客服專員的名稱。

2. 在下拉式清單中，選取模型部署的名稱。 部署名稱是您部署現有模型時所選擇的名稱。

3. 延伸模組會產生 Id 值。 設定下列欄位：

   • 新增您的代理程式的描述。
   • 設定系統指令。
   • 設定供代理程式使用的工具。

4. 若要儲存 .yaml 檔案，請選取 VS Code 功能表列上的 檔案>儲存 。

檢視代理 YAML 定義

.yaml 檔案會與設計器一起開啟，裡面包含你代理程式的設定細節。 格式類似以下範例：

# yaml-language-server: $schema=https://aka.ms/ai-foundry-vsc/agent/1.0.0
version: 1.0.0
name: my-agent
description: Description of the agent
id: ''
metadata:
  authors:
    - author1
    - author2
  tags:
    - tag1
    - tag2
model:
  id: 'gpt-4o-1'
  options:
    temperature: 1
    top_p: 1
instructions: Instructions for the agent
tools: []

在代理中新增工具

代理服務提供以下工具以擴展您的代理能力並連結您的資料來源：

• 使用 Bing 搜尋進行基礎設置
• 檔案搜尋
• 程式碼解譯器
• OpenAPI 指定的工具
• 模型內容通訊協定 （MCP）

欲了解更多使用 MCP 工具的資訊，請參閱 Visual Studio Code 中的 Agent Service 與 MCP 伺服器工具（預覽版）相關說明。

在代理中新增工具

1. 在設計工具中，在 [工具] 區段的右上角，選取 [ 新增工具]。 在下拉式清單中，選取您要新增的工具。

   

2. 設計者顯示出適當的窗格以設定工具，如下圖所示：

   • 通過 Bing 搜尋進行接地：

     

   • 檔案搜尋：

     

   • 程式碼解釋器：

     

   • OpenAPI 3.0指定工具：

     

3. 輸入必要資訊之後，請選取 [建立並連線]、[上傳並儲存] 或 [建立工具]。 按鈕標籤依工具類型而異。

   工具建立後，會出現在設計器（Designer）的 TOOL 區塊中。

當您新增工具時，您也可以新增所需的任何新資產。 舉例來說，如果你新增檔案搜尋工具，可以使用現有的向量儲存資產，或建立新的資產來承載你上傳的檔案。

將代理程式部署到 Foundry

完成代理設定後，部署到 Foundry，讓它在雲端運行。

1. 在設計器中，選擇 「在 Microsoft Foundry 建立代理 」按鈕。

2. 在 VS Code 中，重新整理 資源 檢視。 已部署的代理出現在經典代理小節中。

查看已部署代理的詳細資訊

選擇已部署的代理程式，以僅檢視模式開啟 代理偏好設定 窗格。 從這個窗格，您可以：

• 選擇 編輯代理 以開啟代理設計器並編輯 .yaml 定義。
• 選擇 檢視程式碼 以產生使用代理程式的範例程式碼檔案。
• 選擇 「開放遊樂場 」以開啟遠端代理遊樂場。

更新已部署的代理程式

你可以修改已部署代理的設定，並將變更同步回 Foundry。

1. 在 AGENT PREFERENCES 面板中，選擇 編輯 Agent。 代理程式設計工具會開啟代理程式的 .yaml 檔案。

2. 編輯代理程序的設定，例如模型、工具和指示。

3. 選擇 Microsoft Foundry 的更新代理 按鈕來儲存你的變更。 更新後的配置立即生效。

產生範例程式碼檔案

這個擴充功能會產生模板程式碼，用來程式化地與你部署的代理程式互動。

1. 右鍵點選你已部署的代理程式，然後選擇 檢視程式碼。 或者，在 代理偏好設定 面板中，選擇 「檢視代碼 」按鈕。

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

3. 在 「選擇語言 」下拉選單中，選擇你的語言。

4. 在 「選擇認證方法 」下拉選單中，選擇你的認證方法。

擴充功能會根據您選擇的語言產生程式碼文件，並在編輯器中開啟。

檢視範例程式碼檔

產生的程式碼檔案展示了透過 Foundry Projects API 與代理互動的基本呼叫。 以下截圖展示了一個 Python 範例：

在操場測試代理人

利用 Playground 向已部署的代理發送訊息並驗證其行為。

1. 右鍵點擊你已部署的代理程式，然後選擇 Open Playground。

   或者，在工具子區選選「遠端代理遊樂場」連結，選擇你的代理類型，然後從下拉選單中選擇你的代理。

   遠端 代理遊樂場 面板會打開並啟動一個與代理的對話串。

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

   此範例使用 Bing Grounding 來說明資訊的 Web 搜尋。 代理程式會使用您在代理程式設計工具中設定的模型和工具。 資訊的來源會顯示在客服專員註解的區段中。

   

查看代理執行緒

Threads 子區會顯示在與你的代理程式執行期間建立的對話串。 在 經典 版的 資源 檢視下，展開 「線索 」子區塊以查看清單。

備註

討論串是客服專員和使用者之間的對話。 執行緒儲存訊息並自動處理截斷，以使內容適應模型的上下文。 訊息是一種單一互動，可以包含文字、圖片及其他檔案。 執行是代理的單一執行，可以跨越多個執行緒和訊息。

檢視線程詳細數據

要查看 「執行緒詳細 」面板，請從列表中選擇一個執行緒。

檢視執行詳細數據

要查看執行資訊，請在「執行串詳細資訊」面板中選擇「檢視執行資訊」按鈕。 .json 檔案會開啟，內含執行細節，包括代理設定、訊息及工具呼叫。

清理資源

如果你不需要建立的資源，請刪除它們，以避免持續向 Azure 訂閱收費。

刪除代理程式

小提示

因為你可以自訂 Microsoft Foundry 入口網站的 左側窗格 ，你可能會看到與這些步驟中顯示不同的項目。 如果您沒有看到您要尋找的內容，請選取左窗格底部的 ... 更多。

1. 在 VS Code 中，重新整理 [Azure 資源] 檢視。
2. 展開「 代理」 子節以顯示已部署代理的清單。
3. 右鍵點擊你想刪除的代理人，然後選擇 刪除。

刪除您的模型

1. 在 VS Code 中，重新整理 資源 檢視。 展開 [ 模型] 子區段以顯示已部署的模型清單。

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

刪除已連接的工具

1. 開啟 Azure 入口網站。

2. 前往包含該工具資源的資源群組。

3. 選擇資源，然後選擇 刪除。

相關內容

• 在 Visual Studio Code（預覽版）中使用 Agent Service 和 MCP 伺服器工具，將 MCP 工具加入你的代理程式。
• 代理工具概述，詳細介紹檔案搜尋、程式碼解譯器及其他可用工具。
• Foundry Agent Service 概覽，深入探討代理的概念與功能。