使用 Microsoft Foundry Toolkit for Visual Studio Code 來設定提示代理程式或開發基於程式碼的託管代理程式。 根據指令和支援的工具是否符合你的需求,或是需要自訂執行時邏輯來選擇建立路徑。
先決條件
- 安裝 Microsoft Foundry Toolkit for Visual Studio Code。
- 對於使用 Foundry 資源的代理, 請建立一個 Foundry 專案。 請依照針對您所選路線的指南,確認模型、權限和執行階段需求。
- 若要使用 Copilot 輔助程式設計,請使用 Visual Studio Code 中的 GitHub Copilot。
選擇代理人類型
Foundry 支援 提示代理與託管代理。 這兩種代理類型都能使用工具並整合進應用程式。 提示代理不僅限於原型。
| 比較 | 提示代理程式 | 託管代理 |
|---|---|---|
| 定義行為 | 配置模型、說明及支援工具。 | 用框架或自己的程式碼實作自訂邏輯。 |
| 使用目的 | 這些任務由指示和支援的工具處理,例如回答問題或摘要文件。 | 自訂編排、相依性或執行時行為,例如多代理工作流程。 |
| 你維護的是什麼 | 代理設定與已儲存版本。 | 代理程式碼、相依、封裝與部署配置。 |
| 要從何處開始 | 代理程式建置工具 | 代管代理程式範例或 Copilot 輔助程式碼撰寫。 |
當配置選項符合你的需求時,就從即時代理開始。 當你需要更多執行控制時,選擇託管代理。 詳情請參見 「何時使用託管代理」。
開啟 Create 代理
打開建立頁面,選擇如何建立你的經紀人。
如果開發者工具使用按資源群組,請在代理開發工具(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 日正式退休。 這次退休不會影響託管代理程式中的程式碼編排。 若要使用現有的宣告式工作流程,請參見 「使用並遷移宣告式代理工作流程」。
相關內容
在開發與整合你的經紀人時,請參考以下指南: