注意：Vertex AI Search 即将更名为 Agent Search。我们正在更新内容，以反映新品牌。

Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

为自定义搜索设置可配置的价格

Agent Search 为自定义搜索提供两种价格模式：基于一般消耗的价格模式和可配置的价格模式。

本页介绍了价格模式以及如何启用可配置的价格模式。

价格模式

Agent Search for custom search 支持两种价格模式：

常规：随用随付、基于消耗的模式（默认）。
可配置：一种混合定价模式，可让您解绑功能并创建更符合特定应用场景的订阅套餐。借助此价格模式，您只需为所需的功能付费。它提供两种订阅方案和可选的加购项。在项目级层启用此价格模式后，您可以为应用和数据存储区选择可配置定价。

可配置的价格结构

可配置的定价模式提供两种订阅和不同的功能加购项。

订阅套餐

订阅包包含两项订阅：

结构化数据、非结构化数据和网站数据的索引存储空间（以 GiB 为单位）。
标准关键字搜索和过滤功能的搜索查询，以 QPM（每分钟查询次数）为单位。

用量计算

系统会将应用了可配置定价的数据存储区的存储空间大小相加，然后与存储空间订阅阈值进行比较。如果每小时用量高于设置的阈值，则超额部分将按一般定价模式收费。

同样，对于采用可配置价格的应用，其搜索查询单位数 (QPM) 会累加，并与 QPM 订阅阈值进行比较。如果每分钟的使用量高于设置的阈值，则超额部分将按一般价格模式收费。

修改阈值后，系统会将用量与新阈值进行比较，以确定是否超额。

功能插件

您可以使用插件来启用强大的功能。

存储空间加购项

对于语义嵌入项插件，系统会在将文档导入数据存储区时进行结算。

附加服务	说明
语义嵌入	支持为文档创建和维护向量嵌入，这是在搜索查询中使用语义查询插件之前必须执行的操作。

搜索请求插件

当这些功能应用于 search API 调用时，系统会针对这些插件进行结算。

附加服务	说明
语义查询	支持语义搜索功能，可使用嵌入处理更长、更复杂的查询。数据存储区级语义嵌入插件是前提条件。默认情况下，在满足前提条件时应用，除非在请求中停用。
KPI 和个性化	支持基于用户事件的重排序和个性化，以针对您的特定业务 KPI 进行优化。如果数据质量已达到个性化层级，并且训练流水线已准备就绪，系统就会向您收取费用。
AI 概览	启用生成式功能，例如生成式摘要和跟进问题。语义查询插件是前提条件。

如何控制哪些插件应用于搜索请求

由于搜索请求加购项会在适用时默认应用，因此除非您停用它们，否则您需要根据可配置的价格为它们付费。

您可以通过以下两种方式来停用它们：

如果您使用 widget 来托管应用，则可以使用 widget 的界面设置在 widget 级停用插件。如需了解有关该 widget 的一般信息，请参阅向网页添加搜索 widget；如需了解如何配置 widget 设置，请参阅为搜索 widget 配置结果。
在每个请求级别，通过在您使用 engines.servingConfigs.search 方法发出搜索请求时设置 disableSemanticAddOn、disableKpiPersonalizationAddOn 和 disableGenerativeAnswerAddOn 来实现。

如需了解如何停用插件，请参阅管理搜索查询插件的可配置价格。

价格详情

如需详细了解价格（包括示例），请参阅Agent Search 可配置价格。

为项目启用可配置定价模式

本部分介绍如何在项目级配置定价模式。如需为单个应用或数据存储区使用可配置定价，您必须先为该项目启用此功能。

执行此任务所需的权限

如需执行此任务，您必须已获得以下权限或以下 Identity and Access Management (IAM) 角色：

您需要此角色：	或者，您需要拥有以下所有权限：
Discovery Engine Admin (`roles/discoveryengine.admin`)	`discoveryengine.projects.update`

您可以让管理员为您授予这些 Identity and Access Management 角色。如需了解如何授予角色，请参阅管理访问权限或控制对 Agent Search 资源的访问权限。您也可以通过自定义角色或其他预定义角色来获取所需的权限。

控制台

如需使用 Google Cloud 控制台启用可配置的价格，请按以下步骤操作：

在 Google Cloud 控制台中，前往结算页面。

AI Applications
在结算页面上，选择可配置的价格。
在项目范围的可配置价格下，输入 QPM 订阅阈值，最低为 1000 QPM/月。
在项目级可配置价格下，输入存储空间订阅阈值，最低为 50 GiB/月。
点击保存项目设置。

为应用启用可配置价格

本部分介绍如何配置应用级价格模式。如需为单个应用使用可配置定价，您必须先为项目启用此功能。如果您未为应用设置可配置定价，则该应用会使用常规定价模式，而不是由订阅费用涵盖。

执行此任务所需的权限

如需执行此任务，您必须已获得以下权限或以下 Identity and Access Management (IAM) 角色：

您至少需要以下角色之一：	或者，您需要拥有以下所有权限：
Discovery Engine Admin (`roles/discoveryengine.admin`) Discovery Engine Editor (`roles/discoveryengine.editor`)	`discoveryengine.engines.create` `discoveryengine.engines.update` `discoveryengine.engines.delete`

控制台

如需使用 Google Cloud 控制台为应用启用可配置的价格，请按以下步骤操作：

在 Google Cloud 控制台中，前往应用页面。

AI Applications
在应用页面上，点击要修改的应用。
在主菜单中，点击结算，然后选择可配置的价格。
点击保存。

为数据存储区启用可配置的价格

本部分介绍了如何配置数据存储区级层的价格模式。如需为单个数据存储区使用可配置定价，您必须先为项目启用此功能。如果您未为数据存储区设置可配置定价，则该数据存储区将使用常规定价模式，而不是纳入订阅费用中。

执行此任务所需的权限

如需执行此任务，您必须已获得以下权限或以下 Identity and Access Management (IAM) 角色：

您至少需要以下角色之一：	或者，您需要拥有以下所有权限：
Discovery Engine Admin (`roles/discoveryengine.admin`) Discovery Engine Editor (`roles/discoveryengine.editor`)	`discoveryengine.dataStores.create` `discoveryengine.dataStores.update` `discoveryengine.dataStores.delete`

控制台

如需使用 Google Cloud 控制台为数据存储区启用可配置的定价，请按以下步骤操作：

在 Google Cloud 控制台中，前往数据存储区页面。

AI Applications
在数据存储区页面上，点击要修改的数据存储区。
如果数据存储区已关联到任何应用，请确保这些应用已启用可配置定价。

采用常规定价的应用无法连接到采用可配置定价的数据存储区。
点击结算，然后选择可配置的价格。
可选：选择语义（嵌入）插件。这是语义查询和 AI 模式的搜索服务的前提条件。
点击保存。

管理搜索查询加购项的可配置价格

此任务不需要任何特殊角色或权限。

如果您使用 widget 托管应用，并希望通过限制 widget 使用的插件来节省费用，请执行以下操作：

在 Google Cloud 控制台中，前往 AI Applications 页面。

AI Applications
在应用页面上，点击要修改的应用。
点击配置。
如需避免使用 AI 概览插件，请将搜索类型设置为搜索。
在界面标签页上，选择所需的插件。对于搜索类型为搜索的应用，可以停用语义查询插件。对于搜索并提供答案和跟进搜索这两种搜索类型，语义查询插件始终处于开启状态。
点击 Save and publish（保存并发布）。

REST，每次搜索请求

如果您在搜索请求中停用某个插件，Agent Search 不会将其应用于该请求，您也不会因此产生费用。如果您省略配置或将某个字段留空，则在适用时，相应插件会默认应用。

如需针对搜索请求停用搜索请求插件，请执行以下操作：

对于每个查询，请使用语法如下所示的命令：

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search:search" \
  -d '{
        "query": "QUERY",
        "searchAddonSpec": {
          "disableSemanticAddOn": BOOL_DISABLE_SEMANTIC,
          "disableKpiPersonalizationAddOn": BOOL_DISABLE_KPI,
          "disableGenerativeAnswerAddOn": BOOL_DISABLE_GEN_ANSWER
        }
      }'

替换以下内容：

PROJECT_ID：您的 Google Cloud 项目的 ID。
APP_ID：您要查询的 Agent Search 应用的 ID。
QUERY：要搜索的查询文本。

如需停用插件，请将其添加到 searchAddonSpec 对象中：

BOOL_DISABLE_SEMANTIC：如需停用语义插件，请将 disableSemanticAddOn 设置为 true。
BOOL_DISABLE_KPI：如需停用“KPI 和个性化”插件，请将 disableKpiPersonalizationAddOn 设置为 true。
BOOL_DISABLE_GEN_ANSWER：如需停用生成式回答（AI 概览）插件，请将 disableGenerativeAnswerAddOn 设置为 true。

命令和结果示例

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://discoveryengine.googleapis.com/v1beta/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/servingConfigs/default_search:search" \
  -d '{
        "query": "BigQuery data platform",
        "searchAddonSpec": {
          "disableSemanticAddOn": true,
          "disableKpiPersonalizationAddOn": true,
          "disableGenerativeAnswerAddOn": true
        }
      }'
      
{
  "results": [
    {
      "id": "9ec41e0a58436ad16f355cf5a9a21078",
      "document": {
        "name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/branches/0/documents/9ec41e0a58436ad16f355cf5a9a21078",
        "id": "9ec41e0a58436ad16f355cf5a9a21078",
        "derivedStructData": {
          "link": "gs://my-bucket/bq-directory/DiagramAboutBigQuery.png",
          "can_fetch_raw_content": "true",
          "image": {
            "thumbnail": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAhQAAAKx...4x73uMevakHOVSQi/gUVbCto1KDKawAAAABJRU5ErkJggg=="
          },
          "title": "BigQueryIllustrated"
        }
      },
      "rankSignals": {
        "keywordSimilarityScore": 0.548946,
        "topicalityRank": 1,
        "documentAge": 495935.8,
        "boostingFactor": 0,
        "defaultRank": 1
      }
    },
    {
      "id": "c0119791c13a516312bbaad4cffae9f5",
      "document": {
        "name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/branches/0/documents/c0119791c13a516312bbaad4cffae9f5",
        "id": "c0119791c13a516312bbaad4cffae9f5",
        "derivedStructData": {
          "can_fetch_raw_content": "true",
          "link": "gs://my-bucket/bq-directory/AboutBigQuery.pdf",
          "title": "AllAboutBigQuery",
          "image": {
            "thumbnail": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASM ... /062/5c0fGHTW4xm0c5qpsvbIj2v+OW72uPiFpX1x/Xdz/f8BOQGtH50KK50AAAAASUVORK5CYII="
          }
        }
      },
      "rankSignals": {
        "keywordSimilarityScore": 0.37348458,
        "topicalityRank": 2,
        "documentAge": 495935.8,
        "boostingFactor": 0,
        "defaultRank": 2
      }
    }
  ],
  "totalSize": 2,
  "attributionToken": "hwL0BgEKCwjYoqrTBh...x0X3NlYXJjaA",
  "guidedSearchResult": {},
  "summary": {},
  "queryExpansionInfo": {},
  "semanticState": "DISABLED"
}

如需详细了解如何提交搜索请求，请参阅获取搜索结果。

修改订阅阈值

如果您已为项目启用可配置价格，则可以根据需要调整订阅阈值。提高阈值会立即生效，而降低阈值会在下一个结算周期开始时生效。

如需修改订阅阈值，请执行以下操作：

启用后，等待几周，以便累积消费数据。

如果您认为自己的限额可能设置得过高，请务必在下一个月度结算周期结束之前检查消耗情况。
在 Google Cloud 控制台中，前往结算页面。

AI Applications
在结算页面上，点击用量，然后查看用量数据。
点击订阅，然后根据需要提高或降低项目级阈值的值。
点击保存项目设置。

更改订阅阈值后，您必须等待最多两小时才能再次更改。在两小时内更改阈值的请求可能会失败。

如果您降低了阈值，在下一个结算周期开始之前，您不会在订阅页面上看到较低的值。

将价格模式更改为常规定价

您可以将单个应用和数据存储区更改为使用常规定价，而不是可配置定价。或者，您也可以为整个项目停用可配置价格。

您必须先确保与应用关联的数据存储区使用常规定价，然后才能更改应用的定价模式。这是因为使用常规定价的应用无法连接到使用可配置定价的数据存储区。

在将项目重置为常规定价模式之前，您需要确保项目中的所有应用和数据存储区都使用常规定价模式。

为数据存储区启用常规定价

本部分介绍了如何将数据存储区的价格模式设置为常规（默认模式）。

执行此任务所需的权限

如需执行此任务，您必须已获得以下权限或以下 Identity and Access Management (IAM) 角色：

您至少需要以下角色之一：	或者，您需要拥有以下所有权限：
Discovery Engine Admin (`roles/discoveryengine.admin`) Discovery Engine Editor (`roles/discoveryengine.editor`)	`discoveryengine.dataStores.create` `discoveryengine.dataStores.update` `discoveryengine.dataStores.delete`

控制台

如需使用 Google Cloud 控制台为数据存储区启用一般定价，请按以下步骤操作：

在 Google Cloud 控制台中，前往数据存储区页面。

AI Applications
在数据存储区页面上，点击要修改的数据存储区。
点击结算，然后选择一般价格。
点击保存。

为应用启用一般定价

本部分介绍了如何将应用的定价模式设置为常规（默认模式）。

执行此任务所需的权限

如需执行此任务，您必须已获得以下权限或以下 Identity and Access Management (IAM) 角色：

您至少需要以下角色之一：	或者，您需要拥有以下所有权限：
Discovery Engine Admin (`roles/discoveryengine.admin`) Discovery Engine Editor (`roles/discoveryengine.editor`)	`discoveryengine.engines.create` `discoveryengine.engines.update` `discoveryengine.engines.delete`

控制台

如需使用 Google Cloud 控制台为应用启用常规价格，请按以下步骤操作：

在 Google Cloud 控制台中，前往应用页面。

AI Applications
如果连接到应用的任何数据存储区使用可配置定价，请为这些数据存储区启用常规定价。

采用常规定价的应用无法连接到采用可配置定价的数据存储区。
在应用页面上，点击要修改的应用。
在主菜单中，点击结算，然后选择一般价格。
点击保存。

为项目停用可配置价格

在为项目停用可配置价格之前，您需要确保项目中的所有应用和数据存储区都使用常规定价。请参阅为数据存储区启用常规定价和为应用启用常规定价。

执行此任务所需的权限

如需执行此任务，您必须已获得以下权限或以下 Identity and Access Management (IAM) 角色：

您至少需要以下角色之一：	或者，您需要拥有以下所有权限：
Discovery Engine Admin (`roles/discoveryengine.admin`)	`discoveryengine.projects.update`

控制台

如需为项目停用可配置定价模式，请按以下步骤操作：

在 Google Cloud 控制台中，前往结算页面。

AI Applications
在结算页面上，选择一般价格。
点击保存项目设置。

为自定义搜索设置可配置的价格 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

价格模式

可配置的价格结构

订阅套餐

用量计算

功能插件

存储空间加购项

搜索请求插件

如何控制哪些插件应用于搜索请求

价格详情

为项目启用可配置定价模式

控制台

为应用启用可配置价格

控制台

为数据存储区启用可配置的价格

控制台

管理搜索查询加购项的可配置价格

控制台，仅限 widget

REST，每次搜索请求

命令和结果示例

修改订阅阈值

将价格模式更改为常规定价

为数据存储区启用常规定价

控制台

为应用启用一般定价

控制台

为项目停用可配置价格

控制台

为自定义搜索设置可配置的价格