通过

在Microsoft 365 管理中心中设置Microsoft Graph 连接器

  • 项目

本文概述了在Microsoft 365 管理中心中设置Microsoft Graph 连接器的步骤。 简化了设置过程，只需极少量的输入即可简化连接创建。 但是，可以选择自定义设置来微调特定设置。

注意

所有 Microsoft Graph 连接器的安装过程都类似，但并不完全相同。 除了阅读本文外，请务必阅读数据源的连接器特定信息。

注意

最多可以向每个租户添加 30 (30) Microsoft Graph 连接。

提示

产品调查

为了帮助我们了解与将更多数据源连接到 Copilot 或Microsoft搜索相关的要求，我们要求你花几分钟时间填写此 调查表。 根据调查结果，Microsoft将为需求最高的数据源生成连接器。

先决条件

在开始之前，请确保以下各项：

  • 管理员 Access：必须在 M365 管理中心中具有以下角色之一才能配置 Graph 连接器 - 全局管理员、搜索管理员或 Copilot 管理员。
  • 数据源凭据： 为要连接的数据源收集必要的凭据和权限。
  • 服务帐户 (（如果适用）) ： 如果数据源需要服务帐户，请确保它具有必要的角色或权限。

步骤 1：添加Microsoft Graph 连接器

完成以下步骤以配置任何Microsoft Graph 连接器 (或 单击此处 直接访问连接器目录) ：

可用的数据源包括：ADLS Gen2、企业网站、Microsoft SQL Server、Azure SQL、Oracle SQL 数据库、ServiceNow 知识、ServiceNow 目录、文件共享、Azure DevOps 和 MediaWiki。

  1. 打开Microsoft 365 管理中心：

  2. 导航到“设置”：

    • 在左侧导航窗格中，选择“设置”。
    • 单击“搜索”& 智能。

  3. 添加新数据源：

    • 转到 “数据源”选项卡。
    • 单击“ +添加”。
    • 从可用连接器列表中，选择要连接的数据源， (例如 ServiceNow Knowledge、Salesforce 等 ) 。

步骤 2：输入基本连接详细信息

显示适用于 ServiceNow Knowledge 的 Microsoft Graph 连接器的连接创建屏幕的屏幕截图

  1. 显示名称：

    • 若要帮助用户识别 Copilot 和搜索结果中的源，请输入名称以标识连接器。
    • 提供了默认名称，但你可以自定义它以满足组织的需求。

  2. 数据源 URL：

    • 提供数据源的 URL。 例如，如果要连接到 ServiceNow，URL 可能类似于 https://your-organization-name.service-now.com。

  3. 身份验证类型：

    • 选择用于访问数据源的身份验证方法。

  4. 面向有限受众推出

    • 最初，可以将连接器部署到部分用户，以便在 Copilot 和其他搜索图面中进行验证。 此功能允许在更广泛的推出之前测试集成。

注意

对于大多数连接器，默认设置针对数据源进行优化。 这些设置包括访问权限、架构和同步频率。 如果要编辑这些设置中的任何一个，则需要选择 “自定义设置” 选项。

步骤 3：创建连接

  • 单击“ 创建 ”以设置连接。 连接器开始使用默认设置为数据源中的内容编制索引。

显示图形连接器创建成功后成功屏幕的屏幕截图

创建连接后，可以在成功屏幕中添加连接说明。 为了帮助 Copilot 增强用户的连接结果，说明应简要回答以下问题：

  • 此连接包含哪些类型的内容？
  • 用户在各自的组织中如何引用此内容源？
  • 用户在日常工作中引用此内容的工作流的哪一部分？
  • 内容有哪些特征？

若要了解详细信息，请参阅使用 Graph 连接器内容增强Microsoft Copilot发现一文。

自定义安装 (可选)

希望更好地控制配置的管理员可以选择 “自定义安装” 选项。 此选项提供对三个选项卡的访问权限，以获取详细设置： “用户”、“ 内容”和 “同步”。

用户

显示“用户”选项卡的屏幕截图，可在其中配置访问权限和用户映射规则

  1. 访问权限：

    • 选择索引数据是否对以下对象可见：
      • 组织中的每个人。
      • 仅有权访问数据源中内容的人员。

  2. 映射标识：

    • 默认情况下，通过检查数据源中的电子邮件是否与 UserPrincipalName 或 Mail Microsoft Entra ID 匹配来映射用户。
    • 如果此默认值不适用于组织，请提供自定义映射公式。

内容

显示“内容”选项卡的屏幕截图，可在其中配置“查询字符串”和“属性

  1. 管理属性：

    • 配置数据源中的属性，例如使它们可搜索、可查询或可精简。
    • 分配语义标签和别名以增强搜索相关性。

    有关管理属性的详细信息，请参阅 下文。

同步

显示“同步”选项卡的屏幕截图，可在其中配置爬网频率

刷新间隔：

  • 配置数据源和 Graph 连接器索引之间的数据同步频率。

    • 完全爬网： 按计划间隔同步所有数据。
    • 增量爬网：仅汇报已更改或新数据。

  • 根据需要调整组织的默认同步设置。

    有关同步设置的详细信息，请参阅 下文。

更多资源

“管理属性”指南

Content 属性

建议从选项的下拉菜单中选择 内容属性 ，或者保留默认值（如果存在）。 此属性用于内容的全文索引、搜索结果页代码段生成、 结果群集 参与、语言检测、HTML/文本支持、排名和相关性以及查询表述。

如果选择内容属性，则可以在创建结果类型时选择使用系统生成的属性 ResultSnippet。 此属性用作在查询时从内容属性生成的动态代码段的占位符。 如果在结果类型中使用此属性，则会在搜索结果中生成代码片段。

源属性的别名

可以在“别名”列下向属性添加别名。 别名是属性的友好名称。 它们用于查询和筛选器的创建。 它们还用于规范化来自多个连接的源属性，以便它们具有相同的名称。 这样，就可以为具有多个连接的垂直区域创建单个筛选器。 有关详细信息，请参阅 自定义搜索结果页。

源属性的语义标签

可以将语义标签分配给源属性。 标签是由提供语义意义的Microsoft提供的已知标记。 它们允许Microsoft将连接器数据集成到 Microsoft 365 体验中，例如 Copilot、增强搜索、人员卡片、智能发现等。

下表列出了当前支持的标签及其说明。

标签 说明
title 要显示在搜索和其他体验中的项的标题
url 源系统中项的目标 URL
创建者 创建项的人员的姓名
最后一次修改者 最近编辑项目的人员的姓名
Authors 参与/协作处理项目的人员的姓名
创建日期时间 创建项的时间
上次修改日期时间 最近编辑项的时间
文件名 文件项的名称
文件扩展名 文件项的类型，例如 .pdf 或 .word

此页上的属性是基于数据源预先选择的，但如果存在更适合特定标签的其他属性，则可以更改此选择。

标题 标签为最重要的标签。 强烈建议将属性分配给此标签，以便连接参与结果群集体验。

不正确的映射标签会导致搜索体验恶化。 某些标签没有为其分配属性是可以的。

搜索架构属性

可以设置搜索架构属性来控制每个源属性的搜索功能。 搜索架构有助于确定搜索结果页面上显示的结果以及最终用户可以查看和访问的信息。

搜索架构属性包括 “查询”、“ 搜索”、“ 检索”和 “优化”选项。 下表列出了Microsoft Graph 连接器支持的每个属性，并说明了其功能。

搜索架构属性 函数 示例
搜索 使属性的文本内容可搜索。 属性内容包含在全文索引中。 如果 属性是 title，则 Enterprise 查询将返回在任何文本或标题中包含 “企业 ”一词的答案。
查询 按查询搜索特定属性的匹配项。 然后，可以在查询中以编程方式或逐字指定属性名称。 如果可以查询 Title 属性，则支持查询 Title： Enterprise 。
取回 只有可检索的属性才能在结果类型中使用，并在搜索结果中显示。
完善 精简选项可在“Microsoft搜索结果”页上使用。 如果在连接设置过程中标记了 refine 属性，组织中的用户可以在搜索结果页上按 URL进行筛选。

对于除文件共享连接器之外的所有连接器，必须手动设置自定义类型。 若要激活每个字段的搜索功能，需要一个映射到属性列表的搜索架构。 连接配置助手根据所选的源属性集自动选择搜索架构。 可以通过在搜索架构页上为每个属性和属性选择检查框来修改此架构。

显示可通过添加或删除查询、搜索和检索函数来自定义连接器架构的屏幕截图。

搜索架构设置的限制和建议

  • 内容属性仅可搜索。 在下拉列表中选择该属性后，该属性不能与 检索 或 查询选项一起使用。

  • 使用 内容 属性呈现搜索结果时，会出现严重的性能问题。 例如，ServiceNow 知识库文章的“文本内容”字段。

  • 只有标记为可检索的属性才会呈现在搜索结果中，并且可用于创建新式结果类型 (MRT) 。

  • 只能将字符串属性标记为可搜索。

注意

若要在创建连接后更新架构，请参阅 管理搜索架构 一文。

同步设置指南

刷新间隔确定数据在数据源与Microsoft搜索之间同步的频率。 每种类型的数据源都有一组不同的最佳刷新计划，具体取决于数据的修改频率和修改类型。

有两种类型的刷新间隔： 完全刷新 和 增量刷新，但增量刷新不适用于某些数据源。

通过完全刷新，搜索引擎将处理内容源中已更改的项目并编制索引，而不考虑以前的爬网。 完全刷新最适合以下情况：

  • 检测删除数据。
  • 增量刷新发现错误并失败。
  • 已修改 (访问控制 Lists) ACL。
  • 已修改爬网规则。
  • 更新了连接的架构。

使用 增量刷新，搜索引擎只能处理自上次成功爬网以来创建或修改的项目并编制索引。 因此，并非所有内容源中的数据都重新编制索引。 增量刷新最适合检测内容、元数据和其他更新。

注意

增量爬网当前不支持处理 权限更新。

增量刷新比完全刷新更快，因为不会处理未更改的项。 但是，如果选择运行增量刷新，仍需要定期运行完全刷新，以在内容源和搜索索引之间保持正确的数据同步。

爬网计划

可以根据“刷新设置”页上提供的高级计划选项配置完全爬网和增量爬网。 某些连接器不支持增量爬网，配置增量爬网的选项将不适用于这些连接器。 对于其他人，增量爬网是可选的爬网，默认情况下已启用。 默认情况下，将根据连接器类型为你选择爬网计划。 此默认设置可以在连接创建期间更改，也可以在从连接的“编辑”流发布连接后进行编辑。 可以从以下字段中选择：

  • 定期：可以选择每天、每周、第 2 周或第 4 周运行爬网。
  • 日 () ：选择仅在一周中的特定日期运行爬网时，将启用此选项。
  • 每天运行一次检查框，你可以选择一天中的爬网开始时间。 如果未选中，则爬网将在一天内默认重复。 可以从下拉列表中选择重复间隔。
  • 频率：如果要在特定时间间隔后一天内重复爬网，请选择此选项。 最小重复频率为 15 分钟，最大为 12 小时。
  • 开始时间：选择要开始爬网的时间。
  • 重置：此选项会将计划重置为连接器的默认计划。

显示示例配置设置的屏幕截图。

配置爬网计划时，需要注意以下几点：

  • 如果将任何字段留空或未选中，图形连接器将选择开始爬网的最佳时间。 例如，如果选择爬网“定期”作为“Day”而不选择开始时间，则 Graph 连接器会根据上次爬网选择时间以开始新的爬网。 如果不想指定爬网的开始时间，最好让连接器决定何时开始爬网。
  • 即使提到开始时间，爬网开始时间也可能延迟一小时。 此延迟可能是由于网络负载等原因造成的。
  • 如果上一次爬网超过到下一次爬网的时间，我们不会停止正在进行的爬网并将下一次爬网排队。 正在进行的爬网完成后，仅当队列爬网的类型与上一个爬网不同 (完整/增量) 时，我们才运行排队爬网。 例如，如果增量爬网超过下一个完全爬网，则我们不会暂停增量爬网并将完全爬网排队。 增量爬网完成后，由于排队爬网属于不同类型的 (完全) ，因此我们立即开始完全爬网。

下面是一些方案：

  • 每 15 分钟后每天运行一次增量爬网

显示每 15 分钟后每天运行增量爬网的屏幕截图。

在这里，选中“每天运行一次”复选框，可以选择“开始时间”，从指定时间开始，一天中只运行一次增量爬网。 但是，取消选择它会让你选择一天内爬网重复的频率。 如果希望连续刷新数据，可以选择在一天内频繁运行增量爬网。 但是，如果数据源中的项数很大，爬网往往更长，或者如果内容不需要频繁更新，则可以选择每天运行一次增量爬网。

显示每天下午 2：00 运行增量爬网的屏幕截图

  • 每周在周三、周六和周日运行增量爬网，每 15 分钟重复一次，从凌晨 1：00 开始

显示每周在周三、周六和周日运行增量爬网的屏幕截图，每 15 分钟重复一次，从凌晨 1：00 开始。

  • 每天凌晨 1：00 运行完全爬网

显示每天凌晨 1：00 运行完全爬网的屏幕截图。

  • 每周五晚上 8：00 运行完全爬网

显示每周星期五晚上 8：00 运行完全爬网的屏幕截图。