從宣告式代理程式連線到其他代理程式

當使用者與 Microsoft 365 Copilot Chat 中的宣告式代理程式互動時,它可以連線到其他代理程式以擷取額外資訊或執行動作。 您可以透過在屬性中 worker_agents 列出代理程式標題 ID,在代理程式資訊清單中宣告這些連線。 在執行階段,Copilot Chat 會作為調解互動的代理人,使用者可以看到客服專員對客服專員的交流,但不需要自行選取已連線的客服專員。

注意

資訊清單宣告的連線代理程式是不同於 Copilot Chat API 的獨立機制,可在您自己的自訂應用程式內啟用由 Microsoft 365 Copilot 提供的交談體驗。

注意

使用者必須先取得每個已連線的代理程式,然後才能使用它們。 如需詳細資訊,請參閱 將已連線的代理程式部署到組織中的使用者。

當使用者與宣告式代理程式互動時,代理程式可以將部分工作委派給已連線的代理程式。 Microsoft 365 Copilot 會評估資訊清單中宣告的已連線代理程式,並根據目前工作以及已連線代理程式的名稱、描述和範例提示來選取一個。 Copilot 會傳送文字要求給選取的連線代理程式、收到文字回應,並將該回應納入宣告式代理程式與使用者的持續互動中。

何時使用已連線的代理程式

使用連線的代理程式跨職能或開發團隊拆分或合併代理程式。

超出單一客服專員所能完成的範圍

大型語言模型 (LLM) 具有有限的有用上下文視窗和一組功能。 單一 LLM 代理程式的可靠性會隨著 擷取更多文件 或 啟用工具時開始下降。 如果代理在新增更多知識或功能後品質較低,請將其中一些功能分割到另一個代理程式並連接到它。 現有代理僅傳送已連線代理完成其部分所需的任務相關資訊。 已連線的代理程式會在自己的內容視窗中運作,不受使用者交談中的其他文件或功能的影響。

與外部開發的代理程式整合

宣告式代理程式可讓您更輕鬆地與其他開發團隊合作。 每個開發團隊都可以專注於其代理的功能和品質,使用連接的代理與其他代理整合。 與微服務一樣,每個代理都可以在不影響其他代理的情況下進行開發。 與微服務不同,代理即使介面發生變化,也可以繼續相互互動。

對多個案例共用代理程式功能

代理程式可能適用於一組文件和動作,但對使用者來說仍然很困難。 考慮一個了解客戶和銷售關聯式資料庫的資料表和資料的代理程式。 此代理程式可能對商店主管管理庫存和業務分析師向主管報告都很有用。 如果該代理可以連接到為商店主管量身定制的代理,提供對話開場白和說明,也可以連接到為業務分析師量身定制的代理。 這兩種類型的使用者可能會從使用針對其案例量身打造的代理程式中獲得更多價值。

啟用已連線的代理程式

您必須在 Microsoft Agent 365 代理程式登錄中註冊已連線的代理程式。 在現有 宣告式代理程式的資訊清單中包含代理程式的標題識別碼,以連線到其他代理程式。 另一個代理人必須是聲明性代理人或擁有註冊的 Agent2Agent 代理人卡。

首先,取得要連線之代理程式的標題識別碼。 代理程式的標題識別碼是一串由單一字母、底線和 GUID 組成的字串。 若為宣告式代理程式,請在 Microsoft 365 代理程式工具組的 [佈建 ] 命令輸出中或 在開發人員模式中尋找。 對於 Microsoft 365 代理程式註冊,它是 idagentRegistration 物件的屬性。

Microsoft 365 Copilot 工作階段的螢幕擷取畫面,其中 Copilot 已傳回卡片,其中包含顯示標題識別碼的偵錯資訊

將標題識別碼新增至 worker_agents 屬性作為 id. 該 worker_agents 屬性已在宣告式代理程式結構描述版本 1.6 中新增。

驗證和授權

連線至宣告式代理程式取決於使用者對 Microsoft 365 Copilot 的現有驗證,因為宣告式代理程式會在 Microsoft 365 Copilot Chat 內執行。 對於在 Microsoft Agent 365 中註冊的外部代理程式,代理程式註冊必須宣告 Microsoft 365 Copilot 向外部代理程式驗證的方式。 註冊不是直接在代理程式註冊中內嵌驗證設定,而是透過 authorizationagentRegistration. 此分離允許獨立於代理程式定義管理驗證設定。 該設計反映了 API 外掛程式資訊清單的設計。

語法

{
  "type": "None | OAuthPluginVault",
  "referenceId": "{string}"
}

屬性會 type 指定外部代理程式所使用的驗證配置。 OAuthPluginVault使用 Microsoft Entra SSO 註冊。 這是 referenceId 在 Teams 開發人員入口網站中產生的 Microsoft Entra SSO registration ID 值。 如需詳細資訊,請參閱使用 Teams 開發人員入口網站 。

使用者是否可以使用已連線的代理程式與驗證分開判斷。 使用者必須能夠存取已連線的代理程式,可以透過自行取得或透過系統管理員部署取得。 系統管理員必須為使用者安裝在 Microsoft Agent 365 中註冊的外部代理程式。

最佳做法

宣告式代理程式會根據已連線代理程式的 name、 description和範例提示來選擇要連線的代理程式。 對於宣告式代理程式,範例提示是 text 資訊清單中的欄位 conversation_starters 。 對於 agentRegistration,它是 examples 代理程式卡片中物件 AgentSkill 的屬性。 智能體的描述應該向人類和智能體描述智能體可以做什麼。 例如,請考慮此描述適用於處理電玩遊戲銷售結構化資料的代理程式。

A comprehensive video game sales analytics agent that provides detailed insights into
gaming industry data across multiple dimensions.
Analyze top-performing games, consoles, genres, and publishers with regional breakdowns
for North America, Europe, Japan, and global markets.
Discover best-selling titles of all time, platform-specific performance metrics, genre
popularity trends, and yearly sales patterns.
Compare sales figures across different publishers, identify market leaders by region,
and explore gaming industry evolution over time.
Whether you need to understand which games dominated specific platforms, analyze
publisher market share through visualizations like histograms, or track sales performance
across different years and regions, this agent delivers comprehensive gaming market
intelligence with precise data-driven answers.

範例提示應告知使用者和代理程式代理程式可以處理的提示類型。 由於使用者可能會針對同一個概念使用不同的術語,因此請考慮改變交談入門的措辭。 例如,在處理法律案件時,好的對話開場白可能也會使用「事項」、「案例」、「客戶」和「問題」等術語。 text已連線的客服人員只會使用 [交談入門] 的欄位。

限制

  • 使用中的代理程式只會傳送文字給已連線的客服程式。 宣告式代理程式會傳回文字或調適型卡片。 具有 Agent2Agent 代理程式卡片的代理程式會傳回文字、Base64 影像二進位檔和 Base64 檔案二進位檔。

  • 當系統提示使用者確認已連線代理程式的 API 外掛程式呼叫時,任何 調適型卡片 都會傳送至作用中代理程式。 使用者看不到自適性卡片,也無法使用對話方塊。 不過,作用中代理程式會處理自適性卡片的資料內容。