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

使用 Microsoft Foundry Toolkit for Visual Studio Code 來設定提示代理程式或開發基於程式碼的託管代理程式。 根據指令和支援的工具是否符合你的需求,或是需要自訂執行時邏輯來選擇建立路徑。

先決條件

選擇代理人類型

Foundry 支援 提示代理與託管代理。 這兩種代理類型都能使用工具並整合進應用程式。 提示代理不僅限於原型。

比較 提示代理程式 託管代理
定義行為 配置模型、說明及支援工具。 用框架或自己的程式碼實作自訂邏輯。
使用目的 這些任務由指示和支援的工具處理,例如回答問題或摘要文件。 自訂編排、相依性或執行時行為,例如多代理工作流程。
你維護的是什麼 代理設定與已儲存版本。 代理程式碼、相依、封裝與部署配置。
要從何處開始 代理程式建置工具 代管代理程式範例或 Copilot 輔助程式碼撰寫。

當配置選項符合你的需求時,就從即時代理開始。 當你需要更多執行控制時,選擇託管代理。 詳情請參見 「何時使用託管代理」。

開啟 Create 代理

打開建立頁面,選擇如何建立你的經紀人。

  1. 在活動列中,選擇 Foundry Toolkit。

  2. 在 開發者工具中,展開 建置,然後選擇 建立代理。

    Create Agent 的截圖,提供從範例編碼、使用 Copilot 編碼,或在 Agent Builder 中建立代理的選項。

如果開發者工具使用按資源群組,請在代理開發工具(Agent Dev Tools)中找到「建立代理」而非建置。

選擇建立路徑

選擇符合你代理類型的路由,然後依照其指引設定、測試、儲存或部署代理。

Route Create Agent 中的動作 下一則指南
代理程式建構工具 選擇 「建立代理」 以設定提示代理,無需託管代理程式碼專案。 建立一個提示代理人。
宿主代理樣本 在「 從範例中編寫代理人」選項中,選擇框架或瀏覽 所有範例。 為你的情境選擇一個範例。 對於以程式碼為基礎的編排,請建立代管代理程式。 如需其他案例,請依照所選範例產生的README.md操作。
Copilot 輔助程式撰寫 選擇用 Copilot 編寫代理程式,以開發具備 GitHub Copilot 和 Foundry 技能的代理程式碼。 在程式碼代理程式中使用 Microsoft Foundry Skill。 在部署前檢視產生的程式碼並進行測試。

代理建構器也支援本地儲存的提示。 他們的儲存、工具及評估選項與 Foundry 提示代理不同。 請參閱 使用本機提示。

選擇如何安排或排程工作

對於新的程式碼型工作流程,請透過範例或 Copilot 路徑使用 Microsoft Agent Framework。 若要在觸發器或排程中呼叫現有代理,請參閱 Foundry Agent Service 中的例程(預覽版)。

這很重要

Microsoft Foundry 中的宣告式工作流程目前處於預覽階段,將於 2026 年 12 月 1 日正式退休。 這次退休不會影響託管代理程式中的程式碼編排。 若要使用現有的宣告式工作流程,請參見 「使用並遷移宣告式代理工作流程」。

在開發與整合你的經紀人時,請參考以下指南: