秘訣
推薦項目: 從 Work IQ 開發工具 開始,支援專業程式碼宣告式代理程式和外掛程式案例。 請參閱 WIQD 快速入門。 工具組式指示仍然適用於需要工具組的指示的現有專案和工作流程。 在選擇工具之前,請先檢查 功能和目標體驗支援 : WIQD 不會以自訂引擎代理程式為目標。
您可以新增程式碼解釋器和影像產生器等功能以及知識來源,以增強和自訂代理程式的知識,以增強宣告式代理程式的使用者體驗。 資訊清單參考中的功能物件和 Microsoft 365 Copilot 中的 [知識] 區段提供數個選項,供您為使用者解除鎖定功能。 本文說明您可以新增至代理程式的知識來源。
下表列出您可以使用 Microsoft 365 Copilot 中的代理程式建立器或 Microsoft 365 代理程式工具組來設定的功能和知識來源,並指出使用者是否需要 Microsoft 365 Copilot 授權或計量使用量才能存取具有該功能或知識來源的代理程式。
下表描述的是代理程式建立器和工具組設定路徑,而非 WIQD 功能涵蓋範圍。 對於建議的專業代碼路由,請確認 WIQD 文件中支援的設定。
| 功能或知識來源 | 代理程式建立器 | Agents Toolkit | 需要授權或計量使用量嗎? |
|---|---|---|---|
| 程式碼解譯器 | ✅ | ✅ | 否 |
| 影像產生器 | ✅ | ✅ | 否 |
| Copilot 連接器 | ✅ | ✅ | 是 |
| SharePoint | ✅ | ✅ | 是 |
| OneDrive | ✅ | ✅ | 是 |
| 內嵌檔案內容 | ✅ | ❌ | 是 |
| Bing Web 搜尋 | ✅ | ✅ | 否 |
| 範圍 Web 搜尋 | ✅ | ✅ | 否 |
| Dataverse | ✅ | ✅* | 是 |
| 電子郵件 | ✅ | ✅* | 是, (僅限授權) |
| 人員 | ✅ | ✅ | 是, (僅限授權) |
| OneNote 頁面 | ✅ | ❌ | 否 |
| Teams 訊息 | ✅ | ✅* | 是, (僅限授權) |
| Teams 會議 | ✅ | ✅ | 是, (僅限授權) |
* 提供知識範圍的選項。
Copilot 連接器
Microsoft 365 Copilot 連接器可讓您將組織資料新增到代理程式做為基礎資訊。 使用 Copilot 連接器將您的企業營運資料擷取至 Microsoft Graph,讓 Copilot 可以將您的資料推理為回應使用者提示的基礎資訊。 如需詳細資訊,請參閱 Microsoft 365 Copilot 連接器概觀。
如需如何將 Copilot 連接器作為知識新增至代理程式工具組中的代理程式資訊清單的相關資訊,請參閱 Copilot 連接器物件。
如需如何將 Copilot 連接器新增至代理程式產生器中的代理程式的相關資訊,請參閱 Copilot 連接器。
SharePoint 和 OneDrive
當您設定代理程式以使用 SharePoint 和 OneDrive 內容做為知識時,Copilot 會搜尋使用者有權存取的 SharePoint 和 OneDrive 檔案、資料夾或網站,以取得基礎資訊。
如需有關如何將 SharePoint 和 OneDrive 知識新增至 Agents Toolkit 中的代理程式資訊清單的詳細資訊,請參閱 OneDrive 和 SharePoint 物件。
如需有關如何將 SharePoint 和 OneDrive 知識新增至代理程式建立器中的代理程式、每個代理程式限制以及如何處理權限和敏感度標籤的詳細資訊,請參閱 SharePoint 和 OneDrive 內容。
注意
SharePoint 和 OneDrive 知識來源要求登入使用者擁有有效的 Microsoft 365 Copilot 授權。 如果使用者沒有授權,要求將失敗並顯示「 抱歉,我無法回應」訊息。
沒有 Copilot 授權 (CDX) 租用戶帳戶的客戶數位體驗可以發佈代理程式,但無法執行以 SharePoint 為基礎的擷取。 使用 Microsoft 365 Copilot 開發人員授權在非生產環境中測試案例。
Web 和限定範圍的 Web 搜尋
Web 搜尋可讓代理程式使用 Bing 中的搜尋索引來回應使用者提示。 如果您在代理程式中啟用 Web 搜尋,則代理程式可以在其回應中傳回任何 Web 資料。 您也可以將 Web 搜尋範圍設定為最多四個公用網站。
重要
組織系統管理員可以停用 Copilot 及其組織內所有代理程式的 Web 搜尋。 如果系統管理員停用 Web 搜尋,啟用 Web 搜尋的代理程式就不會回報錯誤,也不會將 Web 搜尋納入其知識中。 開發人員模式偵錯卡 指出,如果代理程式啟用了 Web 搜尋,則已啟用,即使系統管理員已停用。 如需詳細資訊,請參閱在 Microsoft 365 系統管理中心管理 Microsoft 365 Copilot 案例。
新增 Web 和限定範圍的 Web 搜尋
如果您使用代理程式工具組和 Visual Studio Code 建立代理程式,請將值WebSearch新增至資訊清單檔案中的 capabilities 屬性,以啟用 Web 搜尋。 若要將網頁搜尋範圍限定為特定網站,請新增 sites 屬性並指定最多四個 URL,如下列範例所示。
注意
若要將限定範圍 Web 搜尋新增至您的代理程式,請使用 1.3 版 或更新版本的宣告式代理程式資訊清單架構。
{
"capabilities": [
{
"name": "WebSearch",
"sites": [
{
"url": "cnn.com"
}
]
}
]
}
如果您使用 Agent Builder 建立代理程式,請在 [設定 ] 索引標籤的 [知識] 底下,列出您要參考的網站 URL。
Web 搜尋基礎知識與動態內容
當宣告式代理程式的資訊清單將 Web 搜尋範圍限定為特定網站 URL 時,代理程式會將其回應建立在 Bing 為這些網站編制索引的內容,而不是直接存取基礎資料來源。
範圍 Web 搜尋仰賴 Bing 為已設定網站編制索引的內容。 因此,相依於用戶端轉譯或動態產生資料的內容可能無法在搜尋結果中完全呈現。 在某些情況下,相對於即時網站上顯示的內容,動態載入的內容可能遺失或過時。
這種行為可能會產生不一致的結果。 網站上顯示的內容可能與客服專員可用的內容不同,而且客服專員可能無法可靠地從動態產生或經常更新的清單傳回最新項目。
目前的宣告式代理程式架構會發生此行為。 宣告式代理程式不適用於動態產生或非 OpenAPI Web 來源,這些案例可能會導致基礎設置結果不完整或不一致。
若要直接存取結構化、經常變更的內容,請使用由 OpenAPI 規格支援的 API 外掛程式,而不是限定範圍的 Web 搜尋。 API 外掛程式可讓代理程式直接查詢基礎資料來源,並使用 API 參數 (例如排序和結果限制),而不是依賴索引的 Web 內容。 或者,將內容移轉至支援的 OpenAPI 型或靜態知識來源。 如需這些方法的指導方針,請參閱:
內嵌檔案內容
如果您使用 Agent Builder 建立代理程式,您可以直接從裝置或雲端上傳檔案,以內嵌內容供客服專員用作知識。 內嵌檔案內容會儲存 在 SharePoint Embedded 中。 這些檔案會計入您租用戶中的 OneDrive 和 SharePoint 容量。
注意
- 檔案上傳功能可供已啟用使用計費或具有 Microsoft 365 Copilot 授權的使用者使用。
- Microsoft 365 政府社群雲端 (GCC) 環境中不支援內嵌檔案內容。
如需內嵌檔案的詳細資訊,請參閱 內嵌檔案內容。
重要
Microsoft 內嵌檔案不支援 Purview 資訊屏障 (IB) 。 任何可以存取代理程式的使用者都可以看到以內嵌檔案內容為基礎的回應。
Dataverse
Dataverse 知識可讓代理程式以自然語言回應使用者對其 CRM 資料或來自 Microsoft Dataverse 中資料表資料的查詢。 您可以將 Dataverse 執行個體新增為知識來源,並新增同義字和字彙表,以協助系統更有效地解釋資料表中的自訂資料。 如需詳細資訊,請參閱 新增 Dataverse 知識來源。
新增 Dataverse 知識
如果您使用代理程式建立器來建立代理程式,請在知識區段的設定索引標籤上選取 Dynamics 365 和 Power Apps。 選取 + 以找出您想要包含的應用程式,然後選取該應用程式,或保持原樣以在所有應用程式中搜尋。 您可以透過 Work IQ 中的商務應用程式存取代理程式產生器中的 Dataverse 知識,系統管理員必須先 啟用此功能。
如果您使用代理程式工具組和 Visual Studio Code 建立代理程式,請將值capabilities新增至Dataverse代理程式資訊清單檔案中的屬性以啟用 Dataverse 知識,如下列範例所示。
注意
若要新增 Dataverse 知識,請使用 1.3 版 或更新版本的宣告式代理程式資訊清單架構。
{
"capabilities": [
{
"name": "Dataverse",
"knowledge_sources": [
{
"host_name": "YourOrgID.crm.dynamics.com",
"skill": "DVCopilotSkillName",
"tables": [
{
"table_name": "account"
},
{
"table_name": "opportunity"
}
]
}
]
}
]
}
新增此技能之前,請確定 skill 您的 Dataverse 環境中存在 capabilities 陣列中的值。 此外,請確定該 host_name 值符合您的組織識別碼。
擷取預先存在的技能值或建立新的技能值
擷取或建立 Dataverse skill 值:
從 Power Apps 取得您的組織識別碼 Maker 入口網站 >設定>開發人員資源。
取得持有人權杖以 驗證 和建立 Dataverse 資源。 若要取得持有人權杖,請在 Azure 入口網站中建立新的應用程式註冊,然後執行下列 curl 要求。
curl -X POST https://login.microsoftonline.com/<tenant_ID>/oauth2/v2.0/token \ -H "Content-Type: application/x-www-form-urlencoded" \ -d "client_id=<client_ID>" \ -d "scope=https://YourOrgID.crm.dynamics.com/.default" \ -d "client_secret=<client_secret>" \ -d "grant_type=client_credentials"使用下列 curl 要求來判斷值是否
skill已存在。 如果值已存在,則skill回應會包含 Dataverse 環境中現有DVTableSearch技能的清單。AUTH="Bearer {TOKEN}" ORG="https://YourOrgID.crm.dynamics.com" API="$ORG/api/data/v9.1" curl -s -X GET "$API/dvtablesearchs?\$select=dvtablesearchid,name,searchtype" \ -H "Authorization: $AUTH" \ -H "Accept: application/json"回應
{ "@odata.context": "https://YourOrgID.crm.dynamics.com/api/data/v9.1/$metadata#dvtablesearchs(dvtablesearchid,name,se…), "value": [ { "@odata.etag": "W/\"4277...\"", "dvtablesearchid": "15369...", "name": "User_Account_jSd6V...", "searchtype": 0 } ] }如果值
skill已存在,請在代理程式資訊清單檔案中使用該值。 如果值不存在,回應skill會包含空白陣列。回應
{ "@odata.context":"https://YourOrgID.crm.dynamics.com/api/data/v9.1/$metadata#dvtablesearchs(dvtablesearchid,name,searchtype)", "value":[] }如果不
skill存在,請建立DVTableSearch技能並使用您指派給它的名稱。要求
AUTH="Bearer {TOKEN}" ORG="https://YourOrgID.crm.dynamics.com" API="$ORG/api/data/v9.1" curl -i -X POST "$API/dvtablesearchs" \ -H "Authorization: $AUTH" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{ "name": "Account_SystemUser_Skill", "searchtype": 0, "DVTableSearch_DVTableSearch_DVTableSearch": [ { "name": "Account", "entitylogicalname": "account" } ] }'回應
要求傳回 204 無內容 ,表示
DVTableSearch已成功建立技能。HTTP/1.1 204 No Content再次執行步驟 3 中的 curl 要求,以檢查現有
DVTableSearch的技能。 回應包含dvtablesearchid新建立skill的 。 您可以使用此值或name代理資訊清單檔案屬性中的skill值。
電子郵件
Email 知識可讓您將代理範圍限定為個人或共用信箱,並可選擇特定信箱資料夾。
新增電子郵件知識來源
如果您使用 Agent Builder 建立代理程式,請在 [知識] 區段的 [設定] 索引標籤上,選取 [我的電子郵件]。
注意
使用 Agent Builder 時,您目前無法將電子郵件的範圍限定為特定資料夾或共用信箱。
如果您使用代理程式工具組和 Visual Studio Code 建立代理程式,若要新增電子郵件知識,請將值新增至Email代理程式資訊清單檔案中的 capabilities 屬性,如下列範例所示。 您可以參考多個信箱資料夾,也只能參考一個共用資料夾。
注意
您必須使用 1.3 版 或更新版本的宣告式代理程式資訊清單架構,才能新增 Email 知識。
{
"capabilities": [
{
"name": "Email",
"shared_mailbox": "sample@service.microsoft.com",
"folders": [
{
"folder_id": "inbox"
}
]
}
]
}
在 [folder_id ] 欄位中,您可以參考已知的資料夾名稱或資料夾 ID。 如需已知資料夾名稱的清單,請參閱 mailFolder resource type。 若要取得資料夾識別碼的清單,請在 Graph 總管中使用下列查詢:
https://graph.microsoft.com/v1.0/me/mailFolders
在 [shared_mailbox ] 欄位中,使用共用信箱的 SMTP 位址。
在 [group_mailboxes ] 欄位中,您可以指定最多 array 25 () 的字串,其中包含您希望代理限定範圍的共用信箱或 Microsoft 365 群組的 SMTP 位址。
如果您同時參考共用信箱和資料夾,代理程式會將回應範圍設定為共用信箱內的資料夾。 如果您只參照資料夾,代理程式會將回應範圍限定為個人信箱內的資料夾內容。
如果您不參考共用信箱或資料夾,代理程式搜尋的範圍不會限定為任何資料夾或信箱,它會根據使用者的查詢從所有電子郵件內容傳回結果。
人員
讓您的客服專員以 People 資料為基礎,以提供更個人化和上下文感知的回應。 People Data 結合有關個人的公開資訊,例如姓名、職位、技能和組織關係,以及使用者連線、共同作業者和相關見解的個人檢視。 此知識來源可讓代理程式:
- 查詢使用者和同事設定檔,包括報告結構和聯絡詳細資訊。
- 識別組織內的領域專家和關鍵合作者。
- 根據使用者的關係、過去的互動和偏好來個人化回應。
- 提供針對特定團隊或個人量身打造的建議和溝通技巧。
新增人員知識來源
如果您使用 Copilot Studio 建立代理程式,則預設會針對擁有 Microsoft 365 Copilot 授權的使用者啟用 People 知識來源。
如果您使用代理程式工具組和 Visual Studio Code 建立代理程式,請將值新增至People代理程式資訊清單檔案中的 capabilities 屬性,以啟用人員知識,如下列範例所示。 僅聲明基本 People 功能可讓客服專員 僅根據基本組織資料 進行推理,例如 設定檔卡片中可用的資料。 若要包含代理程式使用者與組織中參照人員之間的相關團隊訊息、電子郵件和檔案等內容,請參閱版本 1.6 以使用 include_related_content 屬性。
注意
若要新增知識來源 (People 而不) 相關內容,請使用 1.3 版 或更新版本的宣告式代理程式資訊清單架構。 若要使用此 include_related_content 屬性,請使用 版本 1.6 或更新版本。
{
"capabilities": [
{
"name":"People"
}
]
}
如果您的客服專員需要推理客服專員使用者與參考人員之間的相關內容 () ,例如相關團隊訊息、電子郵件和檔案,請利用該 include_related_content 屬性。 預設值為 false。
{
"capabilities": [
{
"name":"People",
"include_related_content": true
}
]
}
OneNote 頁面
當您使用 Microsoft 365 Copilot 建立代理程式時,您可以從檔案選擇器中選擇特定的 OneNote 頁面,以作為知識上傳。 您只能選取個別的 OneNote 頁面。 選取整個 OneNote 筆記本的選項無法使用。
使用檔案選擇器來新增 OneNote 頁面。 Agent Builder 不支援輸入 OneNote 頁面 URL。
Teams 訊息
您可以設定代理程式使用 Teams 頻道、會議聊天、群組聊天和一對一聊天做為知識來源。 您可以選擇指定最多五個頻道、群組、1:1 或會議聊天的連結,以設定 Copilot 搜尋的範圍,或是允許代理程式使用使用者的 Teams 內容,包括頻道、會議以及個人和群組聊天,做為知識來源。
代理程式可以傳回 Teams 訊息中共用檔案的連結,但無法傳回儲存在 Teams 頻道中的檔案連結,除非代理程式也已 OneDriveAndSharePoint 啟用。 如需如何為 Copilot 最佳化 SharePoint 內容的相關資訊,請參閱最佳 化內容擷取。
新增 Teams 訊息知識來源
如果您使用 Agent Builder 建立代理程式,請在 [設定 ] 索引標籤的 [知識] 區段中,選取搜尋列,然後選擇 [ 我的 Teams 聊天和會議]。 若要將代理程式範圍限定為特定頻道、會議或群組聊天,請在 [ 聊天 ] 索引標籤上,選取您要新增為知識的聊天。
如果您使用代理程式工具組和 Visual Studio Code 建立代理程式,若要啟用 Teams 訊息知識,請將值新增至TeamsMessage資訊清單參考中的 capabilities 屬性。 如果您想要將 Teams 知識的範圍設定為最多五個 Teams 資源,請新增 urls 屬性的連結,如下列範例所示。
注意
您必須使用 1.3 版 或更新版本的宣告式代理程式資訊清單架構,才能新增 TeamsMessage 知識來源。
{
"capabilities": [
{
"name": "TeamsMessages",
"urls": []
}
]
}
取得頻道或會議的 URL
若要取得 Teams 頻道的 URL,請選擇頻道名稱旁的三個點 (...) ,然後選擇 [取得頻道連結]。
若要取得 Teams 會議的 URL,請開啟會議,選擇 [加入] 旁的箭號,然後選擇 [ 複製加入連結]。
取得群組或一對一聊天的 URL
若要取得群組或一對一聊天的 URL,您需要包含 chatId 的深層連結。 深層連結採用下列格式: https://teams.microsoft.com/l/chat/<chatId>/conversations。 每個聊天的 chatId 值都不同。
若要取得群組或一對一聊天的 chatId 值:
- 在 Microsoft Teams 中,移至聊天中的任何訊息。
- 將游標停留在郵件上,然後選擇三個點 (...) 。
- 選取 複製連結。
- 將連結貼到 [記事本] 或類似的應用程式中。 連結看起來類似下列 URL:
https://teams.microsoft.com/l/chat/19:12ab3c4d-a123-12a3-a123-123ab12c12de_12a3bcd4-1234-1234-123a-1b2345c678d9@unq.gbl.spaces//1743033793614?context=%7B%22contextType%22%3A%22chat%22%7D。 - 複製介於
chat/和下一個/之間的 URL 區段。 該區段通常以 開頭。19:這是 chatId。 在上述範例中, chatId 為19:12ab3c4d-a123-12a3-a123-123ab12c12de_12a3bcd4-1234-1234-123a-1b2345c678d9@unq.gbl.spaces。 - 將 chatId 新增至深層連結。 例如:
https://teams.microsoft.com/l/chat/19:12ab3c4d-a123-12a3-a123-123ab12c12de_12a3bcd4-1234-1234-123a-1b2345c678d9@unq.gbl.spaces/conversations。
如需詳細資訊,請參閱 Teams 聊天的深度連結。
Teams 會議
使用 Teams 會議知識,您可以將代理程式限定為回答會議相關問題,包括單一會議或會議系列。 例如,您的代理程式可以回應諸如「回顧昨天的會議並列出動作項目」或「在我的會議中對 Project X 有何評論?」之類的查詢。 您可以選擇將此知識來源的範圍設定為最多五個特定會議。 此知識來源可讓代理程式存取會議中繼資料 (主題、召集人、出席者和標題) 、文字記錄內容和會議聊天。
注意
參照會議系列僅限於該系列的最後四個執行個體。
新增會議知識來源
如果您使用 Agent Builder 建立代理程式,請在 [設定 ] 索引標籤的 [知識] 區段中,選取搜尋列,然後選擇 [ 我的 Teams 聊天和會議]。 Agent Builder 即將推出將範圍縮小到 [會議] 的功能。
如果您使用代理程式工具組和 Visual Studio Code 建立代理程式,若要啟用會議知識,請將值新增至Meetings代理程式資訊清單檔案中的功能屬性,如下列範例所示。 如果您想要將代理程式的範圍限定為特定會議,請將會議的 UID 新增至 items_by_id 屬性。 如需尋找會議識別碼的指示,請參閱 取得會議識別碼。
注意
您必須使用 1.6 版 或更新版本的宣告式代理程式資訊清單架構,才能新增 Meetings 知識來源。
{
"capabilities": [
{
"name":"Meetings",
"items_by_id": [
{
"id": "010000002300A00045B6C7890D12E0030000000040056F7GH890IJ01000000000000000020000000J3L45M6A7NO8PQ9R0S12TUV340XY5Z00",
"is_series": true
}
]
}
]
}