google-cloud-discovery_engine-v1beta 0.15.0 → 0.17.0

data/proto_docs/google/cloud/discoveryengine/v1beta/completion_service.rb

@@ -111,6 +111,274 @@ module Google
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
         end
+
+        # Request message for
+        # {::Google::Cloud::DiscoveryEngine::V1beta::CompletionService::Client#advanced_complete_query CompletionService.AdvancedCompleteQuery}
+        # method.
+        # .
+        # @!attribute [rw] completion_config
+        #   @return [::String]
+        #     Required. The completion_config of the parent dataStore or engine resource
+        #     name for which the completion is performed, such as
+        #     `projects/*/locations/global/collections/default_collection/dataStores/*/completionConfig`
+        #     `projects/*/locations/global/collections/default_collection/engines/*/completionConfig`.
+        # @!attribute [rw] query
+        #   @return [::String]
+        #     Required. The typeahead input used to fetch suggestions. Maximum length is
+        #     128 characters.
+        #
+        #     The query can not be empty for most of the suggestion types. If it is
+        #     empty, an `INVALID_ARGUMENT` error is returned. The exception is when the
+        #     suggestion_types contains only the type `RECENT_SEARCH`, the query can
+        #     be an empty string. The is called "zero prefix" feature, which returns
+        #     user's recently searched queries given the empty query.
+        # @!attribute [rw] query_model
+        #   @return [::String]
+        #     Specifies the autocomplete data model. This overrides any model specified
+        #     in the Configuration > Autocomplete section of the Cloud console. Currently
+        #     supported values:
+        #
+        #     * `document` - Using suggestions generated from user-imported documents.
+        #     * `search-history` - Using suggestions generated from the past history of
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::SearchService::Client#search SearchService.Search}
+        #     API calls. Do not use it when there is no traffic for Search API.
+        #     * `user-event` - Using suggestions generated from user-imported search
+        #     events.
+        #     * `document-completable` - Using suggestions taken directly from
+        #     user-imported document fields marked as completable.
+        #
+        #     Default values:
+        #
+        #     * `document` is the default model for regular dataStores.
+        #     * `search-history` is the default model for site search dataStores.
+        # @!attribute [rw] user_pseudo_id
+        #   @return [::String]
+        #     A unique identifier for tracking visitors. For example, this could be
+        #     implemented with an HTTP cookie, which should be able to uniquely identify
+        #     a visitor on a single device. This unique identifier should not change if
+        #     the visitor logs in or out of the website.
+        #
+        #     This field should NOT have a fixed value such as `unknown_visitor`.
+        #
+        #     This should be the same identifier as
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::UserEvent#user_pseudo_id UserEvent.user_pseudo_id}
+        #     and
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::SearchRequest#user_pseudo_id SearchRequest.user_pseudo_id}.
+        #
+        #     The field must be a UTF-8 encoded string with a length limit of 128
+        # @!attribute [rw] user_info
+        #   @return [::Google::Cloud::DiscoveryEngine::V1beta::UserInfo]
+        #     Optional. Information about the end user.
+        #
+        #     This should be the same identifier information as
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::UserEvent#user_info UserEvent.user_info}
+        #     and
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::SearchRequest#user_info SearchRequest.user_info}.
+        # @!attribute [rw] include_tail_suggestions
+        #   @return [::Boolean]
+        #     Indicates if tail suggestions should be returned if there are no
+        #     suggestions that match the full query. Even if set to true, if there are
+        #     suggestions that match the full query, those are returned and no
+        #     tail suggestions are returned.
+        # @!attribute [rw] boost_spec
+        #   @return [::Google::Cloud::DiscoveryEngine::V1beta::AdvancedCompleteQueryRequest::BoostSpec]
+        #     Optional. Specification to boost suggestions matching the condition.
+        # @!attribute [rw] suggestion_types
+        #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::AdvancedCompleteQueryRequest::SuggestionType>]
+        #     Optional. Suggestion types to return. If empty or unspecified, query
+        #     suggestions are returned. Only one suggestion type is supported at the
+        #     moment.
+        class AdvancedCompleteQueryRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Specification to boost suggestions based on the condtion of the suggestion.
+          # @!attribute [rw] condition_boost_specs
+          #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::AdvancedCompleteQueryRequest::BoostSpec::ConditionBoostSpec>]
+          #     Condition boost specifications. If a suggestion matches multiple
+          #     conditions in the specifictions, boost values from these specifications
+          #     are all applied and combined in a non-linear way. Maximum number of
+          #     specifications is 20.
+          #
+          #     Note: Currently only support language condition boost.
+          class BoostSpec
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Boost applies to suggestions which match a condition.
+            # @!attribute [rw] condition
+            #   @return [::String]
+            #     An expression which specifies a boost condition. The syntax is the same
+            #     as [filter expression
+            #     syntax](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata#filter-expression-syntax).
+            #     Currently, the only supported condition is a list of BCP-47 lang codes.
+            #
+            #     Example:
+            #
+            #     * To boost suggestions in languages `en` or `fr`:
+            #     `(lang_code: ANY("en", "fr"))`
+            # @!attribute [rw] boost
+            #   @return [::Float]
+            #     Strength of the boost, which should be in [-1, 1].
+            #     Negative boost means demotion. Default is 0.0.
+            #
+            #     Setting to 1.0 gives the suggestions a big promotion. However, it does
+            #     not necessarily mean that the top result will be a boosted suggestion.
+            #
+            #     Setting to -1.0 gives the suggestions a big demotion. However, other
+            #     suggestions that are relevant might still be shown.
+            #
+            #     Setting to 0.0 means no boost applied. The boosting condition is
+            #     ignored.
+            class ConditionBoostSpec
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+          end
+
+          # Suggestion type to return.
+          module SuggestionType
+            # Default value.
+            SUGGESTION_TYPE_UNSPECIFIED = 0
+
+            # Returns query suggestions.
+            QUERY = 1
+
+            # Returns people suggestions.
+            PEOPLE = 2
+
+            # Returns content suggestions.
+            CONTENT = 3
+
+            # Returns recent search suggestions.
+            RECENT_SEARCH = 4
+
+            # Returns Google Workspace suggestions.
+            GOOGLE_WORKSPACE = 5
+          end
+        end
+
+        # Response message for
+        # {::Google::Cloud::DiscoveryEngine::V1beta::CompletionService::Client#advanced_complete_query CompletionService.AdvancedCompleteQuery}
+        # method.
+        # @!attribute [rw] query_suggestions
+        #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::AdvancedCompleteQueryResponse::QuerySuggestion>]
+        #     Results of the matched query suggestions. The result list is ordered and
+        #     the first result is a top suggestion.
+        # @!attribute [rw] tail_match_triggered
+        #   @return [::Boolean]
+        #     True if the returned suggestions are all tail suggestions.
+        #
+        #     For tail matching to be triggered, include_tail_suggestions in the request
+        #     must be true and there must be no suggestions that match the full query.
+        # @!attribute [rw] people_suggestions
+        #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::AdvancedCompleteQueryResponse::PersonSuggestion>]
+        #     Results of the matched people suggestions. The result list is ordered and
+        #     the first result is the top suggestion.
+        # @!attribute [rw] content_suggestions
+        #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::AdvancedCompleteQueryResponse::ContentSuggestion>]
+        #     Results of the matched content suggestions. The result list is ordered and
+        #     the first result is the top suggestion.
+        # @!attribute [rw] recent_search_suggestions
+        #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::AdvancedCompleteQueryResponse::RecentSearchSuggestion>]
+        #     Results of the matched "recent search" suggestions. The result list is
+        #     ordered and the first result is the top suggestion.
+        class AdvancedCompleteQueryResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Suggestions as search queries.
+          # @!attribute [rw] suggestion
+          #   @return [::String]
+          #     The suggestion for the query.
+          # @!attribute [rw] completable_field_paths
+          #   @return [::Array<::String>]
+          #     The unique document field paths that serve as the source of this
+          #     suggestion if it was generated from completable fields.
+          #
+          #     This field is only populated for the document-completable model.
+          # @!attribute [rw] data_store
+          #   @return [::Array<::String>]
+          #     The name of the dataStore that this suggestion belongs to.
+          class QuerySuggestion
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Suggestions as people.
+          # @!attribute [rw] suggestion
+          #   @return [::String]
+          #     The suggestion for the query.
+          # @!attribute [rw] person_type
+          #   @return [::Google::Cloud::DiscoveryEngine::V1beta::AdvancedCompleteQueryResponse::PersonSuggestion::PersonType]
+          #     The type of the person.
+          # @!attribute [rw] document
+          #   @return [::Google::Cloud::DiscoveryEngine::V1beta::Document]
+          #     The document data snippet in the suggestion. Only a subset of fields is
+          #     populated.
+          # @!attribute [rw] data_store
+          #   @return [::String]
+          #     The name of the dataStore that this suggestion belongs to.
+          class PersonSuggestion
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # The type of the person based on the source.
+            module PersonType
+              # Default value.
+              PERSON_TYPE_UNSPECIFIED = 0
+
+              # The suggestion is from a GOOGLE_IDENTITY source.
+              CLOUD_IDENTITY = 1
+
+              # The suggestion is from a THIRD_PARTY_IDENTITY source.
+              THIRD_PARTY_IDENTITY = 2
+            end
+          end
+
+          # Suggestions as content.
+          # @!attribute [rw] suggestion
+          #   @return [::String]
+          #     The suggestion for the query.
+          # @!attribute [rw] content_type
+          #   @return [::Google::Cloud::DiscoveryEngine::V1beta::AdvancedCompleteQueryResponse::ContentSuggestion::ContentType]
+          #     The type of the content suggestion.
+          # @!attribute [rw] document
+          #   @return [::Google::Cloud::DiscoveryEngine::V1beta::Document]
+          #     The document data snippet in the suggestion. Only a subset of fields will
+          #     be populated.
+          # @!attribute [rw] data_store
+          #   @return [::String]
+          #     The name of the dataStore that this suggestion belongs to.
+          class ContentSuggestion
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # The type of the content returned for content suggestions.
+            module ContentType
+              # Default value.
+              CONTENT_TYPE_UNSPECIFIED = 0
+
+              # The suggestion is from a Google Workspace source.
+              GOOGLE_WORKSPACE = 1
+
+              # The suggestion is from a third party source.
+              THIRD_PARTY = 2
+            end
+          end
+
+          # Suggestions from recent search history.
+          # @!attribute [rw] suggestion
+          #   @return [::String]
+          #     The suggestion for the query.
+          # @!attribute [rw] recent_search_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     The time when this recent rearch happened.
+          class RecentSearchSuggestion
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
       end
     end
   end

data/proto_docs/google/cloud/discoveryengine/v1beta/control.rb

@@ -26,6 +26,9 @@ module Google
         #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::Condition::QueryTerm>]
         #     Search only
         #     A list of terms to match the query on.
+        #     Cannot be set when
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::Condition#query_regex Condition.query_regex}
+        #     is set.
         #
         #     Maximum of 10 query terms.
         # @!attribute [rw] active_time_range
@@ -33,6 +36,12 @@ module Google
         #     Range of time(s) specifying when condition is active.
         #
         #     Maximum of 10 time ranges.
+        # @!attribute [rw] query_regex
+        #   @return [::String]
+        #     Optional. Query regex to match the whole search query.
+        #     Cannot be set when
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::Condition#query_terms Condition.query_terms}
+        #     is set. This is currently supporting promotion use case.
         class Condition
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/discoveryengine/v1beta/control_service.rb

@@ -25,9 +25,9 @@ module Google
         # @!attribute [rw] parent
         #   @return [::String]
         #     Required. Full resource name of parent data store. Format:
-        #     `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}`
+        #     `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`
         #     or
-        #     `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`.
+        #     `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`.
         # @!attribute [rw] control
         #   @return [::Google::Cloud::DiscoveryEngine::V1beta::Control]
         #     Required. The Control to create.
@@ -66,7 +66,7 @@ module Google
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The resource name of the Control to delete. Format:
-        #     `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`
+        #     `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`
         class DeleteControlRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -76,7 +76,7 @@ module Google
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The resource name of the Control to get. Format:
-        #     `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`
+        #     `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`
         class GetControlRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -86,9 +86,9 @@ module Google
         # @!attribute [rw] parent
         #   @return [::String]
         #     Required. The data store resource name. Format:
-        #     `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}`
+        #     `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`
         #     or
-        #     `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`.
+        #     `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`.
         # @!attribute [rw] page_size
         #   @return [::Integer]
         #     Optional. Maximum number of results to return. If unspecified, defaults

data/proto_docs/google/cloud/discoveryengine/v1beta/conversational_search_service.rb

@@ -27,9 +27,9 @@ module Google
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The resource name of the Conversation to get. Format:
-        #     `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`.
+        #     `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`.
         #     Use
-        #     `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/-`
+        #     `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/-`
         #     to activate auto session mode, which automatically creates a new
         #     conversation inside a ConverseConversation session.
         # @!attribute [rw] query
@@ -38,7 +38,7 @@ module Google
         # @!attribute [rw] serving_config
         #   @return [::String]
         #     The resource name of the Serving Config to use. Format:
-        #     `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/servingConfigs/{serving_config_id}`
+        #     `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/servingConfigs/{serving_config_id}`
         #     If this is not set, the default serving config will be used.
         # @!attribute [rw] conversation
         #   @return [::Google::Cloud::DiscoveryEngine::V1beta::Conversation]
@@ -131,7 +131,7 @@ module Google
         # @!attribute [rw] parent
         #   @return [::String]
         #     Required. Full resource name of parent data store. Format:
-        #     `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`
+        #     `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`
         # @!attribute [rw] conversation
         #   @return [::Google::Cloud::DiscoveryEngine::V1beta::Conversation]
         #     Required. The conversation to create.
@@ -162,7 +162,7 @@ module Google
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The resource name of the Conversation to delete. Format:
-        #     `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`
+        #     `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`
         class DeleteConversationRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -172,7 +172,7 @@ module Google
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The resource name of the Conversation to get. Format:
-        #     `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`
+        #     `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`
         class GetConversationRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -182,7 +182,7 @@ module Google
         # @!attribute [rw] parent
         #   @return [::String]
         #     Required. The data store resource name. Format:
-        #     `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`
+        #     `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`
         # @!attribute [rw] page_size
         #   @return [::Integer]
         #     Maximum number of results to return. If unspecified, defaults
@@ -255,6 +255,9 @@ module Google
         # @!attribute [rw] related_questions_spec
         #   @return [::Google::Cloud::DiscoveryEngine::V1beta::AnswerQueryRequest::RelatedQuestionsSpec]
         #     Related questions specification.
+        # @!attribute [rw] grounding_spec
+        #   @return [::Google::Cloud::DiscoveryEngine::V1beta::AnswerQueryRequest::GroundingSpec]
+        #     Optional. Grounding specification.
         # @!attribute [rw] answer_generation_spec
         #   @return [::Google::Cloud::DiscoveryEngine::V1beta::AnswerQueryRequest::AnswerGenerationSpec]
         #     Answer generation specification.
@@ -265,7 +268,11 @@ module Google
         #   @return [::Google::Cloud::DiscoveryEngine::V1beta::AnswerQueryRequest::QueryUnderstandingSpec]
         #     Query understanding specification.
         # @!attribute [rw] asynchronous_mode
+        #   @deprecated This field is deprecated and may be removed in the next major version update.
         #   @return [::Boolean]
+        #     Deprecated: This field is deprecated. Streaming Answer API will be
+        #     supported.
+        #
         #     Asynchronous mode control.
         #
         #     If enabled, the response will be returned with answer/session resource
@@ -328,6 +335,35 @@ module Google
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
+          # Grounding specification.
+          # @!attribute [rw] include_grounding_supports
+          #   @return [::Boolean]
+          #     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.
+          # @!attribute [rw] filtering_level
+          #   @return [::Google::Cloud::DiscoveryEngine::V1beta::AnswerQueryRequest::GroundingSpec::FilteringLevel]
+          #     Optional. Specifies whether to enable the filtering based on grounding
+          #     score and at what level.
+          class GroundingSpec
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Level to filter based on answer grounding.
+            module 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
+            end
+          end
+
           # Answer generation specification.
           # @!attribute [rw] model_spec
           #   @return [::Google::Cloud::DiscoveryEngine::V1beta::AnswerQueryRequest::AnswerGenerationSpec::ModelSpec]
@@ -373,6 +409,19 @@ module Google
           #     If this field is set to `false`, all search results are used regardless
           #     of relevance to generate answers. If set to `true` or unset, the behavior
           #     will be determined automatically by the service.
+          # @!attribute [rw] ignore_jail_breaking_query
+          #   @return [::Boolean]
+          #     Optional. Specifies whether to filter out jail-breaking queries. The
+          #     default value is `false`.
+          #
+          #     Google employs search-query classification to detect jail-breaking
+          #     queries. No summary is returned if the search query is classified as a
+          #     jail-breaking query. A user might add instructions to the query to
+          #     change the tone, style, language, content of the answer, or ask the
+          #     model to act as a different entity, e.g. "Reply in the tone of a
+          #     competing company's CEO". If this field is set to `true`, we skip
+          #     generating summaries for jail-breaking queries and return fallback
+          #     messages instead.
           class AnswerGenerationSpec
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -459,6 +508,10 @@ module Google
             #     configurations for those dataStores. This is only considered for
             #     engines with multiple dataStores use case. For single dataStore within
             #     an engine, they should use the specs at the top level.
+            # @!attribute [rw] natural_language_query_understanding_spec
+            #   @return [::Google::Cloud::DiscoveryEngine::V1beta::SearchRequest::NaturalLanguageQueryUnderstandingSpec]
+            #     Optional. Specification to enable natural language understanding
+            #     capabilities for search requests.
             class SearchParams
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -495,12 +548,18 @@ module Google
                 #     Title.
                 # @!attribute [rw] document_contexts
                 #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::AnswerQueryRequest::SearchSpec::SearchResultList::SearchResult::UnstructuredDocumentInfo::DocumentContext>]
-                #     List of document contexts.
+                #     List of document contexts. The content will be used for Answer
+                #     Generation. This is supposed to be the main content of the document
+                #     that can be long and comprehensive.
                 # @!attribute [rw] extractive_segments
                 #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::AnswerQueryRequest::SearchSpec::SearchResultList::SearchResult::UnstructuredDocumentInfo::ExtractiveSegment>]
                 #     List of extractive segments.
                 # @!attribute [rw] extractive_answers
+                #   @deprecated This field is deprecated and may be removed in the next major version update.
                 #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::AnswerQueryRequest::SearchSpec::SearchResultList::SearchResult::UnstructuredDocumentInfo::ExtractiveAnswer>]
+                #     Deprecated: This field is deprecated and will have no effect on
+                #     the Answer generation.
+                #     Please use document_contexts and extractive_segments fields.
                 #     List of extractive answers.
                 class UnstructuredDocumentInfo
                   include ::Google::Protobuf::MessageExts
@@ -512,7 +571,7 @@ module Google
                   #     Page identifier.
                   # @!attribute [rw] content
                   #   @return [::String]
-                  #     Document content.
+                  #     Document content to be used for answer generation.
                   class DocumentContext
                     include ::Google::Protobuf::MessageExts
                     extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -520,6 +579,8 @@ module Google
 
                   # Extractive segment.
                   # [Guide](https://cloud.google.com/generative-ai-app-builder/docs/snippets#extractive-segments)
+                  # Answer generation will only use it if document_contexts is empty.
+                  # This is supposed to be shorter snippets.
                   # @!attribute [rw] page_identifier
                   #   @return [::String]
                   #     Page identifier.
@@ -552,9 +613,25 @@ module Google
                 # @!attribute [rw] content
                 #   @return [::String]
                 #     Chunk textual content.
+                # @!attribute [rw] document_metadata
+                #   @return [::Google::Cloud::DiscoveryEngine::V1beta::AnswerQueryRequest::SearchSpec::SearchResultList::SearchResult::ChunkInfo::DocumentMetadata]
+                #     Metadata of the document from the current chunk.
                 class ChunkInfo
                   include ::Google::Protobuf::MessageExts
                   extend ::Google::Protobuf::MessageExts::ClassMethods
+
+                  # Document metadata contains the information of the document of the
+                  # current chunk.
+                  # @!attribute [rw] uri
+                  #   @return [::String]
+                  #     Uri of the document.
+                  # @!attribute [rw] title
+                  #   @return [::String]
+                  #     Title of the document.
+                  class DocumentMetadata
+                    include ::Google::Protobuf::MessageExts
+                    extend ::Google::Protobuf::MessageExts::ClassMethods
+                  end
                 end
               end
             end
@@ -587,11 +664,14 @@ module Google
                 # Adversarial query classification type.
                 ADVERSARIAL_QUERY = 1
 
-                # Non-answer-seeking query classification type.
+                # Non-answer-seeking query classification type, for chit chat.
                 NON_ANSWER_SEEKING_QUERY = 2
 
                 # Jail-breaking query classification type.
                 JAIL_BREAKING_QUERY = 3
+
+                # Non-answer-seeking query classification type, for no clear intent.
+                NON_ANSWER_SEEKING_QUERY_V2 = 4
               end
             end
 
@@ -651,7 +731,7 @@ module Google
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The resource name of the Answer to get. Format:
-        #     `projects/{project_number}/locations/{location_id}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}`
+        #     `projects/{project}/locations/{location}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}`
         class GetAnswerRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -661,7 +741,7 @@ module Google
         # @!attribute [rw] parent
         #   @return [::String]
         #     Required. Full resource name of parent data store. Format:
-        #     `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`
+        #     `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`
         # @!attribute [rw] session
         #   @return [::Google::Cloud::DiscoveryEngine::V1beta::Session]
         #     Required. The session to create.
@@ -692,7 +772,7 @@ module Google
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The resource name of the Session to delete. Format:
-        #     `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`
+        #     `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`
         class DeleteSessionRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -702,7 +782,7 @@ module Google
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The resource name of the Session to get. Format:
-        #     `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`
+        #     `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`
         class GetSessionRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -712,7 +792,7 @@ module Google
         # @!attribute [rw] parent
         #   @return [::String]
         #     Required. The data store resource name. Format:
-        #     `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`
+        #     `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`
         # @!attribute [rw] page_size
         #   @return [::Integer]
         #     Maximum number of results to return. If unspecified, defaults

data/proto_docs/google/cloud/discoveryengine/v1beta/custom_tuning_model.rb

@@ -27,8 +27,9 @@ module Google
         #     Required. The fully qualified resource name of the model.
         #
         #     Format:
-        #     `projects/{project_number}/locations/{location}/collections/{collection}/dataStores/{data_store}/customTuningModels/{custom_tuning_model}`
-        #     model must be an alpha-numerical string with limit of 40 characters.
+        #     `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/customTuningModels/{custom_tuning_model}`.
+        #
+        #     Model must be an alpha-numerical string with limit of 40 characters.
         # @!attribute [rw] display_name
         #   @return [::String]
         #     The display name of the model.
@@ -41,13 +42,17 @@ module Google
         # @!attribute [rw] create_time
         #   @deprecated This field is deprecated and may be removed in the next major version update.
         #   @return [::Google::Protobuf::Timestamp]
-        #     Timestamp the Model was created at.
+        #     Deprecated: Timestamp the Model was created at.
         # @!attribute [rw] training_start_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Timestamp the model training was initiated.
         # @!attribute [rw] metrics
         #   @return [::Google::Protobuf::Map{::String => ::Float}]
         #     The metrics of the trained model.
+        # @!attribute [rw] error_message
+        #   @return [::String]
+        #     Currently this is only populated if the model state is
+        #     `INPUT_VALIDATION_FAILED`.
         class CustomTuningModel
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods