连接第三方数据源

注意 ：此功能为预览版，受 GCP 服务专用条款的“正式发布前产品条款”约束。我们对正式发布前产品和功能的支持可能比较有限，并且对正式发布前产品和功能的更改可能与其他正式发布前版本不兼容。如需了解详情，请参阅发布阶段说明。此外，使用此功能，即表示您同意生成式 AI 预览版条款及条件（“预览版条款”）。对于此功能，您可以按照云端数据处理附录中的说明处理个人数据，但受到协议中的适用限制和义务（如“预览版条款”中所定义）的约束。

本页介绍了如何将第三方数据源连接到 Vertex AI Search。

预览版：第三方连接器目前处于预览版阶段，需要通过许可名单授权。您必须列入许可名单才能使用此功能。

当您连接第三方数据源时，Vertex AI Search 会创建一个数据连接器，并为您指定的实体将数据存储区（称为实体数据存储区）与该连接器相关联。实体类型因您要连接的数据源而异。例如，Jira Cloud 实体包括问题、附件、评论和工作日志。

第三方数据源仅适用于通用搜索应用。Chat、推荐和客服应用无法使用第三方数据源。

第三方连接器与 CMEK 不兼容。

如需改为从 Google 数据源导入数据，请参阅创建搜索数据存储空间。

准备工作

1. 请与您的 Google 客户支持团队联系，请求将您添加到第三方数据源连接器的许可名单。

2. 前往您计划使用的来源对应的部分：

   • 关联 Adobe Experience Manager
   • 关联 AODocs（其他许可名单）
   • “Connect”框
   • 关联 Coda（额外的许可名单）
   • 关联 Confluence Cloud
   • 连接 Confluence Data Center 本地版
   • 关联 Dropbox
   • 关联 Dynamics 365
   • 关联 GitHub（其他许可名单）
   • 关联 GitLab（其他许可名单）
   • 关联 Jira Cloud
   • 连接 Jira Data Center 本地版
   • 关联 Microsoft Outlook（其他许可名单）
   • 关联 Microsoft Teams（其他许可名单）
   • 关联 Notion（额外的许可名单）
   • 关联 OneDrive
   • 关联 Salesforce
   • 关联 ServiceNow
   • 关联 SharePoint Online
   • 关联 Slack
   • 关联 Trello
   • 关联 Workday（其他许可名单）
   • 关联 Zendesk（额外的许可名单）

关联 Adobe Experience Manager

请按照以下步骤将数据从 Adobe Experience Manager 同步到 Vertex AI Search。

预览版：第三方连接器目前处于预览版阶段，需要通过许可名单才能使用。您必须列入许可名单才能使用此功能。

您首次设置数据源并导入数据后，数据存储区会按照您在设置期间选择的频率同步来自该数据源的数据。

准备工作

在设置连接之前，请执行以下操作：

1. 除了第三方连接器许可名单之外，此连接器还要求将您的项目添加到另一个许可名单中。如需添加到此许可名单，请与您的 Vertex AI Search 客户支持团队联系。

2. 为数据源设置访问权限控制。如需了解如何设置访问权限控制，请参阅使用数据源访问权限控制。

3. Adobe Experience Manager 管理员必须生成或获取以下内容，才能与 Vertex AI Search 集成：

   • Adobe Experience Manager 实例的服务凭据
   • 您的 Adobe Experience Manager 网站的实例网址

创建 Adobe Experience Manager 连接器

控制台

如需使用 Google Cloud 控制台将数据从 Adobe Experience Manager 同步到 Vertex AI Search，请按以下步骤操作：

1. 在 Google Cloud 控制台中，前往 Agent Builder 页面。

   Agent Builder

2. 在导航菜单中，点击数据存储空间。

3. 点击 创建数据存储区。

4. 在选择数据源页面上，滚动或搜索 Adobe Experience Manager 以关联第三方来源。

5. 输入您的 Adobe Experience Manager 身份验证信息，然后点击继续。

6. 选择要同步的实体，然后点击继续。

7. 为您的数据存储区选择一个区域。

8. 为数据连接器输入名称。

9. 选择同步频率。

10. 点击创建。Vertex AI Search 会创建数据存储区，并在数据存储区页面上显示您的数据存储区。

11. 如需查看数据提取状态，请前往数据存储区页面，然后点击连接器名称，在其数据页面上查看相关详细信息。当连接器开始同步数据时，连接器状态会从正在创建变为正在运行。提取完成后，状态会变为有效，表示已设置与数据源的连接，并正在等待下一次预定的同步。

    提取过程可能需要几分钟到几小时才能完成，具体取决于数据的大小。

后续步骤

• 如需将连接器附加到应用，请按照创建搜索应用中的步骤创建应用并选择连接器。

• 如需预览应用设置完毕后搜索结果的显示方式，请参阅获取搜索结果。如果您使用了第三方访问权限控制，请参阅预览启用了第三方访问权限控制的应用的结果。

关联 AODocs

请按照以下步骤将数据从 AODocs 同步到 Vertex AI Search。

预览版：第三方连接器目前处于预览版阶段，需要通过许可名单授权。您必须列入许可名单才能使用此功能。

您首次设置数据源并导入数据后，数据存储区会按照您在设置期间选择的频率同步来自该数据源的数据。

准备工作

在设置连接之前，请执行以下操作：

1. 除了第三方连接器许可名单之外，此连接器还要求将您的项目添加到另一个许可名单中。如需添加到此许可名单，请与您的 Vertex AI Search 客户支持团队联系。

2. 为数据源设置访问权限控制。如需了解如何设置访问权限控制，请参阅使用数据源访问权限控制。

3. AODocs 管理员必须生成或获取以下内容，才能与 Vertex AI Search 集成：

   • 实例 ID（AODocs 实例的网域网址）
   • 客户端 ID
   • 客户端密钥

创建 AODocs 连接器

控制台

如需使用 Google Cloud 控制台将数据从 AODocs 同步到 Vertex AI Search，请按以下步骤操作：

1. 在 Google Cloud 控制台中，前往 Agent Builder 页面。

   Agent Builder

2. 在导航菜单中，点击数据存储空间。

3. 点击 创建数据存储区。

4. 在选择数据源页面上，滚动或搜索 AODocs 以关联第三方来源。

5. 输入您的 AODocs 身份验证信息，然后点击 Authenticate。系统随即会显示一个新窗口。

6. 请先对您的账号进行身份验证并确认验证成功，然后返回为数据存储区指定 AODocs 来源页面。

7. 选择要同步的实体，然后点击继续。

8. 为您的数据存储区选择一个区域。

9. 为数据连接器输入名称。

10. 选择同步频率。

11. 点击创建。Vertex AI Search 会创建数据存储区，并在数据存储区页面上显示您的数据存储区。

12. 如需查看数据提取状态，请前往数据存储区页面，然后点击连接器名称，在其数据页面上查看相关详细信息。当连接器开始同步数据时，连接器状态会从正在创建变为正在运行。提取完成后，状态会变为有效，表示已设置与数据源的连接，并正在等待下一次预定的同步。

    提取过程可能需要几分钟到几小时才能完成，具体取决于数据的大小。

后续步骤

• 如需将连接器附加到应用，请按照创建搜索应用中的步骤创建应用并选择连接器。

• 如需预览应用设置完毕后搜索结果的显示方式，请参阅获取搜索结果。如果您使用了第三方访问权限控制，请参阅预览启用了第三方访问权限控制的应用的结果。

Connect Box

请按照以下步骤将数据从 Box 同步到 Vertex AI Search。

预览版：第三方连接器目前处于预览版阶段，需要通过许可名单授权。您必须列入许可名单才能使用此功能。

您首次设置数据源并导入数据后，数据存储区会按照您在设置期间选择的频率同步来自该数据源的数据。

准备工作

在设置连接之前，请执行以下操作：

1. 为数据源设置访问权限控制。如需了解如何设置访问权限控制，请参阅使用数据源访问权限控制。

2. 请准备好以下 Box 身份验证信息。如需了解如何设置这些参数，请参阅 Box 开发者文档中的 JWT Auth。

   • 企业 ID
   • 客户端 ID
   • 客户端密钥
   • 公钥 ID
   • 私钥
   • 口令

3. 创建 JWT 端点时，请配置以下范围：

   查看范围

   • root_readonly
   • root_readwrite
   • manage_managed_users
   • manage_app_users
   • manage_groups
   • manage_enterprise_properties
   • as_user
   • generate_access_token

评论的增量更改的同步时间可能会超过配置的频率间隔。如果复制或移动包含实体的文件夹，增量更改的同步时间可能会超过配置的频率间隔时间。

创建 Box 应用

1. 使用您的管理员账号登录 Box 开发者控制台。
2. 点击创建新应用。
3. 选择自定义应用类型。
4. 输入应用名称。
5. 设置应用的用途：集成、AI 或 Google Cloud Agent Builder。
6. 选择 Server authentication with JWT（使用 JWT 进行服务器身份验证）。

配置 Box 应用

1. 通过创建公钥/私钥对，为 Box 应用配置设置：

   1. 前往 Box 开发者控制台。

   2. 在配置标签页中，点击生成公钥/私钥对。

      • 系统会自动将公钥及其 ID 上传到控制台。创建连接时会使用此 ID。
      • 您可以将包含私钥和密码的配置文件下载到本地。请务必保留此配置文件以备日后使用。
      • 如需自行生成密钥，请参阅 Box 密钥对设置指南。

2. 配置所需权限：在应用范围部分，选择读取存储在 Box 中的所有文件和文件夹。

   1. 在授权标签页中，点击查看并提交，然后等待管理员批准。
   2. 管理员可以在管理控制台中批准应用。

   授权后，Box 会完成应用的完整设置。

创建 Box 连接器

控制台

如需使用 Google Cloud 控制台将数据从 Box 同步到 Vertex AI Search，请按以下步骤操作：

1. 在 Google Cloud 控制台中，前往 Agent Builder 页面。

   Agent Builder

2. 在导航菜单中，点击数据存储空间。

3. 点击 创建数据存储区。

4. 在选择数据源页面上，滚动或搜索 Box 以关联第三方来源。

5. 输入您的身份验证信息。

6. 选择要同步的实体，然后点击继续。

7. 为您的数据存储区选择一个区域。

8. 为数据存储区输入名称。

9. 为数据存储区选择同步频率。

10. 点击创建。Vertex AI Search 会创建数据存储区，并在数据存储区页面上显示您的数据存储区。

11. 如需查看数据注入状态，请前往数据存储区页面，然后点击数据存储区名称，在其数据页面上查看相关详细信息。当连接器开始同步数据时，连接器状态会从正在创建变为正在运行。提取完成后，状态会变为有效，表示已设置与数据源的连接，并正在等待下一次预定的同步。

    提取过程可能需要几分钟或几小时，具体取决于数据的大小。

后续步骤

• 如需将数据存储区附加到应用，请按照创建搜索应用中的步骤创建应用并选择数据存储区。

• 如需预览设置应用和数据存储区后搜索结果的显示方式，请参阅获取搜索结果。如果您使用了第三方访问权限控制，请参阅预览启用了第三方访问权限控制的应用的结果。

连接 Coda

请按照以下步骤将数据从 Coda 同步到 Vertex AI Search。

预览版：第三方连接器目前处于预览版阶段，需要通过许可名单授权。您必须列入许可名单才能使用此功能。

您首次设置数据源并导入数据后，数据存储区会按照您在设置期间选择的频率同步来自该数据源的数据。

准备工作

在设置连接之前，请执行以下操作：

1. 除了第三方连接器许可名单之外，此连接器还要求将您的项目添加到另一个许可名单中。如需添加到此许可名单，请与您的 Vertex AI Search 客户支持团队联系。

2. 为数据源设置访问权限控制。如需了解如何设置访问权限控制，请参阅使用数据源访问权限控制。

3. Coda 管理员必须生成或获取 Coda API 令牌，才能与 Vertex AI Search 集成。

创建 Coda 连接器

控制台

如需使用 Google Cloud 控制台将数据从 Coda 同步到 Vertex AI Search，请按以下步骤操作：

1. 在 Google Cloud 控制台中，前往 Agent Builder 页面。

   Agent Builder

2. 在导航菜单中，点击数据存储空间。

3. 点击 创建数据存储区。

4. 在选择数据源页面上，滚动或搜索 Coda 以关联第三方来源。

5. 输入您的 Coda 身份验证信息，然后点击继续。

6. 选择要同步的实体，然后点击继续。

7. 为您的数据存储区选择一个区域。

8. 为数据连接器输入名称。

9. 选择同步频率。

10. 点击创建。Vertex AI Search 会创建数据存储区，并在数据存储区页面上显示您的数据存储区。

11. 如需查看数据提取状态，请前往数据存储区页面，然后点击连接器名称，在其数据页面上查看相关详细信息。当连接器开始同步数据时，连接器状态会从正在创建变为正在运行。提取完成后，状态会变为有效，表示已设置与数据源的连接，并正在等待下一次预定的同步。

    提取过程可能需要几分钟到几小时才能完成，具体取决于数据的大小。

后续步骤

• 如需将连接器附加到应用，请按照创建搜索应用中的步骤创建应用并选择连接器。

• 如需预览应用设置完毕后搜索结果的显示方式，请参阅获取搜索结果。如果您使用了第三方访问权限控制，请参阅预览启用了第三方访问权限控制的应用的结果。

连接 Confluence Cloud

请按照以下步骤将数据从 Confluence Cloud 同步到 Vertex AI Search。

预览版：第三方连接器目前处于预览版阶段，需要通过许可名单授权。您必须列入许可名单才能使用此功能。

首次设置数据源并导入数据后，您可以选择数据存储区与该数据源同步的频率。

准备工作

在设置连接之前，请执行以下操作：

1. 验证您是否对 Confluence 实例和项目拥有管理员访问权限。

2. 为数据源设置访问权限控制。如需了解如何设置访问权限控制，请参阅使用数据源访问权限控制。

在 Confluence 中设置身份验证和权限

确保您拥有必要的身份验证详细信息，并拥有对 Confluence 实例的管理员访问权限。按照以下说明通过 Atlassian Developer Console 创建客户端 ID 和客户端密钥，配置所需的 OAuth 2.0 范围，为用户设置权限，检索实例网址和 ID，配置角色，并进行身份验证，以便在 Confluence Cloud 和 Vertex AI Search 之间同步数据。如需启用 OAuth 2.0 并获取客户端 ID 和密钥，请参阅 Atlassian Developer 文档中的 OAuth 2.0 (3LO) 应用。

1. 在 Atlassian Developer Console 中创建 OAuth 2.0 集成：

   1. 登录 Atlassian 开发者控制台。
   2. 点击个人资料图标，然后选择 Atlassian Developer Console。
   3. 点击创建，然后选择 OAuth 2.0 集成。
   4. 输入应用的名称，然后执行以下操作：
      1. 勾选条款及条件复选框。
      2. 点击创建。
      3. 点击授权。
      4. 在授权类型表格中，针对 OAuth 2.0 (3LO) 选择添加。
   5. 在 Callback 网址（回调网址）字段中，输入 https://vertexaisearch.cloud.google.com/console/oauth/confluence_oauth.html。
   6. 点击保存更改。

   如果您看到以下警告：您的应用没有任何 API。向应用添加 API，然后继续执行第 2 步并完成所有剩余步骤。否则，请跳到第 4 步和第 5 步。

2. 启用 OAuth 2.0：

   1. 点击权限。
   2. 前往 Confluence API。
   3. 点击添加。
   4. 点击配置。
   5. 前往精细镜重标签页，然后点击修改镜重。
   6. 选择以下范围。

      视图范围

      • read:attachment:confluence
      • read:configuration:confluence
      • read:content.metadata:confluence
      • read:content-details:confluence
      • read:group:confluence
      • read:space:confluence
      • read:user:confluence
   7. 确认已选择七个镜重，然后保存更改。

3. 获取客户端 ID 和客户端密钥：

   1. 点击分发。
   2. 选择修改。
   3. 选择共享以启用其他字段的修改功能。
   4. 填写其余字段。
   5. 看到 Does your app store personal data? 时，选择是
   6. 选择设置以复制您的客户端 ID 和客户端密钥。

4. 获取实例网址：

   1. 前往 atlassian.net，然后使用您的管理员账号登录。
   2. 选择要同步的应用。例如，同步第一个应用。
   3. 找到实例网址。它会显示为地址栏中的子网域。

5. 获取实例 ID：

   1. 打开一个新标签页，复制实例网址，然后将 /_edge/tenant_info 附加到实例网址。例如 https://YOUR-INSTANCE.atlassian.net/_edge/tenant_info。
   2. 前往该链接，找到 cloudId 值。cloudId 是您的实例 ID。

设置权限和角色

1. 使用您的管理员账号登录 atlassian.com。
2. 点击菜单图标或前往 admin.atlassian.com。
3. 在管理页面上，点击管理用户，然后前往群组页面。
4. 前往您的 Atlassian 网域网站，然后打开 Confluence Cloud 实例。
5. 前往 IAM。

6. 向 Confluence 管理员授予 Discovery Engine 角色。这样，Confluence 管理员就可以按照创建 Confluence Cloud 连接器中所述的方式配置连接器。

7. 向用户授予管理员角色：

   1. 创建专用用户账号。使用此账号进行数据存储区设置。
   2. 为新用户分配管理员角色。

8. 在 Atlassian 中配置权限：

   1. 前往您的 Atlassian 网域网站，然后打开 Confluence Cloud 实例。或者，您也可以直接访问 admin.atlassian.com。

   2. 点击菜单图标，然后选择所需选项。

   3. 可选：如果系统提示，请从着陆页中选择合适的组织。

9. 创建和配置群组：

   1. 在管理员页面上，根据需要点击管理用户按钮，然后从下拉列表中选择管理用户。
   2. 在用户管理页面上，选择群组。
   3. 点击创建群组，然后指定名称。使用此组分配连接器所需的权限。

10. 向群组添加权限：分配用户访问权限管理员角色。

11. 分配群组成员：

    1. 在群组页面上，点击添加产品，然后从下拉列表中选择适当的产品角色。在本例中，请选择用户访问权限管理员。
    2. 点击添加以确认角色分配。
    3. 点击添加群组成员以添加用户账号或群组成员。确保连接器代表这些用户进行身份验证以提取文档。

为了正确应用用户权限，每个 Confluence Cloud 用户都必须向所有用户公开其电子邮件地址。为此，请在 Confluence Cloud 中更改电子邮件公开范围设置，并将公开范围设置为 Anyone。如需了解详情，请参阅 Atlassian 文档中的设置电子邮件公开范围。

创建 Confluence Cloud 连接器

控制台

如需使用 Google Cloud 控制台将数据从 Confluence Cloud 同步到 Vertex AI Search，请按以下步骤操作：

1. 在 Google Cloud 控制台中，前往 Agent Builder 页面。

   Agent Builder

2. 在导航菜单中，点击数据存储空间。

3. 点击 创建数据存储区。

4. 在选择数据源页面上，滚动或搜索 Confluence 以关联第三方来源。

5. 输入您的身份验证信息，然后点击身份验证。

6. 系统随即会打开一个新窗口。输入实例用户名和密码。 请先检查身份验证是否成功，然后再返回为数据存储区指定 Confluence 来源页面。

7. 选择要同步的实体，然后点击继续。

8. 为数据连接器选择一个区域。

9. 为数据连接器输入名称。

10. 选择同步频率。

11. 点击创建。Vertex AI Search 会创建数据存储区，并在数据存储区页面上显示您的数据存储区。

12. 如需查看数据注入的状态，请前往数据存储区页面，然后点击数据存储区名称，在其数据页面上查看相关详细信息。当连接器开始同步数据时，连接器状态会从正在创建变为正在运行。提取完成后，状态会变为有效，表示已设置与数据源的连接，并正在等待下一次预定的同步。

    提取过程可能需要几分钟或几小时，具体取决于数据的大小。

后续步骤

• 如需将数据存储区附加到应用，请按照创建搜索应用中的步骤创建应用并选择数据存储区。

• 请参阅预览具有第三方访问权限控制功能的应用的结果。

连接 Confluence Data Center 本地版

按照此过程在 Agent Builder 中创建 Confluence Data Center 数据存储区和搜索应用，将本地 Confluence 数据与 Vertex AI Search 同步。

预览版：第三方连接器目前处于预览版阶段，需要通过许可名单才能使用。您必须列入许可名单才能使用此功能。

首次设置数据源并导入数据后，您可以选择数据存储区与该数据源同步的频率。

准备工作

在设置连接之前，请确保您已准备好以下内容：

1. 服务附件（仅适用于专用目标类型）：配置服务附件以实现安全的数据传输。
2. 用户名和密码：从您的 Confluence 管理员处获取用于身份验证的有效凭据。
3. 对于专用目标类型，此字段为可选：网域网址：指定 Confluence Data Center 实例的网址。
4. 可选：基本网域名称：为 Confluence 实例提供基本网域名称。
5. 可选：目的地端口：指定用于与 Confluence Data Center 通信的端口。

6. 请遵循以下配置准则，通过 Private Service Connect(PSC) 建立连接。根据需要调整或添加资源。确保 PSC 服务附件已正确配置为连接到专用实例，并且符合已发布服务的要求。

   1. 配置网络设置：

      1. 将 PSC 服务连接和负载均衡器放置在同一虚拟私有云网络中的不同子网中。

      2. 出于安全考虑，后端系统必须保持对公共网络的封闭状态。不过，请确保它可以接受来自以下来源的流量：

         • 对于基于代理/HTTP(S) 的负载平衡器（L4 代理 ILB、L7 ILB），请将后端配置为接受来自虚拟私有云网络中的代理子网的请求。

         • 如需了解详情，请参阅基于 Envoy 的负载平衡器的代理专用子网文档。

   2. 调整防火墙规则：

      1. 入站规则：

         • 允许从 PSC 服务附加子网到内部负载平衡器 (ILB) 子网的流量。
         • 确保 ILB 可以将流量发送到后端。
         • 允许健康检查探测到达后端。

      2. 出站规则：默认情况下，启用出站流量，除非应用了特定拒绝规则。

7. 其他注意事项：请确保将所有组件（包括 PSC 服务连接和负载均衡器）都放在同一区域。

生成服务连接

请按以下步骤生成服务附件：

1. 确定端点类型：选择公开或不公开端点。

2. 对于公共端点：如果 Confluence Data Center 目标类型为公共，则您无需为服务连接创建设置。不过，您可以在创建连接器时，在 Google Cloud 控制台的网域网址字段中使用您的公开网址。

3. 对于专用端点：

   1. 使用 Private Service Connect (PSC) 可实现从专用实例到 Google Cloud的连接。

   2. 创建 Virtual Private Cloud 网络和所需的子网。

   3. 创建虚拟机 (VM) 实例并安装后端服务。

   4. 可选：设置健康检查探测来监控后端健康状况。

   5. 添加负载均衡器，将流量路由到虚拟机或后端。

   6. 定义防火墙规则，以允许 PSC 端点与后端之间的流量。

   7. 通过创建 PSC 服务连接来发布端点。

创建 Confluence Data Center 用户并设置权限

若要让 Vertex AI Search 能够从 Confluence 获取数据，您需要创建一个具有最低必要权限的新用户。请按照以下步骤创建用户并设置所需权限。

1. 以管理员身份登录：

   1. 前往您的 Atlassian 网域网站，然后打开 Confluence Data Center 实例。
   2. 输入管理员用户名和密码。
   3. 点击 Log In。

2. 创建新用户：

   创建数据存储区时，您必须创建用户才能从第三方实例获取数据。

   1. 点击“设置”图标。
   2. 选择用户管理。
   3. 如果系统提示，请输入管理员凭据。
   4. 在管理页面中，点击创建用户。
   5. 输入电子邮件地址、全名、用户名和密码。
   6. 点击创建用户。

3. 将用户分配给群组：

   1. 在 Confluence 管理页面中，前往“用户和安全”标签页，然后点击群组。
   2. 点击添加群组。输入群组名称并创建群组。
   3. 在查找群组字段中，输入群组名称以查找群组。
   4. 点击“设置”图标。
   5. 选择商家资料账号，然后前往用户管理。
   6. 在用户页面中，点击“列出用户”下方的查找用户字段，然后搜索新创建的用户。
   7. 点击相应用户，打开查看用户页面。
   8. 点击修改群组以打开修改用户群组页面。
   9. 选中所创建用户群组对应的复选框。
   10. 点击保存将用户分配给新创建的群组。

   添加的用户会显示在群组成员部分。

4. 配置用户权限：

   1. 在 Confluence 管理页面中，前往问题标签页。
   2. 找到权限。
   3. 选择查看全球权限。
   4. 选择修改权限。
   5. 在修改全局权限页面中，搜索分配给用户的群组，然后启用可以使用选项。

配置文档空间

1. 点击 Confluence 图标以前往信息中心页面。
2. 点击创建聊天室。
3. 选择文档空间，然后点击下一步。
4. 输入所有必要的详细信息，然后点击创建以创建文档聊天室。
5. 在我的聊天室下，点击新创建的聊天室。
6. 前往网页，然后打开菜单（三点状图标）。
7. 选择限制。
8. 从限制下拉菜单中，选择查看和修改受限选项。
9. 搜索相应群组，然后分配可查看权限。
10. 点击应用。 创建的用户具有最低访问权限，并且为聊天室设置了权限。您还可以为博客分配权限。

创建 Confluence Data Center 本地连接器

控制台

1. 在 Google Cloud 控制台中，前往 Agent Builder 页面。

   Agent Builder

2. 在导航菜单中，点击数据存储空间。

3. 点击 创建数据存储区。

4. 在选择数据源页面上，滚动或搜索 Confluence 数据中心以连接第三方来源。

5. 输入您的身份验证信息，然后点击继续。

6. 从目标类型下拉列表中，选择公开或不公开。

   1. 对于公开目标类型，您无需为服务连接创建设置。不过，您可以在 Google Cloud 控制台的“网域网址”字段中使用您的公开网址。

   2. 对于不公开目的地类型，请输入所有必要信息：

      1. 例如，使用网域网址：
         • 服务连接：输入您的服务连接。
         • 可选：基础网域名称：输入您的基础网域。
         • 网域网址：输入您的网域网址。
         • 可选：目标端口：输入目标端口。
      2. 如果没有网域网址：
         • 服务连接：输入您的服务连接。
         • 可选：目标端口：输入目标端口。

7. 点击继续。

8. 可选：高级选项：根据需要选择并启用代理设置和 SSL 设置。

9. 在要同步的实体下，选择要同步的所有必需实体，然后点击继续。

10. 为数据连接器选择一个区域，然后输入数据连接器的名称。

11. 选择同步频率。

对于私有目的地类型，在您提交连接器的详细信息后，VAIS 会向您的 PSC 发送连接请求。前往您的连接器，您会看到一条消息，提示您在 PSC 中将 projectId 列入许可名单。在您允许 PSC 中的连接之前，连接器会一直处于错误状态。当您接受连接请求后，连接器会在下次运行同步时切换到有效状态。如果您将 PSC 配置为接受所有连接，则连接器会在创建后自动切换到有效状态。

对于公开目的地类型，连接器在提交后会自动进入有效状态。

如需验证数据存储区和提取活动的状态，请执行以下操作：

1. 在数据存储区列表中找到该连接器，然后监控其状态，直到其变为活跃。
2. 连接器状态变为有效后，点击所需实体，并确认已提取所有所选实体。同步开始时，数据存储区状态会从“正在创建”变为“正在运行”，在数据提取完成后变为“活跃”，这表示数据存储区已设置完毕。数据提取可能需要几个小时，具体取决于数据的大小。

后续步骤

• 如需将数据存储区附加到应用，请按照创建搜索应用中的步骤创建应用并选择数据存储区。
• 请参阅预览具有第三方访问权限控制功能的应用的结果。

关联 Dropbox

请按照以下步骤将数据从 Dropbox 同步到 Vertex AI Search。

预览版：第三方连接器目前处于预览版阶段，需要通过许可名单授权。您必须列入许可名单才能使用此功能。

您首次设置数据源并导入数据后，数据存储区会按照您在设置期间选择的频率同步来自该数据源的数据。

准备工作

在设置连接之前，请执行以下操作：

1. 为数据源设置访问权限控制。如需了解详情，请参阅使用数据源访问权限控制。

2. 请准备好以下 Dropbox 身份验证信息。如需了解如何设置这些参数，请参阅 Dropbox 文档中的 OAuth 指南。

   • 客户端 ID
   • 客户端密钥

创建 Dropbox 连接器

控制台

如需使用 Google Cloud 控制台将数据从 Dropbox 同步到 Vertex AI Search，请按以下步骤操作：

1. 在 Google Cloud 控制台中，前往 Agent Builder 页面。

   Agent Builder

2. 在导航菜单中，点击数据存储空间。

3. 点击 创建数据存储区。

4. 在选择数据源页面上，滚动或搜索 Dropbox 以关联第三方来源。

5. 输入您的 Dropbox 身份验证信息，然后点击身份验证。系统随即会显示一个新窗口。

6. 请先对您的账号进行身份验证并确认验证成功，然后返回为数据存储区指定 Dropbox 来源页面。

7. 选择要同步的实体，然后点击继续。

8. 为数据存储区选择位置。

9. 为数据存储区输入名称。

10. 为数据存储区选择同步频率。

11. 点击创建。Vertex AI Search 会创建数据存储区，并在数据存储区页面上显示您的数据存储区。

12. 如需查看数据注入的状态，请前往数据存储区页面，然后点击数据存储区名称，在其数据页面上查看相关详细信息。当连接器开始同步数据时，连接器状态会从正在创建变为正在运行。提取完成后，状态会变为有效，表示已设置与数据源的连接，并正在等待下一次按计划的同步。查看文档标签页，确保实体已正确提取。

    提取过程可能需要几分钟或几小时，具体取决于数据的大小。

后续步骤

• 如需将数据存储区附加到应用，请按照创建搜索应用中的步骤创建应用并选择数据存储区。

• 如需预览设置应用和数据存储区后搜索结果的显示方式，请参阅获取搜索结果。如果您使用了第三方访问权限控制，请参阅预览启用了第三方访问权限控制的应用的结果。

关联 Dynamics 365

请按照以下步骤将数据从 Dynamics 365 同步到 Vertex AI Search。

预览版：第三方连接器目前处于预览版阶段，需要通过许可名单授权。您必须列入许可名单才能使用此功能。

您首次设置数据源并导入数据后，数据存储区会按照您在设置期间选择的频率同步来自该数据源的数据。

注意： 此连接器提供部分 ACL 支持。在非公开预览版期间，系统会验证用户网域，但不支持精细的用户验证。

准备工作

在创建 Dynamics 365 连接器之前，请执行以下操作：

1. Dynamics 365 管理员必须生成或获取以下内容，才能与 Vertex AI Search 集成：

   • 客户端 ID
   • 客户端密钥
   • Azure 租户
   • 组织网址

2. 为数据源设置访问权限控制。如需了解如何设置访问权限控制，请参阅使用数据源访问权限控制。

创建 Dynamics 365 连接器

控制台

如需使用 Google Cloud 控制台将数据从 Dynamics 365 同步到 Vertex AI Search，请按以下步骤操作：

1. 在 Google Cloud 控制台中，前往 Agent Builder 页面。

   Agent Builder

2. 在导航菜单中，点击数据存储空间。

3. 点击 创建数据存储区。

4. 在选择数据源页面上，滚动或搜索 Dynamics 365 以关联第三方来源。

5. 输入您的 Dynamics 365 身份验证信息，然后点击继续。

6. 输入您的 Azure 租户和组织网址，然后点击继续。

7. 选择要同步的实体，然后点击继续。

8. 为您的数据存储区选择一个区域。

9. 为数据连接器输入名称。

10. 选择同步频率。

11. 点击创建。Vertex AI Search 会创建数据存储区，并在数据存储区页面上显示您的数据存储区。

12. 如需查看数据提取状态，请前往数据存储区页面，然后点击连接器名称，在其数据页面上查看相关详细信息。当连接器开始同步数据时，连接器状态会从正在创建变为正在运行。提取完成后，状态会变为有效，表示已设置与数据源的连接，并正在等待下一次预定的同步。

    提取过程可能需要几分钟到几小时才能完成，具体取决于数据的大小。

后续步骤

• 如需将连接器附加到应用，请按照创建搜索应用中的步骤创建应用并选择连接器。

• 如需预览应用设置完毕后搜索结果的显示方式，请参阅获取搜索结果。如果您使用了第三方访问权限控制，请参阅预览启用了第三方访问权限控制的应用的结果。

关联 GitHub

请按照以下步骤将数据从 GitHub 同步到 Vertex AI Search。

预览版：第三方连接器目前处于预览版阶段，需要通过许可名单才能使用。您必须列入许可名单才能使用此功能。

您首次设置数据源并导入数据后，数据存储区会按照您在设置期间选择的频率同步来自该数据源的数据。

准备工作

在设置连接之前，请执行以下操作：

1. 除了第三方连接器许可名单之外，此连接器还要求将您的项目添加到另一个许可名单中。如需添加到此许可名单，请与您的 Vertex AI Search 客户支持团队联系。

2. 为数据源设置访问权限控制。如需了解如何设置访问权限控制，请参阅使用数据源访问权限控制。

3. GitHub 管理员必须获取 GitHub 实例个人访问令牌，才能与 Vertex AI Search 集成。

创建 GitHub 连接器

控制台

如需使用 Google Cloud 控制台将数据从 GitHub 同步到 Vertex AI Search，请按以下步骤操作：

1. 在 Google Cloud 控制台中，前往 Agent Builder 页面。

   Agent Builder

2. 在导航菜单中，点击数据存储空间。

3. 点击 创建数据存储区。

4. 在选择数据源页面上，滚动或搜索 GitHub 以关联第三方来源。

5. 输入您的 GitHub 身份验证信息，然后点击继续。

6. 选择要同步的实体，然后点击继续。

7. 为您的数据存储区选择一个区域。

8. 为数据连接器输入名称。

9. 选择同步频率。

10. 点击创建。Vertex AI Search 会创建数据存储区，并在数据存储区页面上显示您的数据存储区。

11. 如需查看数据提取状态，请前往数据存储区页面，然后点击连接器名称，在其数据页面上查看相关详细信息。当连接器开始同步数据时，连接器状态会从正在创建变为正在运行。提取完成后，状态会变为有效，表示已设置与数据源的连接，并正在等待下一次预定的同步。

    提取过程可能需要几分钟到几小时才能完成，具体取决于数据的大小。

后续步骤

• 如需将连接器附加到应用，请按照创建搜索应用中的步骤创建应用并选择连接器。

• 如需预览应用设置完毕后搜索结果的显示方式，请参阅获取搜索结果。如果您使用了第三方访问权限控制，请参阅预览启用了第三方访问权限控制的应用的结果。

关联 GitLab

请按照以下步骤将数据从 GitLab 同步到 Vertex AI Search。

预览版：第三方连接器目前处于预览版阶段，需要通过许可名单才能使用。您必须列入许可名单才能使用此功能。

您首次设置数据源并导入数据后，数据存储区会按照您在设置期间选择的频率同步来自该数据源的数据。

准备工作

在设置连接之前，请执行以下操作：

1. 除了第三方连接器许可名单之外，此连接器还要求将您的项目添加到另一个许可名单中。如需添加到此许可名单，请与您的 Vertex AI Search 客户支持团队联系。

2. 为数据源设置访问权限控制。如需了解如何设置访问权限控制，请参阅使用数据源访问权限控制。

3. GitLab 管理员必须获取 GitLab 实例个人访问令牌，才能与 Vertex AI Search 集成。

创建 GitLab 连接器

控制台

如需使用 Google Cloud 控制台将数据从 GitLab 同步到 Vertex AI Search，请按以下步骤操作：

1. 在 Google Cloud 控制台中，前往 Agent Builder 页面。

   Agent Builder

2. 在导航菜单中，点击数据存储空间。

3. 点击 创建数据存储区。

4. 在选择数据源页面上，滚动或搜索 GitLab 以关联第三方来源。

5. 输入您的 GitLab 身份验证信息，然后点击继续。

6. 选择要同步的实体，然后点击继续。

7. 为您的数据存储区选择一个区域。

8. 为数据连接器输入名称。

9. 选择同步频率。

10. 点击创建。Vertex AI Search 会创建数据存储区，并在数据存储区页面上显示您的数据存储区。

11. 如需查看数据提取状态，请前往数据存储区页面，然后点击连接器名称，在其数据页面上查看相关详细信息。当连接器开始同步数据时，连接器状态会从正在创建变为正在运行。提取完成后，状态会变为有效，表示已设置与数据源的连接，并正在等待下一次预定的同步。

    提取过程可能需要几分钟到几小时才能完成，具体取决于数据的大小。

后续步骤

• 如需将连接器附加到应用，请按照创建搜索应用中的步骤创建应用并选择连接器。

• 如需预览应用设置完毕后搜索结果的显示方式，请参阅获取搜索结果。如果您使用了第三方访问权限控制，请参阅预览启用了第三方访问权限控制的应用的结果。

关联 Jira Cloud

请按照以下步骤将数据从 Jira Cloud 同步到 Vertex AI Search。

预览版：第三方连接器目前处于预览版阶段，需要通过许可名单授权。您必须列入许可名单才能使用此功能。

首次设置数据源并导入数据后，您可以选择数据存储区与该数据源同步的频率。

准备工作

在设置连接之前，请执行以下操作：

1. 请验证您是否对 Jira 实例和项目拥有管理员访问权限。

2. 设置访问权限控制。确保为您的数据源正确配置了访问权限控制。此步骤可确保只有获得授权的用户才能访问和管理数据。如需了解详情，请参阅使用数据源访问权限控制文档。

3. 为了正确应用用户权限，Jira Cloud 用户必须提供共享同意声明。

4. 确保您拥有 Atlassian 账号、Jira 实例和项目。

在 Jira 中设置身份验证和权限

确保您拥有必要的身份验证详细信息，以及对 Jira 实例的管理员访问权限。按照以下说明通过 Atlassian Developer Console 创建客户端 ID 和客户端密钥，配置所需的 OAuth 2.0 权限范围，为用户设置权限，检索实例网址和 ID，配置角色，并进行身份验证，以便在 Jira Cloud 和 Vertex AI Search 之间同步数据。如需启用 OAuth 2.0 并获取客户端 ID 和密钥，请参阅 Atlassian Developer 文档中的 OAuth 2.0 (3LO) 应用。

1. 在 Atlassian Developer Console 中创建 OAuth 2.0 集成：

   1. 登录 Atlassian Developer Console。
   2. 点击个人资料图标，然后选择 Developer Console（开发者控制台）。
   3. 点击创建，然后选择 OAuth 2.0 集成。
   4. 输入应用名称，然后执行以下操作：

2. 在 Callback 网址（回调网址）字段中，输入 https://vertexaisearch.cloud.google.com/console/oauth/jira_oauth.html。

3. 点击保存更改。

   如果您看到以下警告：您的应用没有任何 API。向应用添加 API，然后继续执行第 2 步并完成所有剩余步骤。否则，请跳到第 4 步和第 5 步。

4. 启用 OAuth 2.0：

   1. 选择权限：
   • 前往 Jira API。
   • 点击添加。
   • 点击配置。
   • 前往传统镜重标签页，然后点击修改镜重。选择以下镜重：

     视图范围

     • read:jira-user
     • read:jira-work
   • 前往精细镜重标签页，然后点击修改镜重。选择以下镜重：

     视图范围

     • read:avatar:jira
     • read:audit-log:jira
     • read:group:jira
     • read:issue-security-level:jira
     • read:issue-security-scheme:jira
     • read:user:jira
   1. 确认已选择 8 个镜重，然后保存更改。

5. 获取客户端 ID 和客户端密钥：

   1. 点击分发。

   2. 选择修改，然后执行以下操作：

      1. 选择共享以启用其他字段的修改功能。
      2. 填写其余字段。
      3. 看到 Does your app store personal data? 时，选择是

   3. 选择设置以复制您的客户端 ID 和客户端密钥。

6. 获取实例网址：

   1. 前往 atlassian.net，然后使用您的管理员账号登录。
   2. 选择要同步的应用。例如，同步第一个应用。
   3. 找到实例网址，即地址栏中的子网域。

7. 获取实例 ID：

   1. 打开一个新标签页，复制实例网址，然后将 /_edge/tenant_info 附加到实例网址。例如 https://YOUR-INSTANCE.atlassian.net/_edge/tenant_info。
   2. 前往该链接，找到 cloudId 值。cloudId 是您的实例 ID。

设置权限和角色

1. 使用您的管理员账号登录 atlassian.com。
2. 点击左上角的菜单图标，或前往 admin.atlassian.com。
3. 在管理页面上，点击管理用户，然后前往群组页面。
4. 点击创建群组。输入群组名称并创建群组。
5. 点击添加产品。
6. 在向组添加产品对话框中，选择用户访问权限管理员作为产品角色。
7. 点击添加。
8. 在群组页面上，点击添加群组成员，以添加该连接器进行身份验证的用户或账号。

为了正确应用用户权限，每个 Jira Cloud 用户都必须向所有用户公开其电子邮件地址。为此，请在 Confluence Cloud 中更改电子邮件公开范围设置，并将公开范围设置为 Anyone。如需了解详情，请参阅 Atlassian 文档中的设置电子邮件公开范围。

创建 Jira Cloud 连接器

控制台

如需使用 Google Cloud 控制台将数据从 Jira Cloud 同步到 Vertex AI Search，请按以下步骤操作：

1. 在 Google Cloud 控制台中，前往 Agent Builder 页面。

   Agent Builder

2. 在导航菜单中，点击数据存储空间。

3. 点击 创建数据存储区。

4. 在选择数据源页面上，滚动或搜索 Jira Cloud 以关联第三方来源。

5. 输入您的身份验证信息，然后点击验证。

6. 输入实例用户名和密码。

7. 请先验证身份验证是否成功，然后再返回为数据存储区指定 Jira 来源页面。

8. 选择要同步的实体，然后点击继续。

9. 为您的数据存储区选择一个区域。

10. 为数据存储区输入名称。

11. 选择同步频率。

12. 点击创建。Vertex AI Search 会创建数据存储区，并在数据存储区页面上显示您的数据存储区。

13. 如需查看数据注入的状态，请前往数据存储区页面，然后点击数据存储区名称，在其数据页面上查看相关详细信息。当连接器开始同步数据时，连接器状态会从正在创建变为正在运行。提取完成后，状态会变为有效，表示已设置与数据源的连接，并正在等待下一次预定的同步。

    提取过程可能需要几分钟或几小时，具体取决于数据的大小。

后续步骤

• 如需将数据存储区附加到应用，请按照创建搜索应用中的步骤创建应用并选择数据存储区。

• 请参阅预览具有第三方访问权限控制功能的应用的结果。

连接 Jira Data Center 本地版

按照此过程在 Agent Builder 中创建 Jira Data Center 数据存储区和搜索应用，将本地 Jira 数据与 Vertex AI Search 同步。

预览版：第三方连接器目前处于预览版阶段，需要通过许可名单授权。您必须列入许可名单才能使用此功能。

首次设置数据源并导入数据后，您可以选择数据存储区与该数据源同步的频率。

准备工作

在设置连接之前，请确保您已准备好以下内容：

1. 服务附件（仅适用于专用目标类型）：配置服务附件以实现安全的数据传输。
2. 用户名和密码：向 Jira 管理员获取用于身份验证的有效凭据。
3. 对于专用目标类型，此字段为可选：网域网址：指定 Jira Data Center 实例的网址。
4. 可选：基本域名：提供 Jira 实例的基本域名。
5. 可选：目的地端口：指定用于与 Jira Data Center 通信的端口。

6. 请遵循以下配置准则，通过 Private Service Connect (PSC) 建立连接。根据需要调整或添加资源。确保 PSC 服务附件已正确配置为连接到专用实例，并且符合已发布服务的要求。

   1. 配置网络设置：

      1. 将 PSC 服务连接和负载均衡器放置在同一虚拟私有云网络中的不同子网中。

      2. 出于安全考虑，后端系统必须保持对公共网络的封闭状态。不过，请确保它可以接受来自以下来源的流量：

         • 对于基于代理/HTTP(S) 的负载平衡器（L4 代理 ILB、L7 ILB），请将后端配置为接受来自虚拟私有云网络中的代理子网的请求。

         • 如需了解详情，请参阅基于 Envoy 的负载平衡器的代理专用子网文档。

   2. 调整防火墙规则：

      1. 入站规则：

         • 允许从 PSC 服务附加子网到内部负载平衡器 (ILB) 子网的流量。
         • 确保 ILB 可以将流量发送到后端。
         • 允许健康检查探测到达后端。

      2. 出站规则：默认情况下，启用出站流量，除非应用了特定拒绝规则。

7. 其他注意事项：请确保将所有组件（包括 PSC 服务连接和负载均衡器）都放在同一区域。

生成服务连接

请按以下步骤生成服务附件：

1. 确定端点类型：选择公开或不公开端点。

2. 对于公共端点：如果 Jira Data Center 目标类型为公共，则您无需为服务连接创建设置。不过，您可以在 Google Cloud 控制台的网域网址字段中使用您的公开网址。

3. 对于专用端点：

   1. 使用 PSC 可启用从专用实例到 Google Cloud的连接。

   2. 创建 Virtual Private Cloud 网络和所需的子网。

   3. 创建虚拟机 (VM) 实例并安装后端服务。

   4. 可选：设置健康检查探测来监控后端健康状况。

   5. 添加负载均衡器，将流量路由到虚拟机或后端。

   6. 定义防火墙规则，以允许 PSC 端点与后端之间的流量。

   7. 通过创建 PSC 服务连接来发布端点。

创建 Jira Data Center 用户并设置权限

若要让 Vertex AI Search 能够从 Jira 获取数据，您需要创建一个具有最低必要权限的新用户。请按照以下步骤创建用户并设置所需权限。

1. 以管理员身份登录：

   1. 前往您的 Atlassian 网域网站，然后打开 Jira Data Center 实例。
   2. 输入管理员用户名和密码。
   3. 点击 Log In。

2. 创建新用户：

   创建数据存储区时，您必须创建用户才能从第三方实例获取数据。

   1. 点击“设置”图标。
   2. 选择用户管理。
   3. 如果系统提示，请输入管理员凭据。
   4. 在管理页面中，点击创建用户。
   5. 输入电子邮件地址、全名、用户名和密码。
   6. 点击创建用户。

3. 将用户分配给群组：

   1. 在管理页面中，点击“用户管理”下方的群组。
   2. 输入名称，然后点击添加群组以创建群组。
   3. 选择新创建的群组。
   4. 点击添加/移除用户。
   5. 点击将成员添加到所选群组框旁边的成员图标。
   6. 选择新创建的用户，然后点击保存所选内容。
   7. 点击添加所选用户，即可在“群组成员”部分中看到新用户。

   您可以在群组成员部分查看已添加的用户。

4. 配置用户权限：

   1. 在管理页面中，前往问题标签页。
   2. 选择权限方案。
   3. 点击添加权限方案。
   4. 输入 scheme 的名称，然后点击添加。
   5. 选择方案，然后点击权限图标。
   6. 点击授予权限。
   7. 添加以下权限，将这些权限分配给之前创建的组，然后点击授予：
      1. 浏览项目。
      2. 浏览项目归档。
   8. 将此架构添加到需要群组用户访问权限才能查看项目、问题、评论、工作日志和附件的项目。

配置应用访问权限

1. 在管理页面中，前往应用标签页。
2. 在应用标签页下，选择应用访问权限。
3. 搜索并选择所创建的群组。
4. 验证该组是否显示在访问权限列表中。

创建的用户具有最低访问权限。此架构会添加到项目中。Jira 管理员可以向该群组添加更多成员，也可以向该项目添加用户。

创建 Jira Data Center 本地连接器

控制台

1. 在 Google Cloud 控制台中，前往 Agent Builder 页面。

   Agent Builder

2. 在导航菜单中，点击数据存储空间。

3. 点击 创建数据存储区。

4. 在选择数据源页面上，滚动或搜索 Jira 数据中心以关联第三方来源。

5. 输入您的身份验证信息，然后点击继续。

6. 从目标类型下拉列表中，选择公开或不公开。

   1. 对于公开目标类型，您无需为服务连接创建设置。不过，您可以在 Google Cloud 控制台的“网域网址”字段中使用您的公开网址。

   2. 对于不公开目的地类型，请输入所有必要信息：

      1. 例如，使用网域网址：
         • 服务连接：输入您的服务连接。
         • 可选：基础网域名称：输入您的基础网域。
         • 网域网址：输入您的网域网址。
         • 可选：目标端口：输入目标端口。
      2. 如果没有网域网址：
         • 服务连接：输入您的服务连接。
         • 可选：目标端口：输入目标端口。

7. 点击继续。

8. 可选：高级选项：根据需要选择并启用代理设置和 SSL 设置。

9. 在要同步的实体下，选择要同步的所有必需实体，然后点击继续。

10. 为数据连接器选择一个区域，然后输入数据连接器的名称。

11. 选择同步频率。

对于私有目的地类型，在您提交连接器的详细信息后，VAIS 会向您的 PSC 发送连接请求。前往您的连接器，您会看到一条消息，提示您在 PSC 中将 projectId 列入许可名单。在您允许 PSC 中的连接之前，连接器会一直处于错误状态。当您接受连接请求后，连接器会在下次运行同步时切换到有效状态。如果您将 PSC 配置为接受所有连接，则连接器会在创建后自动切换到有效状态。

对于公开目的地类型，连接器在提交后会自动进入有效状态。如需验证数据存储区和提取活动的状态，请执行以下操作：

1. 在数据存储区列表中找到该连接器，然后监控其状态，直到其变为活跃。
2. 连接器状态变为有效后，点击所需的实体，并确认已提取所有所选实体。同步开始时，数据存储区状态会从“正在创建”变为“正在运行”，在数据提取完成后变为“活跃”，表示数据存储区已设置完毕。提取过程可能需要几个小时，具体取决于数据的大小。

后续步骤

• 如需将数据存储区附加到应用，请按照创建搜索应用中的步骤创建应用并选择数据存储区。

• 请参阅预览具有第三方访问权限控制功能的应用的结果。

关联 Microsoft Outlook

请按照以下步骤将数据从 Microsoft Outlook 同步到 Vertex AI Search。

预览版：第三方连接器目前处于预览版阶段，需要通过许可名单授权。您必须列入许可名单才能使用此功能。

您首次设置数据源并导入数据后，数据存储区会按照您在设置期间选择的频率同步来自该数据源的数据。

准备工作

在设置连接之前，请执行以下操作：

1. 除了第三方连接器许可名单之外，此连接器还要求将您的项目添加到另一个许可名单中。如需添加到此许可名单，请与您的 Vertex AI Search 客户支持团队联系。

2. 为数据源设置访问权限控制。如需了解如何设置访问权限控制，请参阅使用数据源访问权限控制。

3. Microsoft Outlook 管理员必须生成或获取以下内容，才能与 Vertex AI Search 集成：

   • 客户端 ID
   • 客户端密钥
   • 租户 ID

创建 Microsoft Outlook 连接器

控制台

如需使用 Google Cloud 控制台将数据从 Microsoft Outlook 同步到 Vertex AI Search，请按以下步骤操作：

1. 在 Google Cloud 控制台中，前往 Agent Builder 页面。

   Agent Builder

2. 在导航菜单中，点击数据存储空间。

3. 点击 创建数据存储区。

4. 在选择数据源页面上，滚动或搜索 Microsoft Outlook 以关联第三方来源。

5. 输入您的 Microsoft Outlook 身份验证信息，然后点击继续。

6. 选择要同步的实体，然后点击继续。

7. 为您的数据存储区选择一个区域。

8. 为数据连接器输入名称。

9. 选择同步频率。

10. 点击创建。Vertex AI Search 会创建数据存储区，并在数据存储区页面上显示您的数据存储区。

11. 如需查看数据提取状态，请前往数据存储区页面，然后点击连接器名称，在其数据页面上查看相关详细信息。当连接器开始同步数据时，连接器状态会从正在创建变为正在运行。提取完成后，状态会变为有效，表示已设置与数据源的连接，并正在等待下一次预定的同步。

    提取过程可能需要几分钟到几小时才能完成，具体取决于数据的大小。

后续步骤

• 如需将连接器附加到应用，请按照创建搜索应用中的步骤创建应用并选择连接器。

• 如需预览应用设置完毕后搜索结果的显示方式，请参阅获取搜索结果。如果您使用了第三方访问权限控制，请参阅预览启用了第三方访问权限控制的应用的结果。

关联 Microsoft Teams

请按照以下步骤将数据从 Microsoft Teams 同步到 Vertex AI Search。

预览版：第三方连接器目前处于预览版阶段，需要通过许可名单授权。您必须列入许可名单才能使用此功能。

您首次设置数据源并导入数据后，数据存储区会按照您在设置期间选择的频率同步来自该数据源的数据。

准备工作

在设置连接之前，请执行以下操作：

1. 除了第三方连接器许可名单之外，此连接器还要求将您的项目添加到另一个许可名单中。如需添加到此许可名单，请与您的 Vertex AI Search 客户支持团队联系。

2. 为数据源设置访问权限控制。如需了解如何设置访问权限控制，请参阅使用数据源访问权限控制。

3. Microsoft Teams 管理员必须生成或获取以下内容，才能与 Vertex AI Search 集成：

   • 客户端 ID
   • 客户端密钥
   • 租户 ID

创建 Microsoft Teams 连接器

控制台

如需使用 Google Cloud 控制台将数据从 Microsoft Teams 同步到 Vertex AI Search，请按以下步骤操作：

1. 在 Google Cloud 控制台中，前往 Agent Builder 页面。

   Agent Builder

2. 在导航菜单中，点击数据存储空间。

3. 点击 创建数据存储区。

4. 在选择数据源页面上，滚动或搜索 Microsoft Teams 以关联第三方来源。

5. 输入您的 Microsoft Teams 身份验证信息，然后点击继续。

6. 选择要同步的实体，然后点击继续。

7. 为您的数据存储区选择一个区域。

8. 为数据连接器输入名称。

9. 选择同步频率。

10. 点击创建。Vertex AI Search 会创建数据存储区，并在数据存储区页面上显示您的数据存储区。

11. 如需查看数据提取状态，请前往数据存储区页面，然后点击连接器名称，在其数据页面上查看相关详细信息。当连接器开始同步数据时，连接器状态会从正在创建变为正在运行。提取完成后，状态会变为有效，表示已设置与数据源的连接，并正在等待下一次预定的同步。

    提取过程可能需要几分钟到几小时才能完成，具体取决于数据的大小。

后续步骤

• 如需将连接器附加到应用，请按照创建搜索应用中的步骤创建应用并选择连接器。

• 如需预览应用设置完毕后搜索结果的显示方式，请参阅获取搜索结果。如果您使用了第三方访问权限控制，请参阅预览启用了第三方访问权限控制的应用的结果。

关联 Notion

请按照以下步骤将数据从 Notion 同步到 Vertex AI Search。

预览版：第三方连接器目前处于预览版阶段，需要通过许可名单才能使用。您必须列入许可名单才能使用此功能。

您首次设置数据源并导入数据后，数据存储区会按照您在设置期间选择的频率同步来自该数据源的数据。

注意： 此连接器提供部分 ACL 支持。在非公开预览版期间，系统会验证用户网域，但不支持精细的用户验证。

准备工作

在设置连接器之前，请执行以下操作：

1. 除了第三方连接器许可名单之外，此连接器还要求将您的项目添加到另一个许可名单中。如需添加到此许可名单，请与您的 Vertex AI Search 客户支持团队联系。

2. Notion 管理员必须生成或获取以下内容，才能与 Vertex AI Search 集成：

   • Notion 实例的 API 令牌
   • 工作区 ID

3. 为数据源设置访问权限控制。如需了解如何设置访问权限控制，请参阅使用数据源访问权限控制。

创建 Notion 连接器

控制台

如需使用 Google Cloud 控制台将数据从 Notion 同步到 Vertex AI Search，请按以下步骤操作：

1. 在 Google Cloud 控制台中，前往 Agent Builder 页面。

   Agent Builder

2. 在导航菜单中，点击数据存储空间。

3. 点击 创建数据存储区。

4. 在选择数据源页面上，滚动或搜索 Notion 以关联第三方来源。

5. 输入您的 Notion 身份验证信息，然后点击继续。

6. 选择要同步的实体，然后点击继续。

7. 为您的数据存储区选择一个区域。

8. 为数据连接器输入名称。

9. 选择同步频率。

10. 点击创建。Vertex AI Search 会创建数据存储区，并在数据存储区页面上显示您的数据存储区。

11. 如需查看数据提取状态，请前往数据存储区页面，然后点击连接器名称，在其数据页面上查看相关详细信息。当连接器开始同步数据时，连接器状态会从正在创建变为正在运行。提取完成后，状态会变为有效，表示已设置与数据源的连接，并正在等待下一次预定的同步。

    提取过程可能需要几分钟到几小时才能完成，具体取决于数据的大小。

后续步骤

• 如需将连接器附加到应用，请按照创建搜索应用中的步骤创建应用并选择连接器。

• 如需预览应用设置完毕后搜索结果的显示方式，请参阅获取搜索结果。如果您使用了第三方访问权限控制，请参阅预览启用了第三方访问权限控制的应用的结果。

关联 OneDrive

请按照以下步骤将数据从 OneDrive 同步到 Vertex AI Search。

预览版：第三方连接器目前处于预览版阶段，需要通过许可名单才能使用。您必须列入许可名单才能使用此功能。

您首次设置数据源并导入数据后，数据存储区会按照您在设置期间选择的频率同步来自该数据源的数据。

准备工作

在设置连接之前，请执行以下操作：

1. 为数据源设置访问权限控制。如需了解如何设置访问权限控制，请参阅使用数据源访问权限控制。

2. 请准备好以下 OneDrive 身份验证信息：

   1. 客户端 ID、客户端密钥和租户 ID。如需了解如何设置这些参数，请参阅 Microsoft 文档中的快速入门：向 Microsoft Identity Platform 注册应用。

   2. 指定访问权限范围。必须拥有管理员角色。如需了解详情，请参阅 Microsoft 文档中的快速入门：配置客户端应用以访问 Web API。

   3. 配置以下镜重：

      查看范围

      • Files.Read.All (Application)
      • Group.Read.All (Application)
      • User.Read.All (Application)

创建 OneDrive 连接器

控制台

如需使用 Google Cloud 控制台将数据从 OneDrive 同步到 Vertex AI Search，请按以下步骤操作：

1. 在 Google Cloud 控制台中，前往 Agent Builder 页面。

   Agent Builder

2. 在导航菜单中，点击数据存储空间。

3. 点击 创建数据存储区。

4. 在选择数据源页面上，滚动或搜索 OneDrive 以关联第三方来源。

5. 输入您的 OneDrive 身份验证信息。

6. 选择要同步的实体，然后点击继续。

7. 为您的数据存储区选择一个区域。

8. 为数据存储区输入名称。

9. 为数据存储区选择同步频率。

10. 点击创建。Vertex AI Search 会创建数据存储区，并在数据存储区页面上显示您的数据存储区。

11. 如需查看数据注入状态，请前往数据存储区页面，然后点击数据存储区名称，在其数据页面上查看相关详细信息。当连接器开始同步数据时，连接器状态会从正在创建变为正在运行。提取完成后，状态会变为有效，表示已设置与数据源的连接，并正在等待下一次预定的同步。

    提取过程可能需要几分钟或几小时，具体取决于数据的大小。

后续步骤

• 如需将数据存储区附加到应用，请按照创建搜索应用中的步骤创建应用并选择数据存储区。

• 如需预览设置应用和数据存储区后搜索结果的显示方式，请参阅获取搜索结果。如果您使用了第三方访问权限控制，请参阅预览启用了第三方访问权限控制的应用的结果。

关联 Salesforce

请按照以下步骤将数据从 Salesforce 同步到 Vertex AI Search。

预览版：第三方连接器目前处于预览版阶段，需要通过许可名单才能使用。您必须列入许可名单才能使用此功能。

您首次设置数据源并导入数据后，数据存储区会按照您在设置期间选择的频率同步来自该数据源的数据。

准备工作

在设置连接之前，请执行以下操作：

1. 为数据源设置访问权限控制。如需了解如何设置访问权限控制，请参阅使用数据源访问权限控制。

2. 请准备好以下身份验证信息。如需了解如何在 Salesforce 中设置客户端 ID 和客户端密钥，请参阅 Salesforce 文档中的为 OAuth 2.0 客户端凭据流程配置关联的应用。

   • 实例网址
   • 使用方 ID
   • 使用方密钥

存在以下限制：

1. 使用企业版或开发者版方案。不支持试用账号。
2. 确保您使用的是 Sales Cloud。不支持 Service Cloud。
3. 将 Google Cloud 添加到 Salesforce CORS 许可名单。如果您已完成此任务，请执行下一步。
   1. 按照 Salesforce 文档中的说明配置 CORS 许可名单。
   2. 输入 https://console.cloud.google.com/ 作为源网址，然后保存配置。

创建 Salesforce 连接器

控制台

如需使用 Google Cloud 控制台将数据从 Salesforce 同步到 Vertex AI Search，请按以下步骤操作：

1. 在 Google Cloud 控制台中，前往 Agent Builder 页面。

   Agent Builder

2. 在导航菜单中，点击数据存储空间。

3. 点击 创建数据存储区。

4. 在选择数据源页面上，滚动或搜索 Salesforce 以连接第三方来源。

5. 输入您的 Salesforce 身份验证信息。

6. 选择要同步的实体，然后点击继续。

7. 为您的数据存储区选择一个区域。

8. 为数据存储区输入名称。

9. 选择同步频率。

10. 点击创建。Vertex AI Search 会创建数据存储区，并在数据存储区页面上显示您的数据存储区。

11. 如需查看数据注入的状态，请前往数据存储区页面，然后点击数据存储区名称，在其数据页面上查看其详细信息。连接器开始同步数据时，连接器状态会从“正在创建”更改为“正在运行”。提取完成后，状态会变为有效，表示已设置与数据源的连接，并正在等待下一次预定的同步。

    提取过程可能需要几分钟或几小时，具体取决于数据的大小。

后续步骤

• 如需将数据存储区附加到应用，请按照创建搜索应用中的步骤创建应用并选择数据存储区。

• 请参阅预览具有第三方访问权限控制功能的应用的结果。

连接 ServiceNow

请按照以下步骤将数据从 ServiceNow 同步到 Vertex AI Search。

预览版：第三方连接器目前处于预览版阶段，需要通过许可名单才能使用。您必须列入许可名单才能使用此功能。

您首次设置数据源并导入数据后，数据存储区会按照您在设置期间选择的频率同步来自该数据源的数据。

准备工作

在设置连接之前，请确保您已完成以下准备工作：

1. ServiceNow 实例：按照 ServiceNow 开发者文档中的说明创建 ServiceNow 实例。

2. Google Cloud 项目：使用能够管理组织级配置的管理员账号设置 Google Cloud 项目，确保组织能够设置员工队伍。

3. 员工池：确保您的组织已设置为管理员工池。

设置 ServiceNow

ServiceNow 提供两个主要网站：

1. ServiceNow 主网站：您的 ServiceNow 实例的网站。

   • 管理用户、群组和系统管理任务。
   • 网址：您的 ServiceNow 实例的网址。
   • 使用您的管理员凭据登录。

2. 开发者网站：

   • 配置知识库、设置工作流程并开发自定义应用。
   • 网址：https://developer.service-now.com。
   • 使用您的 ServiceNow ID 登录。

注意： 对于以下设置，请使用 ServiceNow 主网站来配置 OAuth 和权限。

如需创建 OAuth 端点，请执行以下操作：

1. 使用管理员权限登录主 ServiceNow 实例。
2. 依次前往全部 > System OAuth > Application registry。
3. 点击新建，然后选择为外部客户端创建 OAuth API 端点。检索客户端 ID 和客户端密钥。

4. 填写所需信息：

   1. 名称：唯一名称。
   2. 重定向网址：https://vertexaisearch.cloud.google.com/console/oauth/servicenow_oauth.html。

5. 点击提交以创建凭据。

6. 提交后，点击该名称即可查看客户端密钥。

7. 系统会遮盖 Secret。点击旁边的锁形图标以取消隐藏并查看 Secret。

8. 保留客户端 ID 和密钥的副本，以便在需要时使用。

9. 前往 developer.service-now.com，然后点击管理实例密码。

10. 请保留用户名和密码的副本，以备在需要时使用。

11. 至此，您已获得设置 ServiceNow 数据存储区所需的全部五项信息。如果您不介意使用“管理员”角色提取数据，请继续创建数据存储区。

设置角色和权限

您必须拥有安全管理员角色，才能创建和管理用户。如果您没有此角色，请点击个人资料下的提升角色，将角色提升为 security_admin。选择 security_admin 角色，然后点击更新。您必须拥有 security_admin 角色，才能创建角色和管理用户。

1. 创建具有 ACL 规则的自定义角色：

   1. 依次选择全部 > 用户管理 > 角色。
   2. 点击新建以创建新角色。
   3. 选择一个名称，然后点击提交。
   4. 依次前往系统安全 > 访问控制 (ACL)，以创建新的 ACL 规则。
   5. 点击新建以创建新的 ACL 规则。
   6. 选择一个角色，例如 sys_user_role。
   7. 点击提交，然后分配角色。

   8. 重复此过程，直到授予所有表访问权限。连接器需要访问以下表，才能成功运行每个实体：

      1. 事故：incident。
      2. 目录项：sc_cat_item、sc_cat_item_user_criteria_mtom、sc_cat_item_user_criteria_no_mtom、sc_cat_item_user_mtom、sc_cat_item_user_no_mtom。
      3. 知识：kb_knowledge、kb_knowledge_base、kb_uc_can_read_mtom、kb_uc_can_contribute_mtom。
      4. 附件：所有列出的项。
      5. 身份：sys_user_role、sys_user_has_role、sys_user_group、sys_user_grmember、sys_user。
      6. 随着新条件的提取而更新：core_company、cmn_location、cmn_department。
      7. 用户条件：user_criteria。

   9. 在搜索栏中前往 sys_security_acl_role_list.do，验证所有 ACL 是否均已更新。

   10. 选择要验证的角色。

   11. 确认已向所选角色分配所有必需的 ACL。

2. 将角色授予服务账号：

   1. 依次前往全部 > 用户管理 > 用户，然后选择相应用户。
   2. 找到要授予角色的用户，然后选择该用户。

3. 如果没有可用的用户，请依次前往系统安全 > 用户和群组 > 用户。

4. 点击新建，在用户表中创建新的服务账号。

5. 请务必勾选仅限 Web 服务访问权限复选框。

6. 前往页面底部的角色表格。

7. 点击右侧的修改。

8. 授予之前创建的角色，并将其分配给用户。根据创建的角色类型，选择适当的角色并进行分配。

9. 获取用户的用户名和密码。在同一页面上，点击设置密码。

10. 自动生成密码并将其保存以供日后使用：

    1. 用户 ID：manager。
    2. 密码：输入自动生成的密码。

配置员工池

请按照相关说明使用以下任一配置设置员工池：

1. Azure OIDC 设置
2. Azure SAML 设置
3. Okta 和 OIDC 设置
4. Okta 和 SAML 设置

创建 ServiceNow 连接器

控制台

如需使用 Google Cloud 控制台将数据从 ServiceNow 同步到 Vertex AI Search，请按以下步骤操作：

1. 在 Google Cloud 控制台中，前往 Agent Builder 页面。

   Agent Builder

2. 在导航菜单中，点击数据存储空间。

3. 点击 创建数据存储区。

4. 在选择数据源页面上，滚动或搜索 ServiceNow 以关联第三方来源。

5. 输入您的 ServiceNow 身份验证信息。

6. 选择要同步的实体，然后点击继续。

7. 为数据连接器选择一个区域。

8. 为数据连接器输入名称。

9. 选择同步频率。

10. 点击创建。Vertex AI Search 会创建数据存储区，并在数据存储区页面上显示您的数据存储区。

11. 如需查看数据注入的状态，请前往数据存储区页面，然后点击数据连接器名称，在其数据页面上查看相关详细信息。连接器开始同步数据时，连接器状态会从“正在创建”更改为“正在运行”。提取完成后，状态会变为有效，表示已设置与数据源的连接，并正在等待下一次预定的同步。

    提取过程可能需要几分钟到几小时才能完成，具体取决于数据的大小。

后续步骤

• 如需将数据存储区附加到应用，请按照创建搜索应用中的步骤创建应用并选择数据存储区。

• 请参阅预览具有第三方访问权限控制功能的应用的结果。

连接 SharePoint Online

请按照以下步骤将数据从 SharePoint Online 同步到 Vertex AI Search。

预览版：第三方连接器目前处于预览版阶段，需要通过许可名单授权。您必须列入许可名单才能使用此功能。

您首次设置数据源并导入数据后，数据存储区会按照您在设置期间选择的频率同步来自该数据源的数据。

准备工作

在设置连接之前，请执行以下操作：

1. 为数据源设置访问权限控制。如需了解如何设置访问权限控制，请参阅使用数据源访问权限控制。

2. 授予管理员同意书。如需了解如何授予意见征求，请参阅 Microsoft Entra 文档中的向应用授予租户级管理员意见征求。

3. 准备以下 Sharepoint Online 身份验证信息，以便在设置过程中使用：

   1. 实例网址。采用 http://DOMAIN_OR_SERVER/[sites/]WEBSITE 的形式。

   2. 联合身份验证需要租户 ID 和客户端 ID，而 OAuth 需要租户 ID、客户端 ID 和客户端密钥。如需注册应用，请为登录受众群体选择仅此组织目录中的账号，然后找到此身份验证信息。如需了解详情，请参阅 Microsoft Entra 文档中的快速入门：向 Microsoft 身份平台注册应用。

   3. 注册应用时，请使用 https://vertexaisearch.cloud.google.com/console/oauth/confluence_oauth.html 作为 Web 回调网址。

   4. 配置应用权限时，请为 Graph API 添加以下应用权限：

      查看范围

      • GroupMember.Read.All
      • Sites.FullControl.All
      • User.Read.All

   5. 配置应用权限时，请为 Sharepoint REST API 添加以下委托权限：

      查看范围

      • AllSites.FullControl

4. 下表介绍了建议配置的角色及其限制。

查看角色

角色	客户端应用注册	提取所有实体的内容	提取 ACL	提取身份	备注
网站管理员	否	是	是	是
网站集管理员	否	是	是	是
全球管理员	是	否	是	否	限制：全局管理员无法提取身份实体或评论和附件实体。
网站所有者	否	是	是	否	限制：网站所有者与 Microsoft 365 管理中心 / Entra 管理中心相关，并非仅限于 SharePoint。
应用管理员	是	不适用	不适用	不适用	应用管理员角色与 Microsoft 365 管理中心 / Entra 管理中心相关。并非仅限于 SharePoint。

您可以使用此方法精细控制 SharePoint REST API 权限，从而限制用户账号对资源的访问权限。请务必创建新的 SharePoint 用户，这可能会增加许可费用。使用 OAuth 2.0 刷新令牌方法设置 Entra 应用注册，并启用对 SharePoint 的安全访问。

配置 Entra 应用注册

设置 Entra 应用注册，以便安全地访问 SharePoint。您可以选择使用基于令牌的访问权限联合凭据或用于精细控制的 OAuth 2.0 刷新令牌。请按照以下步骤配置应用注册、授予权限和建立身份验证。

1. 联合凭据：设置联合凭据，以便 Google 能够使用经过加密签名的令牌安全地访问 SharePoint，从而避免使用真实用户正文。如需配置权限并授予访问权限，请执行以下操作：

   1. 获取服务账号客户端 ID：

      1. 在 Google Cloud 控制台中，前往 Agent Builder 页面。
      2. 在导航菜单中，点击数据存储空间。
      3. 点击 创建数据存储区。
      4. 在选择数据源页面上，滚动或搜索 SharePoint Online 以连接第三方来源。
      5. 记下主题标识符。

   2. 在 Microsoft Entra 中注册应用：

      1. 前往 Entra 管理中心。

      2. 创建应用注册：

         • 支持的账号类型：仅组织目录中的账号。
         • 保留其他默认设置，然后点击注册。

      3. 记下客户端 ID 和租户 ID。

   3. 添加联合凭据：

      1. 依次点击 Certificates & secrets（证书和密钥）> Federated credentials（联合凭据）> Add credential（添加凭据）。

      2. 使用以下设置：

         • 签发者：https://accounts.google.com
         • 主题标识符：使用所述的主题标识符。
         • 名称：提供唯一的名称。

      3. 点击添加以授予访问权限。

   4. 设置 API 权限：

      1. 添加并授予以下权限的管理员同意：

         • GroupMember.Read.All（应用）：读取所有群组成员资格。
         • Sites.Read.All（应用）：读取所有网站。
         • User.Read.All（应用）：读取所有用户的完整个人资料。
         • Sites.FullControl.All（应用）：对所有网站拥有完全控制权。

      2. 使用 Sites.Selected 分配特定网站权限，而不是 Sites.FullControl.All。无法通过界面直接配置 Sites.Selected。选择 Sites.Selected 后，您必须调用 Microsoft Graph API，以便为要抓取的网站向应用明确授予 fullcontrol 角色。

      3. 授予 Sites.Read.All 以抓取根网站网址下的所有子网站。

2. OAuth 2.0 刷新令牌：使用 SharePoint 用户的客户端密钥和刷新令牌配置 OAuth 2.0 身份验证，以便对 SharePoint API 访问进行精细控制。如需设置应用注册、添加客户端密钥并分配 API 权限，请执行以下操作：

   1. 创建应用注册：

      1. 前往 Entra 管理中心。

      2. 创建应用注册：

         • 支持的账号类型：仅组织目录中的账号。
         • 重定向 URI：https://vertexaisearch.cloud.google.com/console/oauth/sharepoint_oauth.html。

      3. 记下客户端 ID 和租户 ID。

   2. 添加客户端密钥：

      1. 依次前往证书和密钥 > 新建客户端密钥。

      2. 记下 Secret 字符串。

   3. 设置 API 权限：

      1. 添加并授予以下权限的管理员同意：

         • GroupMember.Read.All：读取所有群组成员资格。
         • Sites.FullControl.All：对所有网站集合拥有完全控制权。
         • User.Read.All：读取所有用户的完整个人资料。
         • AllSites.FullControl：对所有网站拥有完全控制权。

      2. 使用对特定网站的访问权限受限的专用用户账号。

      3. 确保该账号对所选网站拥有所有者访问权限。

创建 SharePoint Online 连接器

控制台

如需使用 Google Cloud 控制台将数据从 Sharepoint Online 同步到 Vertex AI Search，请按以下步骤操作：

1. 在 Google Cloud 控制台中，前往 Agent Builder 页面。

   Agent Builder

2. 在导航菜单中，点击数据存储空间。

3. 点击 创建数据存储区。

4. 在选择数据源页面上，滚动或搜索 SharePoint Online 以连接第三方来源。

5. 输入您的 Sharepoint Online 身份验证信息，然后点击验证。

6. 输入 SharePoint 网站网址：

   • 对于单个网站：https://<domain_name>.sharepoint.com/sites/<site_name>。
   • 对于所有第一级网站：https://<domain_name>.sharepoint.com。

7. 选择要同步的实体，然后点击继续。

8. 为您的数据存储区选择一个区域。

9. 为数据存储区输入名称。

10. 为数据存储区选择同步频率。

11. 点击创建。Vertex AI Search 会创建数据存储区，并在数据存储区页面上显示您的数据存储区。

12. 如需查看数据注入状态，请前往数据存储区页面，然后点击数据存储区名称，在其数据页面上查看相关详细信息。当连接器开始同步数据时，连接器状态会从正在创建变为正在运行。提取完成后，状态会变为有效，表示已设置与数据源的连接，并正在等待下一次预定的同步。

    提取过程可能需要几分钟或几小时，具体取决于数据的大小。

测试搜索引擎

配置搜索引擎后，请测试其功能。这样可以确保它根据用户访问权限返回准确的结果。

1. 启用 Web 应用：

   1. 前往应用集成配置，然后切换到启用网站应用。

2. 测试 Web 应用：

   1. 点击 Web 应用链接旁边的打开，然后使用您的员工队伍中的用户登录。

   2. 验证搜索结果是否仅限于已登录用户可以访问的内容。

注意： 如果您在使用 Microsoft ID 登录时遇到问题，请验证该用户是否已添加到 Microsoft Entra 上的企业应用的用户名单中。

配置员工池

借助员工池，您可以在 Google Cloud 控制台中管理和对来自外部身份提供方（例如 Azure 或 Okta）的用户进行身份验证。如需配置员工池并启用 Web 应用以实现顺畅的用户访问，请执行以下操作：

1. 按照相应的设置手册在 Google Cloud 中在组织一级创建员工队伍：

   1. Azure OIDC 设置
   2. Azure SAML 设置
   3. Okta 和 OIDC 设置
   4. Okta 和 SAML 设置

2. 在 Agent Builder > Settings（设置）中，为您创建应用所在的区域配置员工池。

后续步骤

• 如需将数据存储区附加到应用，请按照创建搜索应用中的步骤创建应用并选择数据存储区。

• 请参阅预览具有第三方访问权限控制功能的应用的结果。

关联 Slack

请按照以下步骤将数据从 Slack 同步到 Vertex AI Search。

预览版：第三方连接器目前处于预览版阶段，需要通过许可名单授权。您必须列入许可名单才能使用此功能。

您首次设置数据源并导入数据后，数据存储区会按照您在设置期间选择的频率同步来自该数据源的数据。

准备工作

在设置连接之前，请执行以下操作：

1. 为数据源设置访问权限控制。如需了解如何设置访问权限控制，请参阅使用数据源访问权限控制。

2. 请与工作区所有者联系，让其授予您在工作区中安装新应用的权限。

3. 准备以下 Slack 身份验证信息：

   1. 工作区 ID：请按照 Slack 文档中为数据存储区指定 Slack 来源中的说明获取工作区 ID。

   2. 访问令牌：创建客户端应用并定义所需的范围。如需了解详情，请参阅 Slack 文档中的快速入门和如何快速获取和使用 Slack API 令牌。

   3. 设置 OAuth 2.0 权限范围时，请配置以下范围：

      查看范围

      • users:read.email
      • channels:history
      • channels:read
      • groups:history
      • groups:read
      • im:history
      • im:read
      • mpim:history
      • mpim:read
      • team:read
      • users:read
      • files:read

4. 默认情况下，Slack 会限制抓取和同步私人频道、群组消息和私信中的内容。

配置 Slack 应用

获取访问令牌，以允许 Vertex AI Search 从您的 Slack 工作区注入文档。

注意 ：创建 Slack 应用，然后根据您的要求选择聊天机器人令牌（生成聊天机器人令牌）或用户令牌（生成用户令牌）。

1. 生成聊天机器人令牌，以安全地访问私密渠道、即时消息 (IM) 和多方即时消息 (MPIM)。聊天机器人令牌无法抓取其不属于的公开频道，加入公开频道会生成加入消息。

   1. 登录 Slack API 应用。
   2. 点击创建新应用。
   3. 选择从头开始。
   4. 输入应用的名称，然后选择要集成到其中的工作区。
   5. 点击创建应用。
   6. 点击 OAuth & Permissions（OAuth 和权限）。
   7. 在 Bot 令牌范围下，添加以下必需的范围：

      查看范围

      • users:read.email
      • channels:history
      • channels:read
      • groups:history
      • groups:read
      • im:history
      • im:read
      • mpim:history
      • mpim:read
      • team:read
      • users:read
      • files:read

   默认情况下，聊天机器人会从 #general 和 #random 通道读取数据。

   1. 如需启用抓取功能，请执行以下操作：

      1. 对于公开频道，请授予 channels:join 范围，以允许聊天机器人自动加入。
      2. 对于私人渠道，请手动邀请聊天机器人。

   2. 点击安装到您的用户名工作区。

   3. 按照屏幕上的说明安装应用并检索聊天机器人令牌。

2. 生成用户令牌，以便无需先加入即可访问所有公开频道。除非用户拥有访问权限，否则用户令牌无法抓取私享频道、即时通讯或 MPIM。

   1. 登录 Slack API 应用。
   2. 点击创建新应用。
   3. 选择从头开始。
   4. 输入应用的名称，然后选择要集成到其中的工作区。
   5. 点击创建应用。
   6. 点击 OAuth & Permissions（OAuth 和权限）。

   7. 在用户令牌范围下，添加以下必需的范围：

      查看范围

      • users:read.email
      • channels:history
      • channels:read
      • groups:history
      • groups:read
      • im:history
      • im:read
      • mpim:history
      • mpim:read
      • users:read
      • files:read

   8. 点击安装到您的用户名工作区。

   9. 按照屏幕上的说明安装应用并检索用户令牌。

创建 Slack Cloud 连接器

控制台

如需使用 Google Cloud 控制台将数据从 Slack 同步到 Vertex AI Search，请按以下步骤操作：

1. 在 Google Cloud 控制台中，前往 Agent Builder 页面。

   Agent Builder

2. 在导航菜单中，点击数据存储空间。

3. 点击 创建数据存储区。

4. 在选择数据源页面上，滚动或搜索 Slack 以关联第三方来源。

5. 输入您的 Slack 身份验证信息。

   • 实例 ID（工作区 ID）：通过浏览器登录您的 Slack 工作区即可获取此 ID。工作区 ID 是网址中 /client 后面的路径段。
   • 身份验证令牌：使用上一部分中获取的令牌。

6. 选择要同步的实体，然后点击继续。

7. 为您的数据存储区选择一个区域。

8. 为数据存储区输入名称。

9. 为数据存储区选择同步频率。

10. 点击创建。Vertex AI Search 会创建数据存储区，并在数据存储区页面上显示您的数据存储区。

11. 如需查看数据注入状态，请前往数据存储区页面，然后点击数据存储区名称，在其数据页面上查看相关详细信息。当连接器开始同步数据时，连接器状态会从正在创建变为正在运行。提取完成后，状态会变为有效，表示已设置与数据源的连接，并正在等待下一次预定的同步。

    提取过程可能需要几分钟或几小时，具体取决于数据的大小。

后续步骤

• 如需将数据存储区附加到应用，请按照创建搜索应用中的步骤创建应用并选择数据存储区。

• 请参阅预览具有第三方访问权限控制功能的应用的结果。

关联 Trello

请按照以下步骤将数据从 Trello 同步到 Vertex AI Search。

预览版：第三方连接器目前处于预览版阶段，需要通过许可名单授权。您必须列入许可名单才能使用此功能。

您首次设置数据源并导入数据后，数据存储区会按照您在设置期间选择的频率同步来自该数据源的数据。

注意： 此连接器提供部分 ACL 支持。在非公开预览版期间，系统会验证用户网域，但不支持精细的用户验证。

准备工作

在设置连接器之前，请确保已完成以下步骤：

1. 验证您是否拥有 Trello 管理员访问权限。Trello 管理员必须在下一部分中生成 API 密钥和令牌。
2. 检查您的项目是否已添加到许可名单中，以便使用 Trello。
3. 为数据源设置访问权限控制。如需了解如何设置访问权限控制，请参阅使用数据源访问权限控制。

在 Trello 中生成 API 密钥和令牌

Trello 管理员必须执行以下步骤：

1. 创建一个 Trello 强大的功能来生成 API 密钥。
2. 前往 Trello 的“管理”页面。
3. 前往“API 密钥”标签页，然后选择用于生成新 API 密钥的选项。
4. 点击令牌。
5. 点击允许。
6. 复制令牌。

如需详细了解 Trello API，请参阅 API 简介。

创建 Trello 连接器

控制台

如需使用 Google Cloud 控制台将数据从 Trello 同步到 Vertex AI Search，请按以下步骤操作：

1. 在 Google Cloud 控制台中，前往 Agent Builder 页面。

   Agent Builder

2. 在导航菜单中，点击数据存储空间。

3. 点击 创建数据存储区。

4. 在选择数据源页面上，滚动或搜索 Trello 以关联第三方来源。

5. 输入您的 Trello 身份验证信息，然后点击继续。

6. 可选：如需路由 HTTP 流量，请点击添加目标位置，然后输入代理服务器的主机名或 IP 地址。然后点击继续。

7. 选择要同步的实体，然后点击继续。

8. 为您的数据存储区选择一个区域。

9. 为数据连接器输入名称。

10. 选择同步频率。

11. 点击创建。Vertex AI Search 会创建数据存储区，并在数据存储区页面上显示您的数据存储区。

12. 如需查看数据提取状态，请前往数据存储区页面，然后点击连接器名称，在其数据页面上查看相关详细信息。当连接器开始同步数据时，连接器状态会从正在创建变为正在运行。提取完成后，状态会变为有效，表示已设置与数据源的连接，并正在等待下一次预定的同步。

    提取过程可能需要几分钟到几小时才能完成，具体取决于数据的大小。

后续步骤

• 如需将连接器附加到应用，请按照创建搜索应用中的步骤创建应用并选择连接器。

• 如需预览应用设置完毕后搜索结果的显示方式，请参阅获取搜索结果。如果您使用了第三方访问权限控制，请参阅预览启用了第三方访问权限控制的应用的结果。

关联 Workday

请按照以下步骤将数据从 Workday 同步到 Vertex AI Search。

预览版：第三方连接器目前处于预览版阶段，需要通过许可名单才能使用。您必须列入许可名单才能使用此功能。

您首次设置数据源并导入数据后，数据存储区会按照您在设置期间选择的频率同步来自该数据源的数据。

注意： 不支持对 Workday 进行访问权限控制。

准备工作

在创建 Workday 连接器之前，请执行以下操作：

1. 除了第三方连接器许可名单之外，此连接器还要求将您的项目添加到另一个许可名单中。如需添加到此许可名单，请与您的 Vertex AI Search 客户支持团队联系。

2. Workday 管理员必须生成或获取以下内容，才能与 Vertex AI Search 集成：

   1. 客户端 ID。从 Workday 中的“查看 API 客户端”页面获取。
   2. 客户端密钥。从 Workday 中的“查看 API 客户端”页面获取。
   3. 刷新令牌。从 Workday 中的“查看 API 客户端”页面获取。
   4. 可选：代理服务器。要将 HTTP 流量路由到的代理的主机名或 IP 地址。
   5. 可选：基准网址。Workday 连接的基准网址。
   6. 可选：API 网址。用于发出 SOAP 请求的 API 端点的完整网址。例如：https://<var>host</var>.workday.com/ccx/service/<var>tenant</var>/<var>service</var>。
   7. Workday 租户。账号的租户。例如 abc_cms1。您可以在 Workday 实例配置详情中获取租户的名称。

3. 为数据源设置访问权限控制。如需了解如何设置访问权限控制，请参阅使用数据源访问权限控制。

创建 Workday 连接器

控制台

如需使用 Google Cloud 控制台将数据从 Workday 同步到 Vertex AI Search，请按以下步骤操作：

1. 在 Google Cloud 控制台中，前往 Agent Builder 页面。

   Agent Builder

2. 在导航菜单中，点击数据存储空间。

3. 点击 创建数据存储区。

4. 在选择数据源页面上，滚动或搜索 Workday 以关联第三方来源。

5. 输入您的 Workday 身份验证信息，然后点击继续。

6. 可选：输入您的 Workday 目标账号信息，然后点击继续。

7. 输入您的 Workday 租户，然后点击继续。

8. 选择要同步的实体，然后点击继续。

9. 为您的数据存储区选择一个区域。

10. 为数据连接器输入名称。

11. 选择同步频率。

12. 点击创建。Vertex AI Search 会创建数据存储区，并在数据存储区页面上显示您的数据存储区。

13. 如需查看数据提取状态，请前往数据存储区页面，然后点击连接器名称，在其数据页面上查看相关详细信息。当连接器开始同步数据时，连接器状态会从正在创建变为正在运行。提取完成后，状态会变为有效，表示已设置与数据源的连接，并正在等待下一次预定的同步。

    提取过程可能需要几分钟到几小时才能完成，具体取决于数据的大小。

后续步骤

• 如需将连接器附加到应用，请按照创建搜索应用中的步骤创建应用并选择连接器。

• 如需预览应用设置完毕后搜索结果的显示方式，请参阅获取搜索结果。如果您使用了第三方访问权限控制，请参阅预览启用了第三方访问权限控制的应用的结果。

关联 Zendesk

请按照以下步骤将数据从 Zendesk 同步到 Vertex AI Search。

预览版：第三方连接器目前处于预览版阶段，需要通过许可名单授权。您必须列入许可名单才能使用此功能。

您首次设置数据源并导入数据后，数据存储区会按照您在设置期间选择的频率同步来自该数据源的数据。

准备工作

在设置连接之前，请执行以下操作：

1. 除了第三方连接器许可名单之外，此连接器还要求将您的项目添加到另一个许可名单中。如需添加到此许可名单，请与您的 Vertex AI Search 客户支持团队联系。

2. 为数据源设置访问权限控制。如需了解如何设置访问权限控制，请参阅使用数据源访问权限控制。

3. Zendesk 管理员必须生成或获取以下内容，才能与 Vertex AI Search 集成：

   1. 访问令牌。Zendesk 实例的 API 令牌。
   2. 实例 URI。

创建 Zendesk 连接器

控制台

如需使用 Google Cloud 控制台将数据从 Zendesk 同步到 Vertex AI Search，请按以下步骤操作：

1. 在 Google Cloud 控制台中，前往 Agent Builder 页面。

   Agent Builder

2. 在导航菜单中，点击数据存储空间。

3. 点击 创建数据存储区。

4. 在选择数据源页面上，滚动或搜索 Zendesk 以关联第三方来源。

5. 输入您的 Zendesk 身份验证信息，然后点击继续。

6. 选择要同步的实体，然后点击继续。

7. 为您的数据存储区选择一个区域。

8. 为数据连接器输入名称。

9. 选择同步频率。

10. 点击创建。Vertex AI Search 会创建数据存储区，并在数据存储区页面上显示您的数据存储区。

11. 如需查看数据提取状态，请前往数据存储区页面，然后点击连接器名称，在其数据页面上查看相关详细信息。当连接器开始同步数据时，连接器状态会从正在创建变为正在运行。提取完成后，状态会变为有效，表示已设置与数据源的连接，并正在等待下一次预定的同步。

    提取过程可能需要几分钟到几小时才能完成，具体取决于数据的大小。

后续步骤

• 如需将连接器附加到应用，请按照创建搜索应用中的步骤创建应用并选择连接器。

• 如需预览应用设置完毕后搜索结果的显示方式，请参阅获取搜索结果。如果您使用了第三方访问权限控制，请参阅预览启用了第三方访问权限控制的应用的结果。