@google-cloud/discoveryengine 2.0.1 → 2.1.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [2.1.0](https://github.com/googleapis/google-cloud-node/compare/discoveryengine-v2.0.1...discoveryengine-v2.1.0) (2025-05-09)
+
+
+### Features
+
+* [discoveryengine] move serving config update API to GA ([#6211](https://github.com/googleapis/google-cloud-node/issues/6211)) ([2fcdb39](https://github.com/googleapis/google-cloud-node/commit/2fcdb39efdd799850847756f2dcf128d1262e1a0))
+
 ## [2.0.1](https://github.com/googleapis/google-cloud-node/compare/discoveryengine-v2.0.0...discoveryengine-v2.0.1) (2025-03-21)
 
 

package/README.md

@@ -44,7 +44,7 @@ Google APIs Client Libraries, in [Client Libraries Explained][explained].
 1.  [Select or create a Cloud Platform project][projects].
 1.  [Enable billing for your project][billing].
 1.  [Enable the Discovery Engine API API][enable_api].
-1.  [Set up authentication with a service account][auth] so you can access the
+1.  [Set up authentication][auth] so you can access the
     API from your local workstation.
 
 ### Installing the client library
@@ -146,6 +146,7 @@ Samples are in the [`samples/`](https://github.com/googleapis/google-cloud-node/
 | Conversational_search_service.get_session | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/conversational_search_service.get_session.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/conversational_search_service.get_session.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Conversational_search_service.list_conversations | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/conversational_search_service.list_conversations.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/conversational_search_service.list_conversations.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Conversational_search_service.list_sessions | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/conversational_search_service.list_sessions.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/conversational_search_service.list_sessions.js,packages/google-cloud-discoveryengine/samples/README.md) |
+| Conversational_search_service.stream_answer_query | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/conversational_search_service.stream_answer_query.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/conversational_search_service.stream_answer_query.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Conversational_search_service.update_conversation | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/conversational_search_service.update_conversation.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/conversational_search_service.update_conversation.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Conversational_search_service.update_session | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/conversational_search_service.update_session.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/conversational_search_service.update_session.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Data_store_service.create_data_store | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/data_store_service.create_data_store.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/data_store_service.create_data_store.js,packages/google-cloud-discoveryengine/samples/README.md) |
@@ -181,13 +182,17 @@ Samples are in the [`samples/`](https://github.com/googleapis/google-cloud-node/
 | Search_service.search_lite | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/search_service.search_lite.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/search_service.search_lite.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Search_tuning_service.list_custom_models | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/search_tuning_service.list_custom_models.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/search_tuning_service.list_custom_models.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Search_tuning_service.train_custom_model | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/search_tuning_service.train_custom_model.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/search_tuning_service.train_custom_model.js,packages/google-cloud-discoveryengine/samples/README.md) |
+| Serving_config_service.update_serving_config | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/serving_config_service.update_serving_config.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/serving_config_service.update_serving_config.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Site_search_engine_service.batch_create_target_sites | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/site_search_engine_service.batch_create_target_sites.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/site_search_engine_service.batch_create_target_sites.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Site_search_engine_service.batch_verify_target_sites | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/site_search_engine_service.batch_verify_target_sites.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/site_search_engine_service.batch_verify_target_sites.js,packages/google-cloud-discoveryengine/samples/README.md) |
+| Site_search_engine_service.create_sitemap | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/site_search_engine_service.create_sitemap.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/site_search_engine_service.create_sitemap.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Site_search_engine_service.create_target_site | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/site_search_engine_service.create_target_site.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/site_search_engine_service.create_target_site.js,packages/google-cloud-discoveryengine/samples/README.md) |
+| Site_search_engine_service.delete_sitemap | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/site_search_engine_service.delete_sitemap.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/site_search_engine_service.delete_sitemap.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Site_search_engine_service.delete_target_site | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/site_search_engine_service.delete_target_site.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/site_search_engine_service.delete_target_site.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Site_search_engine_service.disable_advanced_site_search | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/site_search_engine_service.disable_advanced_site_search.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/site_search_engine_service.disable_advanced_site_search.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Site_search_engine_service.enable_advanced_site_search | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/site_search_engine_service.enable_advanced_site_search.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/site_search_engine_service.enable_advanced_site_search.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Site_search_engine_service.fetch_domain_verification_status | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/site_search_engine_service.fetch_domain_verification_status.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/site_search_engine_service.fetch_domain_verification_status.js,packages/google-cloud-discoveryengine/samples/README.md) |
+| Site_search_engine_service.fetch_sitemaps | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/site_search_engine_service.fetch_sitemaps.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/site_search_engine_service.fetch_sitemaps.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Site_search_engine_service.get_site_search_engine | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/site_search_engine_service.get_site_search_engine.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/site_search_engine_service.get_site_search_engine.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Site_search_engine_service.get_target_site | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/site_search_engine_service.get_target_site.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/site_search_engine_service.get_target_site.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Site_search_engine_service.list_target_sites | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/site_search_engine_service.list_target_sites.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/site_search_engine_service.list_target_sites.js,packages/google-cloud-discoveryengine/samples/README.md) |
@@ -466,4 +471,4 @@ See [LICENSE](https://github.com/googleapis/google-cloud-node/blob/main/LICENSE)
 [projects]: https://console.cloud.google.com/project
 [billing]: https://support.google.com/cloud/answer/6293499#enable-billing
 [enable_api]: https://console.cloud.google.com/flows/enableapi?apiid=discoveryengine.googleapis.com
-[auth]: https://cloud.google.com/docs/authentication/getting-started
+[auth]: https://cloud.google.com/docs/authentication/external/set-up-adc-local

package/build/protos/google/cloud/discoveryengine/v1/answer.proto

@@ -18,6 +18,7 @@ package google.cloud.discoveryengine.v1;
 
 import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
+import "google/cloud/discoveryengine/v1/safety.proto";
 import "google/protobuf/struct.proto";
 import "google/protobuf/timestamp.proto";
 
@@ -42,10 +43,13 @@ message Answer {
   // Citation info for a segment.
   message Citation {
     // Index indicates the start of the segment, measured in bytes (UTF-8
-    // unicode).
+    // unicode). If there are multi-byte characters,such as non-ASCII
+    // characters, the index measurement is longer than the string length.
     int64 start_index = 1;
 
-    // End of the attributed segment, exclusive.
+    // End of the attributed segment, exclusive. Measured in bytes (UTF-8
+    // unicode). If there are multi-byte characters,such as non-ASCII
+    // characters, the index measurement is longer than the string length.
     int64 end_index = 2;
 
     // Citation sources for the attributed segment.
@@ -58,6 +62,33 @@ message Answer {
     string reference_id = 1;
   }
 
+  // Grounding support for a claim in `answer_text`.
+  message GroundingSupport {
+    // Required. Index indicates the start of the claim, measured in bytes
+    // (UTF-8 unicode).
+    int64 start_index = 1 [(google.api.field_behavior) = REQUIRED];
+
+    // Required. End of the claim, exclusive.
+    int64 end_index = 2 [(google.api.field_behavior) = REQUIRED];
+
+    // A score in the range of [0, 1] describing how grounded is a specific
+    // claim by the references.
+    // Higher value means that the claim is better supported by the reference
+    // chunks.
+    optional double grounding_score = 3;
+
+    // Indicates that this claim required grounding check. When the
+    // system decided this claim didn't require attribution/grounding check,
+    // this field is set to false. In that case, no grounding check was
+    // done for the claim and therefore `grounding_score`, `sources` is not
+    // returned.
+    optional bool grounding_check_required = 4;
+
+    // Optional. Citation sources for the claim.
+    repeated CitationSource sources = 5
+        [(google.api.field_behavior) = OPTIONAL];
+  }
+
   // Reference.
   message Reference {
     // Unstructured document information.
@@ -148,6 +179,12 @@ message Answer {
 
       // Structured search data.
       google.protobuf.Struct struct_data = 2;
+
+      // Output only. The title of the document.
+      string title = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+      // Output only. The URI of the document.
+      string uri = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
     }
 
     // Search result content.
@@ -314,6 +351,9 @@ message Answer {
 
     // Answer generation has succeeded.
     SUCCEEDED = 3;
+
+    // Answer generation is currently in progress.
+    STREAMING = 4;
   }
 
   // An enum for answer skipped reasons.
@@ -381,9 +421,17 @@ message Answer {
   // The textual answer.
   string answer_text = 3;
 
+  // A score in the range of [0, 1] describing how grounded the answer is by the
+  // reference chunks.
+  optional double grounding_score = 12;
+
   // Citations.
   repeated Citation citations = 4;
 
+  // Optional. Grounding supports.
+  repeated GroundingSupport grounding_supports = 13
+      [(google.api.field_behavior) = OPTIONAL];
+
   // References.
   repeated Reference references = 5;
 
@@ -407,4 +455,8 @@ message Answer {
   // Output only. Answer completed timestamp.
   google.protobuf.Timestamp complete_time = 9
       [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Optional. Safety ratings.
+  repeated SafetyRating safety_ratings = 14
+      [(google.api.field_behavior) = OPTIONAL];
 }

package/build/protos/google/cloud/discoveryengine/v1/chunk.proto

@@ -99,7 +99,8 @@ message Chunk {
   // Output only. Represents the relevance score based on similarity.
   // Higher score indicates higher chunk relevance.
   // The score is in range [-1.0, 1.0].
-  // Only populated on [SearchService.SearchResponse][].
+  // Only populated on
+  // [SearchResponse][google.cloud.discoveryengine.v1.SearchResponse].
   optional double relevance_score = 8
       [(google.api.field_behavior) = OUTPUT_ONLY];
 

package/build/protos/google/cloud/discoveryengine/v1/common.proto

@@ -16,6 +16,7 @@ syntax = "proto3";
 
 package google.cloud.discoveryengine.v1;
 
+import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
 
 option csharp_namespace = "Google.Cloud.DiscoveryEngine.V1";
@@ -39,12 +40,6 @@ option (google.api.resource_definition) = {
   type: "discoveryengine.googleapis.com/Location"
   pattern: "projects/{project}/locations/{location}"
 };
-option (google.api.resource_definition) = {
-  type: "discoveryengine.googleapis.com/ServingConfig"
-  pattern: "projects/{project}/locations/{location}/dataStores/{data_store}/servingConfigs/{serving_config}"
-  pattern: "projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/servingConfigs/{serving_config}"
-  pattern: "projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/servingConfigs/{serving_config}"
-};
 option (google.api.resource_definition) = {
   type: "discoveryengine.googleapis.com/GroundingConfig"
   pattern: "projects/{project}/locations/{location}/groundingConfigs/{grounding_config}"
@@ -220,4 +215,38 @@ message UserInfo {
   // [UserEvent.direct_user_request][google.cloud.discoveryengine.v1.UserEvent.direct_user_request]
   // is set.
   string user_agent = 2;
+
+  // Optional. IANA time zone, e.g. Europe/Budapest.
+  string time_zone = 3 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Double list.
+message DoubleList {
+  // Double values.
+  repeated double values = 1;
+}
+
+// Promotion proto includes uri and other helping information to display the
+// promotion.
+message SearchLinkPromotion {
+  // Required. The title of the promotion.
+  // Maximum length: 160 characters.
+  string title = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The URL for the page the user wants to promote. Must be set for
+  // site search. For other verticals, this is optional.
+  string uri = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The promotion thumbnail image url.
+  string image_uri = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The Promotion description.
+  // Maximum length: 200 characters.
+  string description = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The enabled promotion will be returned for any serving configs
+  // associated with the parent of the control this promotion is attached to.
+  //
+  // This flag is used for basic site search only.
+  bool enabled = 5 [(google.api.field_behavior) = OPTIONAL];
 }

package/build/protos/google/cloud/discoveryengine/v1/control.proto

@@ -95,9 +95,97 @@ message Control {
 
   // Adjusts order of products in returned list.
   message BoostAction {
-    // Required. Strength of the boost, which should be in [-1, 1]. Negative
+    // Specification for custom ranking based on customer specified attribute
+    // value. It provides more controls for customized ranking than the simple
+    // (condition, boost) combination above.
+    message InterpolationBoostSpec {
+      // The control points used to define the curve. The curve defined
+      // through these control points can only be monotonically increasing
+      // or decreasing(constant values are acceptable).
+      message ControlPoint {
+        // Optional. Can be one of:
+        // 1. The numerical field value.
+        // 2. The duration spec for freshness:
+        // The value must be formatted as an XSD `dayTimeDuration` value (a
+        // restricted subset of an ISO 8601 duration value). The pattern for
+        // this is: `[nD][T[nH][nM][nS]]`.
+        string attribute_value = 1 [(google.api.field_behavior) = OPTIONAL];
+
+        // Optional. The value between -1 to 1 by which to boost the score if
+        // the attribute_value evaluates to the value specified above.
+        float boost_amount = 2 [(google.api.field_behavior) = OPTIONAL];
+      }
+
+      // The attribute(or function) for which the custom ranking is to be
+      // applied.
+      enum AttributeType {
+        // Unspecified AttributeType.
+        ATTRIBUTE_TYPE_UNSPECIFIED = 0;
+
+        // The value of the numerical field will be used to dynamically update
+        // the boost amount. In this case, the attribute_value (the x value)
+        // of the control point will be the actual value of the numerical
+        // field for which the boost_amount is specified.
+        NUMERICAL = 1;
+
+        // For the freshness use case the attribute value will be the duration
+        // between the current time and the date in the datetime field
+        // specified. The value must be formatted as an XSD `dayTimeDuration`
+        // value (a restricted subset of an ISO 8601 duration value). The
+        // pattern for this is: `[nD][T[nH][nM][nS]]`.
+        // For example, `5D`, `3DT12H30M`, `T24H`.
+        FRESHNESS = 2;
+      }
+
+      // The interpolation type to be applied. Default will be linear
+      // (Piecewise Linear).
+      enum InterpolationType {
+        // Interpolation type is unspecified. In this case, it defaults to
+        // Linear.
+        INTERPOLATION_TYPE_UNSPECIFIED = 0;
+
+        // Piecewise linear interpolation will be applied.
+        LINEAR = 1;
+      }
+
+      // Optional. The name of the field whose value will be used to determine
+      // the boost amount.
+      string field_name = 1 [(google.api.field_behavior) = OPTIONAL];
+
+      // Optional. The attribute type to be used to determine the boost amount.
+      // The attribute value can be derived from the field value of the
+      // specified field_name. In the case of numerical it is straightforward
+      // i.e. attribute_value = numerical_field_value. In the case of freshness
+      // however, attribute_value = (time.now() - datetime_field_value).
+      AttributeType attribute_type = 2 [(google.api.field_behavior) = OPTIONAL];
+
+      // Optional. The interpolation type to be applied to connect the control
+      // points listed below.
+      InterpolationType interpolation_type = 3
+          [(google.api.field_behavior) = OPTIONAL];
+
+      // Optional. The control points used to define the curve. The monotonic
+      // function (defined through the interpolation_type above) passes through
+      // the control points listed here.
+      repeated ControlPoint control_points = 4
+          [(google.api.field_behavior) = OPTIONAL];
+    }
+
+    // Constant value boost or custom ranking based boost specifications.
+    oneof boost_spec {
+      // Optional. Strength of the boost, which should be in [-1, 1]. Negative
+      // boost means demotion. Default is 0.0 (No-op).
+      float fixed_boost = 4 [(google.api.field_behavior) = OPTIONAL];
+
+      // Optional. Complex specification for custom ranking based on customer
+      // defined attribute value.
+      InterpolationBoostSpec interpolation_boost_spec = 5
+          [(google.api.field_behavior) = OPTIONAL];
+    }
+
+    // Strength of the boost, which should be in [-1, 1]. Negative
     // boost means demotion. Default is 0.0 (No-op).
-    float boost = 1 [(google.api.field_behavior) = REQUIRED];
+    float boost = 1 [deprecated = true];
 
     // Required. Specifies which products to apply the boost to.
     //
@@ -164,6 +252,24 @@ message Control {
     repeated string synonyms = 1;
   }
 
+  // Promote certain links based on some trigger queries.
+  //
+  // Example: Promote shoe store link when searching for `shoe` keyword.
+  // The link can be outside of associated data store.
+  message PromoteAction {
+    // Required. Data store with which this promotion is attached to.
+    string data_store = 1 [
+      (google.api.field_behavior) = REQUIRED,
+      (google.api.resource_reference) = {
+        type: "discoveryengine.googleapis.com/DataStore"
+      }
+    ];
+
+    // Required. Promotion attached to this action.
+    SearchLinkPromotion search_link_promotion = 2
+        [(google.api.field_behavior) = REQUIRED];
+  }
+
   // Actions are restricted by Vertical and Solution
   //
   // Required.
@@ -180,6 +286,11 @@ message Control {
 
     // Treats a group of terms as synonyms of one another.
     SynonymsAction synonyms_action = 10;
+
+    // Promote certain links based on predefined trigger queries.
+    //
+    // This now only supports basic site search.
+    PromoteAction promote_action = 15;
   }
 
   // Immutable. Fully qualified name

package/build/protos/google/cloud/discoveryengine/v1/conversational_search_service.proto

@@ -22,6 +22,7 @@ import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
 import "google/cloud/discoveryengine/v1/answer.proto";
 import "google/cloud/discoveryengine/v1/conversation.proto";
+import "google/cloud/discoveryengine/v1/safety.proto";
 import "google/cloud/discoveryengine/v1/search_service.proto";
 import "google/cloud/discoveryengine/v1/session.proto";
 import "google/protobuf/empty.proto";
@@ -166,6 +167,29 @@ service ConversationalSearchService {
     };
   }
 
+  // Answer query method (streaming).
+  //
+  // It takes one
+  // [AnswerQueryRequest][google.cloud.discoveryengine.v1.AnswerQueryRequest]
+  // and returns multiple
+  // [AnswerQueryResponse][google.cloud.discoveryengine.v1.AnswerQueryResponse]
+  // messages in a stream.
+  rpc StreamAnswerQuery(AnswerQueryRequest)
+      returns (stream AnswerQueryResponse) {
+    option (google.api.http) = {
+      post: "/v1/{serving_config=projects/*/locations/*/dataStores/*/servingConfigs/*}:streamAnswer"
+      body: "*"
+      additional_bindings {
+        post: "/v1/{serving_config=projects/*/locations/*/collections/*/dataStores/*/servingConfigs/*}:streamAnswer"
+        body: "*"
+      }
+      additional_bindings {
+        post: "/v1/{serving_config=projects/*/locations/*/collections/*/engines/*/servingConfigs/*}:streamAnswer"
+        body: "*"
+      }
+    };
+  }
+
   // Gets a Answer.
   rpc GetAnswer(GetAnswerRequest) returns (Answer) {
     option (google.api.http) = {
@@ -470,10 +494,50 @@ message ListConversationsResponse {
 // method.
 message AnswerQueryRequest {
   // Safety specification.
+  // There are two use cases:
+  // 1. when only safety_spec.enable is set, the BLOCK_LOW_AND_ABOVE threshold
+  // will be applied for all categories.
+  // 2. when safety_spec.enable is set and some safety_settings are set, only
+  // specified safety_settings are applied.
   message SafetySpec {
+    // Safety settings.
+    message SafetySetting {
+      // Probability based thresholds levels for blocking.
+      enum HarmBlockThreshold {
+        // Unspecified harm block threshold.
+        HARM_BLOCK_THRESHOLD_UNSPECIFIED = 0;
+
+        // Block low threshold and above (i.e. block more).
+        BLOCK_LOW_AND_ABOVE = 1;
+
+        // Block medium threshold and above.
+        BLOCK_MEDIUM_AND_ABOVE = 2;
+
+        // Block only high threshold (i.e. block less).
+        BLOCK_ONLY_HIGH = 3;
+
+        // Block none.
+        BLOCK_NONE = 4;
+
+        // Turn off the safety filter.
+        OFF = 5;
+      }
+
+      // Required. Harm category.
+      HarmCategory category = 1 [(google.api.field_behavior) = REQUIRED];
+
+      // Required. The harm block threshold.
+      HarmBlockThreshold threshold = 2 [(google.api.field_behavior) = REQUIRED];
+    }
+
     // Enable the safety filtering on the answer response. It is false by
     // default.
     bool enable = 1;
+
+    // Optional. Safety settings.
+    // This settings are effective only when the safety_spec.enable is true.
+    repeated SafetySetting safety_settings = 2
+        [(google.api.field_behavior) = OPTIONAL];
   }
 
   // Related questions specification.
@@ -482,6 +546,33 @@ message AnswerQueryRequest {
     bool enable = 1;
   }
 
+  // Grounding specification.
+  message GroundingSpec {
+    // Level to filter based on answer grounding.
+    enum FilteringLevel {
+      // Default is no filter
+      FILTERING_LEVEL_UNSPECIFIED = 0;
+
+      // Filter answers based on a low threshold.
+      FILTERING_LEVEL_LOW = 1;
+
+      // Filter answers based on a high threshold.
+      FILTERING_LEVEL_HIGH = 2;
+    }
+
+    // Optional. Specifies whether to include grounding_supports in the answer.
+    // The default value is `false`.
+    //
+    // When this field is set to `true`, returned answer will have
+    // `grounding_score` and will contain GroundingSupports for each claim.
+    bool include_grounding_supports = 2
+        [(google.api.field_behavior) = OPTIONAL];
+
+    // Optional. Specifies whether to enable the filtering based on grounding
+    // score and at what level.
+    FilteringLevel filtering_level = 3 [(google.api.field_behavior) = OPTIONAL];
+  }
+
   // Answer generation specification.
   message AnswerGenerationSpec {
     // Answer Generation Model specification.
@@ -750,6 +841,27 @@ message AnswerQueryRequest {
 
     // Query rephraser specification.
     message QueryRephraserSpec {
+      // Query Rephraser Model specification.
+      message ModelSpec {
+        // Query rephraser types. Currently only supports single-hop
+        // (max_rephrase_steps = 1) model selections. For multi-hop
+        // (max_rephrase_steps > 1), there is only one default model.
+        enum ModelType {
+          // Unspecified model type.
+          MODEL_TYPE_UNSPECIFIED = 0;
+
+          // Small query rephraser model. Gemini 1.0 XS model.
+          SMALL = 1;
+
+          // Large query rephraser model. Gemini 1.0 Pro model.
+          LARGE = 2;
+        }
+
+        // Optional. Enabled query rephraser model type. If not set, it will use
+        // LARGE by default.
+        ModelType model_type = 1 [(google.api.field_behavior) = OPTIONAL];
+      }
+
       // Disable query rephraser.
       bool disable = 1;
 
@@ -757,6 +869,9 @@ message AnswerQueryRequest {
       // The max number is 5 steps.
       // If not set or set to < 1, it will be set to 1 by default.
       int32 max_rephrase_steps = 2;
+
+      // Optional. Query Rephraser Model specification.
+      ModelSpec model_spec = 3 [(google.api.field_behavior) = OPTIONAL];
     }
 
     // Query classification specification.
@@ -764,6 +879,42 @@ message AnswerQueryRequest {
 
     // Query rephraser specification.
     QueryRephraserSpec query_rephraser_spec = 2;
+
+    // Optional. Whether to disable spell correction.
+    // The default value is `false`.
+    bool disable_spell_correction = 3 [(google.api.field_behavior) = OPTIONAL];
+  }
+
+  // End user specification.
+  message EndUserSpec {
+    // End user metadata.
+    message EndUserMetaData {
+      // Chunk information.
+      message ChunkInfo {
+        // Document metadata contains the information of the document of
+        // the current chunk.
+        message DocumentMetadata {
+          // Title of the document.
+          string title = 1;
+        }
+
+        // Chunk textual content. It is limited to 8000 characters.
+        string content = 1;
+
+        // Metadata of the document from the current chunk.
+        DocumentMetadata document_metadata = 2;
+      }
+
+      // Search result content.
+      oneof content {
+        // Chunk information.
+        ChunkInfo chunk_info = 1;
+      }
+    }
+
+    // Optional. End user metadata.
+    repeated EndUserMetaData end_user_metadata = 1
+        [(google.api.field_behavior) = OPTIONAL];
   }
 
   // Required. The resource name of the Search serving config, such as
@@ -798,6 +949,9 @@ message AnswerQueryRequest {
   // Related questions specification.
   RelatedQuestionsSpec related_questions_spec = 5;
 
+  // Optional. Grounding specification.
+  GroundingSpec grounding_spec = 6 [(google.api.field_behavior) = OPTIONAL];
+
   // Answer generation specification.
   AnswerGenerationSpec answer_generation_spec = 7;
 
@@ -850,6 +1004,9 @@ message AnswerQueryRequest {
   // Document](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements)
   // for more details.
   map<string, string> user_labels = 13;
+
+  // Optional. End user specification.
+  EndUserSpec end_user_spec = 14 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Response message for
@@ -940,6 +1097,10 @@ message GetSessionRequest {
       type: "discoveryengine.googleapis.com/Session"
     }
   ];
+
+  // Optional. If set to true, the full session including all answer details
+  // will be returned.
+  bool include_answer_details = 2 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Request for ListSessions method.
@@ -971,13 +1132,18 @@ message ListSessionsRequest {
   // A comma-separated list of fields to order by, sorted in ascending order.
   // Use "desc" after a field name for descending.
   // Supported fields:
+  //
   //   * `update_time`
   //   * `create_time`
   //   * `session_name`
+  //   * `is_pinned`
   //
   // Example:
-  // "update_time desc"
-  // "create_time"
+  //
+  // * "update_time desc"
+  // * "create_time"
+  // * "is_pinned desc,update_time desc": list sessions by is_pinned first, then
+  //    by update_time.
   string order_by = 5;
 }