建置宣告式代理程式的最佳做法

宣告式代理程式會透過指示、知識來源和支援的功能,針對特定商務案例自訂 Microsoft 365 Copilot。 使用這些實踐可以讓代理保持專注、安全地配置其操作,並隨著其發展評估其行為。

從定義的受眾、使用者工作和預期結果開始。 如需受管理執行階段與您操作的服務之間的界限,請參閱宣 告式代理程式架構。

注意

本文涵蓋使用 Copilot 受管理執行階段的宣告式代理程式。 如果您要建置可擷取 Microsoft 365 基礎資料的自訂引擎代理程式,請遵循 擷取 API 最佳做法 和 權限和限制。 該指引與設定宣告式代理程式的知識來源是分開的。

宣告式代理程式元件

選擇每個元件以支援客服專員的預期工作。 遵循所選撰寫工具和資訊清單架構中的限制。

元件 最佳作法
Name (名稱) 使用傳達客服專員目的的獨特名稱。 Agent Builder 最多允許 30 個字元;宣告式代理程式資訊清單最多允許 100 個。
描述 在 1,000 個字元的限制內,用幾句精確的句子摘要工作和領域。 在指示欄位中保留詳細的行為指示。
指示 在 8,000 個字元的限制內,定義代理程式的用途、支援的工作、來源和工具使用、輸出格式和失敗行為。
知識來源 新增預期問題的相關來源。 確認其支援的範圍、新鮮度、權限和授權。
內建功能 僅當代碼 解釋器 或 影像產生器 等功能支援預期工作時,才啟用它們。
自訂技能 (預覽) 將 技能 用於模組化工作指令、資源或指令碼。 在高水平上參考配置的技能,而不是複製他們的詳細說明。
動作 使用 MCP 或 API 外掛程式 支援與外部服務的互動。 描述每個工具的用途、輸入、輸出和故障條件。
交談入門 提供具代表性的提示,示範支援的工作。 沒有最低數目要求。 測試每個提示並遵循所選工具的限制。

代理程式指示的最佳做法

使用指示來定義客服專員應如何處理預期任務:

  • 陳述結果和界限。 描述代理程式協助使用者完成哪些任務、需要哪些資訊,以及它應該如何回應不支援的要求。
  • 明確來源和工具使用。 識別適用於每個工作的已設定來源、功能或動作。 詢問遺漏的輸入,而不是猜測。
  • 將步驟與簡報分開。 在順序重要的地方使用清晰的任務步驟,並指定回應的預期語氣、結構和詳細程度。
  • 規劃遺失的資訊和失敗。 描述如何在不聲稱成功的情況下處理不可用的來源、不完整的結果、拒絕存取和不成功的操作。
  • 讓指示與知識分開。 請勿在 SharePoint 文件或其他知識來源中放置行為指示,以規避指示限制。 擷取的內容不是信任的製造商撰寫的指令內容。

如需模型變更的詳細模式、範例和指引,請參閱 撰寫有效的指示。 對於將知識與 API 呼叫相結合的任務,請參閱 使用 API 外掛程式編寫代理程式的指示。

選擇正確的知識來源

根據客服專員必須回答的問題選取 知識來源 :

  • 偏好相關性而非數量。 將來源範圍限定為工作所需的檔案、網站、聊天或其他內容。 針對 SharePoint 和內嵌檔案,請遵循 最佳化內容擷取。
  • 將擷取與新鮮度要求相符。 定期檢閱來源內容和擁有權。 範圍 Web 搜尋使用 Bing 索引內容,而不是直接查詢基礎資料。 針對目前的結構化資料,請改為評估支援的 API 或 MCP 動作。 請參閱 Web 搜尋基礎知識和動態內容。
  • 共用前確認存取。 使用代表目標對象和權限的使用者進行測試。 與原始檔案的存取權分開檢閱 內嵌檔案共用行為 。
  • 檢查功能和授權支援。 來源和範圍選項會因製作工具和租用戶設定而異。 遵循 知識來源支援矩陣 和 授權指引。
  • 評估基礎,而不僅僅是回答流利程度。 使用已知答案測試問題,並檢查回答和引文是否與預期來源相符。 包含無法獲得答案的問題。

新增來源本身並不會阻止代理使用內建模型知識。 當案例需要以來源為依據的回應時,請在指示中設定behavior_overrides.special_instructions.discourage_model_knowledgetrue並強化預期的來源用途。 此控制項無法保證回應只會使用設定的來源。 缺少證據時,繼續評估來源屬性和行為。 請參閱 對已設定知識來源的地面回應 和 特殊指示參考。

設計安全動作

將動作用於與外部服務的支援互動,並將它們與知識來源區分開來。 用於基礎設置的 Copilot 連接器無法與變更外部資料的 API 或 MCP 工具交換。

  • 精確描述作業。 解釋何時應該使用工具、其所需參數以及預期結果和錯誤。 如需 REST API,請遵循 OpenAPI 文件指導方針。
  • 設定整合確認。 對於 API 外掛程式,請使用 OpenAPI 擴充功能 x-openai-isConsequential,而不是 isConsequential,並將具有副作用的作業標示為後果性作業。 對於 MCP 工具,請僅用於 readOnlyHint 唯讀工具。 請遵循 MCP 和 API 外掛程式的確認提示 ,以取得支援的設定和行為。
  • 在服務中強制執行存取。 使用支援的 驗證方法 ,並驗證外部服務中的授權和輸入。 指示和確認提示不會取代這些檢查。
  • 針對失敗和重複的要求進行設計。 測試拒絕的確認、過期的驗證、無效的輸入和服務錯誤。 對於變更資料的作業,請確保重試不會無意中重複變更。

使用 [規劃資料]、[隱私權] 和 [安全性 ] 來識別每個動作的資料流程、權限和人工監督需求。

測試和反覆執行

在變更代理之前定義預期行為,並保留一組可重複的測試案例。 使用編寫工具的測試經驗以獲得早期意見反應,然後在其預期主機中驗證已部署的代理程式。

測試區域 要驗證的內容
支援的工作 對話開場白、現實的使用者措辭和後續問題會產生預期的結果。
資訊遺失或不受支援 客服專員要求提供必要的輸入,解釋無法使用的證據,並且不會編造事實或聲稱已完成不成功的動作。
基礎設置和權限 答案和引文符合預期的來源。 測試具有不同存取權的使用者,並確認未公開受限制的資訊。
動作與失敗 檢查實際的外部結果以及回應。 測試確認、取消、驗證失敗、服務錯誤和重複請求。
主機體驗 測試您要部署到的每個支援應用程式。 檢查文件內容、回應呈現方式和可用功能,而不是在所有應用程式中假設相同的行為。
效能與變更 測量回應時間,並在指令、知識、工具、技能或平台行為變更後重新執行迴歸案例。

包含未撰寫說明的使用者,讓測試擷取到非預期的措辭和假設。 將可重現的使用者報告問題轉換為迴歸案例。

如需測試案例設計、判斷提示和可重複評估,請參閱 代理程式評估概觀。 如需版本檢查,請參閱 負責任的 AI 驗證 和 驗證和測試您的外掛程式。