google-cloud-dialogflow 0.14.0 → 1.1.2

data/lib/google/cloud/dialogflow/v2/doc/google/cloud/dialogflow/v2/session.rb

@@ -1,498 +0,0 @@
-# Copyright 2020 Google LLC
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     https://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-
-module Google
-  module Cloud
-    module Dialogflow
-      module V2
-        # ============================================================================
-        # Requests and responses for custom methods.
-        # The request to detect user's intent.
-        # @!attribute [rw] session
-        #   @return [String]
-        #     Required. The name of the session this query is sent to. Format:
-        #     `projects/<Project ID>/agent/sessions/<Session ID>`. It's up to the API
-        #     caller to choose an appropriate session ID. It can be a random number or
-        #     some type of user identifier (preferably hashed). The length of the session
-        #     ID must not exceed 36 bytes.
-        # @!attribute [rw] query_params
-        #   @return [Google::Cloud::Dialogflow::V2::QueryParameters]
-        #     The parameters of this query.
-        # @!attribute [rw] query_input
-        #   @return [Google::Cloud::Dialogflow::V2::QueryInput]
-        #     Required. The input specification. It can be set to:
-        #
-        #     1.  an audio config
-        #         which instructs the speech recognizer how to process the speech audio,
-        #
-        #     2.  a conversational query in the form of text, or
-        #
-        #     3.  an event that specifies which intent to trigger.
-        # @!attribute [rw] output_audio_config
-        #   @return [Google::Cloud::Dialogflow::V2::OutputAudioConfig]
-        #     Instructs the speech synthesizer how to generate the output
-        #     audio. If this field is not set and agent-level speech synthesizer is not
-        #     configured, no output audio is generated.
-        # @!attribute [rw] output_audio_config_mask
-        #   @return [Google::Protobuf::FieldMask]
-        #     Mask for {Google::Cloud::Dialogflow::V2::DetectIntentRequest#output_audio_config output_audio_config} indicating which settings in this
-        #     request-level config should override speech synthesizer settings defined at
-        #     agent-level.
-        #
-        #     If unspecified or empty, {Google::Cloud::Dialogflow::V2::DetectIntentRequest#output_audio_config output_audio_config} replaces the agent-level
-        #     config in its entirety.
-        # @!attribute [rw] input_audio
-        #   @return [String]
-        #     The natural language speech audio to be processed. This field
-        #     should be populated iff `query_input` is set to an input audio config.
-        #     A single request can contain up to 1 minute of speech audio data.
-        class DetectIntentRequest; end
-
-        # The message returned from the DetectIntent method.
-        # @!attribute [rw] response_id
-        #   @return [String]
-        #     The unique identifier of the response. It can be used to
-        #     locate a response in the training example set or for reporting issues.
-        # @!attribute [rw] query_result
-        #   @return [Google::Cloud::Dialogflow::V2::QueryResult]
-        #     The selected results of the conversational query or event processing.
-        #     See `alternative_query_results` for additional potential results.
-        # @!attribute [rw] webhook_status
-        #   @return [Google::Rpc::Status]
-        #     Specifies the status of the webhook request.
-        # @!attribute [rw] output_audio
-        #   @return [String]
-        #     The audio data bytes encoded as specified in the request.
-        #     Note: The output audio is generated based on the values of default platform
-        #     text responses found in the `query_result.fulfillment_messages` field. If
-        #     multiple default text responses exist, they will be concatenated when
-        #     generating audio. If no default platform text responses exist, the
-        #     generated audio content will be empty.
-        # @!attribute [rw] output_audio_config
-        #   @return [Google::Cloud::Dialogflow::V2::OutputAudioConfig]
-        #     The config used by the speech synthesizer to generate the output audio.
-        class DetectIntentResponse; end
-
-        # Represents the parameters of the conversational query.
-        # @!attribute [rw] time_zone
-        #   @return [String]
-        #     The time zone of this conversational query from the
-        #     [time zone database](https://www.iana.org/time-zones), e.g.,
-        #     America/New_York, Europe/Paris. If not provided, the time zone specified in
-        #     agent settings is used.
-        # @!attribute [rw] geo_location
-        #   @return [Google::Type::LatLng]
-        #     The geo location of this conversational query.
-        # @!attribute [rw] contexts
-        #   @return [Array<Google::Cloud::Dialogflow::V2::Context>]
-        #     The collection of contexts to be activated before this query is
-        #     executed.
-        # @!attribute [rw] reset_contexts
-        #   @return [true, false]
-        #     Specifies whether to delete all contexts in the current session
-        #     before the new ones are activated.
-        # @!attribute [rw] session_entity_types
-        #   @return [Array<Google::Cloud::Dialogflow::V2::SessionEntityType>]
-        #     Additional session entity types to replace or extend developer
-        #     entity types with. The entity synonyms apply to all languages and persist
-        #     for the session of this query.
-        # @!attribute [rw] payload
-        #   @return [Google::Protobuf::Struct]
-        #     This field can be used to pass custom data into the webhook
-        #     associated with the agent. Arbitrary JSON objects are supported.
-        # @!attribute [rw] sentiment_analysis_request_config
-        #   @return [Google::Cloud::Dialogflow::V2::SentimentAnalysisRequestConfig]
-        #     Configures the type of sentiment analysis to perform. If not
-        #     provided, sentiment analysis is not performed.
-        class QueryParameters; end
-
-        # Represents the query input. It can contain either:
-        #
-        # 1.  An audio config which
-        #     instructs the speech recognizer how to process the speech audio.
-        #
-        # 2.  A conversational query in the form of text,.
-        #
-        # 3.  An event that specifies which intent to trigger.
-        # @!attribute [rw] audio_config
-        #   @return [Google::Cloud::Dialogflow::V2::InputAudioConfig]
-        #     Instructs the speech recognizer how to process the speech audio.
-        # @!attribute [rw] text
-        #   @return [Google::Cloud::Dialogflow::V2::TextInput]
-        #     The natural language text to be processed.
-        # @!attribute [rw] event
-        #   @return [Google::Cloud::Dialogflow::V2::EventInput]
-        #     The event to be processed.
-        class QueryInput; end
-
-        # Represents the result of conversational query or event processing.
-        # @!attribute [rw] query_text
-        #   @return [String]
-        #     The original conversational query text:
-        #
-        #     * If natural language text was provided as input, `query_text` contains
-        #       a copy of the input.
-        #     * If natural language speech audio was provided as input, `query_text`
-        #       contains the speech recognition result. If speech recognizer produced
-        #       multiple alternatives, a particular one is picked.
-        #     * If automatic spell correction is enabled, `query_text` will contain the
-        #       corrected user input.
-        # @!attribute [rw] language_code
-        #   @return [String]
-        #     The language that was triggered during intent detection.
-        #     See [Language
-        #     Support](https://cloud.google.com/dialogflow/docs/reference/language)
-        #     for a list of the currently supported language codes.
-        # @!attribute [rw] speech_recognition_confidence
-        #   @return [Float]
-        #     The Speech recognition confidence between 0.0 and 1.0. A higher number
-        #     indicates an estimated greater likelihood that the recognized words are
-        #     correct. The default of 0.0 is a sentinel value indicating that confidence
-        #     was not set.
-        #
-        #     This field is not guaranteed to be accurate or set. In particular this
-        #     field isn't set for StreamingDetectIntent since the streaming endpoint has
-        #     separate confidence estimates per portion of the audio in
-        #     StreamingRecognitionResult.
-        # @!attribute [rw] action
-        #   @return [String]
-        #     The action name from the matched intent.
-        # @!attribute [rw] parameters
-        #   @return [Google::Protobuf::Struct]
-        #     The collection of extracted parameters.
-        # @!attribute [rw] all_required_params_present
-        #   @return [true, false]
-        #     This field is set to:
-        #
-        #     * `false` if the matched intent has required parameters and not all of
-        #       the required parameter values have been collected.
-        #     * `true` if all required parameter values have been collected, or if the
-        #       matched intent doesn't contain any required parameters.
-        # @!attribute [rw] fulfillment_text
-        #   @return [String]
-        #     The text to be pronounced to the user or shown on the screen.
-        #     Note: This is a legacy field, `fulfillment_messages` should be preferred.
-        # @!attribute [rw] fulfillment_messages
-        #   @return [Array<Google::Cloud::Dialogflow::V2::Intent::Message>]
-        #     The collection of rich messages to present to the user.
-        # @!attribute [rw] webhook_source
-        #   @return [String]
-        #     If the query was fulfilled by a webhook call, this field is set to the
-        #     value of the `source` field returned in the webhook response.
-        # @!attribute [rw] webhook_payload
-        #   @return [Google::Protobuf::Struct]
-        #     If the query was fulfilled by a webhook call, this field is set to the
-        #     value of the `payload` field returned in the webhook response.
-        # @!attribute [rw] output_contexts
-        #   @return [Array<Google::Cloud::Dialogflow::V2::Context>]
-        #     The collection of output contexts. If applicable,
-        #     `output_contexts.parameters` contains entries with name
-        #     `<parameter name>.original` containing the original parameter values
-        #     before the query.
-        # @!attribute [rw] intent
-        #   @return [Google::Cloud::Dialogflow::V2::Intent]
-        #     The intent that matched the conversational query. Some, not
-        #     all fields are filled in this message, including but not limited to:
-        #     `name`, `display_name`, `end_interaction` and `is_fallback`.
-        # @!attribute [rw] intent_detection_confidence
-        #   @return [Float]
-        #     The intent detection confidence. Values range from 0.0
-        #     (completely uncertain) to 1.0 (completely certain).
-        #     This value is for informational purpose only and is only used to
-        #     help match the best intent within the classification threshold.
-        #     This value may change for the same end-user expression at any time due to a
-        #     model retraining or change in implementation.
-        #     If there are `multiple knowledge_answers` messages, this value is set to
-        #     the greatest `knowledgeAnswers.match_confidence` value in the list.
-        # @!attribute [rw] diagnostic_info
-        #   @return [Google::Protobuf::Struct]
-        #     Free-form diagnostic information for the associated detect intent request.
-        #     The fields of this data can change without notice, so you should not write
-        #     code that depends on its structure.
-        #     The data may contain:
-        #
-        #     * webhook call latency
-        #     * webhook errors
-        # @!attribute [rw] sentiment_analysis_result
-        #   @return [Google::Cloud::Dialogflow::V2::SentimentAnalysisResult]
-        #     The sentiment analysis result, which depends on the
-        #     `sentiment_analysis_request_config` specified in the request.
-        class QueryResult; end
-
-        # The top-level message sent by the client to the
-        # {Google::Cloud::Dialogflow::V2::Sessions::StreamingDetectIntent Sessions::StreamingDetectIntent} method.
-        #
-        # Multiple request messages should be sent in order:
-        #
-        # 1.  The first message must contain
-        # {Google::Cloud::Dialogflow::V2::StreamingDetectIntentRequest#session session},
-        #     {Google::Cloud::Dialogflow::V2::StreamingDetectIntentRequest#query_input query_input} plus optionally
-        #     {Google::Cloud::Dialogflow::V2::StreamingDetectIntentRequest#query_params query_params}. If the client
-        #     wants to receive an audio response, it should also contain
-        #     {Google::Cloud::Dialogflow::V2::StreamingDetectIntentRequest#output_audio_config output_audio_config}.
-        #     The message must not contain
-        #     {Google::Cloud::Dialogflow::V2::StreamingDetectIntentRequest#input_audio input_audio}.
-        # 2.  If {Google::Cloud::Dialogflow::V2::StreamingDetectIntentRequest#query_input query_input} was set to
-        #     {Google::Cloud::Dialogflow::V2::InputAudioConfig query_input::audio_config}, all subsequent
-        #     messages must contain
-        #     {Google::Cloud::Dialogflow::V2::StreamingDetectIntentRequest#input_audio input_audio} to continue with
-        #     Speech recognition.
-        #     If you decide to rather detect an intent from text input after you
-        #     already started Speech recognition, please send a message with
-        #     {Google::Cloud::Dialogflow::V2::QueryInput#text query_input::text}.
-        #
-        #     However, note that:
-        #
-        # * Dialogflow will bill you for the audio duration so far.
-        #   * Dialogflow discards all Speech recognition results in favor of the
-        #     input text.
-        #     * Dialogflow will use the language code from the first message.
-        #
-        #     After you sent all input, you must half-close or abort the request stream.
-        # @!attribute [rw] session
-        #   @return [String]
-        #     Required. The name of the session the query is sent to.
-        #     Format of the session name:
-        #     `projects/<Project ID>/agent/sessions/<Session ID>`. It's up to the API
-        #     caller to choose an appropriate `Session ID`. It can be a random number or
-        #     some type of user identifier (preferably hashed). The length of the session
-        #     ID must not exceed 36 characters.
-        # @!attribute [rw] query_params
-        #   @return [Google::Cloud::Dialogflow::V2::QueryParameters]
-        #     The parameters of this query.
-        # @!attribute [rw] query_input
-        #   @return [Google::Cloud::Dialogflow::V2::QueryInput]
-        #     Required. The input specification. It can be set to:
-        #
-        #     1.  an audio config which instructs the speech recognizer how to process
-        #         the speech audio,
-        #
-        #     2.  a conversational query in the form of text, or
-        #
-        #     3.  an event that specifies which intent to trigger.
-        # @!attribute [rw] single_utterance
-        #   @return [true, false]
-        #     Please use {Google::Cloud::Dialogflow::V2::InputAudioConfig#single_utterance InputAudioConfig#single_utterance} instead.
-        #     If `false` (default), recognition does not cease until
-        #     the client closes the stream. If `true`, the recognizer will detect a
-        #     single spoken utterance in input audio. Recognition ceases when it detects
-        #     the audio's voice has stopped or paused. In this case, once a detected
-        #     intent is received, the client should close the stream and start a new
-        #     request with a new stream as needed.
-        #     This setting is ignored when `query_input` is a piece of text or an event.
-        # @!attribute [rw] output_audio_config
-        #   @return [Google::Cloud::Dialogflow::V2::OutputAudioConfig]
-        #     Instructs the speech synthesizer how to generate the output
-        #     audio. If this field is not set and agent-level speech synthesizer is not
-        #     configured, no output audio is generated.
-        # @!attribute [rw] output_audio_config_mask
-        #   @return [Google::Protobuf::FieldMask]
-        #     Mask for {Google::Cloud::Dialogflow::V2::StreamingDetectIntentRequest#output_audio_config output_audio_config} indicating which settings in this
-        #     request-level config should override speech synthesizer settings defined at
-        #     agent-level.
-        #
-        #     If unspecified or empty, {Google::Cloud::Dialogflow::V2::StreamingDetectIntentRequest#output_audio_config output_audio_config} replaces the agent-level
-        #     config in its entirety.
-        # @!attribute [rw] input_audio
-        #   @return [String]
-        #     The input audio content to be recognized. Must be sent if
-        #     `query_input` was set to a streaming input audio config. The complete audio
-        #     over all streaming messages must not exceed 1 minute.
-        class StreamingDetectIntentRequest; end
-
-        # The top-level message returned from the
-        # `StreamingDetectIntent` method.
-        #
-        # Multiple response messages can be returned in order:
-        #
-        # 1.  If the input was set to streaming audio, the first one or more messages
-        #     contain `recognition_result`. Each `recognition_result` represents a more
-        #     complete transcript of what the user said. The last `recognition_result`
-        #     has `is_final` set to `true`.
-        #
-        # 2.  The next message contains `response_id`, `query_result`
-        #     and optionally `webhook_status` if a WebHook was called.
-        # @!attribute [rw] response_id
-        #   @return [String]
-        #     The unique identifier of the response. It can be used to
-        #     locate a response in the training example set or for reporting issues.
-        # @!attribute [rw] recognition_result
-        #   @return [Google::Cloud::Dialogflow::V2::StreamingRecognitionResult]
-        #     The result of speech recognition.
-        # @!attribute [rw] query_result
-        #   @return [Google::Cloud::Dialogflow::V2::QueryResult]
-        #     The result of the conversational query or event processing.
-        # @!attribute [rw] webhook_status
-        #   @return [Google::Rpc::Status]
-        #     Specifies the status of the webhook request.
-        # @!attribute [rw] output_audio
-        #   @return [String]
-        #     The audio data bytes encoded as specified in the request.
-        #     Note: The output audio is generated based on the values of default platform
-        #     text responses found in the `query_result.fulfillment_messages` field. If
-        #     multiple default text responses exist, they will be concatenated when
-        #     generating audio. If no default platform text responses exist, the
-        #     generated audio content will be empty.
-        # @!attribute [rw] output_audio_config
-        #   @return [Google::Cloud::Dialogflow::V2::OutputAudioConfig]
-        #     The config used by the speech synthesizer to generate the output audio.
-        class StreamingDetectIntentResponse; end
-
-        # Contains a speech recognition result corresponding to a portion of the audio
-        # that is currently being processed or an indication that this is the end
-        # of the single requested utterance.
-        #
-        # Example:
-        #
-        # 1.  transcript: "tube"
-        #
-        # 2.  transcript: "to be a"
-        #
-        # 3.  transcript: "to be"
-        #
-        # 4.  transcript: "to be or not to be"
-        #     is_final: true
-        #
-        # 5.  transcript: " that's"
-        #
-        # 6.  transcript: " that is"
-        #
-        # 7.  message_type: `END_OF_SINGLE_UTTERANCE`
-        #
-        # 8.  transcript: " that is the question"
-        #     is_final: true
-        #
-        # Only two of the responses contain final results (#4 and #8 indicated by
-        # `is_final: true`). Concatenating these generates the full transcript: "to be
-        # or not to be that is the question".
-        #
-        # In each response we populate:
-        #
-        # * for `TRANSCRIPT`: `transcript` and possibly `is_final`.
-        #
-        # * for `END_OF_SINGLE_UTTERANCE`: only `message_type`.
-        # @!attribute [rw] message_type
-        #   @return [Google::Cloud::Dialogflow::V2::StreamingRecognitionResult::MessageType]
-        #     Type of the result message.
-        # @!attribute [rw] transcript
-        #   @return [String]
-        #     Transcript text representing the words that the user spoke.
-        #     Populated if and only if `message_type` = `TRANSCRIPT`.
-        # @!attribute [rw] is_final
-        #   @return [true, false]
-        #     If `false`, the `StreamingRecognitionResult` represents an
-        #     interim result that may change. If `true`, the recognizer will not return
-        #     any further hypotheses about this piece of the audio. May only be populated
-        #     for `message_type` = `TRANSCRIPT`.
-        # @!attribute [rw] confidence
-        #   @return [Float]
-        #     The Speech confidence between 0.0 and 1.0 for the current portion of audio.
-        #     A higher number indicates an estimated greater likelihood that the
-        #     recognized words are correct. The default of 0.0 is a sentinel value
-        #     indicating that confidence was not set.
-        #
-        #     This field is typically only provided if `is_final` is true and you should
-        #     not rely on it being accurate or even set.
-        # @!attribute [rw] speech_word_info
-        #   @return [Array<Google::Cloud::Dialogflow::V2::SpeechWordInfo>]
-        #     Word-specific information for the words recognized by Speech in
-        #     {Google::Cloud::Dialogflow::V2::StreamingRecognitionResult#transcript transcript}. Populated if and only if `message_type` = `TRANSCRIPT` and
-        #     [InputAudioConfig.enable_word_info] is set.
-        # @!attribute [rw] speech_end_offset
-        #   @return [Google::Protobuf::Duration]
-        #     Time offset of the end of this Speech recognition result relative to the
-        #     beginning of the audio. Only populated for `message_type` = `TRANSCRIPT`.
-        class StreamingRecognitionResult
-          # Type of the response message.
-          module MessageType
-            # Not specified. Should never be used.
-            MESSAGE_TYPE_UNSPECIFIED = 0
-
-            # Message contains a (possibly partial) transcript.
-            TRANSCRIPT = 1
-
-            # Event indicates that the server has detected the end of the user's speech
-            # utterance and expects no additional inputs.
-            # Therefore, the server will not process additional audio (although it may subsequently return additional results). The
-            # client should stop sending additional audio data, half-close the gRPC
-            # connection, and wait for any additional results until the server closes
-            # the gRPC connection. This message is only sent if `single_utterance` was
-            # set to `true`, and is not used otherwise.
-            END_OF_SINGLE_UTTERANCE = 2
-          end
-        end
-
-        # Represents the natural language text to be processed.
-        # @!attribute [rw] text
-        #   @return [String]
-        #     Required. The UTF-8 encoded natural language text to be processed.
-        #     Text length must not exceed 256 characters.
-        # @!attribute [rw] language_code
-        #   @return [String]
-        #     Required. The language of this conversational query. See [Language
-        #     Support](https://cloud.google.com/dialogflow/docs/reference/language)
-        #     for a list of the currently supported language codes. Note that queries in
-        #     the same session do not necessarily need to specify the same language.
-        class TextInput; end
-
-        # Events allow for matching intents by event name instead of the natural
-        # language input. For instance, input `<event: { name: "welcome_event",
-        # parameters: { name: "Sam" } }>` can trigger a personalized welcome response.
-        # The parameter `name` may be used by the agent in the response:
-        # `"Hello #welcome_event.name! What can I do for you today?"`.
-        # @!attribute [rw] name
-        #   @return [String]
-        #     Required. The unique identifier of the event.
-        # @!attribute [rw] parameters
-        #   @return [Google::Protobuf::Struct]
-        #     The collection of parameters associated with the event.
-        # @!attribute [rw] language_code
-        #   @return [String]
-        #     Required. The language of this query. See [Language
-        #     Support](https://cloud.google.com/dialogflow/docs/reference/language)
-        #     for a list of the currently supported language codes. Note that queries in
-        #     the same session do not necessarily need to specify the same language.
-        class EventInput; end
-
-        # Configures the types of sentiment analysis to perform.
-        # @!attribute [rw] analyze_query_text_sentiment
-        #   @return [true, false]
-        #     Instructs the service to perform sentiment analysis on
-        #     `query_text`. If not provided, sentiment analysis is not performed on
-        #     `query_text`.
-        class SentimentAnalysisRequestConfig; end
-
-        # The result of sentiment analysis as configured by
-        # `sentiment_analysis_request_config`.
-        # @!attribute [rw] query_text_sentiment
-        #   @return [Google::Cloud::Dialogflow::V2::Sentiment]
-        #     The sentiment analysis result for `query_text`.
-        class SentimentAnalysisResult; end
-
-        # The sentiment, such as positive/negative feeling or association, for a unit
-        # of analysis, such as the query text.
-        # @!attribute [rw] score
-        #   @return [Float]
-        #     Sentiment score between -1.0 (negative sentiment) and 1.0 (positive
-        #     sentiment).
-        # @!attribute [rw] magnitude
-        #   @return [Float]
-        #     A non-negative number in the [0, +inf) range, which represents the absolute
-        #     magnitude of sentiment, regardless of score (positive or negative).
-        class Sentiment; end
-      end
-    end
-  end
-end