google-cloud-dialogflow-v2 1.8.0 → 1.9.0

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

@@ -297,6 +297,8 @@ module Google
         # @!attribute [rw] phrase_sets
         #   @return [::Array<::String>]
         #     List of names of Cloud Speech phrase sets that are used for transcription.
+        #     For phrase set limitations, please refer to [Cloud Speech API quotas and
+        #     limits](https://cloud.google.com/speech-to-text/quotas#content).
         # @!attribute [rw] audio_encoding
         #   @return [::Google::Cloud::Dialogflow::V2::AudioEncoding]
         #     Audio encoding of the audio content to process.

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

@@ -70,6 +70,9 @@ module Google
         # @!attribute [r] telephony_connection_info
         #   @return [::Google::Cloud::Dialogflow::V2::Conversation::TelephonyConnectionInfo]
         #     Output only. The telephony connection information.
+        # @!attribute [r] ingested_context_references
+        #   @return [::Google::Protobuf::Map{::String => ::Google::Cloud::Dialogflow::V2::Conversation::ContextReference}]
+        #     Output only. The context reference updates provided by external systems.
         class Conversation
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -118,6 +121,74 @@ module Google
             end
           end
 
+          # Represents a section of ingested context information.
+          # @!attribute [rw] context_contents
+          #   @return [::Array<::Google::Cloud::Dialogflow::V2::Conversation::ContextReference::ContextContent>]
+          #     Required. The list of content updates for a context reference.
+          # @!attribute [rw] update_mode
+          #   @return [::Google::Cloud::Dialogflow::V2::Conversation::ContextReference::UpdateMode]
+          #     Required. The mode in which context reference contents are updated.
+          # @!attribute [rw] language_code
+          #   @return [::String]
+          #     Optional. The language of the information ingested, defaults to "en-US"
+          #     if not set.
+          # @!attribute [r] create_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     Output only. The time the context reference was first created.
+          class ContextReference
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Contents ingested.
+            # @!attribute [rw] content
+            #   @return [::String]
+            #     Required. The information ingested in a single request.
+            # @!attribute [rw] content_format
+            #   @return [::Google::Cloud::Dialogflow::V2::Conversation::ContextReference::ContextContent::ContentFormat]
+            #     Required. The format of the ingested string.
+            # @!attribute [r] ingestion_time
+            #   @return [::Google::Protobuf::Timestamp]
+            #     Output only. The time when this information was incorporated into the
+            #     relevant context reference.
+            class ContextContent
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+
+              # Represents the format of the ingested string.
+              module ContentFormat
+                # Unspecified content format.
+                CONTENT_FORMAT_UNSPECIFIED = 0
+
+                # Content was provided in JSON format.
+                JSON = 1
+
+                # Content was provided as plain text.
+                PLAIN_TEXT = 2
+              end
+            end
+
+            # Represents the mode in which context reference contents are updated.
+            module UpdateMode
+              # Unspecified update mode.
+              UPDATE_MODE_UNSPECIFIED = 0
+
+              # Context content updates are applied in append mode.
+              APPEND = 1
+
+              # Context content updates are applied in overwrite mode.
+              OVERWRITE = 2
+            end
+          end
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::Google::Cloud::Dialogflow::V2::Conversation::ContextReference]
+          class IngestedContextReferencesEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
           # Enumeration of the completion status of the conversation.
           module LifecycleState
             # Unknown.
@@ -299,6 +370,50 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # The request message for [ConversationsService.IngestContextReferences][].
+        # @!attribute [rw] conversation
+        #   @return [::String]
+        #     Required. Resource identifier of the conversation to ingest context
+        #     information for. Format: `projects/<Project ID>/locations/<Location
+        #     ID>/conversations/<Conversation ID>`.
+        # @!attribute [rw] context_references
+        #   @return [::Google::Protobuf::Map{::String => ::Google::Cloud::Dialogflow::V2::Conversation::ContextReference}]
+        #     Required. The context references to ingest. The key is the name of the
+        #     context reference and the value contains the contents of the context
+        #     reference. The key is used to incorporate ingested context references to
+        #     enhance the generator.
+        class IngestContextReferencesRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::Google::Cloud::Dialogflow::V2::Conversation::ContextReference]
+          class ContextReferencesEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
+        # The response message for [ConversationsService.IngestContextReferences][].
+        # @!attribute [rw] ingested_context_references
+        #   @return [::Google::Protobuf::Map{::String => ::Google::Cloud::Dialogflow::V2::Conversation::ContextReference}]
+        #     All context references ingested.
+        class IngestContextReferencesResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::Google::Cloud::Dialogflow::V2::Conversation::ContextReference]
+          class IngestedContextReferencesEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
         # The request message for
         # {::Google::Cloud::Dialogflow::V2::Conversations::Client#suggest_conversation_summary Conversations.SuggestConversationSummary}.
         # @!attribute [rw] conversation
@@ -497,6 +612,12 @@ module Google
         #     `projects/<Project ID>/locations/<Location ID>/generators/<Generator ID>`
         #
         #     Note: The following fields are mutually exclusive: `generator_name`, `generator`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] context_references
+        #   @return [::Google::Protobuf::Map{::String => ::Google::Cloud::Dialogflow::V2::Conversation::ContextReference}]
+        #     Optional. A section of ingested context information. The key is the name of
+        #     the context reference and the value contains the contents of the context
+        #     reference. The key is used to incorporate ingested context references to
+        #     enhance the generator.
         # @!attribute [rw] conversation_context
         #   @return [::Google::Cloud::Dialogflow::V2::ConversationContext]
         #     Optional. Context of the conversation, including transcripts.
@@ -507,6 +628,15 @@ module Google
         class GenerateStatelessSuggestionRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::Google::Cloud::Dialogflow::V2::Conversation::ContextReference]
+          class ContextReferencesEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
         end
 
         # The response message for
@@ -861,6 +991,30 @@ module Google
             INTENT = 3
           end
         end
+
+        # The request message for
+        # {::Google::Cloud::Dialogflow::V2::Conversations::Client#generate_suggestions Conversations.GenerateSuggestions}.
+        # @!attribute [rw] conversation
+        #   @return [::String]
+        #     Required. The conversation for which the suggestions are generated. Format:
+        #     `projects/<Project ID>/locations/<Location
+        #     ID>/conversations/<Conversation ID>`.
+        #
+        #     The conversation must be created with a conversation profile which has
+        #     generators configured in it to be able to get suggestions.
+        # @!attribute [rw] latest_message
+        #   @return [::String]
+        #     Optional. The name of the latest conversation message for which the request
+        #     is triggered. Format: `projects/<Project ID>/locations/<Location
+        #     ID>/conversations/<Conversation ID>/messages/<Message ID>`.
+        # @!attribute [rw] trigger_events
+        #   @return [::Array<::Google::Cloud::Dialogflow::V2::TriggerEvent>]
+        #     Optional. A list of trigger events. Only generators configured in the
+        #     conversation_profile whose trigger_event is listed here will be triggered.
+        class GenerateSuggestionsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
       end
     end
   end

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

@@ -278,6 +278,14 @@ module Google
 
             # Customer defined sections.
             CUSTOMER_DEFINED = 7
+
+            # Concise version of the situation section. This type is only available if
+            # type SITUATION is not selected.
+            SITUATION_CONCISE = 9
+
+            # Concise version of the action section. This type is only available if
+            # type ACTION is not selected.
+            ACTION_CONCISE = 10
           end
         end
 
@@ -303,6 +311,15 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Free form generator context that customer can configure.
+        # @!attribute [rw] text
+        #   @return [::String]
+        #     Optional. Free form text input to LLM.
+        class FreeFormContext
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # LLM generator.
         # @!attribute [r] name
         #   @return [::String]
@@ -311,9 +328,16 @@ module Google
         # @!attribute [rw] description
         #   @return [::String]
         #     Optional. Human readable description of the generator.
+        # @!attribute [rw] free_form_context
+        #   @return [::Google::Cloud::Dialogflow::V2::FreeFormContext]
+        #     Input of free from generator to LLM.
+        #
+        #     Note: The following fields are mutually exclusive: `free_form_context`, `summarization_context`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] summarization_context
         #   @return [::Google::Cloud::Dialogflow::V2::SummarizationContext]
         #     Input of prebuilt Summarization feature.
+        #
+        #     Note: The following fields are mutually exclusive: `summarization_context`, `free_form_context`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] inference_parameter
         #   @return [::Google::Cloud::Dialogflow::V2::InferenceParameter]
         #     Optional. Inference parameters for this generator.
@@ -321,6 +345,13 @@ module Google
         #   @return [::Google::Cloud::Dialogflow::V2::TriggerEvent]
         #     Optional. The trigger event of the generator. It defines when the generator
         #     is triggered in a conversation.
+        # @!attribute [rw] published_model
+        #   @return [::String]
+        #     Optional. The published Large Language Model name.
+        #     * To use the latest model version, specify the model name without version
+        #       number. Example: `text-bison`
+        #     * To use a stable model version, specify the version number as well.
+        #       Example: `text-bison@002`.
         # @!attribute [r] create_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Output only. Creation time of this generator.
@@ -332,6 +363,15 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Suggestion generated using free form generator.
+        # @!attribute [rw] response
+        #   @return [::String]
+        #     Required. Free form suggestion.
+        class FreeFormSuggestion
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Suggested summary of the conversation.
         # @!attribute [rw] summary_sections
         #   @return [::Array<::Google::Cloud::Dialogflow::V2::SummarySuggestion::SummarySection>]
@@ -354,9 +394,16 @@ module Google
         end
 
         # Suggestion generated using a Generator.
+        # @!attribute [rw] free_form_suggestion
+        #   @return [::Google::Cloud::Dialogflow::V2::FreeFormSuggestion]
+        #     Optional. Free form suggestion.
+        #
+        #     Note: The following fields are mutually exclusive: `free_form_suggestion`, `summary_suggestion`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] summary_suggestion
         #   @return [::Google::Cloud::Dialogflow::V2::SummarySuggestion]
         #     Optional. Suggested summary.
+        #
+        #     Note: The following fields are mutually exclusive: `summary_suggestion`, `free_form_suggestion`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         class GeneratorSuggestion
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -374,6 +421,12 @@ module Google
           # Conversations.GenerateStatelessSuggestion and
           # Conversations.GenerateSuggestions.
           MANUAL_CALL = 2
+
+          # Triggers after each customer message only.
+          CUSTOMER_MESSAGE = 3
+
+          # Triggers after each agent message only.
+          AGENT_MESSAGE = 4
         end
       end
     end

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

@@ -681,6 +681,41 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # The response message for
+        # {::Google::Cloud::Dialogflow::V2::Conversations::Client#generate_suggestions Conversations.GenerateSuggestions}.
+        # @!attribute [rw] generator_suggestion_answers
+        #   @return [::Array<::Google::Cloud::Dialogflow::V2::GenerateSuggestionsResponse::GeneratorSuggestionAnswer>]
+        #     The answers generated for the conversation based on context.
+        # @!attribute [rw] latest_message
+        #   @return [::String]
+        #     The name of the latest conversation message used as context for
+        #     compiling suggestion.
+        #
+        #     Format: `projects/<Project ID>/locations/<Location
+        #     ID>/conversations/<Conversation ID>/messages/<Message ID>`.
+        class GenerateSuggestionsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # A GeneratorSuggestion answer.
+          # @!attribute [rw] generator_suggestion
+          #   @return [::Google::Cloud::Dialogflow::V2::GeneratorSuggestion]
+          #     Suggestion details.
+          # @!attribute [rw] source_generator
+          #   @return [::String]
+          #     The name of the generator used to generate this suggestion. Format:
+          #     `projects/<Project ID>/locations/<Location ID>/generators/<Generator
+          #     ID>`.
+          # @!attribute [rw] answer_record
+          #   @return [::String]
+          #     Answer record that uniquely identifies the suggestion. This can be used
+          #     to provide suggestion feedback.
+          class GeneratorSuggestionAnswer
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
         # The request message for
         # {::Google::Cloud::Dialogflow::V2::Participants::Client#suggest_smart_replies Participants.SuggestSmartReplies}.
         # @!attribute [rw] parent
@@ -953,27 +988,33 @@ 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`. 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`. 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`. 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`. 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`. 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`. 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`. 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`. 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`. 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`. 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.
         class SuggestionResult
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-dialogflow-v2
 version: !ruby/object:Gem::Version
-  version: 1.8.0
+  version: 1.9.0
 platform: ruby
 authors:
 - Google LLC
 bindir: bin
 cert_chain: []
-date: 2025-03-06 00:00:00.000000000 Z
+date: 2025-03-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common