连接第三方数据源

注意 ：此功能为预览版，受 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。

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

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

准备工作

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

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

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

• 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。

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

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

准备工作

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

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

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

• 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。

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

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

准备工作

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

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

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

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

• 创建 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 应用

配置 Box 应用的设置。

创建公钥/私钥

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

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

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

配置所需权限

1. 在应用范围部分，选择以下权限：
   • 读取存储在 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。

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

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

准备工作

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

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

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

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

  • Coda API 令牌。

创建 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。

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

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

准备工作

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

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

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

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

按照以下部分中的说明操作，确保您拥有对 Confluence 实例的必要身份验证详细信息和管理员访问权限。通过 Atlassian 开发者控制台创建客户端 ID 和客户端密钥，配置所需的 OAuth 2.0 范围，并为用户设置权限。检索实例网址和 ID、配置角色并进行身份验证，以便在 Confluence Cloud 和 Vertex AI Search 之间同步数据。

- Instance ID. This is the `cloudid` and is available on
  <code>https://<var>EXAMPLE</var>.atlassian.net/_edge/tenant_info</code>
  and copying the value of `cloudId`.

• 启用 OAuth 2.0 并获取客户端 ID 和客户端密钥。
  • 前往 Confluence API。
  • 点击添加。

  • 点击配置。

    b. 前往精细镜重标签页，然后点击修改镜重。选择以下范围：

    视图范围

    • read:attachment:confluence
    • read:configuration:confluence
    • read:content.metadata:confluence
    • read:content-details:confluence
    • read:group:confluence
    • read:space:confluence
    • read:user:confluence

  确认已选择 7 个镜重，然后保存更改。

1. 点击分发。

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

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

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

检索实例网址和实例 ID

获取实例网址：

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

获取实例 ID：

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

设置权限和角色

如需向 Confluence 管理员授予 Discovery Engine 编辑者角色，请执行以下操作：

1. 前往您的 Atlassian 网域网站，然后打开 Confluence Cloud 实例。
2. 前往 IAM。
3. 向 Confluence 管理员授予 Discovery Engine 角色。这样，Confluence 管理员就可以按照创建 Confluence Cloud 连接器中所述的方式配置连接器。

如需向用户授予管理员角色，请执行以下操作：

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

如需在 Atlassian 中配置权限，请执行以下操作：

1. 前往您的 Atlassian 网域网站，然后打开 Confluence Cloud 实例。
2. 点击菜单图标，然后选择所需选项。
   • 或者，您也可以直接访问 admin.atlassian.com。
3. （可选）如果系统提示，请从着陆页中选择合适的组织。

如需创建和配置组，请执行以下操作：

1. 在管理员页面上，点击管理用户按钮（如有）。
   • 从下拉列表中选择管理用户。
2. 在用户管理页面上，选择群组。
3. 点击创建群组，然后指定名称。
   • 使用此组分配连接器所需的权限。
4. 向群组添加权限：分配用户访问权限管理员角色。

如需分配群组成员，请执行以下操作：

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 同步。

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

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

准备工作

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

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

Private Service Connect 配置指南

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

• 网络配置：

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

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

  • 对于基于代理/HTTP(s) 的负载平衡器（L4 代理 ILB、L7 ILB），请将后端配置为接受来自虚拟私有云网络中的代理子网的请求。
  • 如需了解详情，请参阅基于 Envoy 的负载平衡器的代理专用子网文档。

• 防火墙规则：

  a. 入站规则：

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

  b. 出站规则：

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

其他注意事项：

• 请确保将所有组件（包括 PSC 服务连接和负载均衡器）都放在同一区域。

生成服务连接

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

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

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

3. 对于专用端点：

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

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

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

   d. （可选）设置健康检查探针以监控后端健康状况。

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

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

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

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

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

以管理员身份登录

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

创建新用户

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

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

将用户分配给群组

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

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

配置用户权限

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

配置文档空间

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

创建 Confluence Data Center 本地连接器

设置 Confluence Data Center 本地连接器，以便与 Google Cloud同步数据。首先，在 Agent Builder 中创建数据存储区，并配置连接设置，包括身份验证和同步偏好设置。

#### 创建 Confluence Data Center 本地连接器

控制台

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

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

后续步骤

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

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

关联 Dropbox

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

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

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

准备工作

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

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

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

  • 客户端 ID
  • 客户端密钥

控制台

如需使用 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 连接器之前，请执行以下操作：

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

  • 客户端 ID
  • 客户端密钥
  • Azure 租户
  • 组织网址。例如 https://abc123.cloudax.dynamics.com/。

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

创建 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。

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

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

准备工作

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

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

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

• GitHub 管理员必须获得以下权限才能与 Vertex AI Search 集成：

  • GitHub 实例个人访问令牌。

创建 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。

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

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

准备工作

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

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

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

• GitLab 管理员必须获得以下权限才能与 Vertex AI Search 集成：

  • GitLab 实例个人访问令牌。

创建 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。

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

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

准备工作

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

• 验证您是否对 Jira 实例和项目拥有管理员访问权限。
• 设置访问权限控制。确保为数据源正确配置了访问权限控制。此步骤可确保只有获得授权的用户才能访问和管理数据。如需了解详情，请参阅使用数据源访问权限控制文档。
• 为了正确应用用户权限，Jira Cloud 用户必须提供共享同意声明。
• 确保您拥有 Atlassian 账号、Jira 实例和项目。

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

请按照以下部分中的说明操作，确保您拥有必要的身份验证详细信息以及对 Jira 实例的管理员访问权限。通过 Atlassian 开发者控制台创建客户端 ID 和客户端密钥，配置所需的 OAuth 2.0 范围，并为用户设置权限。检索实例网址和 ID、配置角色并进行身份验证，以便在 Jira Cloud 和 Vertex AI Search 之间同步数据。

创建客户端 ID 和客户端密钥

如需启用 OAuth 2.0 并获取客户端 ID 和密钥，请参阅 Atlassian Developer 文档中的 OAuth 2.0 (3LO) 应用。

如需在 Atlassian Developer 控制台中创建 OAuth 2.0 集成，请执行以下操作：

1. 登录 developer.atlassian.com。
2. 点击右上角的个人资料图标，然后选择 Developer Console（开发者控制台）。
3. 点击创建，然后选择 OAuth 2.0 集成。

4. 输入应用的名称。

   • 勾选条款及条件复选框。
   • 点击创建。
   • 点击授权。
   • 在授权类型表格中，针对 OAuth 2.0 (3LO) 选择添加。

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

6. 点击保存更改。

如果您看到以下警告：您的应用没有任何 API。如需向应用添加 API，请执行以下操作：

1. 选择权限：

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

     视图范围

     • read:avatar:jira
     • read:audit-log:jira
     • read:group:jira
     • read:issue-security-level:jira
     • read:issue-security-scheme:jira
     • read:jira-user
     • read:jira-work
     • read:user:jira

   确认已选择 8 个镜重，然后保存更改。

2. 点击分发。

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

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

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

检索实例网址和实例 ID

获取实例网址：

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

获取实例 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 以关联第三方来源。

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 同步。

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

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

准备工作

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

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

Private Service Connect 配置指南

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

• 网络配置：

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

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

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

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

• 防火墙规则：

  a. 入站规则：

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

  b. 出站规则：

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

其他注意事项：

• 请确保将所有组件（包括 PSC 服务连接和负载均衡器）都放在同一区域。

生成服务连接

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

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

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

3. 对于专用端点：

   a. 使用 PSC 可允许从私有实例连接到 Google Cloud。

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

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

   d. （可选）设置健康检查探测来监控后端健康状况。

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

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

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

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

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

以管理员身份登录

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

创建新用户

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

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

将用户分配给群组

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

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

配置用户权限

1. 在管理页面中，前往问题标签页。
2. 选择权限架构。
3. 点击添加权限方案。
4. 为方案输入名称，然后点击添加。
5. 选择方案，然后点击权限图标。
6. 点击授予权限。
7. 添加以下权限，将这些权限分配给之前创建的组，然后点击授予：
   • 浏览项目。
   • 浏览项目归档。

您可以将此架构添加到需要该群组用户访问权限才能查看该项目以及该项目中的工单、评论、工作日志和附件的项目。

配置应用访问权限

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

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

创建 Jira Data Center 本地连接器

设置 Jira Data Center 本地连接器，以便与 Google Cloud同步数据。首先，在 Agent Builder 中创建数据存储区，并配置连接设置，包括身份验证和同步偏好设置。

创建 Jira Data Center 本地连接器

控制台

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

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

   Agent Builder

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

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

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

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

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

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

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

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

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

11. 选择同步频率。

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

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

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

后续步骤

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

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

关联 Microsoft Outlook

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

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

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

准备工作

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

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

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

• 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。

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

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

准备工作

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

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

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

• 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 支持。在非公开预览版期间，系统会验证用户网域，但不支持精细的用户验证。

准备工作

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

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

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

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

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

创建 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。

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

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

准备工作

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

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

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

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

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

    配置以下镜重：

    查看范围

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

控制台

如需使用 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。

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

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

准备工作

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

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

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

  • 实例网址：您的 Salesforce 实例的域名。搜索我的网域，复制以 my.salesforce.com 结尾的域名，然后在开头添加 https://。
  • 客户端 ID：点击管理客户详情，从关联的应用复制客户端 ID。如果启用了刷新令牌，请验证令牌是否已刷新，并在创建数据存储区时提供最新的令牌。
  • 客户端密钥：点击管理客户详细信息，从关联的应用复制客户端密钥。如果启用了刷新令牌，请验证令牌是否已刷新，并在创建数据存储区时提供最新的令牌。

• 为了正确应用用户权限，Salesforce 用户必须提供分享同意。

• 使用企业版或开发者版方案。不支持试用账号。

• 确保您使用的是 Sales Cloud。不支持 Service Cloud。

• 将 Google Cloud 添加到 Salesforce CORS 许可名单。如果您已完成此任务，请前往“创建应用”部分。

  • 按照 Salesforce 文档中的说明配置 CORS 许可名单。
  • 输入 https://console.cloud.google.com/ 作为源网址，然后保存配置。

创建应用

Salesforce 支持以下应用：

1. 关联的应用。
2. 外部客户端应用。

创建关联的应用

如需在 Salesforce 中设置关联应用以与 Google Cloud集成，请执行以下操作：

1. 登录 Salesforce。
2. 点击齿轮图标，然后前往设置。
3. 在 Setup 菜单下，前往 App Manager。
4. 点击 New connected app。

5. 如需配置关联的应用，请执行以下操作：

   a. 在关联的应用创建页面中，执行以下操作：

   • 选中启用 OAuth 设置。
   • 将回调网址设置为：https://vertexaisearch.cloud.google.com/console/oauth/salesforce_oauth.html。
   • 选择以下 OAuth 范围：
     • 完全访问权限 (full)。
     • 随时执行请求 (refresh_token, offline_access)。

   b. 启用以下流程：

   • 客户端凭据流程。
   • 授权代码和凭据流程。
   • 授权代码和凭据流程的 POST 正文中的用户凭据。
   • 对于客户端凭据流程，请在以此身份运行字段中指定您的用户名。您必须对连接器可以提取的所有实体拥有读取权限。

创建关联的应用后，请执行以下操作：

1. 修改应用政策：

   • 前往 App Manager（应用管理器），然后修改新创建的应用。
   • 将 IP Relaxation（IP 放宽）设置为 Relax IP restrictions。
   • 根据需要将刷新令牌政策配置为 Valid until revoked 或更严格的设置。
   • 确保允许的用户已设为 All users may self-authorize。

2. 配置 IP 限制：

   • 如果启用了组织级 IP 地址范围强制执行，请依次前往安全 > 网络访问，然后设置受信任的 IP 地址范围。如需了解详情，请参阅关联的应用 IP 放宽和持续 IP 违规处置文档。
   • 如果不需要 IP 地址限制，请停用对每项请求强制执行登录 IP 地址范围限制。

3. 配置 OAuth 关联的应用：

   • 请使用以下指南配置 OAuth 关联的应用：
     • 关联应用基础知识。
     • API 集成。
     • 客户端凭据设置。

4. 保存关联的应用：

   • 保存并退出关联的应用。
   • 在搜索栏中，搜索 OAuth and OpenId connect settings（OAuth 和 OpenId Connect 设置）。
   • 启用允许使用授权代码和凭据流程以及 OAuth 用户名-密码流程。

创建外部客户端应用

如需在 Salesforce 中创建和配置外部客户端应用，以便为集成启用基于 OAuth 的身份验证，请执行以下操作：

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

   • 登录 Salesforce。
   • 点击齿轮图标，然后前往设置。
   • 依次前往设置 > 应用 > 外部客户端应用。
   • 点击新建外部客户端应用。

2. 提供所需信息：

   • 输入应用名称和您的电子邮件地址。默认情况下，系统会自动填充 API 名称。
   • 将分发状态保留为 Local。

3. 启用 OAuth 设置：

   • 展开 API（启用 OAuth 设置），然后选择 Enable OAuth（启用 OAuth）。
   • 配置：
     • 回调网址：https://login.salesforce.com/services/oauth2/callback
     • OAuth 范围：通过 API 管理用户数据 (api)。
     • 在流程启用中，选择启用客户端凭据流程。
     • 点击创建以创建外部客户端应用。前往外部客户端应用管理器查看您添加到列表中的应用。

4. 修改应用政策：

   • 打开创建的应用。
   • 前往政策，然后点击修改。
   • 在 OAuth 流程和外部客户端应用增强功能中，选中启用客户端凭据流程。
   • 在 Run as（以此身份运行）字段中输入您的 Salesforce 用户名。

5. 访问 OAuth 凭据：

   • 点击设置。
   • 点击 OAuth 设置。
   • 点击使用方密钥和使用方密码以访问凭据。验证码会发送到您的电子邮件地址。
   • 输入验证码，然后点击验证。
   • 复制使用方密钥，并将其用作客户端 ID。
   • 复制使用方密码，并将其用作客户端密钥。

创建 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。

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

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

准备工作

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

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

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

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

注意： 如需详细了解如何配置用户角色和设置访问权限控制，请参阅 ServiceNow 文档中的 [创建角色][servicenow-create-role] 部分，其中介绍了如何为用户定义权限。此外，请参阅 [创建 ACL 规则][servicenow-rule]，其中介绍了如何为不同的数据和功能设置精细的访问权限控制。

设置 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. 填写所需信息：

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

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

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

7. 该密钥已被遮盖。点击旁边的锁形图标以取消隐藏并查看 Secret。

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

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

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

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

设置角色和权限

您必须拥有安全管理员角色，才能创建和管理用户。如果您没有此角色，请执行以下操作：

1. 点击个人资料下的提升角色，将角色提升为 security_admin。

2. 选择 security_admin 角色，然后点击更新。您必须拥有 security_admin 角色，才能创建角色和管理用户。

创建包含 ACL 规则的自定义角色

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

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

   • 事故：incident。
   • 目录项：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。
   • 知识：kb_knowledge、kb_knowledge_base、kb_uc_can_read_mtom、kb_uc_can_contribute_mtom。
   • 附件：所有列出的项。
   • 身份：sys_user_role、sys_user_has_role、sys_user_group、sys_user_grmember、sys_user。
   • 随着新条件的提取而更新：core_company、cmn_location、cmn_department。
   • 用户条件：user_criteria。

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

10. 选择要验证的角色。

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

向服务账号授予角色

1. 依次前往全部 > 用户管理 > 用户，然后选择相应用户。
2. 找到要授予角色的用户，然后选择该用户。
3. 如果没有可用的用户，请依次前往系统安全 > 用户和群组 > 用户。
4. 点击新建，在用户表中创建新的服务账号。
5. 请务必勾选仅限 Web 服务访问权限复选框。
6. 前往页面底部的角色表格。
7. 点击右侧的修改。
8. 授予之前创建的角色，并将其分配给用户。根据创建的角色类型，选择适当的角色并进行分配。
9. 获取用户的用户名和密码。在同一页面上，点击设置密码。

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

    • 用户 ID：manager。
    • 密码：输入自动生成的密码。

配置员工池

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

• Azure OIDC 设置。
• Azure SAML 设置。
• OKTA 和 OIDC 设置。
• 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。

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

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

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

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

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

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

  • 实例网址。采用 http://DOMAIN_OR_SERVER/[sites/]WEBSITE 的形式。如需详细了解网址，请参阅 SharePoint 文档中的 SharePoint 中的网址和令牌。

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

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

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

    查看范围

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

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

    查看范围

    • AllSites.FullControl

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

  查看角色

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

控制台

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

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

   Agent Builder

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

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

4. 在选择数据源页面上，前往第三方来源部分，然后选择 Sharepoint Online。

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

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

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

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

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

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

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

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

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

后续步骤

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

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

关联 Slack

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

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

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

准备工作

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

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

• 请与 Workspace 所有者联系，获取在工作区中安装新应用的权限。

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

  • 工作区 ID：请按照 Slack 文档中为数据存储区指定 Slack 来源中的说明获取工作区 ID。
  • 访问令牌：创建客户端应用并定义所需的范围。如需了解详情，请参阅 Slack 文档中的快速入门和如何快速获取和使用 Slack API 令牌。
  • 设置 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

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

配置 Slack 应用

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

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

生成聊天机器人令牌

生成聊天机器人令牌，以安全地访问私密渠道、即时消息 (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 通道读取数据。如需启用抓取功能，请执行以下操作：

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

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

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

生成用户令牌

生成用户令牌，以便访问所有公开频道，而无需先加入这些频道。除非用户拥有访问权限，否则用户令牌无法抓取私享频道、即时通讯或 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 支持。在非公开预览版期间，系统会验证用户网域，但不支持精细的用户验证。

准备工作

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

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

在 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 连接器之前，请执行以下操作：

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

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

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

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

创建 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。

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

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

准备工作

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

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

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

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

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

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

后续步骤

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

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