google-cloud-dialogflow-v2 1.17.0 → 1.18.0

data/proto_docs/google/cloud/dialogflow/v2/participant.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2021 Google LLC
+# Copyright 2026 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -168,7 +168,8 @@ module Google
         #     ID>/conversations/<Conversation ID>/messages/<Message ID>`.
         # @!attribute [rw] content
         #   @return [::String]
-        #     Required. The message content.
+        #     Optional. The message content.
+        #     Only one of `content` and `companion_query` should be set - not both.
         # @!attribute [rw] language_code
         #   @return [::String]
         #     Optional. The message language.
@@ -468,7 +469,7 @@ module Google
         #     is set in the first message. The complete audio over all streaming
         #     messages must not exceed 1 minute.
         #
-        #     Note: The following fields are mutually exclusive: `input_audio`, `input_text`, `input_dtmf`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `input_audio`, `input_text`, `input_dtmf`, `suggestion_input`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] input_text
         #   @return [::String]
         #     The UTF-8 encoded natural language text to be processed. Must be sent if
@@ -476,7 +477,7 @@ module Google
         #     256 bytes for virtual agent interactions. The `input_text` field can be
         #     only sent once, and would cancel the speech recognition if any ongoing.
         #
-        #     Note: The following fields are mutually exclusive: `input_text`, `input_audio`, `input_dtmf`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `input_text`, `input_audio`, `input_dtmf`, `suggestion_input`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] input_dtmf
         #   @return [::Google::Cloud::Dialogflow::V2::TelephonyDtmfEvents]
         #     The DTMF digits used to invoke intent and fill in parameter value.
@@ -484,7 +485,12 @@ module Google
         #     This input is ignored if the previous response indicated that DTMF input
         #     is not accepted.
         #
-        #     Note: The following fields are mutually exclusive: `input_dtmf`, `input_audio`, `input_text`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `input_dtmf`, `input_audio`, `input_text`, `suggestion_input`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] suggestion_input
+        #   @return [::Google::Cloud::Dialogflow::V2::SuggestionInput]
+        #     Optional. Input for confirming, revising, or canceling a suggestion.
+        #
+        #     Note: The following fields are mutually exclusive: `suggestion_input`, `input_audio`, `input_text`, `input_dtmf`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] query_params
         #   @return [::Google::Cloud::Dialogflow::V2::QueryParameters]
         #     Parameters for a Dialogflow virtual-agent query.
@@ -764,6 +770,113 @@ module Google
           end
         end
 
+        # Structured wrapper that pairs tool execution details with strongly-typed
+        # citations.
+        # @!attribute [rw] tool_call_info
+        #   @return [::Google::Cloud::Dialogflow::V2::GeneratorSuggestion::ToolCallInfo]
+        #     Optional. Tool execution request/response details.
+        # @!attribute [rw] text_update
+        #   @return [::String]
+        #     Optional. The conversational text update generated by the agent
+        #     accompanying this tool call (e.g. "The status of your order 12345 is
+        #     currently being retrieved..."). This is a status update emitted alongside
+        #     in-flight tool execution and is not accumulated into the final response.
+        class ToolCallSuggestion
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Represents events containing tool call execution progress.
+        # @!attribute [rw] tool_call_suggestions
+        #   @return [::Array<::Google::Cloud::Dialogflow::V2::ToolCallSuggestion>]
+        #     Optional. Tool call suggestions associated with these events.
+        class ToolCallEvents
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Represents a companion suggestion answer.
+        # @!attribute [rw] guidances
+        #   @return [::Array<::Google::Cloud::Dialogflow::V2::CompanionSuggestion::Guidance>]
+        #     List of guidances generated by the Companion Agent.
+        class CompanionSuggestion
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Represents guidance for companion suggestion.
+          # @!attribute [rw] suggested_reply
+          #   @return [::String]
+          #     Suggested reply for the agent to respond to the customer.
+          # @!attribute [rw] suggested_action
+          #   @return [::String]
+          #     Suggested action to human agent. For example, "Ask the customer for
+          #     their shipping address" or "Create a new case for the customer".
+          # @!attribute [rw] instruction_source
+          #   @return [::Google::Cloud::Dialogflow::V2::GuidanceInstruction]
+          #     Guidance instruction source.
+          # @!attribute [rw] knowledge_sources
+          #   @return [::Array<::Google::Cloud::Dialogflow::V2::CompanionSuggestion::Guidance::KnowledgeSource>]
+          #     Knowledge sources.
+          # @!attribute [rw] explanation
+          #   @return [::String]
+          #     Optional. A brief explanation of why the action is suggested.
+          # @!attribute [rw] grounding_metadata
+          #   @return [::Google::Cloud::Dialogflow::V2::GroundingMetadata]
+          #     Optional. Grounding metadata for the generated guidance.
+          # @!attribute [rw] tool_calls
+          #   @return [::Array<::Google::Cloud::Dialogflow::V2::ToolCallSuggestion>]
+          #     Optional. Rich structured tool calls and their associated citations
+          #     delivered directly as suggestions.
+          # @!attribute [rw] triggering_tool_call_answer_records
+          #   @return [::Array<::String>]
+          #     Optional. The AnswerRecords of the tool calls that triggered this
+          #     guidance.
+          #     Format: `projects/<Project ID>/locations/<Location
+          #     ID>/answerRecords/<Answer Record ID>`.
+          class Guidance
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Represents a knowledge source for the guidance.
+            # @!attribute [rw] knowledge_article_url
+            #   @return [::String]
+            #     URL of the knowledge article.
+            # @!attribute [rw] knowledge_article_title
+            #   @return [::String]
+            #     Knowledge article title.
+            # @!attribute [rw] knowledge_snippet
+            #   @return [::String]
+            #     Knowledge snippet.
+            class KnowledgeSource
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+          end
+        end
+
+        # Represents the response message for GenerateCompanionSuggestions.
+        # @!attribute [rw] companion_suggestion
+        #   @return [::Google::Cloud::Dialogflow::V2::CompanionSuggestion]
+        #     Contains the core suggestion generated by the Companion Agent.
+        # @!attribute [rw] answer_record
+        #   @return [::String]
+        #     Answer record that uniquely identifies the suggestion.
+        #     Format: `projects/<Project ID>/locations/<Location
+        #     ID>/answerRecords/<Answer Record ID>`.
+        # @!attribute [rw] latest_message
+        #   @return [::String]
+        #     The name of the latest conversation message used to compile suggestion for.
+        #     Format: `projects/<Project ID>/locations/<Location
+        #     ID>/conversations/<Conversation ID>/messages/<Message ID>`.
+        # @!attribute [r] suggestion_index
+        #   @return [::Integer]
+        #     Output only. The 1-based sequential index of the suggestion generated in
+        #     this session.
+        class GenerateCompanionSuggestionsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # The request message for
         # {::Google::Cloud::Dialogflow::V2::Participants::Client#suggest_smart_replies Participants.SuggestSmartReplies}.
         # @!attribute [rw] parent
@@ -1036,33 +1149,38 @@ module Google
         #   @return [::Google::Rpc::Status]
         #     Error status if the request failed.
         #
-        #     Note: The following fields are mutually exclusive: `error`, `suggest_articles_response`, `suggest_knowledge_assist_response`, `suggest_faq_answers_response`, `suggest_smart_replies_response`, `generate_suggestions_response`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `error`, `suggest_articles_response`, `suggest_knowledge_assist_response`, `suggest_faq_answers_response`, `suggest_smart_replies_response`, `generate_suggestions_response`, `generate_companion_suggestions_response`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] suggest_articles_response
         #   @return [::Google::Cloud::Dialogflow::V2::SuggestArticlesResponse]
         #     SuggestArticlesResponse if request is for ARTICLE_SUGGESTION.
         #
-        #     Note: The following fields are mutually exclusive: `suggest_articles_response`, `error`, `suggest_knowledge_assist_response`, `suggest_faq_answers_response`, `suggest_smart_replies_response`, `generate_suggestions_response`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `suggest_articles_response`, `error`, `suggest_knowledge_assist_response`, `suggest_faq_answers_response`, `suggest_smart_replies_response`, `generate_suggestions_response`, `generate_companion_suggestions_response`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] suggest_knowledge_assist_response
         #   @return [::Google::Cloud::Dialogflow::V2::SuggestKnowledgeAssistResponse]
         #     SuggestKnowledgeAssistResponse if request is for KNOWLEDGE_ASSIST.
         #
-        #     Note: The following fields are mutually exclusive: `suggest_knowledge_assist_response`, `error`, `suggest_articles_response`, `suggest_faq_answers_response`, `suggest_smart_replies_response`, `generate_suggestions_response`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `suggest_knowledge_assist_response`, `error`, `suggest_articles_response`, `suggest_faq_answers_response`, `suggest_smart_replies_response`, `generate_suggestions_response`, `generate_companion_suggestions_response`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] suggest_faq_answers_response
         #   @return [::Google::Cloud::Dialogflow::V2::SuggestFaqAnswersResponse]
         #     SuggestFaqAnswersResponse if request is for FAQ_ANSWER.
         #
-        #     Note: The following fields are mutually exclusive: `suggest_faq_answers_response`, `error`, `suggest_articles_response`, `suggest_knowledge_assist_response`, `suggest_smart_replies_response`, `generate_suggestions_response`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `suggest_faq_answers_response`, `error`, `suggest_articles_response`, `suggest_knowledge_assist_response`, `suggest_smart_replies_response`, `generate_suggestions_response`, `generate_companion_suggestions_response`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] suggest_smart_replies_response
         #   @return [::Google::Cloud::Dialogflow::V2::SuggestSmartRepliesResponse]
         #     SuggestSmartRepliesResponse if request is for SMART_REPLY.
         #
-        #     Note: The following fields are mutually exclusive: `suggest_smart_replies_response`, `error`, `suggest_articles_response`, `suggest_knowledge_assist_response`, `suggest_faq_answers_response`, `generate_suggestions_response`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `suggest_smart_replies_response`, `error`, `suggest_articles_response`, `suggest_knowledge_assist_response`, `suggest_faq_answers_response`, `generate_suggestions_response`, `generate_companion_suggestions_response`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] generate_suggestions_response
         #   @return [::Google::Cloud::Dialogflow::V2::GenerateSuggestionsResponse]
         #     Suggestions generated using generators triggered by customer or agent
         #     messages.
         #
-        #     Note: The following fields are mutually exclusive: `generate_suggestions_response`, `error`, `suggest_articles_response`, `suggest_knowledge_assist_response`, `suggest_faq_answers_response`, `suggest_smart_replies_response`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `generate_suggestions_response`, `error`, `suggest_articles_response`, `suggest_knowledge_assist_response`, `suggest_faq_answers_response`, `suggest_smart_replies_response`, `generate_companion_suggestions_response`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] generate_companion_suggestions_response
+        #   @return [::Google::Cloud::Dialogflow::V2::GenerateCompanionSuggestionsResponse]
+        #     Suggestions generated by companion agent.
+        #
+        #     Note: The following fields are mutually exclusive: `generate_companion_suggestions_response`, `error`, `suggest_articles_response`, `suggest_knowledge_assist_response`, `suggest_faq_answers_response`, `suggest_smart_replies_response`, `generate_suggestions_response`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         class SuggestionResult
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1359,7 +1477,7 @@ module Google
         #     The latency of the service.
         # @!attribute [rw] query_generation_debug_info
         #   @return [::Google::Cloud::Dialogflow::V2::KnowledgeAssistDebugInfo::QueryGenerationDebugInfo]
-        #     Token usage metadata for query generation.
+        #     Debug information and model metadata for query generation.
         # @!attribute [rw] ces_debug_info
         #   @return [::Google::Protobuf::Struct]
         #     Debug information from CES runtime API.
@@ -1431,7 +1549,7 @@ module Google
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
-          # Token usage metadata for query generation.
+          # Debug information and model metadata for query generation.
           # @!attribute [rw] prompt_token_count
           #   @return [::Integer]
           #     The total number of tokens in the prompt.
@@ -1441,6 +1559,20 @@ module Google
           # @!attribute [rw] total_token_count
           #   @return [::Integer]
           #     The total number of tokens for the entire request.
+          # @!attribute [rw] thinking_level
+          #   @return [::String]
+          #     The thinking level configured for the Gemini model.
+          # @!attribute [rw] thinking_budget_tokens
+          #   @return [::Integer]
+          #     The thinking budget (in number of tokens) configured for the Gemini
+          #     model.
+          # @!attribute [rw] similarity_to_last_query
+          #   @return [::Float]
+          #     The similarity score of the suggested query to the last suggested query.
+          # @!attribute [rw] similarity_to_last_query_threshold
+          #   @return [::Float]
+          #     The similarity threshold used to filter out queries similar to the last
+          #     suggestion.
           class QueryGenerationDebugInfo
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1650,6 +1782,291 @@ module Google
           end
         end
 
+        # The request message for
+        # {::Google::Cloud::Dialogflow::V2::Participants::Client#streaming_reactive_companion_suggestions Participants.StreamingReactiveCompanionSuggestions}.
+        # @!attribute [rw] participant
+        #   @return [::String]
+        #     Required. The human-agent participant name.
+        #     Format: `projects/<Project ID>/locations/<Location
+        #     ID>/conversations/<Conversation ID>/participants/<Participant ID>`.
+        # @!attribute [rw] text_input
+        #   @return [::String]
+        #     The natural language text to be processed.
+        #
+        #     Note: The following fields are mutually exclusive: `text_input`, `cancel_reactive_query`, `suggestion_input`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] cancel_reactive_query
+        #   @return [::Google::Cloud::Dialogflow::V2::CancelQuery]
+        #     Signals to cancel the current ongoing reactive query processing.
+        #
+        #     Note: The following fields are mutually exclusive: `cancel_reactive_query`, `text_input`, `suggestion_input`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] suggestion_input
+        #   @return [::Google::Cloud::Dialogflow::V2::SuggestionInput]
+        #     An input representing the selection of a suggestion.
+        #
+        #     Note: The following fields are mutually exclusive: `suggestion_input`, `text_input`, `cancel_reactive_query`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        class StreamingReactiveCompanionSuggestionsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Message to signal cancellation of the current query turn.
+        # Cancels the currently active interactive query, not any query running in
+        # the background.
+        class CancelQuery
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The response message for
+        # {::Google::Cloud::Dialogflow::V2::Participants::Client#streaming_reactive_companion_suggestions Participants.StreamingReactiveCompanionSuggestions}.
+        # @!attribute [rw] response_chunk
+        #   @return [::String]
+        #     Streamed response text chunks.
+        #
+        #     Note: The following fields are mutually exclusive: `response_chunk`, `status`, `reactive_mode_final_response`, `intermediate_tool_call_events`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] status
+        #   @return [::Google::Rpc::Status]
+        #     Status of the response for the current query. If set and non-ok,
+        #     indicates an error occurred during processing of the current query, or
+        #     confirms that a requested cancellation has successfully completed (status
+        #     code CANCELLED).
+        #
+        #     Note: The following fields are mutually exclusive: `status`, `response_chunk`, `reactive_mode_final_response`, `intermediate_tool_call_events`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [r] reactive_mode_final_response
+        #   @return [::Google::Cloud::Dialogflow::V2::StreamingReactiveCompanionSuggestionsResponse::ReactiveModeResponse]
+        #     Output only. The final response from the reactive mode capturing the
+        #     entire accumulated streaming response, grounding metadata, and tool
+        #     calls. Only set when `is_final` is `true` and conversational processing
+        #     for the query turn completes.
+        #
+        #     Note: The following fields are mutually exclusive: `reactive_mode_final_response`, `response_chunk`, `status`, `intermediate_tool_call_events`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [r] intermediate_tool_call_events
+        #   @return [::Google::Cloud::Dialogflow::V2::ToolCallEvents]
+        #     Output only. Captures intermediate tool call events that occur during the
+        #     execution of the reactive query turn. Note that conversational messages
+        #     within tool calls are displayed within the tool cards and hence are not
+        #     accumulated within the `reactive_mode_final_response.response` string.
+        #
+        #     Note: The following fields are mutually exclusive: `intermediate_tool_call_events`, `response_chunk`, `status`, `reactive_mode_final_response`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [r] is_final
+        #   @return [::Boolean]
+        #     Output only. Indicates whether the client/UI can accept a new query for
+        #     reactive chat. When `is_final` is `true`, the reactive chat interface is
+        #     unblocked and ready to receive new human agent queries. For synchronous
+        #     turns, this is set to `true` on the final response chunk. For asynchronous
+        #     tool calls running in the background, this is set to `true` on the
+        #     intermediate trigger chunk to unblock the UI while the background tool
+        #     execution is in progress.
+        # @!attribute [r] answer_record
+        #   @return [::String]
+        #     Output only. Only set when `is_final` is `true` and conversational turn
+        #     processing completes. The final answer record representing the completed
+        #     suggestion. Only present in the last chunk of the completed response.
+        # @!attribute [rw] text_message_id
+        #   @return [::String]
+        #     Required. The unique message identifier corresponding to the
+        #     human agent query that generated this response chunk.
+        # @!attribute [rw] send_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     The timestamp when the response chunk was sent by the service.
+        class StreamingReactiveCompanionSuggestionsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # The complete response generated by the reactive mode capturing the entire
+          # accumulated streaming response, grounding metadata, and tool calls.
+          # @!attribute [rw] response
+          #   @return [::String]
+          #     Optional. The full reactive suggestion generated by the Companion Agent.
+          #     After the last streaming chunk is sent, this is the final response
+          #     concatenating all the streaming response chunks together to represent the
+          #     full reactive suggestion.
+          # @!attribute [rw] grounding_metadata
+          #   @return [::Google::Cloud::Dialogflow::V2::GroundingMetadata]
+          #     Optional. Grounding metadata for the generated response.
+          # @!attribute [rw] tool_calls
+          #   @return [::Array<::Google::Cloud::Dialogflow::V2::ToolCallSuggestion>]
+          #     Optional. Captures all the rich structured tool calls and their
+          #     associated citations used by the reactive agent to generate the reactive
+          #     suggestion.
+          class ReactiveModeResponse
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
+        # The request message for
+        # {::Google::Cloud::Dialogflow::V2::Participants::Client#bidi_streaming_analyze_content Participants.BidiStreamingAnalyzeContent}.
+        # @!attribute [rw] config
+        #   @return [::Google::Cloud::Dialogflow::V2::BidiStreamingAnalyzeContentRequest::Config]
+        #     The config message for this conversation.
+        #
+        #     Note: The following fields are mutually exclusive: `config`, `input`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] input
+        #   @return [::Google::Cloud::Dialogflow::V2::BidiStreamingAnalyzeContentRequest::Input]
+        #     Text, audio or other multi-modality inputs.
+        #     This is the second and following messages sent by the client.
+        #
+        #     Note: The following fields are mutually exclusive: `input`, `config`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        class BidiStreamingAnalyzeContentRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # The config of the session.
+          # @!attribute [rw] participant
+          #   @return [::String]
+          #     Required. The name of the participant to fetch response for.
+          #     Format: `projects/<Project ID>/locations/<Location
+          #     ID>/conversations/<Conversation ID>/participants/<Participant ID>`.
+          # @!attribute [rw] voice_session_config
+          #   @return [::Google::Cloud::Dialogflow::V2::BidiStreamingAnalyzeContentRequest::Config::VoiceSessionConfig]
+          #     Configure a voice-based session.
+          # @!attribute [rw] initial_virtual_agent_parameters
+          #   @return [::Google::Protobuf::Struct]
+          #     Optional. Parameters to be passed to the virtual agent at the beginning.
+          # @!attribute [rw] initial_virtual_agent_query_params
+          #   @return [::Google::Cloud::Dialogflow::V2::QueryParameters]
+          #     Optional. Initial parameters for the virtual-agent.
+          class Config
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # The config about how to process the audio for a voice-based session.
+            # @!attribute [rw] input_audio_encoding
+            #   @return [::Google::Cloud::Dialogflow::V2::AudioEncoding]
+            #     Required. The encoding of input audio.
+            # @!attribute [rw] input_audio_sample_rate_hertz
+            #   @return [::Integer]
+            #     Required. The sample rate of input audio.
+            # @!attribute [rw] output_audio_encoding
+            #   @return [::Google::Cloud::Dialogflow::V2::OutputAudioEncoding]
+            #     Required. The encoding of output audio.
+            # @!attribute [rw] output_audio_sample_rate_hertz
+            #   @return [::Integer]
+            #     Required. The sample rate of output audio.
+            # @!attribute [rw] enable_cx_proactive_processing
+            #   @return [::Boolean]
+            #     Optional. Whether to enable CX proactive processing.
+            # @!attribute [rw] enable_streaming_synthesize
+            #   @return [::Boolean]
+            #     Optional. If true, Dialogflow will stream the audio bytes from Cloud
+            #     TTS for speech synthesis using the StreamingSynthesize api.
+            # @!attribute [rw] gemini_asr_config
+            #   @return [::Google::Cloud::Dialogflow::V2::SpeechToTextConfig::GeminiAsrConfig]
+            #     Optional. Configuration for using Gemini ASR models served via Vertex
+            #     AI.
+            #     This field is only used when `use_gemini_asr` is true.
+            # @!attribute [rw] use_gemini_asr
+            #   @return [::Boolean]
+            #     Optional. If true, Gemini ASR will be used for transcription instead of
+            #     Cloud Speech-to-Text. If false, Cloud Speech-to-Text will be used.
+            #     If unset, this setting is inherited from the ConversationProfile.
+            class VoiceSessionConfig
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+          end
+
+          # Input that forms data for a single turn.
+          # @!attribute [rw] text
+          #   @return [::String]
+          #     The UTF-8 encoded natural language text to be processed.
+          #
+          #     Note: The following fields are mutually exclusive: `text`, `intent`, `event`, `suggestion_input`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          # @!attribute [rw] intent
+          #   @return [::String]
+          #     The intent to be triggered on V3 agent.
+          #     Format: `projects/<Project ID>/locations/<Location ID>/locations/
+          #     <Location ID>/agents/<Agent ID>/intents/<Intent ID>`. This can only be
+          #     used to trigger the Welcome intent id if the modality is text.
+          #
+          #     Note: The following fields are mutually exclusive: `intent`, `text`, `event`, `suggestion_input`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          # @!attribute [rw] event
+          #   @return [::String]
+          #     The input event name.
+          #     This can only be sent once and would cancel the ongoing speech
+          #     recognition if any. To trigger the Welcome intent use the
+          #     event "WELCOME"
+          #
+          #     Note: The following fields are mutually exclusive: `event`, `text`, `intent`, `suggestion_input`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          # @!attribute [rw] suggestion_input
+          #   @return [::Google::Cloud::Dialogflow::V2::SuggestionInput]
+          #     Optional. Input for confirming, revising, or canceling a suggestion.
+          #
+          #     Note: The following fields are mutually exclusive: `suggestion_input`, `text`, `intent`, `event`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          # @!attribute [rw] virtual_agent_parameters
+          #   @return [::Google::Protobuf::Struct]
+          #     Optional. Parameters to be passed to the virtual agent.
+          class TurnInput
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Input for the conversation.
+          # @!attribute [rw] audio
+          #   @return [::String]
+          #     The content of audio stream to be recognized.
+          #
+          #     Note: The following fields are mutually exclusive: `audio`, `dtmf`, `turn`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          # @!attribute [rw] dtmf
+          #   @return [::Google::Cloud::Dialogflow::V2::TelephonyDtmfEvents]
+          #     The DTMF digits used to invoke intent and fill in parameter value.
+          #
+          #     This input is ignored if the previous response indicated that DTMF
+          #     input is not accepted.
+          #
+          #     Note: The following fields are mutually exclusive: `dtmf`, `audio`, `turn`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          # @!attribute [rw] turn
+          #   @return [::Google::Cloud::Dialogflow::V2::BidiStreamingAnalyzeContentRequest::TurnInput]
+          #     Turn input.
+          #
+          #     Note: The following fields are mutually exclusive: `turn`, `audio`, `dtmf`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          class Input
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
+        # The response message for
+        # {::Google::Cloud::Dialogflow::V2::Participants::Client#bidi_streaming_analyze_content Participants.BidiStreamingAnalyzeContent}.
+        # @!attribute [rw] recognition_result
+        #   @return [::Google::Cloud::Dialogflow::V2::StreamingRecognitionResult]
+        #     The result of speech recognition.
+        #
+        #     Note: The following fields are mutually exclusive: `recognition_result`, `barge_in_signal`, `analyze_content_response`, `turn_complete`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] barge_in_signal
+        #   @return [::Google::Cloud::Dialogflow::V2::BidiStreamingAnalyzeContentResponse::BargeInSignal]
+        #     Indicate the user barge-in has been detected, and client should stop
+        #     playing back the audio.
+        #
+        #     Note: The following fields are mutually exclusive: `barge_in_signal`, `recognition_result`, `analyze_content_response`, `turn_complete`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] analyze_content_response
+        #   @return [::Google::Cloud::Dialogflow::V2::AnalyzeContentResponse]
+        #     The agent response from analyze content.
+        #
+        #     Note: The following fields are mutually exclusive: `analyze_content_response`, `recognition_result`, `barge_in_signal`, `turn_complete`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] turn_complete
+        #   @return [::Google::Cloud::Dialogflow::V2::BidiStreamingAnalyzeContentResponse::TurnComplete]
+        #     Indicate that the turn is complete.
+        #
+        #     Note: The following fields are mutually exclusive: `turn_complete`, `recognition_result`, `barge_in_signal`, `analyze_content_response`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        class BidiStreamingAnalyzeContentResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Indicate the user barge-in has been detected.
+          class BargeInSignal
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Indicate that the turn is complete.
+          class TurnComplete
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
         # Response reason from datastore which indicates data serving status or
         # answer quality degradation.
         module DatastoreResponseReason

data/proto_docs/google/cloud/dialogflow/v2/session.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2020 Google LLC
+# Copyright 2026 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -673,8 +673,9 @@ module Google
         # Represents the natural language text to be processed.
         # @!attribute [rw] text
         #   @return [::String]
-        #     Required. The UTF-8 encoded natural language text to be processed.
+        #     Optional. The UTF-8 encoded natural language text to be processed.
         #     Text length must not exceed 256 characters for virtual agent interactions.
+        #     Only one of `text` and `companion_query` should be set - not both.
         # @!attribute [rw] language_code
         #   @return [::String]
         #     Required. The language of this conversational query. See [Language

data/proto_docs/google/cloud/dialogflow/v2/session_entity_type.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2020 Google LLC
+# Copyright 2026 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/proto_docs/google/cloud/dialogflow/v2/sip_trunk.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2025 Google LLC
+# Copyright 2026 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/proto_docs/google/cloud/dialogflow/v2/tool.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2025 Google LLC
+# Copyright 2026 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/proto_docs/google/cloud/dialogflow/v2/tool_call.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2025 Google LLC
+# Copyright 2026 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -150,6 +150,9 @@ module Google
           # @!attribute [rw] message
           #   @return [::String]
           #     Optional. The error message of the function.
+          # @!attribute [rw] retryable
+          #   @return [::Boolean]
+          #     Optional. Specifies whether the tool call is retryable.
           class Error
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/dialogflow/v2/validation_result.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2020 Google LLC
+# Copyright 2026 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/proto_docs/google/cloud/dialogflow/v2/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2021 Google LLC
+# Copyright 2026 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/proto_docs/google/cloud/dialogflow/v2/webhook.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2020 Google LLC
+# Copyright 2026 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/proto_docs/google/longrunning/operations.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2020 Google LLC
+# Copyright 2026 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/proto_docs/google/protobuf/any.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2020 Google LLC
+# Copyright 2026 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.