- 首頁
- /
- 文章
與微軟 Copilot 整合可讓 Webex 會議使用者安全地連線到他們的 Microsoft Copilot 帳戶作為其資料來源之一。
摘要
透過在 Webex 應用程式中利用 Cisco AI Assistant,使用者可以搜尋、分析和匯總來自 Microsoft 資料來源(包括 SharePoint、OneDrive 和 Copilot Connectors)的結果。
架構概述
連線到 Microsoft Copilot 後,您可以使用 Microsoft 檢索 API 與 Microsoft 資料來源互動。使用 Cisco AI Assistant 時,它可以即時從您的 Microsoft 資料來源檢索資料。
Webex 不會儲存或保留透過 Cisco AI Assistant 傳回給您的資料。資料僅在產生您的回覆時使用,確保您的隱私始終受到保護。
詳細資料流步驟
使用者管理和分配
管理員可以使用控制中心管理擁有 Microsoft Copilot 授權的用戶,並啟用或停用組織、用戶或範本層級的該功能。
用戶授權和連接
-
使用者登入 Webex 應用
-
使用者導航至 設定 頁面以連接其 Microsoft 帳戶。
使用者完成授權程序並選擇要存取的來源(SharePoint、OneDrive 或 Copilot Connector)。
問答工作流程
用戶提出問題,例如:ABC專案進度如何?
以下步驟將由 Webex 會議服務分多個子步驟執行:
-
解密: 系統解密請求。
-
載入上下文: 相關上下文已載入。
-
法學碩士推理: LLM 重寫問題以達到最佳檢索效果。
-
取得整合資訊: 系統檢索配置和令牌以進行多路徑搜尋。
-
多路徑搜尋: 系統透過支援的 Microsoft 工具執行檢索。
-
搜尋: 多路徑檢索工具可搜尋詳細內容。
-
返回搜尋結果: 多路徑檢索工具傳回搜尋結果。
-
-
重新排名 & 過濾: Webex 會議服務使用 LLM 對內容進行重新排序和篩選,以提高相關性。
-
一代: LLM產生帶有引用的最終答案。
-
回答: 最終答案將會發佈到 Webex 應用程式。
資料處理
資料處理
此功能使用以下資料和服務設定資訊來管理授權、檢索已授權的 Microsoft 365 內容,並在 Webex 應用程式中提供回應:
-
Microsoft 應用程式註冊:
Microsoft 應用程式註冊代表在 Microsoft Azure 入口網站(Entra ID)中註冊的 OAuth 2.0 用戶端配置,用於 Cisco AI Assistant 整合。
此註冊定義了 Microsoft 帳戶授權流程中所需的特定委派權限:
-
Read.All 和 Sites.Read.All: 存取 SharePoint 和 OneDrive 內容所必需。
-
ExternalItem.Read.All: 存取 Copilot Connectors 內容所必需。
Cisco AI Assistant 使用此註冊資訊來尋找正確的 OAuth 設定以進行登入和令牌獲取,然後再呼叫 Microsoft 365 Copilot Retrieval API。有關更多信息,請參閱“在 Microsoft Azure 中註冊 Cisco AI Assistant”。
-
-
Microsoft OAuth 令牌:
Microsoft OAuth 令牌是 Microsoft Entra ID 在使用者透過 Webex App 設定頁面登入其 Microsoft 帳戶並授予必要權限後頒發的短期委託存取權杖。
Cisco AI Assistant 使用這些令牌代表使用者呼叫 Microsoft 365 Copilot Retrieval API。Microsoft Entra ID 使用這些令牌來驗證每個要求,識別用戶,並強制執行 Microsoft 365 存取控制和資訊屏障策略,確保只傳回已登入使用者有權存取的內容。
代幣續期
在初始授權時,Microsoft Entra ID 會頒發一個有效期較短的存取權杖(有效期約 60-90 分鐘)和一個有效期較長的刷新令牌。Webex 將刷新令牌安全地儲存在伺服器端,並與使用者的 Webex 身分綁定。
訪問令牌不會持續更新。相反,當使用者提交請求時,Webex 會檢查目前的存取權杖是否仍然有效。如果刷新令牌已過期,Webex 會靜默地將其替換為新的存取權杖。每次使用刷新令牌,其有效期都會延長,只要該功能被定期使用,會話就可以在無需用戶幹預的情況下保持活動狀態。
會話終止
在以下情況下,會話已終止,需要重新進行身份驗證:
-
不活躍: 使用者已長時間未使用此功能(通常為 90 天,視 Microsoft Entra ID 預設政策和客戶的租用戶設定而定。
-
手動斷開連線: 使用者明確地將其 Microsoft 帳戶與 Webex 應用程式設定斷開連線。
-
行政: Microsoft 365 管理員撤銷了 Entra ID 中應用程式的存取權限。
-
配置變更: 已授予的權限範圍已修改,或應用程式註冊已更改。
更多資訊請參閱「Webex App 中的 Microsoft 帳戶授權」。
-
-
提示文字:
提示文字是指使用者在 Cisco AI 助理內輸入的自然語言,例如尋找專案狀態或在其 Microsoft 帳戶中尋找文件的請求。此文字由使用者在運行時產生。
處理工作流程
當收到提示時,思科人工智慧助理會依照以下步驟檢索並呈現資訊:
-
解釋與優化: 助手會解讀提示,進行推理,並執行查詢重寫,以產生最佳化的查詢字串。
-
API 呼叫: 此助理會針對一個或多個資料來源呼叫 Microsoft 365 Copilot 檢索 API。
-
過濾: 在適用的情況下,可以使用關鍵字查詢語言 (KQL) 篩選表達式將檢索範圍限定在特定網站、文件庫、文件類型或日期範圍。
-
重排序與綜合: 助手會對傳回的文字區塊進行重新排序和篩選。然後,它會產生一個最終回應,將原始提示與檢索到的內容結合起來,包括指向原始文件的引用。
-
-
SharePoint 和 OneDrive 內容: SharePoint 和 OneDrive 內容是經過授權的 Microsoft 365 數據,透過 Microsoft 365 Copilot Retrieval API 檢索以回應使用者請求。檢索 API 直接從 Microsoft 365 混合內容索引中提取相關文字區塊,而無需複製、匯出或單獨索引任何資料。
支援的文件類型:.docx 、.pptx、.pdf、.aspx 和 .one;不支援圖像和圖表等非文字內容。
所有內容均在 Microsoft 365 信任邊界內檢索,並且嚴格限於已登入使用者根據 Microsoft 365 權限模型有權存取的文件和文件。
-
要求: https://graph.microsoft.com/v1.0/copilot/retrieval, Cisco AI Assistant 傳送 HTTPS POST 要求,並在 Authorization 標頭中攜帶 Microsoft Entra ID 委託存取權杖。請求正文包含:
-
queryString-根據使用者提示產生的重寫自然語言查詢(最多 1500 個字元)。
-
dataSource—設定為 SharePoint 或 OneDrive(每個請求一個;每個來源都會單獨發出呼叫)。
-
filterExpression(可選)—KQL 表達式,用於依網站 URL、路徑、檔案類型或日期範圍進行篩選。
-
maximumNumberOfResults—每次呼叫最多 25 個結果。
-
-
回覆: Microsoft 365 在其信任邊界內處理請求,並傳回一個 retrievalHits 數組,其中每個項目包含:
-
contentChunk-從內容索引中擷取的文字片段
-
相關分數-查詢與資料區塊之間的餘弦相似度得分,歸一化到 0-1 範圍內。
-
資源——來源元數據,包括檔案名稱、URL、作者和最後修改日期
-
-
資料處理: 不會傳輸完整的文件內容-只會傳回從 Microsoft 365 混合索引中預先擷取的文字區塊。Cisco AI Assistant 會將這些資料區塊暫時傳遞給其 LLM 進行重新排序、篩選和答案產生。來源元資料用於在最終回復中建立引用。Webex 不會將文字區塊儲存到請求持續時間之外。
-
-
副駕駛連接器內容: Copilot Connectors 內容是指透過 Microsoft Graph 連接器匯入 Microsoft 365 內容索引中的第三方或自訂企業數據,並透過 Microsoft 365 Copilot Retrieval API 進行檢索。傳回的內容僅限於已登入使用者根據連接器在 Microsoft 365 中配置的權限有權存取的項目。
-
要求: https://graph.microsoft.com/v1.0/copilot/retrieval, Cisco AI Assistant 傳送 HTTPS POST 要求,並在 Authorization 標頭中攜帶 Microsoft Entra ID 委託存取權杖。請求正文包含:
-
queryString-根據使用者提示產生的重寫自然語言查詢(最多 1500 個字元)。
-
dataSource 設定為 CopilotConnectors。
-
filterExpression(可選)—KQL 表達式,用於將檢索範圍限定到特定的連接器來源或內容類型。
-
maximumNumberOfResults—每次呼叫最多 25 個結果。
-
-
回覆: Microsoft 365 在其信任邊界內處理請求,並傳回一個 retrievalHits 數組,每個條目包含:
-
contentChunk-從已索引的第三方內容中提取的文字片段。
relevanceScore—查詢和資料區塊之間的餘弦相似度得分,歸一化為 0-1 範圍。請注意,並非所有 Copilot Connector 結果都顯示相關性評分。
資源—來源元數據,包括專案名稱、URL 和連接器定義的屬性。
-
-
-
資料處理: 不會傳送完整的來源內容-只會傳回從 Microsoft 365 內容索引中預先擷取的文字區塊。由於檢索 API 每次調用只針對一個資料來源,因此 Cisco AI Assistant 會分別向 SharePoint、OneDrive 和 Copilot Connectors 發出檢索調用,並在重新排序步驟中合併結果。
文字區塊會暫時傳遞給 LLM 進行重新排序、過濾和產生答案,Webex 不會在請求持續時間之外儲存這些文字區塊。
身份驗證和授權
Webex 使用 Microsoft Retrieval API 與您的 Microsoft 帳戶和內容進行交互,該 API 由 Microsoft 身分提供者 (IdP) 進行驗證和管理。與 Microsoft IdP 和檢索 API 的所有通訊均受 TLS 安全連線保護。
Webex 服務驗證
Webex App 中的 Cisco AI Assistant 利用標準的 OAuth 2.0 流程與 Webex 服務互動:
-
身分提供者: Webex身分服務作為基於雲端的身分提供者,用於驗證使用者身分並授權API存取。
-
持有者代幣: 對 Webex API 的請求使用 Webex 身分識別服務所頒發的持有者令牌進行授權。
-
安全通訊: Webex AI Assistant、Webex Identity Service 和 Webex API 之間的所有資料交換均透過 TLS 安全連線進行。
行政要求
要啟用此集成,管理員必須完成以下步驟:
-
Microsoft 365 設定: 管理員必須為相關使用者指派相應的 Microsoft Copilot 授權。
-
Webex 設定: 管理員可以直接在 Control Hub 中啟用或停用組織、使用者或範本層級的此功能。
使用者同意的權限
安裝過程中,需要以下權限:
| 需要權限 | 用途 |
|---|---|
| Webex 應用程式登入並查看使用者個人資料 | 使用您的帳戶登入 Webex 應用程式。 |
| 授權並登入您的 Microsoft 帳戶 | 驗證並授權 Webex App 連線到您的 Microsoft 帳戶。 |
這些權限僅在設定過程中使用,不會被儲存。
服務權限
無需任何特定服務權限。管理員可以在控制中心管理此功能和設置,詳情如下。
在控制中心中整合副駕駛功能管理和授權
管理員可以為自己的組織啟用或停用此功能,或者他們可以透過複選框決定可以授予哪些一個或多個來源權限。
更多信息,請參閱 在 Control Hub 中設定 AI 整合 和 在 Webex App 中啟用或停用 Cisco AI Assistant 搜尋來源
Webex App 設定和配置
管理員啟用此功能後,使用者即可登入 Webex 應用程式並授權連接 Microsoft 帳戶(透過控制中心授權)。