Microsoft 365 Copilot 協調器會協調語言模型、可用內容,以及用來回應使用者要求的功能。 對於宣告式代理程式,這些功能可以包括知識擷取、內建功能,以及 MCP 或 API 外掛程式提供的動作。
本文著重於代理的設定如何影響動作選擇和叫用。 您提供說明、工具定義和外部服務;Microsoft 會管理交談式執行階段。 如需更廣泛的責任分工,請參閱宣 告式代理程式架構。
Copilot orchestrator
協調器會使用代理的組態和可用內容來決定是否要直接回應、擷取知識或叫用工具。 並非每個要求都需要外部動作。
例如,使用者可能會問:「現在指派了哪些票證給我?」具有適當票證動作的客服專員可以從票證服務擷取目前資訊,而不是依賴模型知識。
下圖說明 API 動作互動。 這是概念性檢視,而不是固定的執行順序,也不是每個要求都使用 Microsoft Graph 或外部 API 的保證。
- 解譯要求。 Copilot 會使用提示、代理程式指示、交談記錄和可用的應用程式內容來識別使用者的工作。 平台安全性和原則檢查可能會影響要求是否繼續以及如何繼續。
- 選取相關功能。 Copilot 會判斷設定的知識或工具是否可以提供協助。 對於外部動作,外掛程式和工具描述可協助識別適當的作業。
- 決定輸入並叫用工具。 Copilot 會將可用資訊對應至工具的參數。 指令應引導它詢問遺漏的所需資訊,而不是發明值。 外部通話使用已設定的 驗證 和 確認行為。
- 解譯結果。 Copilot 會使用傳回的資料或錯誤來決定下一個步驟。 互動可以包括另一次通話、澄清請求或對使用者的回應。
- 回應使用者。 Copilot 會使用可用的內容和結果來產生回應。 回應應反映服務實際傳回或變更的內容。
宣告式代理程式支援 鏈結函數呼叫,包括將一個 API 呼叫的輸出傳遞給另一個 API,並將 API 動作與 SharePoint 知識或程式碼解釋器結合。 設計並測試所需的互動,而不是假設固定數量的呼叫總是在輪流中完成。 遵循目前 的外掛程式限制 和外部服務的限制。
平台保護和使用者確認不會取代外部服務中的授權或商務規則檢查。 如果工作流程需要精確的執行順序、交易或復原,請在服務中實作這些需求,而不是依賴模型指令。
Copilot 的協調器如何將動作比對到使用者查詢
外掛程式選擇和個別工具叫用是不同的決策。 外掛程式的描述可協助 Copilot 識別相關的服務或網域。 然後,該外掛程式提供的工具會描述 Copilot 可以叫用的作業及其所需的輸入。
當外掛程式選擇使用語意比對時,比對是基於外掛程式的描述,而不是單個功能的描述。 匹配的插件使其功能或工具可用;它不是五個功能的固定候選清單。 如需目前的選取行為和內容限制,請參閱 MCP 和 API 外掛程式限制。
在每個層級提供有用的描述:
| 設定 | 描述內容 |
|---|---|
| 外掛程式說明 | 服務的用途、支援的使用者工作和網域。 使描述足夠具體,以將其與其他插件區分開來。 |
| 功能或工具定義 | 作業的用途、使用時機,以及是否擷取或變更資料。 對於 API 外掛程式,請將函式名稱對應至 OpenAPI operationId。 |
| 參數 | 必要的輸入、類型、格式和有意義的範例。 區分識別碼和顯示名稱,並清楚說明選擇性行為。 |
| 結果與錯誤 | 傳回的資料、成功作業的意義,以及如何表示失敗。 讓承載保持與工作相關。 |
如需 API 外掛程式,請遵循 建立有效的 OpenAPI 描述。 對於 MCP 外掛程式,請檢查工具定義是 動態探索還是釘選在外掛程式資訊清單中。 透過動態探索,對伺服器工具定義的變更可能會影響選取項目,而不需重新發佈代理程式。
改進和評估動作選擇
描述和指示會影響選取範圍。 他們不保證會針對要求的每個措辭呼叫特定工具。
- 釐清重疊的作業。 如果多種工具看起來合適,請解釋它們的不同用途和所需的輸入。 區分讀取作業與變更資料的作業。
- 將工作連線至指示中的工具。 說明何時使用已設定的工具、如何收集遺漏的資訊,以及如何在後續追蹤要求中使用較早的結果。 請參閱 具有 API 外掛程式的代理程式指示。
- 讓可用工具保持焦點。 公開代理工作所需的作業。 更多的工具定義和更大的承載會佔用內容,並可能降低回應品質。
- 測試實際選取範圍和結果。 包括轉述提示、模棱兩可的請求、缺少的輸入、多步驟任務、取消的確認和服務失敗。 檢查服務收到的操作和參數,而不僅僅是最終措辭。
- 當定義變更時,請重複測試。 在變更外掛程式描述、工具定義、指示或平台之後,重新執行代表性案例。 使用動態探索時包括 MCP 伺服器更新。
重要
遺失或不完整的交談回應無法確定外部作業是否已完成。 在重試變更資料的作業之前,先檢查服務的結果,並將服務設計為安全地處理重複的要求。
如需更廣泛的設計建議,請參閱 宣告式代理程式最佳做法。 如需可重複的測試案例和判斷提示,請參閱 代理程式評估概觀。