- 主页
- /
- 文章
与微软 Copilot 集成允许 Webex 会议用户安全地将他们的微软 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 权限模型有权访问的文件和文档。
-
要求: Cisco AI Assistant 向 https://graph.microsoft.com/v1.0/copilot/retrieval, 发送 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 中配置的权限有权访问的项目。
-
要求: Cisco AI Assistant 向 https://graph.microsoft.com/v1.0/copilot/retrieval, 发送 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 帐户(通过控制中心进行授权)。