Agent Builder 提供簡單的介面供您整合知識來源,讓您的宣告式代理程式更智慧且具上下文感知能力。 這些知識來源讓您的代理以企業資料、公共內容和使用者特定資訊為基礎,使其能夠提供更準確、相關和個人化的回應。
Agent Builder 支援公用網站、SharePoint 和 OneDrive 內容、Teams 聊天和會議、Outlook 電子郵件、內嵌檔案,以及 Microsoft 365 Copilot 連接器。 限制因來源類型而異。
| 知識來源 | 每個代理程式的限制 |
|---|---|
| 公用網站 URL | 四個 URL |
| SharePoint 檔案、資料夾或網站 | 100 個檔案 |
| SharePoint 清單 | 一個清單 |
| OneDrive 檔案 | 50 個檔案 |
| Teams 聊天和會議 | 五次聊天和五次會議 |
| 從裝置上傳的內嵌檔案 | 20 個檔案 |
| Microsoft 365 Copilot 連接器 | 沒有記錄在案的數字限制。 貴組織的系統管理員必須啟用連接器。 |
| Dynamics 365 和 Power Apps 資料 | 沒有記錄在案的數字限制。 貴組織的管理員必須 在 Work IQ 中啟用商務應用程式。 |
本文說明支援的知識來源及其設定步驟。 如需建置代理程式的一般資訊,請參閱 Agent Builder 中的建置代理程式。
如需更廣泛的支援知識來源清單,請參閱 將知識來源新增至宣告式代理程式。 知識來源和功能因授權而異;如需詳細資料,請參閱 Microsoft 365 Copilot 授權和代理程式功能和授權模型。
新增知識來源
如果您使用自然語言建立代理程式,Agent Builder 會根據您的描述為您新增知識來源。 您也可以從 [描述 ] 索引標籤上的聊天方塊新增知識來源:
在 Microsoft 365 Copilot 中,在左側窗格中選擇 [新增代理程式],然後在 [描述] 索引標籤上為您的代理程式提供自然語言描述。
選擇聊天方塊中 () 的 + 加號圖示。 使用下列其中一種方法來新增知識來源:
- 新增工作內容 - 選取、搜尋或上傳檔案。
- 上傳影像和檔案 - 直接從裝置上傳。
- 附加雲端檔案 - 附加您有存取權的雲端檔案。
如果您要手動設定代理程式,以將知識來源新增至代理程式:
在 Microsoft 365 Copilot 中,從左側窗格中選擇 [新增代理程式],然後選擇 [略過] 以設定。
在 [知識 ] 區段中,使用下列其中一種方法來新增知識來源:
- 搜尋 - 輸入要搜尋項目的關鍵字。 使用此選項可新增來源,例如電子郵件和 Teams 訊息。
-
輸入 URL - 新增公用網站、包含網站路徑的 SharePoint 連結 (例如,
.../sites/<site-name>/...) 但不包含查詢參數,或 OneDrive 共用連結。 - 瀏覽 - 使用[附加雲端檔案] 選擇器,瀏覽並選取 SharePoint 或 OneDrive 檔案、資料夾或清單。
- 上傳 - 直接從裝置上傳檔案。
驗證您的知識來源
新增知識來源之後,請確認它們顯示在 [設定] 索引標籤的 [知識] 區段中。接著,在 [試試看] 索引標籤上,詢問其中一個來源中可取得答案的問題,並確認回應使用預期的資訊。
新上傳的 SharePoint 和 OneDrive 內容可能會顯示 [準備中 ] 狀態。 您可以在來源準備時測試代理程式,但在來源準備就緒之前,代理程式不會在其回應中使用該來源。
公用網站
將特定公用網站新增為客服專員知識來源,以使您的客服專員具備上下文感知能力。 當您參照網站做為知識來源時,會套用下列限制:
- 公用網站 URL 只能是兩層。 例如,
https://example.org/a/b/c因為網址超過兩個層級而為無效網址。 - URL 不能包含查詢參數。 例如,
https://example.org?test=1無效。 - 最多可以新增四個 URL。
若要設定您的代理程式以使用任何 Web 資料做為知識:
- 使用自然語言要求 Agent Builder 排定知識來源的優先順序。
- 在 [設定 ] 索引標籤的 [知識] 底下,選擇 [搜尋所有網站] 旁的切換開關。
SharePoint 和 OneDrive 內容
參照特定檔案、資料夾、清單和網站做為代理程式知識來源。 當您從 SharePoint 或 OneDrive 參考來源時,請考慮下列限制:
| 限制或行為 | 詳細資料 |
|---|---|
| SharePoint 檔案 | 為每個代理程式選取最多 100 個 SharePoint 檔案。 |
| SharePoint 清單 | 為每個代理程式選取最多 1 個 SharePoint 清單。 |
| OneDrive 檔案 | 為每個代理程式選取最多 50 個 OneDrive 檔案。 |
| 權限和敏感度標籤 | 代理程式會遵守已上傳至 SharePoint 或 OneDrive 檔案的現有權限和 敏感度標籤 。 |
| 檔案大小 | 雖然您選取的知識檔案沒有直接的檔案大小限制,但代理程式只能推理特定 檔案類型。 |
當您參照 SharePoint 清單時,適用下列限制:
- 清單最多可以有 20,000 個項目 (列) 和 50 MB 的原始文字。 如果您的清單超過任一限制,代理程式會截斷該清單,並在回應中記下截斷。
- [ 附件] 欄 (列出附件) 未編製索引或用於基礎設置;代理程式不會從附件內容接聽。
- 選取 SharePoint 網站時不包含其清單。 若要將清單當做知識使用,請選取特定清單。
注意
- 如果已啟用 [受限制的 SharePoint 搜尋 ],您就無法使用 SharePoint 做為知識來源。
- 當資料位於活頁簿內的一個工作表中時,代理程式以 Excel 中的資料為基礎的查詢回應效果最佳。
- 若要針對 Copilot 進行最佳化,請保持您提供的檔案內容簡潔。 如需詳細資訊,請參閱 您提供給 Copilot 的文件長度。
輸入檔案、資料夾、清單或網站的 URL
輸入 SharePoint 網站、資料夾或檔案的 URL,例如 contoso.sharepoint.com/sites/policies。 代理程式會搜尋 URL 和子路徑。 例如,URL 例如 也 contoso.sharepoint.com/sites 包含子路徑,例如 contoso.sharepoint.com/sites/policies。 客服專員會使用相關資訊來提供有針對性的回應。
您也可以依 URL 新增 SharePoint 清單。 在清單上,選取 [共用 ] 或 [ 複製連結] 以取得連結,然後貼上清單 URL (但不) 查詢參數。 使用特定清單的直接連結,而不是篩選或群組檢視。 SharePoint 網站 URL 不包含該網站中的清單,因此請輸入清單本身的 URL。
針對 OneDrive,請輸入檔案或資料夾的可共用連結 (例如,從瀏覽器或共用選項) 複製的 URL,而不是本機或相對路徑 (C:\Users\YourName\Documents\File.xlsx 例如) 。
提供 URL 之後,請按 Enter 將其新增為知識來源。
瀏覽以選取檔案、資料夾、清單或網站
選取 [知識] 區段中的 [附加雲端檔案] 雲朵圖示以開啟檔案選擇器。 選擇器會顯示您最近存取的 SharePoint 和 OneDrive 網站。 若要檢視更多 SharePoint 網站,請選取左窗格底部的 [其他位置 ]。 如果您最近建立了某個網站,該網站會在幾分鐘後出現。
若要瀏覽 SharePoint 清單,請選取選擇器左側窗格中的 [最近使用的清單 ],然後選取您想要新增的清單。
注意
SharePoint 選擇器可能不會顯示您具有存取權的所有 通訊網站 。 通訊網站只會顯示在 SharePoint 選擇器的 [ 快速存取 ] 和 [最近使用的 ] 區段中。
檔案整備
當您上傳新檔案至 SharePoint 或 OneDrive 時,代理程式最多可能需要幾分鐘的時間,才能將這些檔案包含在回應中。 如果來源尚未就緒,您仍然可以在 [試用 ] 索引標籤上測試您的代理程式。 不過,在新上傳檔案準備就緒之前,回應不會包含新上傳檔案中的資訊。
您可以在 [設定] 索引標籤的 [知識] 區段中檢查檔案整備程度;檔案旁邊有「準備中」字樣。 當您重新命名或刪除上傳到 SharePoint 或 OneDrive 的基礎檔案時,代理程式會擷取變更。 您也可以選取 [ 知識 ] 區段頂端的 [重新整理] 按鈕,以手動重新載入狀態。
OneNote 頁面
您可以從檔案選擇器中選擇特定的 OneNote 頁面,以作為知識上傳。 您只能選取個別的 OneNote 頁面;選取整個 OneNote 筆記本的選項無法使用。 當您選取 [ 我的 SharePoint 檔案、資料夾和網站] 時,OneNote 頁面也包括在內。
使用檔案選擇器來新增 OneNote 頁面。 Agent Builder 不支援輸入 OneNote 頁面 URL。
Microsoft Teams 資料
您可以將您的代理程式接地於 Microsoft Teams 資料中,包括 Teams 聊天訊息和會議資訊。 若要將您有存取權的所有聊天訊息、會議文字記錄及行事曆當做知識使用,請選取 [ 我的 Teams 聊天和會議]。
您也可以將代理程式範圍限定為特定聊天,包括團隊頻道、群組聊天和會議聊天。 將知識範圍限定到特定聊天,可以提高客服專員回應的準確性和相關性。 若要將 Teams 知識範圍限定為特定聊天,請在 [設定 ] 索引標籤上的 [知識 ] 區段中,選取搜尋列。 在開啟的視窗中,選擇 [聊天] 索引標籤,然後選取要新增的特定聊天。 您最多可以新增五個聊天。
您也可以將代理程式範圍限定為特定會議。 將知識範圍限定到特定會議,可以提高客服專員回應的準確性和相關性。 若要將 Teams 知識範圍限定為特定會議,請在 [設定 ] 索引標籤的 [知識 ] 區段中,選取搜尋列。 在開啟的視窗中,選擇 [會議] 索引標籤,然後選取要新增的特定會議。
重要
- Teams 知識可用性取決於您的授權。 如需詳細資料,請參閱 Microsoft 365 Copilot 授權。
- 當您選取 [ 我的 Teams 聊天和會議] 時,代理程式會搜尋所有會議文字記錄和整個行事曆。 若要限制範圍,請改為新增特定會議。
- 根據過去文字記錄的大小,客服專員可能無法存取所有會議文字記錄。
Outlook 電子郵件
您可以在 Outlook 電子郵件中將您的代理程式接地。 若要將電子郵件新增為知識來源,請在 [設定 ] 索引標籤的 [知識 ] 區段中,選取搜尋列,然後選擇 [我的電子郵件]。
注意
您無法設定電子郵件知識的範圍。 當您新增電子郵件時,代理程式會使用您信箱中的所有電子郵件作為知識。 與您共用代理程式的使用者無法以知識方式存取您的電子郵件。 此功能的可用性取決於您的授權。 如需詳細資料,請參閱 Microsoft 365 Copilot 授權。
內嵌檔案內容
您可以直接從您的裝置上傳檔案,供客服專員從 [描述 ] 或 [設定 ] 索引標籤中用作知識。您上傳的檔案會成為代理程式中的內嵌內容。 若要上傳檔案,請從裝置將檔案拖放到任一索引標籤中。您也可以選擇 [設定 ] 索引標籤上的箭頭圖示,從您的裝置上傳檔案。 您可以從裝置上傳個別檔案,但無法上傳檔案資料夾。
您最多可以新增 20 個檔案做為知識來源。
內嵌檔案會儲存在租用戶的預設地理位置中,而不是儲存在使用者慣用的資料位置 (PDL) 。
注意
Microsoft 365 政府社群雲端 (GCC) 環境中不支援內嵌檔案內容。
[ 設定] 索引標籤在 [已上傳的檔案] 底下顯示內嵌檔案。 Files 可能需要幾分鐘的時間上傳,並在完全上傳前顯示為灰色。 上傳時間可能會根據檔案大小和網路速度而有所不同。 如需內嵌檔案大小限制的相關資訊,請參閱 檔案大小限制。
重要
Microsoft 內嵌檔案不支援 Purview 資訊屏障 (IB) 。 任何可以存取代理程式的使用者都可以看到以內嵌檔案內容為基礎的回應。
若要移除您上傳的檔案,請選擇檔案旁邊的 [X],然後選擇 [移除]。
不支援具有下列任何特性的 Files:
- 雙金鑰加密。
- 具有使用者定義權限的敏感度標籤。 如果您上傳具有使用者定義權限的檔案,代理程式建立會失敗。
- 已停用擷取權限權限的敏感度標籤。 如果您上傳這些檔案,代理程式建立將失敗。 如果代理程式使用者沒有內嵌檔案的擷取權限,則使用者無法存取代理程式。
- 來自另一個已啟用加密之租用戶的 Files。
- 密碼保護。
如需詳細資料,請參閱不 支援的敏感度標籤案例。
注意
當您上傳檔案作為代理程式的知識來源時,任何有權存取代理程式的使用者也可以存取檔案中的資訊。 如果使用者沒有檔案上任何敏感度標籤的擷取權限存取權限,則代理程式的存取權會受到限制。
如需內嵌檔案內容索引和擷取的相關資訊,請參閱 最佳化內容擷取。
代理程式內嵌內容的敏感度標籤
如果您上傳任何具有敏感度標籤的檔案,或如果您的租用戶有預設 的敏感度標籤原則 ,請將敏感度標籤套用至代理程式內嵌內容。 透過將敏感度標籤套用至代理程式內嵌內容,您可以確保代理程式符合貴組織的 Microsoft Purview 原則。
套用至內嵌內容的敏感度標籤是下列標籤中較高的優先順序:
- 套用至任何內嵌檔案的最高優先順序敏感度標籤。
- 組織套用的 預設敏感度標籤原則 。
例如,如果您在代理程式中內嵌具有 [一般] 標籤的檔案和具有 [機密] 標籤的檔案,則 [機密] 敏感度標籤會套用至內嵌內容。
注意
敏感度標籤僅適用於內嵌內容;它不適用於代理程式參考的其他知識來源,例如 SharePoint 檔案或 Copilot 連接器內容。
只有具備對內嵌內容所套用之敏感度標籤的擷取權限權限的使用者才能存取及使用代理程式。 標籤不會出現在代理商 Store 清單中。 沒有內嵌內容擷取權限權限的使用者可以檢視代理程式和代理程式描述,但無法新增或使用代理程式。
敏感度標籤也會套用至代理程式回應。 此標籤是下列標籤中優先順序較高的標籤:
- 內嵌內容的敏感度標籤
- 任何其他代理程式知識來源的敏感度標籤,例如 SharePoint 和 OneDrive 檔案。
目前,您無法在代理程式上設定敏感度標籤。
不支援的敏感度標籤案例
下表列出目前不支援的敏感度標籤案例,描述建置器將檔案上傳到代理程式時的行為,並提供建置器建議的動作。
| 案例 | 行為 | 動作 |
|---|---|---|
| 已啟用 Microsoft Purview 雙重金鑰加密的敏感度標籤 | 檔案是內嵌的,但不會做為知識使用。 建立器在上傳檔案時不會看到錯誤訊息。 | 避免使用 DKE 上傳檔案,因為它們無法用作知識。 |
| 已啟用使用者定義權限的敏感度標籤 | 檔案已上傳,但代理程式建立失敗,且沒有錯誤訊息。 | 移除任何具有使用者定義權限的上傳檔案。 |
| 已為使用者停用擷取權限的敏感度標籤 | 檔案已上傳,但代理程式建立失敗,且沒有錯誤訊息。 | 移除任何已上傳並停用擷取權限的檔案。 |
| 來自另一個已啟用加密之租用戶的 Files with sensitivity labels | 檔案會內嵌在代理程式中,但不會做為知識使用。 | 避免從啟用加密的租用戶上傳具有敏感度標籤的檔案,因為它們無法作為知識使用。 |
| 具有密碼保護的 Files | 檔案已上傳,且建置器會在上傳的檔案旁邊看到錯誤訊息。 | 移除任何具有密碼保護功能的上傳檔案。 |
使用內嵌檔案共用代理程式
當您使用內嵌檔案共用代理程式時,您會在使用者取得代理程式時與使用者共用檔案。 使用者取得代理程式之後,他們可以根據這些知識來源,從 Copilot 取得回應。 如需可用的共用選項,請參閱 共用和管理 Agent Builder 內建的代理程式。
當您 共用代理程式時,如果內嵌內容上設定了敏感度標籤,則 [共用] 畫面會顯示敏感度標籤。
檔案類型和大小限制
下表列出您可以作為知識新增至代理程式的檔案類型,以及每種檔案類型的內嵌檔案大小限制。
| 檔案類型 | 內嵌檔案限制 |
|---|---|
| .doc | 512 MB |
| .docx | 512 MB |
| .html* | NA |
| 512 MB | |
| .ppt | 512 MB |
| .pptx | 512 MB |
| .txt | 512 MB |
| .xls | 30 MB |
| .xlsx | 30 MB |
* 僅支援 Microsoft 365 中的 SharePoint。
People data
如果您將客服專員紮根於 People 數據,它可以提供更個人化和上下文感知的回應。 People Data 提供有關個人的公開資訊,例如姓名、職位、技能和組織關係。 此資訊允許代理查找使用者和同事的個人資料,包括報告結構和聯絡詳細資訊。
對於由擁有 Microsoft 365 Copilot 授權的使用者所建立的代理程式,預設會啟用 People 資料。 您可以在代理設定 UI 中停用或重新啟用此功能。 若要停用或啟用 People 資料:
- 在 Agent Builder 的 [設定] 索引標籤上,選取 [參照組織中的人員] 旁的切換開關,以關閉或開啟 People 資料。
此功能的可用性取決於您的授權。 如需詳細資料,請參閱 Microsoft 365 Copilot 授權。
注意
People 資料可作為個人化層,利用來自 Microsoft 365 的內容強化客服專員回應。 它不會帶來新的隱私風險,但為使用者和系統管理員提供透明度和控制。
Copilot 連接器
Copilot 連接器可讓代理程式存取並套用來自外部系統的知識,例如客戶帳戶、事件票證、代碼存放庫和知識文章。 使用 Copilot 連接器將企業資料整合到您的代理程式,並賦予他們網域特定的知識。
注意
系統管理員必須在 Microsoft 365 系統管理中心啟用和設定 Copilot 連接器。
如需 Copilot 連接器的詳細資訊,請參閱 Microsoft 365 Copilot 連接器概觀。
範圍 Copilot 連接器資料來源
為了提高客服人員回應的準確性和相關性,地勤人員不僅涉及廣泛的組織資料,還涉及特定的範圍資料。 若要將代理程式中的連接器資料範圍限定為特定屬性:
在 [設定 ] 索引標籤上的 [ 選擇其他資料來源] 底下,選取資料來源的連接器。
在該連接器的卡上,新增與您的案例相關的連線。
選取箭號以返回 [知識 ] 區段。
展開您新增的連接器,然後選取您要將知識範圍限定為 (的屬性,例如專案、空間、資料夾) ,然後搜尋或輸入屬性名稱。
注意
如果屬性未出現在搜尋結果中,可能是因為:
- 您的系統管理員並未設定限定範圍的內容。
- 您沒有存取內容的必要權限。
- 範圍對選取的連接器無效。
從清單中選取要新增的屬性。
您客服專員的知識範圍現在會限定為與範圍屬性相關聯的資料。
例如,當您使用 Azure DevOps 工作項目連接器時,可以將代理程式的範圍限定為特定區域路徑,以確保代理程式只專注於最相關的工作項目。
若要設定 Azure DevOps 工作項目區域路徑的範圍:
- 在 [選擇其他資料來源] 底下,選取 [Azure DevOps 工作項目]。
- 選取與您的工作相關的連線旁邊的 [ 新增 ]。
- 選取箭號以返回 [知識 ] 區段。
- 選取 區域路徑 ,然後搜尋或輸入區域路徑名稱。
- 選取區域路徑以新增它。
下表列出支援範圍的 Copilot 連接器,以及可用來設定資料範圍的屬性。
| 連接器 | 範圍屬性 |
|---|---|
| Azure DevOps 工作項目 | 區域路徑 |
| Azure DevOps Wiki | Project |
| Confluence | 太空 |
| Google 雲端硬碟 | 資料夾 |
| GitHub 雲端提取要求 | 存放庫 |
| GitHub 雲端問題 | 存放庫 |
| GitHub 雲端知識 | 存放庫 |
| Jira | Project |
| ServiceNow 知識 | 知識庫 |
| ServiceNow 目錄 | 目錄 |
| ServiceNow 票證 | 實體類型 (Sys_class_name/類別/子類別) |
如需可用 Copilot 連接器的詳細資訊,請參閱 預建連接器庫。
Dynamics 365 和 Power Apps 資料
Work IQ 中的商務應用程式可協助專員了解和使用來自 Dynamics 365 和 Power Platform 的商務資料和流程。 連接您的商務應用程式,為客服人員提供回答問題、遵循商務流程以及在現有權限和控制範圍內採取行動所需的內容。
注意
系統管理員必須先在 Microsoft 365 系統管理中心啟用 Work IQ 中的商務應用程式,並為每個 Power Platform 環境啟用 Work IQ。 如需詳細資訊,請參閱 在 Work IQ 中設定商務應用程式。
將 Dataverse 新增為知識來源可提供內容的讀取存取權,並且不允許建立、更新或刪除記錄。
使用 Agent Builder,您可以決定哪些應用程式會包含為資料來源,以及應用程式、表格和資料的存取權。 不過,Dataverse 安全性設定會規範所有資料。 系統不會向尚未具有指定應用程式或資料存取權的使用者提供任何回應。
如果您未選擇特定應用程式,則會在您有存取權的所有應用程式上執行查詢。 如需詳細資訊,請參閱 知識來源。
將您的知識來源置於一般知識之上
您可以設定代理程式,在回應需要知識型搜尋的查詢時,優先處理您提供的知識來源,例如 SharePoint 內容或內嵌檔案。 基於知識的搜索是用戶查找特定信息的請求;例如:
- 現任公司執行長是誰?
- 下一個商務會議是什麼時候?
- 與功能相關的最新更新為何?
某些使用者要求不需要以知識為基礎的搜尋;代理程式可以根據一般 AI 知識進行回應。 例如:
- 將這句話翻譯成西班牙語:“你好,你好嗎?
- 什麼是1+1?
當您啟用此功能時,代理程式會回答不需要使用其一般知識進行搜尋的簡單問題,並且僅使用您的知識來源來回答基於搜尋的問題。 如果代理程式在您提供的知識來源中找不到相關資訊,它會以表示找不到資訊的後援訊息進行回應。 使用 [ 僅使用指定的來源 ] 設定,讓客服專員優先處理您指定的來源。 此設定會優先處理您的來源,而不是封鎖一般 AI 知識。
若要設定您的代理程式以排定知識來源的優先順序,請在 [設定 ] 索引標籤上,選取 [僅使用指定來源] 旁邊的切換開關。
注意
Agent Builder 不支援封鎖客服專員回應中的一般 AI 知識。 若要更嚴格地控制知識來源,請使用 Copilot Studio。 如需詳細資訊,請參閱 使用生成式 AI 協調代理程式行為。