将SharePoint添加为知识源

SharePoint知识源的工作原理是将代理与SharePoint URL 或SharePoint列表配对。 本文介绍在 Add knowledge 对话框中选择 SharePoint 选项提供的完整SharePoint集成功能。

注释

  • “添加知识 ”对话框中,有两个 SharePoint 选项。 文件上传部分中的 SharePoint 选项用于上传单个 SharePoint 文件或文件夹,并启用文件同步功能。 本文介绍在 Copilot Studio 中,SharePoint 选项提供了 SharePoint 的完全支持。

  • 有关限制和支持的 SharePoint 功能的列表,请参阅 SharePoint Web 应用限制

  • 若要添加单个 SharePoint 文件或文件夹,请参阅 “添加 SharePoint 文件和文件夹”。

  • 使用SharePoint作为知识源的代理响应不包括在 conversation 脚本中。

  • 对于以SharePoint知识源为基础的代理,Turn on Work IQ提供更好的知识检索和响应质量。 此功能采用了先进的内部检索工具,使经纪人能够以更高的精度获得更大量的上下文信息。 然而,由于系统复杂度的增加,某些用户和查询可能会经历一定的延迟增加。

当您发布智能体时,使用生成式应答的调用将代表与智能体聊天的用户使用智能体中配置的身份验证设置进行。 默认情况下,在 Copilot Studio 和 Microsoft Teams 中创建的代理使用 Authenticate 和 Microsoft 身份验证选项进行配置,该选项适用于Microsoft Teams、Power Apps和智能 Microsoft 365 Copilot 副驾驶®等环境。

注释

可以在Microsoft Teams聊天中使用生成式答案和SharePoint数据,无需手动身份验证。 若要对以前发布的代理使用此方法,请重新配置代理以将 Authenticate 与 Microsoft 配合使用,然后将其再次发布到Microsoft Teams。 可能需要几个小时的时间才能使此更改生效。 如果用户正在对话中,但更改似乎尚未生效,他们可以在对话框中输入“重新开始”,以强制对话使用最新版本的代理重新启动。 这些更改现在可用于用户与客服代表之间的 Teams 1:1 聊天。 它们尚不适用于群聊或频道消息。

如果要对智能体使用手动身份验证,请参阅 高级身份验证方案

将 SharePoint 网站添加为知识源

当用户提出问题并且智能体没有用于回答的主题时,智能体会搜索 URL 和所有子路径。 例如,contoso.sharepoint.com/sites 等 URL 还包括 contoso.sharepoint.com/sites/policies 等子路径。 生成式回答将这些内容总结成有针对性的回答。

若要将 SharePoint 网站添加为知识源,请执行以下步骤:

  1. 打开代理。

  2. 概述知识页面,或生成式答案节点属性中选择添加知识

  3. “特别推荐 ”部分中,选择 “SharePoint”。

    “添加知识”对话框的屏幕截图,其中突出显示了 SharePoint 选项。

  4. 提供SharePoint URL。 使用手动换行符分隔多个 URL(使用 Shift + Enter)。

  5. 添加名称和说明。 描述应尽可能详细,尤其是在启用生成式人工智能的情况下,因为描述有助于生成式流程编排

  6. 选择 “添加到代理” 以完成添加知识源。

将 SharePoint 列表添加为知识源

SharePoint 列表是存储表格数据并提供快速、轻松访问信息的常用方法。 您的代理可以将这些列表用作知识来源。 通过将 SharePoint 列表添加为知识源,可以创建与源的实时连接,以便将最新的数据用于查询和推理。 用户使用 SharePoint 凭据进行身份验证,这可确保他们在代理提供响应之前有权访问数据。

  1. 打开代理。

  2. 概述知识页面,或生成式答案节点属性中选择添加知识

  3. “特别推荐 ”部分中,选择 “SharePoint”。

  4. 选择 “浏览项目 ”以查找所需列表,或输入特定 SharePoint 网站的 URL。

    选择 SharePoint 选项后,“添加知识”对话框的屏幕截图,其中突出显示了“浏览项”并输入 URL 选项。

  5. 选择“ 浏览项”时,对话框会自动填充 “我的列表 ”和“ 最近列表”。 “我的列表” 仅显示 SharePoint 列表应用中创建的列表。 所有其他列表都显示在 “最近列表”中。 如果没有看到所需列表,请打开SharePoint并访问列表,然后列表会显示在 Recent Lists 中。

    “添加知识”对话框的屏幕截图,选择 SharePoint 选项后,创建者选择了“浏览项目”选项以选择列表。

    一次最多可以选择 15 个列表。 每个列表作为单独的项目逐个添加到代理的知识源中。 若要向代理添加更多列表,请再次使用这些步骤并选择更多列表。

    注释

    如果要使用具有共享访问权限的SharePoint列表,但它不会显示在 Recent Lists 中,请将列表的 URL 粘贴到 URL 选择中。

  6. 选择所需列表后,选择“ 确认选择”。

  7. 添加名称和说明。 描述应尽可能详细,尤其是在启用生成式人工智能的情况下,因为描述有助于生成式流程编排

  8. 选择 “添加到代理” 以完成添加知识源。

高级身份验证场景

默认情况下,Copilot Studio 预配置代理,以便在用户通过Microsoft Teams、Power Apps或智能 Microsoft 365 Copilot 副驾驶®连接到代理时使用Microsoft身份验证来访问SharePoint源。 但是,如果需要手动配置身份验证,则需要执行以下步骤,以便生成的答案可以与 SharePoint 数据源一起使用。

重要

如果启用了受限SharePoint搜索,则会阻止使用SharePoint。

  • 在启用 SSO 的应用中,SharePoint 源的自动生成答案不适用于 guest 用户。

  • 要验证您的代理,请参阅 身份验证

  • 有关如何创建所需的Microsoft Entra ID应用程序注册的说明,请参阅使用 Microsoft Entra ID0 配置用户身份验证。 创建此注册时,您或您的管理员必须在 Microsoft Entra ID 应用注册中指定 Sites.Read.AllFiles.Read.All 范围。

  • 选择 No authentication指定代理不会从SharePoint检索信息。

  • 在配置身份验证时,权限范围影响用户访问。 在 Copilot Studio 中现有 Sites.Read.AllFiles.Read.All 值附近的作用域字段中指定 profileopenid。 使用代理时,这些范围不会向用户授予增加的权限,而是允许他们访问根据配置用于生成答案的SharePoint网站中的可允许内容。

  • SharePoint 支持具有以下身份验证服务提供商的手动身份验证设置:

    • Microsoft Entra ID
    • 使用联合凭据Microsoft Entra ID V2
    • Microsoft Entra ID V2 使用证书
    • Microsoft Entra ID V2 配客户端机密
  • SharePoint不支持使用泛型 OAuth 进行手动身份验证。

  • 此配置仅适用于生成式答案,不适用于 Power Platform 连接器。

筛选 SharePoint 数据源

开发者可以通过指定搜索查询参数来提升代理 SharePoint 知识源的性能。 这些查询参数定义了在知识源中搜索的内容。 例如,你可以指定只搜索过去六个月内被修改过的项目。 此类型的筛选器将构造为:

特征 Operator
Modified on on or after X date

SharePoint 知识源高级设置的截屏,展示了配置设置的示例。

创建筛选条件

添加SharePoint知识源后,可以设置搜索条件。

  1. “知识 ”页上,选择 SharePoint 源。

  2. 选择 SharePoint 源对应的三个点(),然后选择 编辑

  3. 选择高级设置

  4. 生成筛选器以包含或排除 SharePoint 知识源中的信息。 筛选器可以基于以下选择之一:

    • Title
    • 作者
    • 修改者
    • 修改日期
  5. 可以将条件的值设置为以下值之一:

  6. 完成筛选器配置后,选择“ 保存 ”。

如果要筛选SharePoint源,应关闭以下设置:

关闭这些设置可确保如果代理在筛选后的SharePoint知识源中找不到结果,它将以“没有响应”作为回复。