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

Agent Search 为自定义搜索提供两种价格模式：一般按用量计费模式和可配置价格模式。

本页介绍了这两种价格模式，以及如何启用可配置价格模式。

注意： 可配置价格仅适用于 Agent Search 应用 和数据存储区。如果您要创建数据存储区以供 Gemini Enterprise 应用使用，请务必选择一般价格 模式。如需了解如何选择一般价格，请参阅为数据存储区启用可配置价格 。

价格模式

Agent Search 为自定义搜索提供两种价格模式：

• 一般：随用随付、按用量计费模式（默认）。

• 可配置：混合价格模式，可让您取消捆绑功能 并创建更符合您 特定使用场景的订阅套餐。使用此价格模式，您只需为所需的功能付费。它提供两种订阅和可选插件。在项目级层启用此价格模式后，您可以为应用和数据存储区选择可配置价格。

在启用可配置价格之前，请注意以下事项：

• 订阅套餐的结算会在 启用后立即开始。
• 您必须单独注册要纳入订阅范围的每个应用和数据存储区。 任何未注册的资源都将按 默认的随用随付费率收费。
• 如果您选择通过 AI Applications 控制台创建 Gemini Enterprise 数据存储区 ，则必须选择一般价格 模式，才能获得正确的结算。

可配置价格组成部分

可配置价格模式提供两种订阅和不同的功能插件。

订阅套餐

订阅套餐包含两种订阅：

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

用量计算

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

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

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

功能插件

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

存储空间插件

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

插件	说明
语义嵌入	支持为文档创建和维护向量嵌入，这是在搜索查询中使用语义查询插件之前所必需的。

搜索请求插件

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

重要提示 ：只要搜索请求插件适用于请求，系统就会默认应用这些插件。例如，当满足先决条件（数据存储区中启用了语义嵌入插件或有嵌入可用）时，即使您没有明确请求，系统也会自动应用语义查询插件。启用可配置价格后，应用于请求的每个插件都会通过其对应的 SKU 进行结算。如需避免为不需要的插件付费，您必须明确停用该插件。请参阅 控制哪些插件应用于搜索请求。

插件	说明
语义查询	支持使用嵌入处理更长、更复杂的查询，从而实现语义搜索功能。 数据存储区级层的语义嵌入插件是先决条件。满足先决条件时默认应用，除非在请求中停用。
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 控制台启用可配置价格，请按以下步骤操作：

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

   AI Applications

2. 在结算 页面上，选择可配置价格 。

3. 在项目范围的可配置价格 下，输入 QPM 订阅 阈值 ，最低为 1000 QPM/月。

4. 在项目范围的可配置价格 下，输入存储空间订阅 阈值 ，最低为 50 GiB/月。

5. 点击保存项目设置 。

为应用启用可配置价格

本部分介绍了如何在应用级层配置价格模式。 如需为单个应用使用可配置价格，您必须 先为项目启用该功能。如果您没有为应用设置可配置价格，则该应用将使用一般价格模式，而不是纳入订阅费用范围。

执行此任务所需的权限

如需执行此任务，您必须已获得以下权限 或以下 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

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

控制台

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

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

   AI Applications

2. 在应用 页面上，点击要修改的应用。

3. 在主菜单中，点击结算 ，然后选择可配置价格 。

4. 点击保存 。

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

本部分介绍了如何在数据存储区级层配置价格模式。 如需为单个数据存储区使用可配置价格，您必须先 为项目启用该功能。如果您没有为数据存储区设置可配置价格，则该数据存储区将使用一般价格模式，而不是纳入订阅费用范围。

**重要提示** ：如果所选数据存储区将与 Gemini Enterprise 应用搭配使用，请不要为其启用可配置价格。

执行此任务所需的权限

如需执行此任务，您必须已获得以下权限 或以下 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

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

控制台

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

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

   AI Applications

2. 在数据存储区 页面上，点击要修改的数据存储区。

3. 如果数据存储区已关联到任何应用，请确保这些应用已启用可配置价格。

   使用一般价格的应用无法关联到使用可配置价格的数据存储区。

4. 点击结算 ，然后选择可配置价格 。

5. （可选）选择语义（嵌入）插件 。这是为语义查询和 AI 模式提供搜索服务的先决条件。

6. 点击保存 。

管理搜索查询插件的可配置价格

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

仅限控制台、widget

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

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

   AI Applications

2. 在应用 页面上，点击要修改的应用。

3. 点击配置 。

4. 如需避免使用 AI 概览插件，请将搜索类型 设置为搜索 。

5. 在 UI 标签页上，选择所需的插件。对于搜索类型为 搜索的应用，可以停用语义查询插件。对于搜索并提供答案 和跟进搜索 搜索类型，语义查询插件始终处于开启状态。

   

6. 点击 Save and publish （保存并发布）。

REST，每个搜索请求

注意： 此功能为预览版，受 GCP 服务专用条款中的“非正式版产品使用条款” 约束。 我们对正式发布前产品和功能的支持可能比较有限，并且对正式发布前产品和功能的更改可能与其他正式发布前版本不兼容。如需了解详情，请参阅 发布阶段说明。 此外，使用此功能，即表示您同意生成式 AI 预览版条款及条件（“预览版条款”）。对于此功能，您可以按照 云端数据处理附录中的说明处理个人数据，但受到协议中的适用限制和义务（如“预览版条款”中所定义）的约束。

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

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

1. 对于每个查询，请使用具有以下语法的命令：

   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     "https://discoveryengine.googleapis.com/v1beta/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"
   }
     

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

修改订阅阈值

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

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

1. 启用后等待几周，以便累积用量数据。

   如果您认为阈值可能设置得过高，请务必在下一个月度结算周期结束之前检查用量。

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

   AI Applications

3. 在结算 页面上，点击用量 并查看用量数据。

4. 点击订阅 ，然后根据需要增加或减少项目范围阈值的值。

5. 点击保存项目设置 。

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

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

将价格模式更改为一般价格

您可以将单个应用和数据存储区更改为使用一般价格，而不是可配置价格。或者，您可以为整个项目关闭可配置价格。

如需更改应用的价格模式，您必须确保关联到该应用的数据存储区使用一般价格。这是因为使用一般价格的应用无法关联到使用可配置价格的数据存储区。

如需将项目重置为一般价格模式，您需要确保项目中的所有应用和数据存储区都使用一般价格模式。

为数据存储区启用一般价格

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

执行此任务所需的权限

如需执行此任务，您必须已获得以下权限 或以下 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

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

控制台

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

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

   AI Applications

2. 在数据存储区 页面上，点击要修改的数据存储区。

3. 点击结算 ，然后选择一般价格 。

4. 点击保存 。

为应用启用一般价格

本部分介绍了如何将应用的价格模式设置为一般价格（默认模式）。

执行此任务所需的权限

如需执行此任务，您必须已获得以下权限 或以下 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

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

控制台

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

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

   AI Applications

2. 如果关联到该应用的任何数据存储区使用可配置价格， 请为这些数据存储区启用一般价格。

   使用一般价格的应用无法关联到使用可配置价格的数据存储区。

3. 在应用 页面上，点击要修改的应用。

4. 在主菜单中，点击结算 ，然后选择一般价格 。

5. 点击保存 。

为项目停用可配置价格

如需为项目停用可配置价格，您需要确保项目中的所有应用和数据存储区都使用一般价格。 请参阅为数据存储区启用一般价格和为应用启用一般 价格。

执行此任务所需的权限

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

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

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

控制台

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

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

   AI Applications

2. 在结算 页面上，选择一般价格 。

3. 点击保存项目设置 。