网站搜索核对清单

本页面提供了一个核对清单，列出了创建网站搜索应用（一种通用搜索应用）所需的步骤。如需查看用于创建其他类型通用搜索应用的核对清单，请参阅通用搜索核对清单。

如果您刚开始接触 Vertex AI Agent Builder，不妨按照通用搜索使用入门教程创建一个网站数据示例应用。

选择基本网站搜索或高级网站索引编制

Vertex AI Agent Builder 提供两种类型的网站数据存储区：基本网站搜索和高级网站索引编制。

您可以选择启用高级网站索引编制功能，以便为搜索数据存储区中的网页编制索引。高级网站索引编制功能要求进行域名验证，并且比基本网站搜索提供更多功能。如需了解详情，请参阅高级网站索引编制。

根据您根据业务需求所需的网站数据存储区类型，选择以下核对清单之一：

基本网站搜索 高级网站索引编制

提示： 您可以试用 Vertex AI Search 微件，该微件使用高级网站索引编制功能为 Vertex AI Search 文档编制索引。试用 Vertex AI Search！

设置 Google Cloud项目

设置 Google Cloud 项目、启用 Vertex AI Agent Builder，并为项目设置访问控制。如果您已有 Google Cloud 项目，则可以使用现有项目。

操作

1. 查看开始前须知页面，并确认您已完成相应步骤。

准备数据

了解网站搜索应用（一种通用搜索应用）的行为方式，以及在网站数据存储区中添加网站的前提条件。

操作

1. 请参阅关于应用和数据存储区，了解通用应用与数据存储区之间的关系，以及网站数据的组成部分。为数据存储区启用高级网站索引编制后，您可以将该数据存储区用于混合搜索，即将多个数据存储区关联到一个应用。

2. 根据网站数据中的要求准备网站数据。

创建数据存储区

通过提供要包含的网站网址模式和要排除的网址模式来创建数据存储区。数据存储区创建流程涉及启用高级网站索引编制功能的步骤，而该功能需要进行域名验证。

操作

1. 按照使用网站网址创建数据存储区中的说明操作。

   如果数据存储区创建和域名验证成功，Vertex AI Agent Builder 会生成一个初始索引，并会尽可能自动刷新该索引。

   初始索引编制过程可能需要几个小时。

2. 可选：创建一个数据存储区，以便您仅对站点地图执行编制索引和刷新。为此，请按照在数据存储区中启用仅更新网站地图中的说明操作。

   如需了解基于站点地图的索引编制和刷新，请参阅使用站点地图编制和刷新网页索引。

创建应用

创建网站搜索应用并将其关联到新的数据存储区。

操作

1. 创建搜索应用。请务必开启企业版。

在数据存储区一级配置搜索设置

Vertex AI Search 提供了许多配置选项。某些选项取决于您是否计划部署搜索 widget。

操作

Vertex AI Search 提供了多种配置选项，具体取决于您的用例以及您计划部署开箱即用的搜索微件还是将搜索 API 调用集成到您自己的代码中。

• 您可以将搜索微件嵌入到您的网站中，以自动提供搜索栏和可展开的搜索界面。如果您打算部署搜索微件，请配置以下内容：

  • 搜索微件结果。请参阅为搜索微件配置结果。

  • 搜索微件细分条件（预览版）。请参阅为搜索微件配置细分条件。

  • 自动补全。请参阅更新自动补全设置。

  • 搜索优化（预览版）。请参阅利用搜索调参，提高搜索结果的准确性。

• 如果您打算将搜索 API 调用集成到您的服务器或应用中，而不是使用微件，则可以使用以下选项配置搜索设置：

  • 自动补全。根据您的数据，设置基于文档内容、字段、搜索记录或用户事件的自动补全建议。请参阅配置自动补全。

  • 投放控件。控制何时提升、掩埋、过滤或重定向搜索结果，或某些查询是否为其他查询的同义词。请参阅为搜索配置投放控制。

  • 搜索优化（预览版）。使用您自己的训练数据调优搜索模型。请参阅利用搜索调参，提高搜索结果的准确性。

在请求级别配置搜索结果

如果您打算通过将搜索 API 调用集成到自己的代码中来部署应用，Vertex AI Search 提供了其他选项来配置搜索结果的返回方式。

操作

1. 使用以下选项配置搜索结果：

   • 过滤网站搜索。

   • 提升搜索结果排名。

   • 对网页搜索结果进行排序。

   • 获取摘要。

预览搜索结果

您可以预览搜索结果，检查应用配置是否按预期运行。

操作

1. 如需预览搜索结果，请使用控制台或 API。

   • 控制台。使用 Vertex AI Agent Builder 控制台的预览页面预览搜索 widget 配置对结果的影响。请参阅获取搜索结果中的 Console 说明。

   • API。如果您要将 API 调用集成到应用中，可以发出 curl 调用来预览搜索配置。请参阅获取搜索结果中的 REST 说明。

优化搜索结果

利用添加到网页中的结构化数据，丰富数据存储空间的索引。

操作

向网页添加结构化数据是一个迭代过程：

1. 修改网页上的结构化数据。如需了解详情，请参阅使用结构化数据进行高级网站编入索引。
2. 根据需要使用结构化数据属性更新数据存储架构。
3. 重新配置搜索结果。请参阅此核对清单的第 6 步。
4. 预览搜索结果。请参阅此核对清单的第 7 步。
5. 在部署搜索应用之前，请根据需要重复此过程，以实现所需的搜索行为。

部署搜索应用

当您对搜索应用的预览版感到满意后，可以将其部署到您的网站，以便与用户分享。

操作

1. 您可以通过以下任一方式部署搜索应用：

   • 将搜索微件嵌入您的网站。Vertex AI Search 会提供可复制到您的网站或 Web 应用中的代码。这会部署搜索微件。您可以在控制台中预览搜索结果。请参阅将搜索微件添加到网页。

   • 将搜索 API 调用集成到您的服务器或应用中。如需完全控制搜索结果的显示方式，您可以将 API 调用集成到您的服务器或应用中。如需详细了解如何发出 API 调用，请参阅获取搜索结果。如需了解客户端库资源，请参阅 Vertex AI Agent Builder 客户端库。

维护您的应用

您可以维护应用，确保数据存储区中包含最新的必要数据。

操作

1. 刷新数据。
2. 可选：如果您的数据存储空间采用基于站点地图的索引编制和刷新方式，请提交站点地图或站点地图索引，并及时更新这些内容。数据存储区索引会自动更新，其中包含的网址每天都会刷新。如需了解基于站点地图的索引编制和刷新，请参阅使用站点地图编制和刷新网页索引。