媒体搜索核对清单 | Vertex AI Agent Builder

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

准备好数据以导入到 Vertex AI Search。

媒体搜索应用会使用以下数据：

结构化媒体数据。必需。将与媒体内容相关的元数据信息（例如标题、说明和 URI）上传到媒体内容所在的位置。Vertex AI Search 为媒体提供了预定义架构。或者，您也可以使用自己的架构。
用户事件。可选，但强烈建议填写。记录用户事件有助于提高搜索结果的排名。

查看媒体文档和数据存储区简介中有关媒体数据和数据存储区的信息，并根据所需的架构和字段准备数据。如果您使用的是自己的架构，请参阅将架构作为 JSON 对象的示例和结构化数据。
请参阅用户事件简介，了解媒体用户事件要求。

创建应用和数据存储区，然后导入媒体数据。

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

对于媒体搜索应用，建议使用用户事件，但并非强制要求。

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

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

您可以将搜索微件嵌入到您的网站中，以自动提供搜索栏和可展开的搜索界面。如果您打算部署搜索微件，请配置以下内容：
- 搜索微件结果。请参阅为搜索微件配置结果。
- 搜索微件细分条件。请参阅为搜索微件配置细分条件。
如果您打算将搜索 API 调用集成到您的服务器或应用中，而不是使用微件，则可以使用以下选项配置搜索设置：
- 字段设置。对于结构化数据或包含元数据的非结构化数据，请更新字段设置，以优化 Vertex AI Search 使用元数据进行搜索的方式。请参阅为搜索配置字段。
- 自动补全。根据您的数据，设置基于文档内容、字段、搜索记录或用户事件的自动补全建议。请参阅配置自动补全。
- 投放控件。控制何时提升、掩埋、过滤或重定向搜索结果，或控制是否将某些查询与其他查询相关联。请参阅为搜索配置投放控制。
- 即输即搜。如果您的应用使用电视遥控器等不方便的输入设备，您可以启用“边输入边搜索”功能。请参阅为媒体应用提供“输入搜索内容时显示搜索结果”功能。

如果您打算通过将搜索 API 调用集成到自己的代码中来部署应用，则可以为搜索结果配置过滤和提升功能。

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

如需预览搜索结果，请使用控制台或 API。
- 控制台。使用 Vertex AI Agent Builder 控制台的预览页面预览搜索 widget 配置对结果的影响。请参阅获取搜索结果中的 Console 说明。
- API。如果您要将 API 调用集成到应用中，请进行 API 调用以预览搜索配置。请参阅获取搜索结果中的 REST 说明。

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

您可以通过以下任一方式部署搜索应用：
- 将搜索微件嵌入您的网站。Vertex AI Search 会提供可复制到您的网站或 Web 应用中的代码。这会部署搜索微件。您可以在控制台中预览搜索结果。请参阅将搜索微件添加到网页。
- 将搜索 API 调用集成到您的服务器或应用中。如需完全控制搜索结果的显示方式，您可以将 API 调用集成到您的服务器或应用中。如需详细了解如何发出 API 调用，请参阅获取搜索结果。如需了解客户端库资源，请参阅 Vertex AI Agent Builder 客户端库。

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