宣告式代理程式架構

宣告式代理程式會在 Microsoft 365 Copilot 受管理的協調流程和語言模型基礎結構上執行。 您可以設定代理程式的指示、知識來源和支援的功能,而不是實作和託管您自己的交談執行階段。

代理可以使用 Microsoft 365 知識來源、內建功能 (例如程式碼解釋器)、 自訂技能 (預覽) ,以及 MCP 伺服器或 REST API 提供的動作。 它也可以將工作委派給 已連線的代理程式。 可用性取決於製作工具、資訊清單版本、目標體驗、授權和組織原則。

請使用這篇文章來瞭解受管理平台與您設定或操作的元件之間的界限。 若要與可讓您控制協調流程和模型裝載的架構進行比較,請參閱 比較宣告式和自訂引擎代理程式。

架構元件

Microsoft 365 Copilot 提供的執行階段可解釋使用者要求、擷取相關內容、選取功能,並產生回應。 您的組態和外部服務決定了代理可用來完成工作的內容。

宣告式代理程式架構的圖表。

元件 受管理平台 開發人員的責任
用戶端 在支援的 Microsoft 365 體驗中託管交談。 選擇目標體驗並測試其支援的互動、文件內容和回應格式。
基礎結構 託管 Copilot 協調流程和模型執行階段。 設定代理程式並裝載任何外部 API、MCP 伺服器或其使用的其他服務。
目錄和發佈 提供支援的取得、發佈和管理體驗。 選取支援的套件和發佈路徑、維護版本,並與系統管理員合作進行存取和部署。
安全性與規範 套用 Microsoft 365 身分識別、資料存取和平台保護。 設定權限和驗證、評估資料流程,以及在外部服務中強制執行授權和資料保護。
Orchestrator 和語言模型 選取和叫用功能並產生回應。 撰寫指示和工具描述、設定支援的行為設定,以及評估產生的行為。 您不會使用自訂執行階段程式碼取代受管理的協調器。
知識與能力 擷取支援的知識並執行啟用的內建功能。 選擇相關來源和功能,確認使用者存取,並測試檢索品質。
工具呼叫 透過支援的整合叫用已設定的 MCP 或 API 動作。 定義工具輸入和輸出,配置身份驗證和確認,並實施可靠的服務行為。

支援的組態設定會影響受管理的執行階段;它們不會讓您完全控制其實施。 例如,資訊清單支援使用者可以覆寫的 預設回應模式。 請遵循選取的資訊清單架構和撰寫工具以取得可用的設定。

注意

擷取的內容和工具回應可能包含不受信任的指令。 平台保護不會取代服務中的授權檢查或代理程式行為的評估。 規劃適用 的資料、隱私權和安全性需求。

宣告式代理程式資料流程

下列概念流程描述代理如何使用其組態和功能。 它不是固定的執行順序,也不是對發生多少次擷取或工具呼叫的保證。

  1. 收到要求。 使用者在支援的體驗中提交提示。 交談記錄和可用的應用程式內容可能有助於要求。
  2. 選取相關的內容和功能。 Copilot 會使用代理程式的指示、知識設定和工具描述來決定如何處理要求。
  3. 擷取資訊或叫用動作。 Copilot 會擷取可用的知識或呼叫已啟用的功能。 外部動作會使用已設定的驗證和 確認行為。 外部服務會強制執行自己的授權和商務規則。
  4. 產生回應。 Copilot 會使用可用的內容和功能結果來回應。 根據任務,互動可能包括進一步的呼叫、使用者輸入請求或委派給連接的代理。

宣告式代理程式可以鏈結 API 呼叫、使用一個呼叫的輸出做為另一個呼叫的輸入,並將 SharePoint 知識或程式碼解譯器與 API 動作結合。 如需支援的模式和範例,請參閱 API 外掛程式中的鏈結函式呼叫。

指令會引導模型行為;它們無法取代必須強制執行交易、確切執行順序或復原程序的應用程式邏輯。 在 API 或工作流程服務中實作這些需求,或在需要擁有協調流程時評估自訂引擎架構。

專為功能特定限制而設計

請檢查指引中每個功能和整合的限制。 資訊清單欄位的字元限制、知識來源設定限制和執行階段內容限制描述不同的限制。

區域 設計考量 指引
代理程式設定 使用所選結構描述版本和編寫工具支援的屬性和功能。 宣告式代理程式資訊清單參照
知識擷取 選取相關來源,並遵循來源特定的檔案、範圍、存取權和索引需求。 回應不一定包含來源中的每個項目。 知識來源 和 最佳化內容擷取
工具定義和承載 讓工具保持焦點,並讓輸入和輸出保持相關。 大型插件輸入和輸出可以被截斷,有效的上下文限制可能會隨著模型和系統開銷而變化。 MCP 和 API 外掛程式限制
文件內容 請遵循主應用程式支援的文件互動和內容格式,而不是假設所有文件內容都以相同的方式呈現。 與文件互動
服務行為和延遲 測試回應時間、驗證失敗、服務錯誤,以及外部 API 或 MCP 伺服器的限制。 整合和測試元件

針對大型資料集,請設計 API 來篩選、彙總或傳回相關子集,而不是將所有記錄傳送到交談中。 當案例需要文件內容時,請測試支援的主機體驗: 宣告式代理程式可以在 Word 和 PowerPoint 中存取整個開啟的文件,但須遵守 文件格式考量。

優點和限制

宣告式代理程式的主要優點和主要限制有助於判斷此架構何時適合特定使用案例。

主要優勢

宣告式代理程式為想要在現有 Microsoft 365 環境中實作 AI 解決方案的組織提供顯著的好處:

  • 受控交談式執行階段:Microsoft 裝載協調器和模型基礎結構,因此您不需要實作該執行階段。
  • 存取 Microsoft 功能:代理可以使用支援的知識來源和內建功能與外部工具。
  • 以組態為基礎的自訂: 指示、功能和動作可量身打造體驗,而不需要自訂交談引擎。 外部整合仍然可能需要程式碼和主機服務。

主要限制

宣告式方法也會引進可能限制特定使用案例的限制:

  • 受管理的協調流程:您可以透過支援的設定來影響行為,而不是控制每個執行階段決策。 評估代表性任務,而不是將指令視為確定性工作流程引擎。
  • 平台和主機相依性: 功能、回應呈現、授權和管理取決於選取的 Microsoft 365 體驗。 確認每個目標主機中的支援。
  • 內容和擷取限制:知識擷取和工具結果必須符合可用的內容。 大型來源或有效負載無法保證回應的完整涵蓋範圍。
  • 動態 Web 內容考量:限定範圍 Web 搜尋會使用 Bing 索引內容,而不是直接查詢基礎資料來源。 動態產生的內容可能不完整或過時。 當工作需要直接存取目前的結構化資料時,請使用支援的 API 整合。 請參閱 Web 搜尋基礎知識和動態內容。
  • 持續評估: 平台和模型更新可能會改變行為。 隨著代理程式及其相依性的演變,測試指令、擷取和工具使用。

使用案例對齊

根據解決方案所需的控制來選擇架構,而不僅僅是根據任務是否有多個步驟。

最佳案例

宣告式代理程式最適合用於:

  • 資訊擷取: 主要需要搜尋和摘要來自 Microsoft 365 或外部來源資訊的代理程式。
  • 輔助動作:結合知識和支援的 API 或 MCP 動作來協助使用者完成工作的代理程式。
  • 文件協助和分析: 使用支援的文件內容或使用代碼解釋器等功能的代理程式。
  • 生產力提升:受益於 Microsoft 365 內受管理交談體驗的工作。

不適合的案例

當您的需求包括以下內容時,請考慮自訂引擎代理或單獨實作的工作流程:

  • 自訂執行階段控制項:您必須實作自己的協調流程、模型裝載或使用者介面,而不是使用受管理的 Copilot 執行階段。
  • 持久的業務流程:系統必須獨立於對話強制執行確切的執行順序、交易邊界、重試或復原。
  • 大規模資料處理:該任務需要對資料集進行詳盡的處理,而不是檢索或分析相關的對話內容。 在服務中執行該處理,並將適當的結果公開給代理程式。
  • 直接存取動態來源: 此工作需要來自未在 Web 搜尋中充分表示之來源的目前排序結果。 提供支援的 API 或 MCP 整合,而不是單獨依賴範圍 Web 搜尋。

這些需求不一定會排除宣告式代理程式做為交談介面。 服務可以擁有商務程序,而代理程式會收集輸入、叫用支援的動作並呈現結果。