google-cloud-dialogflow 0.2.3 → 0.3.0

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

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -22,20 +22,23 @@ module Google
         # action is an extraction of a user command or sentence semantics.
         # @!attribute [rw] name
         #   @return [String]
-        #     Required for all methods except `create` (`create` populates the name
-        #     automatically.
         #     The unique identifier of this intent.
+        #     Required for {Google::Cloud::Dialogflow::V2::Intents::UpdateIntent Intents::UpdateIntent} and {Google::Cloud::Dialogflow::V2::Intents::BatchUpdateIntents Intents::BatchUpdateIntents}
+        #     methods.
         #     Format: `projects/<Project ID>/agent/intents/<Intent ID>`.
         # @!attribute [rw] display_name
         #   @return [String]
         #     Required. The name of this intent.
         # @!attribute [rw] webhook_state
         #   @return [Google::Cloud::Dialogflow::V2::Intent::WebhookState]
-        #     Required. Indicates whether webhooks are enabled for the intent.
+        #     Optional. Indicates whether webhooks are enabled for the intent.
         # @!attribute [rw] priority
         #   @return [Integer]
         #     Optional. The priority of this intent. Higher numbers represent higher
-        #     priorities. Zero or negative numbers mean that the intent is disabled.
+        #     priorities. If this is zero or unspecified, we use the default
+        #     priority 500000.
+        #
+        #     Negative numbers mean that the intent is disabled.
         # @!attribute [rw] is_fallback
         #   @return [true, false]
         #     Optional. Indicates whether this is a fallback intent.
@@ -57,11 +60,12 @@ module Google
         #     be present in the active user session for an event to trigger this intent.
         # @!attribute [rw] training_phrases
         #   @return [Array<Google::Cloud::Dialogflow::V2::Intent::TrainingPhrase>]
-        #     Optional. The collection of examples/templates that the agent is
+        #     Optional. The collection of examples that the agent is
         #     trained on.
         # @!attribute [rw] action
         #   @return [String]
         #     Optional. The name of the action associated with the intent.
+        #     Note: The action name must not contain whitespaces.
         # @!attribute [rw] output_contexts
         #   @return [Array<Google::Cloud::Dialogflow::V2::Context>]
         #     Optional. The collection of contexts that are activated when the intent
@@ -86,57 +90,78 @@ module Google
         #     taken from among the messages assigned to the DEFAULT_PLATFORM.
         # @!attribute [rw] root_followup_intent_name
         #   @return [String]
-        #     The unique identifier of the root intent in the chain of followup intents.
-        #     It identifies the correct followup intents chain for this intent.
+        #     Read-only. The unique identifier of the root intent in the chain of
+        #     followup intents. It identifies the correct followup intents chain for
+        #     this intent. We populate this field only in the output.
+        #
         #     Format: `projects/<Project ID>/agent/intents/<Intent ID>`.
         # @!attribute [rw] parent_followup_intent_name
         #   @return [String]
-        #     The unique identifier of the parent intent in the chain of followup
-        #     intents.
+        #     Read-only after creation. The unique identifier of the parent intent in the
+        #     chain of followup intents. You can set this field when creating an intent,
+        #     for example with {CreateIntent} or {BatchUpdateIntents}, in order to
+        #     make this intent a followup intent.
+        #
         #     It identifies the parent followup intent.
         #     Format: `projects/<Project ID>/agent/intents/<Intent ID>`.
         # @!attribute [rw] followup_intent_info
         #   @return [Array<Google::Cloud::Dialogflow::V2::Intent::FollowupIntentInfo>]
-        #     Optional. Collection of information about all followup intents that have
-        #     name of this intent as a root_name.
+        #     Read-only. Information about all followup intents that have this intent as
+        #     a direct or indirect parent. We populate this field only in the output.
         class Intent
-          # Represents an example or template that the agent is trained on.
+          # Represents an example that the agent is trained on.
           # @!attribute [rw] name
           #   @return [String]
-          #     Required. The unique identifier of this training phrase.
+          #     Output only. The unique identifier of this training phrase.
           # @!attribute [rw] type
           #   @return [Google::Cloud::Dialogflow::V2::Intent::TrainingPhrase::Type]
           #     Required. The type of the training phrase.
           # @!attribute [rw] parts
           #   @return [Array<Google::Cloud::Dialogflow::V2::Intent::TrainingPhrase::Part>]
-          #     Required. The collection of training phrase parts (can be annotated).
-          #     Fields: `entity_type`, `alias` and `user_defined` should be populated
-          #     only for the annotated parts of the training phrase.
+          #     Required. The ordered list of training phrase parts.
+          #     The parts are concatenated in order to form the training phrase.
+          #
+          #     Note: The API does not automatically annotate training phrases like the
+          #     Dialogflow Console does.
+          #
+          #     Note: Do not forget to include whitespace at part boundaries,
+          #     so the training phrase is well formatted when the parts are concatenated.
+          #
+          #     If the training phrase does not need to be annotated with parameters,
+          #     you just need a single part with only the {Google::Cloud::Dialogflow::V2::Intent::TrainingPhrase::Part#text Part#text} field set.
+          #
+          #     If you want to annotate the training phrase, you must create multiple
+          #     parts, where the fields of each part are populated in one of two ways:
+          #
+          #     * `Part.text` is set to a part of the phrase that has no parameters.
+          #     * `Part.text` is set to a part of the phrase that you want to annotate,
+          #       and the `entity_type`, `alias`, and `user_defined` fields are all
+          #       set.
           # @!attribute [rw] times_added_count
           #   @return [Integer]
-          #     Optional. Indicates how many times this example or template was added to
+          #     Optional. Indicates how many times this example was added to
           #     the intent. Each time a developer adds an existing sample by editing an
           #     intent or training, this counter is increased.
           class TrainingPhrase
             # Represents a part of a training phrase.
             # @!attribute [rw] text
             #   @return [String]
-            #     Required. The text corresponding to the example or template,
-            #     if there are no annotations. For
-            #     annotated examples, it is the text for one of the example's parts.
+            #     Required. The text for this part.
             # @!attribute [rw] entity_type
             #   @return [String]
-            #     Optional. The entity type name prefixed with `@`. This field is
-            #     required for the annotated part of the text and applies only to
-            #     examples.
+            #     Optional. The entity type name prefixed with `@`.
+            #     This field is required for annotated parts of the training phrase.
             # @!attribute [rw] alias
             #   @return [String]
             #     Optional. The parameter name for the value extracted from the
             #     annotated part of the example.
+            #     This field is required for annotated parts of the training phrase.
             # @!attribute [rw] user_defined
             #   @return [true, false]
-            #     Optional. Indicates whether the text was manually annotated by the
-            #     developer.
+            #     Optional. Indicates whether the text was manually annotated.
+            #     This field is set to true when the Dialogflow Console is used to
+            #     manually annotate the part. When creating an annotated part with the
+            #     API, you must set this to true.
             class Part; end
 
             # Represents different types of training phrases.
@@ -150,6 +175,10 @@ module Google
 
               # Templates are not annotated with entity types, but they can contain
               # @-prefixed entity type names as substrings.
+              # Template mode has been deprecated. Example mode is the only supported
+              # way to create new training phrases. If you have existing training
+              # phrases that you've created in template mode, those will continue to
+              # work.
               TEMPLATE = 2
             end
           end
@@ -520,7 +549,7 @@ module Google
           #     Format: `projects/<Project ID>/agent/intents/<Intent ID>`.
           # @!attribute [rw] parent_followup_intent_name
           #   @return [String]
-          #     The unique identifier of the followup intent parent.
+          #     The unique identifier of the followup intent's parent.
           #     Format: `projects/<Project ID>/agent/intents/<Intent ID>`.
           class FollowupIntentInfo; end
 
@@ -547,9 +576,10 @@ module Google
         #   @return [String]
         #     Optional. The language to list training phrases, parameters and rich
         #     messages for. If not specified, the agent's default language is used.
-        #     [More than a dozen
-        #     languages](https://dialogflow.com/docs/reference/language) are supported.
-        #     Note: languages must be enabled in the agent before they can be used.
+        #     [Many
+        #     languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+        #     are supported. Note: languages must be enabled in the agent before they can
+        #     be used.
         # @!attribute [rw] intent_view
         #   @return [Google::Cloud::Dialogflow::V2::IntentView]
         #     Optional. The resource view to apply to the returned intent.
@@ -582,9 +612,10 @@ module Google
         #   @return [String]
         #     Optional. The language to retrieve training phrases, parameters and rich
         #     messages for. If not specified, the agent's default language is used.
-        #     [More than a dozen
-        #     languages](https://dialogflow.com/docs/reference/language) are supported.
-        #     Note: languages must be enabled in the agent, before they can be used.
+        #     [Many
+        #     languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+        #     are supported. Note: languages must be enabled in the agent before they can
+        #     be used.
         # @!attribute [rw] intent_view
         #   @return [Google::Cloud::Dialogflow::V2::IntentView]
         #     Optional. The resource view to apply to the returned intent.
@@ -602,9 +633,10 @@ module Google
         #   @return [String]
         #     Optional. The language of training phrases, parameters and rich messages
         #     defined in `intent`. If not specified, the agent's default language is
-        #     used. [More than a dozen
-        #     languages](https://dialogflow.com/docs/reference/language) are supported.
-        #     Note: languages must be enabled in the agent, before they can be used.
+        #     used. [Many
+        #     languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+        #     are supported. Note: languages must be enabled in the agent before they can
+        #     be used.
         # @!attribute [rw] intent_view
         #   @return [Google::Cloud::Dialogflow::V2::IntentView]
         #     Optional. The resource view to apply to the returned intent.
@@ -614,14 +646,14 @@ module Google
         # @!attribute [rw] intent
         #   @return [Google::Cloud::Dialogflow::V2::Intent]
         #     Required. The intent to update.
-        #     Format: `projects/<Project ID>/agent/intents/<Intent ID>`.
         # @!attribute [rw] language_code
         #   @return [String]
         #     Optional. The language of training phrases, parameters and rich messages
         #     defined in `intent`. If not specified, the agent's default language is
-        #     used. [More than a dozen
-        #     languages](https://dialogflow.com/docs/reference/language) are supported.
-        #     Note: languages must be enabled in the agent, before they can be used.
+        #     used. [Many
+        #     languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+        #     are supported. Note: languages must be enabled in the agent before they can
+        #     be used.
         # @!attribute [rw] update_mask
         #   @return [Google::Protobuf::FieldMask]
         #     Optional. The mask to control which fields get updated.
@@ -633,7 +665,8 @@ module Google
         # The request message for {Google::Cloud::Dialogflow::V2::Intents::DeleteIntent Intents::DeleteIntent}.
         # @!attribute [rw] name
         #   @return [String]
-        #     Required. The name of the intent to delete.
+        #     Required. The name of the intent to delete. If this intent has direct or
+        #     indirect followup intents, we also delete them.
         #     Format: `projects/<Project ID>/agent/intents/<Intent ID>`.
         class DeleteIntentRequest; end
 
@@ -654,9 +687,10 @@ module Google
         #   @return [String]
         #     Optional. The language of training phrases, parameters and rich messages
         #     defined in `intents`. If not specified, the agent's default language is
-        #     used. [More than a dozen
-        #     languages](https://dialogflow.com/docs/reference/language) are supported.
-        #     Note: languages must be enabled in the agent, before they can be used.
+        #     used. [Many
+        #     languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+        #     are supported. Note: languages must be enabled in the agent before they can
+        #     be used.
         # @!attribute [rw] update_mask
         #   @return [Google::Protobuf::FieldMask]
         #     Optional. The mask to control which fields get updated.

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

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -38,6 +38,11 @@ module Google
         #     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]
+        #     Optional. 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] input_audio
         #   @return [String]
         #     Optional. The natural language speech audio to be processed. This field
@@ -52,11 +57,22 @@ module Google
         #     locate a response in the training example set or for reporting issues.
         # @!attribute [rw] query_result
         #   @return [Google::Cloud::Dialogflow::V2::QueryResult]
-        #     The results of the conversational query or event processing.
+        #     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. `webhook_status`
-        #     is never populated in webhook requests.
+        #     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.
@@ -79,13 +95,17 @@ module Google
         #     before the new ones are activated.
         # @!attribute [rw] session_entity_types
         #   @return [Array<Google::Cloud::Dialogflow::V2::SessionEntityType>]
-        #     Optional. The collection of session entity types to replace or extend
-        #     developer entities with for this query only. The entity synonyms apply
-        #     to all languages.
+        #     Optional. 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]
         #     Optional. 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]
+        #     Optional. 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:
@@ -120,7 +140,8 @@ module Google
         # @!attribute [rw] language_code
         #   @return [String]
         #     The language that was triggered during intent detection.
-        #     See [Language Support](https://dialogflow.com/docs/reference/language)
+        #     See [Language
+        #     Support](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
         #     for a list of the currently supported language codes.
         # @!attribute [rw] speech_recognition_confidence
         #   @return [Float]
@@ -129,10 +150,10 @@ module Google
         #     correct. The default of 0.0 is a sentinel value indicating that confidence
         #     was not set.
         #
-        #     You should not rely on this field as it isn't guaranteed to be accurate, or
-        #     even set. In particular this field isn't set in Webhook calls and for
-        #     StreamingDetectIntent since the streaming endpoint has separate confidence
-        #     estimates per portion of the audio in StreamingRecognitionResult.
+        #     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.
@@ -149,6 +170,7 @@ module Google
         # @!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.
@@ -175,10 +197,17 @@ module Google
         #   @return [Float]
         #     The intent detection confidence. Values range from 0.0
         #     (completely uncertain) to 1.0 (completely certain).
+        #     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]
-        #     The free-form diagnostic info. For example, this field
-        #     could contain webhook call latency.
+        #     The free-form diagnostic info. For example, this field could contain
+        #     webhook call latency. The string keys of the Struct's fields map can change
+        #     without notice.
+        # @!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
@@ -197,7 +226,7 @@ module Google
         #     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
+        #     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
@@ -223,6 +252,11 @@ module Google
         #     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]
+        #     Optional. 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] input_audio
         #   @return [String]
         #     Optional. The input audio content to be recognized. Must be sent if
@@ -255,6 +289,14 @@ module Google
         # @!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.
+        # @!attribute [rw] output_audio_config
+        #   @return [Google::Cloud::Dialogflow::V2::OutputAudioConfig]
+        #     Instructs the speech synthesizer how to generate the output audio. This
+        #     field is populated from the agent-level speech synthesizer configuration,
+        #     if enabled.
         class StreamingDetectIntentResponse; end
 
         # Contains a speech recognition result corresponding to a portion of the audio
@@ -276,7 +318,7 @@ module Google
         #
         # 6.  transcript: " that is"
         #
-        # 7.  recognition_event_type: `RECOGNITION_EVENT_END_OF_SINGLE_UTTERANCE`
+        # 7.  message_type: `MESSAGE_TYPE_END_OF_SINGLE_UTTERANCE`
         #
         # 8.  transcript: " that is the question"
         #     is_final: true
@@ -289,21 +331,20 @@ module Google
         #
         # * for `MESSAGE_TYPE_TRANSCRIPT`: `transcript` and possibly `is_final`.
         #
-        # * for `MESSAGE_TYPE_END_OF_SINGLE_UTTERANCE`: only `event_type`.
+        # * for `MESSAGE_TYPE_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 `event_type` = `RECOGNITION_EVENT_TRANSCRIPT`.
+        #     Populated if and only if `message_type` = `MESSAGE_TYPE_TRANSCRIPT`.
         # @!attribute [rw] is_final
         #   @return [true, false]
-        #     The default of 0.0 is a sentinel value indicating `confidence` was not set.
         #     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 `event_type` = `RECOGNITION_EVENT_TRANSCRIPT`.
+        #     for `message_type` = `MESSAGE_TYPE_TRANSCRIPT`.
         # @!attribute [rw] confidence
         #   @return [Float]
         #     The Speech confidence between 0.0 and 1.0 for the current portion of audio.
@@ -340,20 +381,24 @@ module Google
         # @!attribute [rw] sample_rate_hertz
         #   @return [Integer]
         #     Required. Sample rate (in Hertz) of the audio content sent in the query.
-        #     Refer to [Cloud Speech API documentation](https://cloud.google.com/speech/docs/basics) for more
-        #     details.
+        #     Refer to
+        #     [Cloud Speech API
+        #     documentation](https://cloud.google.com/speech-to-text/docs/basics) for
+        #     more details.
         # @!attribute [rw] language_code
         #   @return [String]
         #     Required. The language of the supplied audio. Dialogflow does not do
         #     translations. See [Language
-        #     Support](https://dialogflow.com/docs/languages) 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.
+        #     Support](https://cloud.google.com/dialogflow-enterprise/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.
         # @!attribute [rw] phrase_hints
         #   @return [Array<String>]
         #     Optional. The collection of phrase hints which are used to boost accuracy
         #     of speech recognition.
-        #     Refer to [Cloud Speech API documentation](https://cloud.google.com/speech/docs/basics#phrase-hints)
+        #     Refer to
+        #     [Cloud Speech API
+        #     documentation](https://cloud.google.com/speech-to-text/docs/basics#phrase-hints)
         #     for more details.
         class InputAudioConfig; end
 
@@ -361,20 +406,20 @@ module Google
         # @!attribute [rw] text
         #   @return [String]
         #     Required. The UTF-8 encoded natural language text to be processed.
-        #     Text length must not exceed 256 bytes.
+        #     Text length must not exceed 256 characters.
         # @!attribute [rw] language_code
         #   @return [String]
         #     Required. The language of this conversational query. See [Language
-        #     Support](https://dialogflow.com/docs/languages) 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.
+        #     Support](https://cloud.google.com/dialogflow-enterprise/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.
+        # 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?”`.
+        # `"Hello #welcome_event.name! What can I do for you today?"`.
         # @!attribute [rw] name
         #   @return [String]
         #     Required. The unique identifier of the event.
@@ -384,13 +429,42 @@ module Google
         # @!attribute [rw] language_code
         #   @return [String]
         #     Required. The language of this query. See [Language
-        #     Support](https://dialogflow.com/docs/languages) 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.
+        #     Support](https://cloud.google.com/dialogflow-enterprise/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]
+        #     Optional. 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
+
         # Audio encoding of the audio content sent in the conversational query request.
-        # Refer to the [Cloud Speech API documentation](https://cloud.google.com/speech/docs/basics) for more
+        # Refer to the
+        # [Cloud Speech API
+        # documentation](https://cloud.google.com/speech-to-text/docs/basics) for more
         # details.
         module AudioEncoding
           # Not specified.