Copilot Agent Kit 代理函式庫中的元件參考

Agent Library 中的元件是可重複使用的預設元件集合，你可以加入任何 Copilot Studio 代理。 每個元件都被打包成獨立 的元件集合，所以你只需要安裝你需要的元件。

本文為每個元件的參考資料。 關於元件的概述、如何瀏覽與安裝套件中的元件，以及如何將它們加入代理程式，請參閱 代理程式庫中的元件管理。

元件一覽

代理函式庫包含以下組件，並隨其解決方案運送。 不需要連線參考的元件則存在於獨立的基底解中。 共用一個連接器的元件會被歸為一組。

Prerequisites

在開始之前，請確保以下先決條件已達成：

• 在您的 Power Platform 環境中安裝並設定 Copilot Agent Kit。
• 登入的使用者在 Copilot Agent Kit 中被指派了 CSK - Maker 的安全角色，以瀏覽和安裝元件。
• Power Platform 環境啟用了 Copilot Studio。
• 在你的環境中準備 AI Builder 的信用點數（這是提示型元件的必要條件）。
• 對於 ServiceNow Ticket Assistant，請在 Power Platform 中設置一個 ServiceNow 實例，並有 REST API 存取權和 ServiceNow 連線。 想了解更多，請參考 ServiceNow 服務主體設定。

Document Extraction

文件擷取將上傳的文件轉換成結構化資料。 它使用 AI Builder 提示，根據可配置的結構解析並提取關鍵欄位。

使用時機：發票處理、合約審查、表單數位化，或任何需要從非結構化文件中擷取結構化資訊的情況。

文件擷取的運作方式

1. 使用者將文件上傳到客服人員對話中。
2. 該元件使用 AI Builder 處理文件。
3. 元件會回傳擷取後的結構化輸出，你可以儲存、顯示或傳遞給下游流程。

文件擷取輸入

文件擷取輸出

所有 AI Builder 的提示輸出都會被回傳。

Content Synthesizer

內容合成器將原始搜尋結果轉化為結構化、以證據為基礎的研究區塊，並附有內嵌引用。 它是研究元件與執行簡報元件管線共用的合成引擎。 它也可以作為獨立工具加入任何代理，用於隨選內容綜合。

使用時機：任何需要將多個來源文件綜合成連貫且以引用為基礎的敘事情境，無論是作為多階段流程的一部分，或作為獨立內容生成工具。

內容合成器的運作方式

1. 父管線（或代理）會傳遞研究提示、原始搜尋結果內容及可選樣式指示。
2. 提示依主題整合所有來源的洞見。 它不會逐一總結來源。
3. 證據以所提供的內容為基礎，並附有具體數據點，如數字、百分比、日期及命名實體。
4. 輸出是一個 JSON 物件，包含合成的標記刪除區段及一個擷取引文陣列。

內容合成器輸入

內容合成器輸出

提示符會回傳一個包含兩個欄位的 JSON 物件：

內容合成器的輸出結構

綜合段落遵循以下結構：

• 開場：以最重要的發現作為開場，並預覽關鍵主題。
• 正文：依主題組織（非來源），附有內嵌標註、 [n] 標註關鍵 尋找 標註及可選 [CHART SUGGESTION] 標記。
• 重點摘要：三到五個簡潔且可執行的重點。
• 頁尾：信心評估（高到低）、資料新近性及顯著缺口。

Research Component

研究組件將多個來源的資訊整合成完整的研究報告。 它利用三階段的 AI 流程來規劃、研究並彙整研究結果。

何時使用：競爭分析、市場調查、政策審查，或任何需要跨多元資訊來源綜合視角的情境。

研究組成部分的運作方式

1. 使用者提供研究問題或主題。
2. 第一階段（研究規劃器）：建立結構化的研究計畫，包含章節與查詢。
3. 第二階段（內容綜合器）：搜尋每個章節的網路來源，並產生帶有引用的內容。
4. 第三階段（報告最終版）：將所有章節與引用合併成精緻報告。
5. 最終報告會顯示在對話中。

研究組件輸入

研究組成部分產出

元件在對話中內嵌顯示報告。

執行簡報組成部分

執行簡報組件從複雜輸入中生成簡潔且以決策為導向的摘要。 它利用三階段的 AI 流程來規劃、綜合洞見，並彙整一份精緻的高階主管簡報。

使用時機：董事會會議準備、專案進度更新、季度業務回顧，或任何需要為利害關係人提供精緻摘要的情境。

行政簡報組成部分的運作方式

1. 使用者提供簡短的主題或問題。
2. 第一階段（執行簡報規劃師）：制定具有研究領域的策略研究計畫。
3. 第二階段（Insight Synthesizer，由 內容綜合器驅動）：搜尋各領域的內部及網路來源，擷取關鍵事實與引用。
4. 第三階段（簡報最終稿）：將所有見解與引用彙整成精緻的執行簡報。
5. 簡報會直接在對話中顯示。

執行簡報組件的輸入

執行簡報組件輸出

該組件會在對話中內嵌顯示執行簡報。

ServiceNow 票務助理

ServiceNow Ticket Assistant 直接由 Copilot Studio 代理提供端對端的 ServiceNow 事件管理。 其中包含五個涵蓋完整事件生命週期的主題。

何時使用：IT 客服、員工自助服務，或任何涉及 ServiceNow 事件管理的情境。

ServiceNow 包含主題

ServiceNow prerequisites

這個元件會隨自己的解決方案CopilotStudioKit_ServiceNow_Components（）出貨，因為它在匯入時需要 ServiceNow 連線參考。 在匯入此解決方案前，請確保您具備：

• 一個 ServiceNow 實例，並能存取 REST API。
• 一個在 Power Platform 為 ServiceNow 設定的連線。 在匯入解決方案時會被提示設定這個功能。
• 為所需操作提供適當的 ServiceNow 使用者權限。

ServiceNow 服務主體設定

要設定使用 Microsoft Entra ID 的 ServiceNow Power Platform 連線，請依照「如何設定使用 Microsoft Entra ID 的 ServiceNow Power Platform 連線」中的步驟操作。

ServiceNow 票務助理的運作方式

1. 使用者表達意圖（例如：「我需要建立工單」或「INC0012345狀態如何？」）。
2. 觸發相應主題，並呈現自適應卡片以收集所需輸入。
3. 元件透過連接器呼叫 ServiceNow API，並回傳結果。
4. 操作完成後， 下一步行動 主題會呈現下一步的選項。

Create incident

透過收集使用者資料並透過連接器提交至 ServiceNow，建立新的 ServiceNow 事件。

何時使用：IT 客服、員工自助服務，或任何需要直接從對話中記錄新事件的情境。

建立事件流程

1. 使用者表達了要創建事件的意圖，例如「我需要為一台壞掉的筆電建立工單。」
2. 自適應卡會收集所需的事件細節。
3. 元件呼叫 ServiceNow API 建立事件，並回傳事件編號的確認訊息。
4. 會呈現 下一個動作 選單，讓使用者能繼續執行另一個 ServiceNow 操作。

透過自適應卡建立事件輸入

建立事件輸出

確認訊息內嵌顯示已建立的事件編號。

檢查事件狀態

取得現有 ServiceNow 事件的最新狀態與詳細資料。

檢查事件狀態流程

1. 使用者詢問某事件，例如：「INC0010002 的狀態如何？」
2. 自適應卡會收集事件編號。
3. 元件查詢 ServiceNow 並回傳事件細節。

透過自適應卡檢查事故狀態輸入

檢查事故狀態輸出

解決或關閉事件

將現有 ServiceNow 事件的狀態更新為已解決、關閉、取消、暫停或進行中，並附上解決細節。

解決或關閉事件流程

1. 使用者表達解決或結案意向，例如「關閉工單INC0010002」。
2. 自適應卡會收集事件編號、目標狀態、解決代碼及解決筆記。
3. 元件會在 ServiceNow 更新事件並回傳確認。

解決或結案事件的前提條件

一個 ServiceNow 實例，具備 REST API 存取權限，並在 Power Platform 中連接 ServiceNow 。

透過自適應卡解決或關閉事件輸入

解決或關閉事件輸出

確認訊息內嵌顯示事件狀態更新。

獲取近期事件

可檢索並顯示目前使用者最多 10 起近期 ServiceNow 事件。 不需要輸入欄位。 元件會自動使用已登入使用者的電子郵件。

何時使用：當使用者想要快速了解近期或未解決事件時。

掌握近期事件流程

1. 使用者會詢問他們的事件，例如「顯示我最近的事件」。
2. 元件會查詢 ServiceNow 最多 10 起與登入使用者電子郵件相符的近期事件。
3. 事件細節會直接在對話中顯示。

獲取近期事件資訊

None. 該元件會自動使用已登入使用者的電子郵件。

取得近期事件輸出

元件細節面板

當你在 Copilot Agent Kit 的代理函式庫中開啟元件時，詳細面板會顯示元件描述、類別、輸入與輸出變數，以及所使用的技術。

要安裝元件並將其加入代理工作流程，請參見 元件管理。

使用元件搭配管理解決方案

大多數使用者使用管理式解決方案。 匯入的元件為唯讀。 你可以將它們加入代理人並使用，而不必擔心意外修改底層主題、提示或流程。

即使不編輯元件本身，你也有兩種方式來控制行為：代理指令和工具輸入預設值。

Agent instructions

你的 Copilot Studio 代理的指令欄位是塑造元件使用方式的主要方式。 透過自然語言指令，您可以控制：

• 元件被呼叫時：描述應觸發每個工具的情境或使用者意圖。
• 傳遞哪些資料：告訴客服要包含哪些情境、變數或對話歷史。
• 結果呈現方式：指定格式、語氣、後續動作或元件回傳輸出後的路由。
• 整體協調：當多個元件涉及時，定義作業順序，例如「完成研究後，從研究結果中產生執行簡報」。

工具輸入預設值

當你將元件作為工具加入，例如 AI Builder 提示時，即使使用受管理解決方案，也能直接在 Copilot Studio 中設定輸入參數。 這些輸入讓你能設定比代理指令更具體的預設值。 For example:

• 提供針對你商業文件量身打造的預設 ExtractionSchema 欄位，例如發票欄位如姓名、發票號碼和日期。
• 預先填寫 AdditionalInstructions 貴組織偏好的寫作風格或合規要求。

輸入預設值會依代理設定，因此不同代理可以將不同值傳遞給同一共用元件。

用非管理解決方案自訂元件

如果你需要修改元件內部結構，例如更改提示邏輯、編輯主題流程或重新接線連接器，你必須匯入非管理解決方案。 這個解決方案讓你可以完全編輯代理函式庫中的每個主題、提示詞和流程。

常見的客製化包括：

• 修改提示：調整 AI Builder 提示，使其符合你的網域和輸出格式。
• 變更資料來源：將元件指向您自己的 Dataverse 資料表、SharePoint 清單或外部連接器。
• 調整主題：更新對話流程，使其符合組織的術語與流程。
• 更新觸發詞：加入反映用戶自然需求方式的觸發詞。
• 新增認證：若元件需要存取使用者特定資料，則設定認證。

Related information

• Components management
• AI Builder 文件