宽泛搜索核对清单

本页提供了一份核对清单，列出了创建通用搜索应用所需的步骤。如需查看创建网站搜索应用的核对清单，请参阅网站搜索核对清单。

如果您刚开始接触 Vertex AI Agent Builder，不妨按照 Vertex AI Search 使用入门教程创建一个示例应用。

设置 Google Cloud项目

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

操作

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

准备数据

确定您将在搜索应用中提供哪些类型的数据，并准备好这些数据以便导入 Vertex AI Search。

您可以基于以下类型的数据创建数据存储区：

• 非结构化数据。存储在 Cloud Storage 中的文档（例如 PDF 文件、HTML 文件和 TXT 文件）。您可以选择在 JSON 文件或 BigQuery 表中提供元数据。
• 结构化数据。采用特定架构提供的数据。例如，您可以在 BigQuery 表中提供数据，也可以在 Cloud Storage 中以 JSON 文件的形式提供数据，或者通过 Jira 等第三方连接器提供数据。

操作

1. 如需了解受支持的数据以及应用与数据存储区之间的关系，请参阅应用和数据存储区简介。

2. 根据准备数据以供提取中的说明准备数据。

3. 如果您需要设置访问控制，以限制用户可以在搜索应用的结果中查看的数据，请查看前提条件，然后按照使用数据源访问控制中针对您的身份提供程序类型和数据源的说明操作。

导入数据

创建数据存储区，然后将数据导入其中，或将第三方连接器设置为同步的数据源。

数据的导入方式取决于数据的来源。例如，如果您的数据位于 Cloud Storage 中，您可以通过提供数据的存储分区位置，使用控制台或 API 导入数据。

操作

1. 按照创建搜索数据存储区中针对您的数据源的说明操作。

创建应用

创建通用搜索应用并将其连接到新的数据存储区。

操作

1. 创建搜索应用。

配置搜索设置

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

操作

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

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

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

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

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

   • 字段设置。对于结构化数据或包含元数据的非结构化数据，请更新字段设置，以优化 Vertex AI Search 使用元数据进行搜索的方式。请参阅为搜索配置字段。

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

   • 投放控件。控制何时提升、掩埋、过滤或重定向搜索结果，或控制是否将某些查询与其他查询相关联。请参阅配置投放控制。

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

   • 自定义嵌入（预览版）。如果您创建了自己的嵌入，则可能更希望使用它们，而不是使用 Vertex AI Search 生成的嵌入，以便通过其他情境信息丰富搜索结果。此功能适用于包含结构化数据或包含元数据的非结构化数据的数据存储区。请参阅使用自定义嵌入。

配置搜索结果

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

操作

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

   • 过滤通用搜索结果，以查找结构化或非结构化数据。
   • 获取摘要、提取式回答或提取式片段。请参阅获取摘要和提取的内容。

预览搜索结果

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

操作

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

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

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

部署搜索应用

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

操作

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

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

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

维护您的应用

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

操作

1. 刷新数据。