使用 Microsoft Foundry Toolkit for Visual Studio Code 建立提示代理程式

使用 Microsoft Foundry Toolkit for Visual Studio Code 中的 Agent Builder，來設定提示代理的模型、指令與工具。 在 Playground 中測試代理、將變更儲存為版本，並產生可供應用程式呼叫該代理的用戶端程式碼。

本文先從儲存在 Foundry 中的提示代理程式談起。 代理建構器也支援 本地儲存的提示詞，這些提示具有不同的儲存、工具與評估選項。 關於基於程式碼的替代方案，請參見 「建立代理人」。

先決條件

• 安裝 Microsoft Foundry Toolkit for Visual Studio Code。
• 選擇鑄造廠專案。 你需要權限才能建立代理並使用專案的模型和工具。 參見 Foundry 基於角色的存取控制。
• 該專案中的模型部署。 請參閱設定 Foundry 資源。

本地提示開發不需要 Foundry 專案，除非你使用 Foundry 資源。

建立一個提示代理

先從模型和說明開始，然後儲存並測試代理，再加工具。

1. 在 Foundry 工具包檢視中，選擇開發工具>建構>建立代理。

2. 選擇 「建立代理人 」以開啟代理人建構器。

3. 在 基本資訊中輸入 代理人姓名。 名稱須以字母或數字開頭和結尾。 你可以在它們之間使用連字號。

4. 從 模型中選擇 Foundry 主機模型。 如果需要新增模型，請使用 瀏覽模型 。

5. 在 指令中，描述任務、所需行為及預期反應。 例如，請代理透過識別報告的問題、重現步驟及預期行為來總結軟體問題。 告訴它在資訊不足時先詢問缺少的資訊，而不是憑空捏造細節。

6. 選擇 「儲存到 Foundry」。

7. 在 Playground 標籤中輸入請求並選擇 發送訊息。 問個後續問題來測試對話的氣氛。

8. 檢視回應是否符合你的指示。 細化說明書，儲存，然後視需要重複。

   

如果開發者工具使用 按資源群組， 建立代理程式 會放在 代理開發工具 裡，而不是 建置。 另一個入口是 我的資源> > 代理程式> > 提示代理程式> > 新增提示代理程式。 在該列表中選取現有的代理程式以進行編輯。

選擇存檔地點

可用的存檔動作依據所選模型與工具而定。

Microsoft Foundry 和 Local 徽章顯示代理程式的存放地點。 本地儲存的提示仍然可以呼叫雲端模型。 本地儲存並不代表推論會在你的機器上執行。

存檔草稿與版本

Agent Builder 將本地的復原草稿與已儲存的代理版本分開。

如果 Agent Builder 找到復原草稿，請選擇 還原草稿 或 捨棄。 在切換代理或版本前，請明確保存重要的變更。

你可以測試現有 Foundry 代理程式中尚未儲存的變更。 該執行使用已編輯的設定，而非儲存的代理版本參考。 在依賴連結至版本的對話、追蹤或產生的用戶端程式碼之前，請先儲存。

選擇代理版本

使用代理名稱旁的版本選擇器載入已儲存的版本。 Foundry 代理版本是不可變的。 若要保留早期版本的編輯，請選擇 「儲存至 Foundry 」以建立新版本。

所選版本決定 Agent Builder 中顯示的對話歷史及產生的客戶端程式碼所參考的版本。 關於服務版本的詳細資訊，請參見 「將變更儲存為版本」。

為 Foundry 代理程式新增工具

工具將代理者與模型外的資訊與行動連結起來。 可用的工具取決於模型、你的權限以及專案中的資源。 使用 Tool Catalog 設定共享連線與認證，然後在 Agent Builder 中附加。

1. 在 遊樂場 標籤中開啟已儲存的 Foundry 代理。
2. 在 工具中，選擇 +>新增工具。
3. 在 選擇工具中，從 配置中選擇一個連線，或使用 目錄 來尋找工具。
4. 完成所需設定後，選擇 新增工具。
5. 選擇 「儲存到 Foundry」。
6. 發送需要該工具的請求，並檢視其輸入與結果。 如果客服人員要求核准 ，請選擇 批准或 拒絕 該通話。

要檢視 MCP 工具的工具呼叫批准設定，請開啟其選項並選擇 「配置」。 你可以要求核准、自動核准所有工具，或自動核准特定工具。 在存錢前仔細檢視選擇。

核准設定不會授權存取底層服務。 關於服務權限，請參見 代理身份概念。

使用工具箱（預覽）

工具箱將可重用工具歸類於受管理的 MCP 端點後方。 技能搜尋和工具搜尋皆為預覽版功能。

代理人會使用工具箱或獨立的 Foundry 工具。 附加工具箱會取代其個別工具。 在附上工具箱後， 新增工具 會將工具箱內的工具加入。

工具箱的編輯會暫時保留，直到你儲存代理，他們才會建立新的工具箱版本。 工具箱是共享資源;儲存前請檢視工具箱和代理變更。

1. 開啟已儲存的 Foundry 代理程式。

2. 在工具中，選擇+>瀏覽工具箱。

3. 選擇一個工具箱，檢視其版本、工具與技能。

4. 選取 ，然後新增。

5. 展開工具箱卡片以檢視內容並檢視核准設定。

6. 選擇 「儲存到 Foundry」，然後測試使用其工具的請求。

   

你也可以從工具箱資源列表中選擇 「新增到提示代理 」。 關於工具箱建立與共享連線，請參見 工具目錄。

管理附屬工具箱

使用工具箱卡片的 「更多」選項 選單，然後在修改後儲存代理。

使用 A2A 連接另一個代理程式（預覽版）

代理對代理（A2A）連線可讓提示代理程式將與 A2A 相容的代理作為工具來呼叫。 你可以直接裝上，也可以透過工具箱安裝。 直接附加不需要工具箱的加選設定。

1. 開啟已儲存的 Foundry 代理程式。

2. 在工具中，選擇+>新增代理（A2A）。

3. 在 「Connect an A2A agent」中，選擇相應的分頁。

   Tab	需提供的內容
   已設定	選擇一個現有的 A2A 連線。 當有已配置的連線時，這個分頁就會出現。
   目錄	從 Foundry 帳戶目錄中選擇一位代理人。 當提示時完成代理卡及認證步驟。
   自定義	輸入名稱、有效的 HTTPS 端點，以及代理卡路徑。 如有需要，請選擇「 取得代理人卡時的認證 」。

4. 完成對話以連接或新增代理人。

5. 選擇 「儲存到 Foundry」，然後測試需要連線的請求。

   

關於端點設定、代理卡、身份選項及權限，請參見 啟用 A2A 端點。

回顧對話並更換經紀人

遊樂場包含目前的測試對話。 選擇 「清除所有訊息 」以開始新的對話。

對於已儲存的 Foundry 代理，請選擇 對話 以檢視所選版本的歷史紀錄。 選擇一個對話以檢視其訊息和回覆細節。 開啟歷程記錄不會接續在遊樂場中的對話。

使用 Agent Builder 頂端的代理選擇器，在本地提示與 Foundry 提示代理之間切換。 切換後檢查儲存徽章和版本。 對話標籤是給已儲存的 Foundry 代理使用的，不是本地提示。

產生並改進指令

使用 Generate 從任務描述中草擬指令，或用 Improve 來修訂現有指令。 當場地空無一人時， Inspire me 可以提供一個起點。

1. 選擇支援指令產生的模型。
2. 在 指令中，若欄位為空，選擇 生成 ;若包含指令，則選擇 改善 。
3. 描述任務或變更。 對於現有的 Foundry 代理，改進建議是可選的。
4. 在對話框中選擇 產生 或 改進 。
5. 請檢視修訂後的指示及測試代表的申請。
6. 選擇 「儲存到 Foundry 」以保留設定。

對於已儲存的 Foundry 代理，這些動作會使用 Foundry Prompt Optimizer。 若優化 API 不支援該模型，工具包會在支援時退回標準提示產生。 在新草稿中選擇 Foundry 模型，並不表示該草稿就是已儲存的 Foundry 代理。

評估 Foundry 提示代理程式

儲存你想評估的設定，然後選擇 評估。

• 選擇 Scaffold 評估程式碼以產生本地 Python 評估專案。 依照產生的指示設定並執行。
• 選擇 Foundry 連結以進行引導式評估設定。

執行前務必先檢視已產生的評估配置。 支架以姓名識別代理人;不要以為它會固定你在 Agent Builder 裡選擇的版本。

此分頁與本地提示資料集檢視不同。 關於服務評估的指引，請參閱 「評估您的代理人」。

產生用戶端程式碼

儲存 Foundry 代理後，使用 檢視代碼 選單從應用程式呼叫該代理。

兩個輸出都參考所選的已儲存版本。 如果應用程式需要修改後的設定，請先儲存編輯內容，再產生程式碼。

客戶端程式碼不會把提示代理轉換成託管代理。 若要直接使用 SDK，請參考 prompt-agent 快速啟動。

配合區域提示

選擇本地儲存以使用其他供應商的模型或測試本地工具。 選擇一個型號，輸入說明，然後選擇 「儲存到本地」。 使用 Foundry 模型時，當本地儲存空間可用時，使用儲存選單。

使用 「儲存到本地 」來保留本地變更。 本地存檔不會建立 Foundry 版本或對話歷史紀錄。

連結本地工具

若為本機提示，請選取 Tool>+>MCP Server，以選擇伺服器及其工具。 關於設定與執行時需求，請參見 「連接本地 MCP 伺服器」。

要測試一個功能結構而不實作外部服務：

1. 選擇 工具>+>自訂工具。
2. 選擇 範例 或 上傳現有架構。
3. 提供結構、名稱和描述，然後加入工具。
4. 在工具卡中輸入模擬回應。
5. 執行提示，檢視模型如何使用回應。

模擬回應不會呼叫外部 API。 配置好的 MCP 伺服器可以執行其工具。

設定結構化輸出

對於支援結構化輸出的模型的本地提示：

1. 在模型選擇器旁邊開啟 設定 。
2. 在 結構輸出中，選擇 json_schema。
3. 在 選擇 JSON 架構中，選擇 使用範例 或 上傳檔案。
4. 檢視結構描述，然後選取 Select。
5. 儲存本機提示，並執行請求以檢查其輸出。

可用的格式依型號而異。 這些步驟適用於本地提示執行，而非儲存的 Foundry 提示代理程式的回應架構。

使用資料集變數評估本機提示

對於已儲存的本機提示，評估頁籤提供以資料集為基礎的評估。 在指令中使用變數來執行同一個提示詞，但資料集值不同。

例如，Summarize the issue for {{audience}}. 會使用名為 audience 的資料集欄位。 為每個測試案例提供一個數值。 本地批次執行器在執行提示時會替換該值。

Agent Builder 遊樂場沒有獨立的變數面板。 關於資料集匯入、評估器及結果比較，請參見 「評估模型、提示與代理人」。

產生本地提示詞的程式碼

選擇 檢視程式碼 以產生模型整合程式碼。 可用的 SDK、認證及語言選擇取決於提供者與模式。 這些選項與 Foundry 代理客戶專案及片段動作不同。

相關內容

使用以下指南來開發並發布您的代理程式：

• 使用 Microsoft Foundry Toolkit 建立代理程式
• 代理開發生命週期
• 發布代理人應用程式