Class: Google::Cloud::Dialogflow::V2::SearchKnowledgeRequest::SearchConfig

Inherits:

Object

Object
Google::Cloud::Dialogflow::V2::SearchKnowledgeRequest::SearchConfig

show all

Extended by:: Protobuf::MessageExts::ClassMethods

Includes:: Protobuf::MessageExts

Defined in:: proto_docs/google/cloud/dialogflow/v2/conversation.rb

Overview

Configuration specific to search queries with data stores.

Defined Under Namespace

Classes: BoostSpecs, FilterSpecs

Instance Attribute Summary collapse

Instance Attribute Details

#boost_specs ⇒ `::Array<::Google::Cloud::Dialogflow::V2::SearchKnowledgeRequest::SearchConfig::BoostSpecs>`

Returns Optional. Boost specifications for data stores.

Returns:

(::Array<::Google::Cloud::Dialogflow::V2::SearchKnowledgeRequest::SearchConfig::BoostSpecs>) —
Optional. Boost specifications for data stores.

# File 'proto_docs/google/cloud/dialogflow/v2/conversation.rb', line 542

class SearchConfig
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Boost specifications for data stores.
  # @!attribute [rw] data_stores
  #   @return [::Array<::String>]
  #     Optional. Data Stores where the boosting configuration is applied. The
  #     full names of the referenced data stores. Formats:
  #     `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}`
  #     `projects/{project}/locations/{location}/dataStores/{data_store}`
  # @!attribute [rw] spec
  #   @return [::Array<::Google::Cloud::Dialogflow::V2::SearchKnowledgeRequest::SearchConfig::BoostSpecs::BoostSpec>]
  #     Optional. A list of boosting specifications.
  class BoostSpecs
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Boost specification to boost certain documents.
    # A copy of google.cloud.discoveryengine.v1main.BoostSpec, field
    # documentation is available at
    # https://cloud.google.com/generative-ai-app-builder/docs/reference/rest/v1alpha/BoostSpec
    # @!attribute [rw] condition_boost_specs
    #   @return [::Array<::Google::Cloud::Dialogflow::V2::SearchKnowledgeRequest::SearchConfig::BoostSpecs::BoostSpec::ConditionBoostSpec>]
    #     Optional. Condition boost specifications. If a document matches
    #     multiple conditions in the specifictions, boost scores from these
    #     specifications are all applied and combined in a non-linear way.
    #     Maximum number of specifications is 20.
    class BoostSpec
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Boost applies to documents which match a condition.
      # @!attribute [rw] condition
      #   @return [::String]
      #     Optional. An expression which specifies a boost condition. The
      #     syntax and supported fields are the same as a filter expression.
      #     Examples:
      #
      #     * To boost documents with document ID "doc_1" or "doc_2", and
      #     color
      #       "Red" or "Blue":
      #         * (id: ANY("doc_1", "doc_2")) AND (color: ANY("Red","Blue"))
      # @!attribute [rw] boost
      #   @return [::Float]
      #     Optional. Strength of the condition boost, which should be in [-1,
      #     1]. Negative boost means demotion. Default is 0.0.
      #
      #     Setting to 1.0 gives the document a big promotion. However, it does
      #     not necessarily mean that the boosted document will be the top
      #     result at all times, nor that other documents will be excluded.
      #     Results could still be shown even when none of them matches the
      #     condition. And results that are significantly more relevant to the
      #     search query can still trump your heavily favored but irrelevant
      #     documents.
      #
      #     Setting to -1.0 gives the document a big demotion. However, results
      #     that are deeply relevant might still be shown. The document will
      #     have an upstream battle to get a fairly high ranking, but it is not
      #     blocked out completely.
      #
      #     Setting to 0.0 means no boost applied. The boosting condition is
      #     ignored.
      # @!attribute [rw] boost_control_spec
      #   @return [::Google::Cloud::Dialogflow::V2::SearchKnowledgeRequest::SearchConfig::BoostSpecs::BoostSpec::ConditionBoostSpec::BoostControlSpec]
      #     Optional. Complex specification for custom ranking based on
      #     customer defined attribute value.
      class ConditionBoostSpec
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Specification for custom ranking based on customer specified
        # attribute
        # value. It provides more controls for customized ranking than the
        # simple (condition, boost) combination above.
        # @!attribute [rw] field_name
        #   @return [::String]
        #     Optional. The name of the field whose value will be used to
        #     determine the boost amount.
        # @!attribute [rw] attribute_type
        #   @return [::Google::Cloud::Dialogflow::V2::SearchKnowledgeRequest::SearchConfig::BoostSpecs::BoostSpec::ConditionBoostSpec::BoostControlSpec::AttributeType]
        #     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).
        # @!attribute [rw] interpolation_type
        #   @return [::Google::Cloud::Dialogflow::V2::SearchKnowledgeRequest::SearchConfig::BoostSpecs::BoostSpec::ConditionBoostSpec::BoostControlSpec::InterpolationType]
        #     Optional. The interpolation type to be applied to connect the
        #     control points listed below.
        # @!attribute [rw] control_points
        #   @return [::Array<::Google::Cloud::Dialogflow::V2::SearchKnowledgeRequest::SearchConfig::BoostSpecs::BoostSpec::ConditionBoostSpec::BoostControlSpec::ControlPoint>]
        #     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.
        class BoostControlSpec
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods

          # 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).
          class ControlPoint
            include ::Google::Protobuf::MessageExts
            extend ::Google::Protobuf::MessageExts::ClassMethods
          end

          # The attribute(or function) for which the custom ranking is to be
          # applied.
          module 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]]`. E.g. `5D`, `3DT12H30M`, `T24H`.
            FRESHNESS = 2
          end

          # The interpolation type to be applied. Default will be linear
          # (Piecewise Linear).
          module InterpolationType
            # Interpolation type is unspecified. In this case, it defaults to
            # Linear.
            INTERPOLATION_TYPE_UNSPECIFIED = 0

            # Piecewise linear interpolation will be applied.
            LINEAR = 1
          end
        end
      end
    end
  end

  # Filter specification for data store queries.
  # @!attribute [rw] data_stores
  #   @return [::Array<::String>]
  #     Optional. The data store where the filter configuration is applied.
  #     Full resource name of data store, such as
  #     projects/\\{project}/locations/\\{location}/collections/\\{collectionId}/
  #     dataStores/\\{dataStoreId}.
  # @!attribute [rw] filter
  #   @return [::String]
  #     Optional. The filter expression to be applied.
  #     Expression syntax is documented at
  #     https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata#filter-expression-syntax
  class FilterSpecs
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end
end

#filter_specs ⇒ `::Array<::Google::Cloud::Dialogflow::V2::SearchKnowledgeRequest::SearchConfig::FilterSpecs>`

Returns Optional. Filter specification for data store queries.