如果您是首次使用 Agent Search，不妨按照自定义搜索入门教程 创建一个示例应用。
设置 Google Cloud 项目，开启 Agent Search，并为项目设置访问 权限控制。如果您已有项目，则可以使用现有 Google Cloud 项目（如果您 已有）。
操作
- 查看准备工作 并确认您已完成这些步骤。
确定要在搜索应用中提供哪些类型的数据，并准备好将这些数据导入 Agent Search。
您可以基于以下类型的数据创建数据存储区：
- 非结构化数据 。存储在 Cloud Storage 中的文档（例如 PDF、HTML 和 TXT 文件）。您还可以选择在 JSON 文件或 BigQuery 表中提供元数据。
- 结构化数据 。具有特定架构的数据。例如，您可以提供 BigQuery 表中的数据、Cloud Storage 中的 JSON 文件或来自第三方连接器（例如 Jira）的数据。
操作
如果您需要设置访问权限控制来限制用户在 搜索应用结果中可以查看的数据，请查看 使用数据 源访问权限控制中的前提条件，并按照适用于您的身份提供方类型和数据源的说明操作。
创建数据存储区，然后将数据导入其中，或者将第三方连接器设置为同步的数据源。
导入数据的方式取决于您要从何处导入数据。例如，如果您的数据位于 Cloud Storage 中，您可以提供数据的存储桶位置，使用控制台或 API 导入数据。
操作
- 按照创建搜索数据 存储区中适用于您的数据源的说明操作。
Agent Search for Custom Search 支持两种价格模式：
- 常规：一种基于用量的随用随付模式。
- 可配置：一种混合定价模式，可让您取消捆绑功能并创建更符合您特定应用场景的订阅套餐。借助此价格模式，您只需为所需的功能付费，并可充分利用这些功能的强大功能。它提供两种订阅和可选的附加功能。在项目级层启用此价格模式后，您可以为应用和数据存储区选择可配置的价格。
操作
默认情况下，项目设置为随用随付模式。不过，如需切换到可配置的价格，请执行以下操作：
Agent Search 提供许多配置选项。某些选项取决于您是否计划部署搜索微件。
操作
Agent Search 根据您的使用场景以及您是计划部署开箱即用的搜索微件还是将搜索 API 调用集成到自己的代码中，提供了多种配置选项。
您可以将搜索微件嵌入到网站中。该微件会自动提供搜索栏和可展开的搜索界面。如果您计划部署搜索微件，请配置以下内容：
搜索微件结果 。请参阅配置搜索微件的 结果。
搜索微件分面（预览版） 。请参阅配置分面 以用于搜索微件。
如果您计划将搜索 API 调用集成到服务器或应用中，而不是使用微件，则可以使用以下选项配置搜索设置：
字段设置 。对于结构化数据或带有元数据的非结构化数据，请更新字段设置，以优化 Agent Search 使用元数据进行搜索的方式。请参阅配置搜索字段。
自动补全 。根据您的数据，基于文档内容、字段、搜索记录或用户事件设置自动补全建议。请参阅 配置自动补全。
服务控件 。控制何时提升、隐藏、过滤或重定向搜索结果，或者某些查询是否与其他查询相关联。请参阅配置服务 控件。
搜索调参（预览版） 。使用您自己的训练数据调优搜索模型。请参阅利用搜索 调参，提高搜索结果的准确性。
自定义嵌入（预览版） 。如果您已创建自己的嵌入，则可能更愿意使用它们，而不是使用 Agent Search 生成的嵌入，以便通过额外的上下文丰富搜索结果。此功能适用于包含结构化数据或带有元数据的非结构化数据的数据存储区。请参阅使用自定义 嵌入。
如果您计划通过将搜索 API 调用集成到自己的代码中来部署应用，Agent Search 会提供额外的选项来配置搜索结果的返回方式。
操作
使用以下选项配置搜索结果：
- 过滤结构化或 非结构化数据的自定义搜索结果。
- 获取摘要、提取式答案或提取式片段 。请参阅获取 摘要和提取的内容。
您可以预览搜索结果，以检查应用配置是否按预期运行。
操作
如需预览搜索结果，请使用控制台或 API。
控制台 。使用 Agent Search 控制台的预览 页面预览搜索微件配置对结果的影响。请参阅控制台 说明，了解如何获取搜索 结果。
API 。如果您要将 API 调用集成到应用中，请进行 API 调用以预览搜索配置。请参阅获取搜索结果中的 REST 说明。
如果您对搜索应用的预览版感到满意，请将其部署到您的网站，与用户分享。
操作
您可以通过以下任一方式部署搜索应用：
将搜索微件嵌入到网站中 。Agent Search 提供了您可以复制到网站或 Web 应用中的代码。这会部署搜索微件。您可以在控制台中预览搜索结果。 请参阅向网页中添加搜索微件。
将搜索 API 调用集成到服务器或应用中 。如需完全控制搜索结果的显示方式，您可以将 API 调用集成到服务器或应用中。如需详细了解如何进行 API 调用，请参阅获取搜索结果。如需了解客户端库资源，请参阅 Agent Search client libraries。