Microsoft Foundry 的代理程式開發生命週期涵蓋從初始建立到生產監控。 遵循這個生命週期有助於你建立可靠的經紀人，及早發現問題，並有信心地出貨。 使用 Foundry 入口網站或程式碼來建立、客製化並測試你的代理程式行為。 接著反覆進行追蹤、評估與監控，以提升品質與可靠性。 準備好時，將你的代理發佈為代理應用程式，分享並整合到你的應用程式中。
本文是給想要建置、測試並交付預備上線的代理程式的開發者。
先決條件
- 一個 Microsoft Foundry 專案
- 對特工遊樂場的熟悉度
- 關於程式碼開發：熟悉 開發環境的設定
生命週期一覽
將這個生命週期作為實用的檢查清單，協助你構建和發佈代理程式。
- 選擇代理類型：從提示型代理、工作流程或託管代理開始。
- 建立你的代理並開始測試：在 Playground 或程式碼中迭代。
- 新增工具與資料：附加擷取與操作工具，並在儲存前驗證設定。
- 將變更儲存為版本：捕捉有意義的里程碑並比較不同版本。
- 用追蹤除錯：使用追蹤確認工具呼叫、延遲及端對端行為。 詳情請參閱 代理人追蹤概述。
- 評估品質與安全性：在發表前進行可重複的評估以捕捉迴歸問題。 概念指引請參見 代理人評估員。
- 發佈並整合：發佈一個穩定的端點並將其整合到你的應用程式中。 有關步驟，請參見 Microsoft Foundry 中的發佈與分享代理。
- 監控與迭代：監控生產環境的效能與品質，然後視需要更新與重新發布。 如需指引，請參閱 「監控品質與安全」。
Microsoft Foundry 中的代理類型
代理人有三種類型：
基於提示：基於提示的代理是一種宣告式定義的單一代理，結合模型配置、指令、工具與自然語言提示來驅動行為。 透過將知識和記憶的工具相連來擴展它。 編輯、管理版本、測試、評估、監控並發布以提示為基礎的代理，這些代理可以在 Foundry 入口網站的代理沙盒中進行。
工作流程：利用工作流程建立更進階的工作流程，協調一連串動作或協調多個代理人。 工作流程在入口網站有自己的介面，但生命週期相同。 詳情請參閱 「在 Microsoft Foundry 建立工作流程」。
託管代理（預覽）：託管代理是容器化代理，透過支援的框架或自訂程式碼來建構。 Foundry Agent Service 負責部署和管理這些代理。 你不會在代理建置介面中編輯託管代理，但仍可調用、評估、監控及發布。 詳情請參見 「什麼是託管代理？」
在 Foundry 入口網站或您自己的開發環境中，使用 CLI、SDK 或 REST API 建立基於提示的代理與工作流程。 如需詳細資訊，請參閱快速入門。
建立提示型代理程式
如果你已經知道想建立哪種代理，先命名它，然後開始設定它的模型、指示和工具。
備註
你指定代理人後，就不能更改名字。 在程式碼中，你用<agent_name>:<version>來指代你的代理人。
在程式代碼中開發代理程式
如果你偏好程式碼工作，請使用支援的方式將代理程式碼帶到開發環境，然後在本地測試，然後部署到 Azure。
在 agent playground 聊天窗格的 程式碼 標籤中，你可以擷取一段程式碼片段，將你的代理人指向專門用於 Web 雲端的 Visual Studio Code 環境。 這段摘要預先設定好了你需要的套件和擴充功能，並附有有效開發和部署 Foundry 代理到 Azure 的說明。 您也可以將程式碼片段直接複製到您偏好的開發環境。 詳情請參閱 遊樂場文件。
代理開發生命週期的核心能力
代理程式建置體驗為代理程式開發生命週期的每個核心步驟提供整合式體驗。 在開發生產準備的代理應用程式時，請善用這些核心能力。 每個功能都有深入的文件，你可以在那裡了解更多。
將變更另存為版本
在建立第一個基於提示的代理程式或工作流程後，將後續變更存為新版本。 你可以在 Agent Playground 測試未儲存的變更。 但如果你想查看對話紀錄、監控客服表現或進行完整評估，就必須儲存你的變更。
代理版本管理提供以下功能來管理代理的設定與迭代。 此系統確保所有變更都能被追蹤、可測試，並能在不同版本間進行比較。
版本不變性：每個代理在你儲存後都是不可變的。 對現有版本的任何修改都需要儲存並建立新版本。 此要求有助於確保版本完整性並防止意外覆寫。
草稿狀態管理：你可以測試處於未儲存狀態的代理以進行實驗。 離開鑄造廠入口會失去未儲存的變更，因此請經常存檔以保留重要修改。
版本控制操作：您可以將請求導向特定代理版本，以啟用受控部署與回滾功能。
版本歷史導覽：存取任一代理的版本歷史，前往任一特定版本，並進行以下比較：
比較類型 Description 代理程式設定 使用版本下拉選單比較不同版本的設定 聊天輸出 分析使用相同輸入的代理版本間反應差異 YAML 定義 回顧代理人定義的差異
新增工具
透過賦予代理知識（特定檔案或索引）或允許它執行動作（呼叫外部 API）來增強功能。 工具適用於大多數使用情境，從簡單的檔案上傳到自訂的模型情境協定（MCP）伺服器連線皆有。 對於較複雜的工具，你可能需要設定認證或在附加到代理時新增連線。
要儲存附帶工具的代理，必須成功設定該工具。 在各代理間重複使用已設定的工具。 有關可用工具的資訊，請參閱 工具目錄。
透過追蹤（預覽）來除錯與驗證
當你新增工具並反覆修改提示時，使用追蹤來驗證端到端的行為：
- 確認代理程式是否呼叫預期的工具。
- 檢查工具的輸入與輸出。
- 識別不同型號與工具呼叫間的延遲熱點。
欲了解更多資訊，請參閱 代理人追蹤概述。
評估品質與安全（預覽）
在發佈代理之前（以及任何有意義的變更後），先進行評估，捕捉迴歸問題，並一致衡量各版本的品質。
- 關於代理人的關鍵評估維度，請參見 代理人評估者。
- 若想自動化以程式碼為先的工作流程，請參見 「評估你的 AI 代理本地」。
發佈後的監控
發佈代理應用程式後，請將其視為生產軟體：
- 監控品質與安全訊號。
- 在行為變更時檢閱追蹤記錄。
- 修正問題或改進後再更新並重新發布。
如需指引，請參閱 「監控品質與安全」。
身份與權限規劃
工具與下游資源通常需要驗證。 當你發佈代理時，它的身份與權限模型可能會改變。 確保你的已發布代理程式只擁有它所需的存取權限。
詳情請參閱 Microsoft Foundry 中的代理身份概念。
安全性和存取
把你的代理程式設定當作應用程式程式碼來處理。 在整個生命週期中保護機密與權限：
- 使用最小權限與角色指派，取代嵌入鍵。 欲了解更多資訊，請參閱 Foundry 入口網站中的角色基礎存取控制。
- 將秘密存放在受管理的秘密儲存庫中，並透過連線來引用，而非硬編碼在程式碼、設定檔或提示符中。 如需指引，請參閱 「建立金鑰庫連線」。
- 發佈前，確認已發佈代理應用程式中的代理身份與工具連線僅擁有所需的存取權限。 詳情請參閱 Microsoft Foundry 中的代理身份概念。
發佈你的代理或工作流程
當你建立一個滿意的代理或工作流程版本後，再以 代理應用程式的形式發佈。 你會有一個穩定的端點，可以在瀏覽器中開啟測試、與他人分享，或嵌入現有應用程式中。 你和你的合作夥伴可以驗證效能，並找出需要改進的地方。 隨時進行必要的更新並重新發布新版本。
這很重要
分配給專案識別的權限不會自動轉移到已發佈的代理。 發佈後，將必要的權限重新分配給代理應用程式的身份。
常見的代理開發陷阱
- 未儲存的變更是暫時性的：如果你想比較版本、查看歷史紀錄或執行完整評估，請將變更存為一個版本。
- 工具必須在儲存前設定好：如果工具需要認證或連線，存檔前請完成設定。
- 發佈可能需要權限更新：發佈後，重新檢查已發佈代理的資源存取權限，並移除代理不再需要的存取權限。
相關內容
進一步了解代理類型：
配置與擴充代理：
發布並監控代理人：
除錯與評估：