google-apis-dialogflow_v3beta1 0.93.0 → 0.95.0

data/lib/google/apis/dialogflow_v3beta1/classes.rb

@@ -174,8 +174,8 @@ module Google
         # @return [String]
         attr_accessor :no_speech_timeout
       
-        # Use timeout based endpointing, interpreting endpointer sensitivy as seconds of
-        # timeout value.
+        # Use timeout based endpointing, interpreting endpointer sensitivity as seconds
+        # of timeout value.
         # Corresponds to the JSON property `useTimeoutBasedEndpointing`
         # @return [Boolean]
         attr_accessor :use_timeout_based_endpointing
@@ -547,6 +547,13 @@ module Google
         # @return [String]
         attr_accessor :data_store_type
       
+        # The document processing mode for the data store connection. Should only be set
+        # for PUBLIC_WEB and UNSTRUCTURED data stores. If not set it is considered as
+        # DOCUMENTS, as this is the legacy mode.
+        # Corresponds to the JSON property `documentProcessingMode`
+        # @return [String]
+        attr_accessor :document_processing_mode
+      
         def initialize(**args)
            update!(**args)
         end
@@ -555,6 +562,7 @@ module Google
         def update!(**args)
           @data_store = args[:data_store] if args.key?(:data_store)
           @data_store_type = args[:data_store_type] if args.key?(:data_store_type)
+          @document_processing_mode = args[:document_processing_mode] if args.key?(:document_processing_mode)
         end
       end
       
@@ -2134,7 +2142,7 @@ module Google
       
         # A list of transitions for the transition rules of this page. They route the
         # conversation to another page in the same flow, or another flow. When we are in
-        # a certain page, the TransitionRoutes are evalauted in the following order: *
+        # a certain page, the TransitionRoutes are evaluated in the following order: *
         # TransitionRoutes defined in the page with intent specified. * TransitionRoutes
         # defined in the transition route groups with intent specified. *
         # TransitionRoutes defined in flow with intent specified. * TransitionRoutes
@@ -3390,7 +3398,7 @@ module Google
         # @return [String]
         attr_accessor :client_id
       
-        # Required. The client secret provided by the 3rd party platform.
+        # Optional. The client secret provided by the 3rd party platform.
         # Corresponds to the JSON property `clientSecret`
         # @return [String]
         attr_accessor :client_secret
@@ -3947,8 +3955,8 @@ module Google
         # @return [String]
         attr_accessor :no_speech_timeout
       
-        # Use timeout based endpointing, interpreting endpointer sensitivy as seconds of
-        # timeout value.
+        # Use timeout based endpointing, interpreting endpointer sensitivity as seconds
+        # of timeout value.
         # Corresponds to the JSON property `useTimeoutBasedEndpointing`
         # @return [Boolean]
         attr_accessor :use_timeout_based_endpointing
@@ -4254,6 +4262,11 @@ module Google
       class GoogleCloudDialogflowCxV3beta1AgentGitIntegrationSettings
         include Google::Apis::Core::Hashable
       
+        # Integration settings for a Git service hosted on Cloud Run.
+        # Corresponds to the JSON property `gitConnectionSettings`
+        # @return [Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowCxV3beta1AgentGitIntegrationSettingsGitConnectionSettings]
+        attr_accessor :git_connection_settings
+      
         # Settings of integration with GitHub.
         # Corresponds to the JSON property `githubSettings`
         # @return [Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowCxV3beta1AgentGitIntegrationSettingsGithubSettings]
@@ -4265,10 +4278,55 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @git_connection_settings = args[:git_connection_settings] if args.key?(:git_connection_settings)
           @github_settings = args[:github_settings] if args.key?(:github_settings)
         end
       end
       
+      # Integration settings for a Git service hosted on Cloud Run.
+      class GoogleCloudDialogflowCxV3beta1AgentGitIntegrationSettingsGitConnectionSettings
+        include Google::Apis::Core::Hashable
+      
+        # The name of the SecretManager secret version resource storing the git access
+        # token. Format: `projects/`project`/secrets/`secret`/versions/`version``
+        # Corresponds to the JSON property `accessTokenSecret`
+        # @return [String]
+        attr_accessor :access_token_secret
+      
+        # Optional. List of branches configured for the repository.
+        # Corresponds to the JSON property `branches`
+        # @return [Array<String>]
+        attr_accessor :branches
+      
+        # Required. Display name for the repository
+        # Corresponds to the JSON property `displayName`
+        # @return [String]
+        attr_accessor :display_name
+      
+        # Required. Git server reporitory URI.
+        # Corresponds to the JSON property `repositoryUri`
+        # @return [String]
+        attr_accessor :repository_uri
+      
+        # Required. Default branch of the repository.
+        # Corresponds to the JSON property `trackingBranch`
+        # @return [String]
+        attr_accessor :tracking_branch
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @access_token_secret = args[:access_token_secret] if args.key?(:access_token_secret)
+          @branches = args[:branches] if args.key?(:branches)
+          @display_name = args[:display_name] if args.key?(:display_name)
+          @repository_uri = args[:repository_uri] if args.key?(:repository_uri)
+          @tracking_branch = args[:tracking_branch] if args.key?(:tracking_branch)
+        end
+      end
+      
       # Settings of integration with GitHub.
       class GoogleCloudDialogflowCxV3beta1AgentGitIntegrationSettingsGithubSettings
         include Google::Apis::Core::Hashable
@@ -4629,7 +4687,7 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Optional. Condition boost specifications. If a document matches multiple
-        # conditions in the specifictions, boost scores from these specifications are
+        # conditions in the specifications, boost scores from these specifications are
         # all applied and combined in a non-linear way. Maximum number of specifications
         # is 20.
         # Corresponds to the JSON property `conditionBoostSpecs`
@@ -5604,6 +5662,13 @@ module Google
         # @return [String]
         attr_accessor :data_store_type
       
+        # The document processing mode for the data store connection. Should only be set
+        # for PUBLIC_WEB and UNSTRUCTURED data stores. If not set it is considered as
+        # DOCUMENTS, as this is the legacy mode.
+        # Corresponds to the JSON property `documentProcessingMode`
+        # @return [String]
+        attr_accessor :document_processing_mode
+      
         def initialize(**args)
            update!(**args)
         end
@@ -5612,6 +5677,7 @@ module Google
         def update!(**args)
           @data_store = args[:data_store] if args.key?(:data_store)
           @data_store_type = args[:data_store_type] if args.key?(:data_store_type)
+          @document_processing_mode = args[:document_processing_mode] if args.key?(:document_processing_mode)
         end
       end
       
@@ -7264,38 +7330,6 @@ module Google
         end
       end
       
-      # The request message for Playbooks.ExportPlaybook.
-      class GoogleCloudDialogflowCxV3beta1ExportPlaybookRequest
-        include Google::Apis::Core::Hashable
-      
-        # Optional. The data format of the exported agent. If not specified, `BLOB` is
-        # assumed.
-        # Corresponds to the JSON property `dataFormat`
-        # @return [String]
-        attr_accessor :data_format
-      
-        # Optional. The [Google Cloud Storage](https://cloud.google.com/storage/docs/)
-        # URI to export the playbook to. The format of this URI must be `gs:///`. If
-        # left unspecified, the serialized playbook is returned inline. Dialogflow
-        # performs a write operation for the Cloud Storage object on the caller's behalf,
-        # so your request authentication must have write permissions for the object.
-        # For more information, see [Dialogflow access control](https://cloud.google.com/
-        # dialogflow/cx/docs/concept/access-control#storage).
-        # Corresponds to the JSON property `playbookUri`
-        # @return [String]
-        attr_accessor :playbook_uri
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @data_format = args[:data_format] if args.key?(:data_format)
-          @playbook_uri = args[:playbook_uri] if args.key?(:playbook_uri)
-        end
-      end
-      
       # Metadata returned for the TestCases.ExportTestCases long running operation.
       # This message currently has no fields.
       class GoogleCloudDialogflowCxV3beta1ExportTestCasesMetadata
@@ -7546,7 +7580,7 @@ module Google
         # every page's transition routes and can support use cases such as the user
         # saying "help" or "can I talk to a human?", which can be handled in a common
         # way regardless of the current page. Transition routes defined in the page have
-        # higher priority than those defined in the flow. TransitionRoutes are evalauted
+        # higher priority than those defined in the flow. TransitionRoutes are evaluated
         # in the following order: * TransitionRoutes with intent specified. *
         # TransitionRoutes with only condition specified. TransitionRoutes with intent
         # specified are inherited by pages in the flow.
@@ -8477,6 +8511,110 @@ module Google
         end
       end
       
+      # Handler can be used to define custom logic to be executed based on the user-
+      # specified triggers.
+      class GoogleCloudDialogflowCxV3beta1Handler
+        include Google::Apis::Core::Hashable
+      
+        # A handler that is triggered by the specified event.
+        # Corresponds to the JSON property `eventHandler`
+        # @return [Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowCxV3beta1HandlerEventHandler]
+        attr_accessor :event_handler
+      
+        # A handler that is triggered on the specific lifecycle_stage of the playbook
+        # execution.
+        # Corresponds to the JSON property `lifecycleHandler`
+        # @return [Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowCxV3beta1HandlerLifecycleHandler]
+        attr_accessor :lifecycle_handler
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @event_handler = args[:event_handler] if args.key?(:event_handler)
+          @lifecycle_handler = args[:lifecycle_handler] if args.key?(:lifecycle_handler)
+        end
+      end
+      
+      # A handler that is triggered by the specified event.
+      class GoogleCloudDialogflowCxV3beta1HandlerEventHandler
+        include Google::Apis::Core::Hashable
+      
+        # Optional. The condition that must be satisfied to trigger this handler.
+        # Corresponds to the JSON property `condition`
+        # @return [String]
+        attr_accessor :condition
+      
+        # Required. The name of the event that triggers this handler.
+        # Corresponds to the JSON property `event`
+        # @return [String]
+        attr_accessor :event
+      
+        # A fulfillment can do one or more of the following actions at the same time: *
+        # Generate rich message responses. * Set parameter values. * Call the webhook.
+        # Fulfillments can be called at various stages in the Page or Form lifecycle.
+        # For example, when a DetectIntentRequest drives a session to enter a new page,
+        # the page's entry fulfillment can add a static response to the QueryResult in
+        # the returning DetectIntentResponse, call the webhook (for example, to load
+        # user data from a database), or both.
+        # Corresponds to the JSON property `fulfillment`
+        # @return [Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowCxV3beta1Fulfillment]
+        attr_accessor :fulfillment
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @condition = args[:condition] if args.key?(:condition)
+          @event = args[:event] if args.key?(:event)
+          @fulfillment = args[:fulfillment] if args.key?(:fulfillment)
+        end
+      end
+      
+      # A handler that is triggered on the specific lifecycle_stage of the playbook
+      # execution.
+      class GoogleCloudDialogflowCxV3beta1HandlerLifecycleHandler
+        include Google::Apis::Core::Hashable
+      
+        # Optional. The condition that must be satisfied to trigger this handler.
+        # Corresponds to the JSON property `condition`
+        # @return [String]
+        attr_accessor :condition
+      
+        # A fulfillment can do one or more of the following actions at the same time: *
+        # Generate rich message responses. * Set parameter values. * Call the webhook.
+        # Fulfillments can be called at various stages in the Page or Form lifecycle.
+        # For example, when a DetectIntentRequest drives a session to enter a new page,
+        # the page's entry fulfillment can add a static response to the QueryResult in
+        # the returning DetectIntentResponse, call the webhook (for example, to load
+        # user data from a database), or both.
+        # Corresponds to the JSON property `fulfillment`
+        # @return [Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowCxV3beta1Fulfillment]
+        attr_accessor :fulfillment
+      
+        # Required. The name of the lifecycle stage that triggers this handler.
+        # Supported values: * `playbook-start` * `pre-action-selection` * `pre-action-
+        # execution`
+        # Corresponds to the JSON property `lifecycleStage`
+        # @return [String]
+        attr_accessor :lifecycle_stage
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @condition = args[:condition] if args.key?(:condition)
+          @fulfillment = args[:fulfillment] if args.key?(:fulfillment)
+          @lifecycle_stage = args[:lifecycle_stage] if args.key?(:lifecycle_stage)
+        end
+      end
+      
       # Metadata returned for the EntityTypes.ImportEntityTypes long running operation.
       class GoogleCloudDialogflowCxV3beta1ImportEntityTypesMetadata
         include Google::Apis::Core::Hashable
@@ -8761,40 +8899,6 @@ module Google
         end
       end
       
-      # The request message for Playbooks.ImportPlaybook.
-      class GoogleCloudDialogflowCxV3beta1ImportPlaybookRequest
-        include Google::Apis::Core::Hashable
-      
-        # The playbook import strategy used for resource conflict resolution associated
-        # with an ImportPlaybookRequest.
-        # Corresponds to the JSON property `importStrategy`
-        # @return [Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowCxV3beta1PlaybookImportStrategy]
-        attr_accessor :import_strategy
-      
-        # Uncompressed raw byte content for playbook.
-        # Corresponds to the JSON property `playbookContent`
-        # NOTE: Values are automatically base64 encoded/decoded in the client library.
-        # @return [String]
-        attr_accessor :playbook_content
-      
-        # [Dialogflow access control] (https://cloud.google.com/dialogflow/cx/docs/
-        # concept/access-control#storage).
-        # Corresponds to the JSON property `playbookUri`
-        # @return [String]
-        attr_accessor :playbook_uri
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @import_strategy = args[:import_strategy] if args.key?(:import_strategy)
-          @playbook_content = args[:playbook_content] if args.key?(:playbook_content)
-          @playbook_uri = args[:playbook_uri] if args.key?(:playbook_uri)
-        end
-      end
-      
       # Metadata returned for the TestCases.ImportTestCases long running operation.
       class GoogleCloudDialogflowCxV3beta1ImportTestCasesMetadata
         include Google::Apis::Core::Hashable
@@ -9906,6 +10010,33 @@ module Google
         end
       end
       
+      # The response message for Tools.ListToolVersions.
+      class GoogleCloudDialogflowCxV3beta1ListToolVersionsResponse
+        include Google::Apis::Core::Hashable
+      
+        # Token to retrieve the next page of results, or empty if there are no more
+        # results in the list.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        # The list of tool versions. There will be a maximum number of items returned
+        # based on the page_size field in the request.
+        # Corresponds to the JSON property `toolVersions`
+        # @return [Array<Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowCxV3beta1ToolVersion>]
+        attr_accessor :tool_versions
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+          @tool_versions = args[:tool_versions] if args.key?(:tool_versions)
+        end
+      end
+      
       # The response message for Tools.ListTools.
       class GoogleCloudDialogflowCxV3beta1ListToolsResponse
         include Google::Apis::Core::Hashable
@@ -10426,7 +10557,7 @@ module Google
       
         # A list of transitions for the transition rules of this page. They route the
         # conversation to another page in the same flow, or another flow. When we are in
-        # a certain page, the TransitionRoutes are evalauted in the following order: *
+        # a certain page, the TransitionRoutes are evaluated in the following order: *
         # TransitionRoutes defined in the page with intent specified. * TransitionRoutes
         # defined in the transition route groups with intent specified. *
         # TransitionRoutes defined in flow with intent specified. * TransitionRoutes
@@ -10643,10 +10774,18 @@ module Google
         attr_accessor :display_name
       
         # Required. High level description of the goal the playbook intend to accomplish.
+        # A goal should be concise since it's visible to other playbooks that may
+        # reference this playbook.
         # Corresponds to the JSON property `goal`
         # @return [String]
         attr_accessor :goal
       
+        # Optional. A list of registered handlers to execute based on the specified
+        # triggers.
+        # Corresponds to the JSON property `handlers`
+        # @return [Array<Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowCxV3beta1Handler>]
+        attr_accessor :handlers
+      
         # Optional. Defined structured input parameters for this playbook.
         # Corresponds to the JSON property `inputParameterDefinitions`
         # @return [Array<Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowCxV3beta1ParameterDefinition>]
@@ -10717,6 +10856,7 @@ module Google
           @create_time = args[:create_time] if args.key?(:create_time)
           @display_name = args[:display_name] if args.key?(:display_name)
           @goal = args[:goal] if args.key?(:goal)
+          @handlers = args[:handlers] if args.key?(:handlers)
           @input_parameter_definitions = args[:input_parameter_definitions] if args.key?(:input_parameter_definitions)
           @instruction = args[:instruction] if args.key?(:instruction)
           @llm_model_settings = args[:llm_model_settings] if args.key?(:llm_model_settings)
@@ -10731,43 +10871,6 @@ module Google
         end
       end
       
-      # The playbook import strategy used for resource conflict resolution associated
-      # with an ImportPlaybookRequest.
-      class GoogleCloudDialogflowCxV3beta1PlaybookImportStrategy
-        include Google::Apis::Core::Hashable
-      
-        # Optional. Specifies the import strategy used when resolving conflicts with the
-        # main playbook. If not specified, 'CREATE_NEW' is assumed.
-        # Corresponds to the JSON property `mainPlaybookImportStrategy`
-        # @return [String]
-        attr_accessor :main_playbook_import_strategy
-      
-        # Optional. Specifies the import strategy used when resolving referenced
-        # playbook/flow conflicts. If not specified, 'CREATE_NEW' is assumed.
-        # Corresponds to the JSON property `nestedResourceImportStrategy`
-        # @return [String]
-        attr_accessor :nested_resource_import_strategy
-      
-        # Optional. Specifies the import strategy used when resolving tool conflicts. If
-        # not specified, 'CREATE_NEW' is assumed. This will be applied after the main
-        # playbook and nested resource import strategies, meaning if the playbook that
-        # references the tool is skipped, the tool will also be skipped.
-        # Corresponds to the JSON property `toolImportStrategy`
-        # @return [String]
-        attr_accessor :tool_import_strategy
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @main_playbook_import_strategy = args[:main_playbook_import_strategy] if args.key?(:main_playbook_import_strategy)
-          @nested_resource_import_strategy = args[:nested_resource_import_strategy] if args.key?(:nested_resource_import_strategy)
-          @tool_import_strategy = args[:tool_import_strategy] if args.key?(:tool_import_strategy)
-        end
-      end
-      
       # Input of the playbook.
       class GoogleCloudDialogflowCxV3beta1PlaybookInput
         include Google::Apis::Core::Hashable
@@ -10798,6 +10901,13 @@ module Google
       class GoogleCloudDialogflowCxV3beta1PlaybookInstruction
         include Google::Apis::Core::Hashable
       
+        # General guidelines for the playbook. These are unstructured instructions that
+        # are not directly part of the goal, e.g. "Always be polite". It's valid for
+        # this text to be long and used instead of steps altogether.
+        # Corresponds to the JSON property `guidelines`
+        # @return [String]
+        attr_accessor :guidelines
+      
         # Ordered list of step by step execution instructions to accomplish target goal.
         # Corresponds to the JSON property `steps`
         # @return [Array<Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowCxV3beta1PlaybookStep>]
@@ -10809,6 +10919,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @guidelines = args[:guidelines] if args.key?(:guidelines)
           @steps = args[:steps] if args.key?(:steps)
         end
       end
@@ -11888,8 +11999,8 @@ module Google
         end
       end
       
-      # The request message for Playbooks.RestorePlaybookVersion.
-      class GoogleCloudDialogflowCxV3beta1RestorePlaybookVersionRequest
+      # The request message for Tools.RestoreToolVersion.
+      class GoogleCloudDialogflowCxV3beta1RestoreToolVersionRequest
         include Google::Apis::Core::Hashable
       
         def initialize(**args)
@@ -11901,19 +12012,17 @@ module Google
         end
       end
       
-      # The response message for Playbooks.RestorePlaybookVersion.
-      class GoogleCloudDialogflowCxV3beta1RestorePlaybookVersionResponse
+      # The response message for Tools.RestoreToolVersion.
+      class GoogleCloudDialogflowCxV3beta1RestoreToolVersionResponse
         include Google::Apis::Core::Hashable
       
-        # Playbook is the basic building block to instruct the LLM how to execute a
-        # certain task. A playbook consists of a goal to accomplish, an optional list of
-        # step by step instructions (the step instruction may refers to name of the
-        # custom or default plugin tools to use) to perform the task, a list of
-        # contextual input data to be passed in at the beginning of the invoked, and a
-        # list of output parameters to store the playbook result.
-        # Corresponds to the JSON property `playbook`
-        # @return [Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowCxV3beta1Playbook]
-        attr_accessor :playbook
+        # A tool provides a list of actions which are available to the Playbook to
+        # attain its goal. A Tool consists of a description of the tool's usage and a
+        # specification of the tool which contains the schema and authentication
+        # information.
+        # Corresponds to the JSON property `tool`
+        # @return [Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowCxV3beta1Tool]
+        attr_accessor :tool
       
         def initialize(**args)
            update!(**args)
@@ -11921,7 +12030,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @playbook = args[:playbook] if args.key?(:playbook)
+          @tool = args[:tool] if args.key?(:tool)
         end
       end
       
@@ -12187,12 +12296,18 @@ module Google
       class GoogleCloudDialogflowCxV3beta1SearchConfig
         include Google::Apis::Core::Hashable
       
-        # Optional. Boosting configuration for the datastores.
+        # Optional. Boosting configuration for the datastores. Maps from datastore name
+        # to their boost configuration. Do not specify more than one BoostSpecs for each
+        # datastore name. If multiple BoostSpecs are provided for the same datastore
+        # name, the behavior is undefined.
         # Corresponds to the JSON property `boostSpecs`
         # @return [Array<Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowCxV3beta1BoostSpecs>]
         attr_accessor :boost_specs
       
-        # Optional. Filter configuration for the datastores.
+        # Optional. Filter configuration for the datastores. Maps from datastore name to
+        # the filter expression for that datastore. Do not specify more than one
+        # FilterSpecs for each datastore name. If multiple FilterSpecs are provided for
+        # the same datastore name, the behavior is undefined.
         # Corresponds to the JSON property `filterSpecs`
         # @return [Array<Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowCxV3beta1FilterSpecs>]
         attr_accessor :filter_specs
@@ -13025,7 +13140,8 @@ module Google
       class GoogleCloudDialogflowCxV3beta1ToolAuthenticationApiKeyConfig
         include Google::Apis::Core::Hashable
       
-        # Required. The API key.
+        # Optional. The API key. If the `secret_version_for_api_key` field is set, this
+        # field will be ignored.
         # Corresponds to the JSON property `apiKey`
         # @return [String]
         attr_accessor :api_key
@@ -13058,7 +13174,7 @@ module Google
       class GoogleCloudDialogflowCxV3beta1ToolAuthenticationBearerTokenConfig
         include Google::Apis::Core::Hashable
       
-        # Required. The text token appended to the text `Bearer` to the request
+        # Optional. The text token appended to the text `Bearer` to the request
         # Authorization header. [Session parameters reference](https://cloud.google.com/
         # dialogflow/cx/docs/concept/parameter#session-ref) can be used to pass the
         # token dynamically, e.g. `$session.params.parameter-id`.
@@ -13085,7 +13201,8 @@ module Google
         # @return [String]
         attr_accessor :client_id
       
-        # Required. The client secret from the OAuth provider.
+        # Optional. The client secret from the OAuth provider. If the `
+        # secret_version_for_client_secret` field is set, this field will be ignored.
         # Corresponds to the JSON property `clientSecret`
         # @return [String]
         attr_accessor :client_secret
@@ -13479,6 +13596,53 @@ module Google
         end
       end
       
+      # Tool version is a snapshot of the tool at certain timestamp.
+      class GoogleCloudDialogflowCxV3beta1ToolVersion
+        include Google::Apis::Core::Hashable
+      
+        # Output only. Last time the tool version was created or modified.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
+        # Required. The display name of the tool version.
+        # Corresponds to the JSON property `displayName`
+        # @return [String]
+        attr_accessor :display_name
+      
+        # Identifier. The unique identifier of the tool version. Format: `projects//
+        # locations//agents//tools//versions/`.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # A tool provides a list of actions which are available to the Playbook to
+        # attain its goal. A Tool consists of a description of the tool's usage and a
+        # specification of the tool which contains the schema and authentication
+        # information.
+        # Corresponds to the JSON property `tool`
+        # @return [Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowCxV3beta1Tool]
+        attr_accessor :tool
+      
+        # Output only. Last time the tool version was created or modified.
+        # Corresponds to the JSON property `updateTime`
+        # @return [String]
+        attr_accessor :update_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @display_name = args[:display_name] if args.key?(:display_name)
+          @name = args[:name] if args.key?(:name)
+          @tool = args[:tool] if args.key?(:tool)
+          @update_time = args[:update_time] if args.key?(:update_time)
+        end
+      end
+      
       # The request message for Flows.TrainFlow.
       class GoogleCloudDialogflowCxV3beta1TrainFlowRequest
         include Google::Apis::Core::Hashable
@@ -14392,7 +14556,7 @@ module Google
         # @return [String]
         attr_accessor :client_id
       
-        # Required. The client secret provided by the 3rd party platform.
+        # Optional. The client secret provided by the 3rd party platform.
         # Corresponds to the JSON property `clientSecret`
         # @return [String]
         attr_accessor :client_secret
@@ -17262,7 +17426,8 @@ module Google
         # @return [String]
         attr_accessor :participant_role
       
-        # Optional. The time when the message was sent.
+        # Optional. The time when the message was sent. For voice messages, this is the
+        # time when an utterance started.
         # Corresponds to the JSON property `sendTime`
         # @return [String]
         attr_accessor :send_time
@@ -20976,7 +21141,8 @@ module Google
         # @return [Array<Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowV2beta1ResponseMessage>]
         attr_accessor :response_messages
       
-        # Optional. The time when the message was sent.
+        # Optional. The time when the message was sent. For voice messages, this is the
+        # time when an utterance started.
         # Corresponds to the JSON property `sendTime`
         # @return [String]
         attr_accessor :send_time
@@ -21263,9 +21429,9 @@ module Google
         # Dialogflow only uses this to determine which conversations were handed off to
         # a human agent for measurement purposes. What else to do with this signal is up
         # to you and your handoff procedures. You may set this, for example: * In the
-        # entry fulfillment of a CX Page if entering the page indicates something went
-        # extremely wrong in the conversation. * In a webhook response when you
-        # determine that the customer issue can only be handled by a human.
+        # entry fulfillment of a Dialogflow CX Page if entering the page indicates
+        # something went extremely wrong in the conversation. * In a webhook response
+        # when you determine that the customer issue can only be handled by a human.
         # Corresponds to the JSON property `liveAgentHandoff`
         # @return [Google::Apis::DialogflowV3beta1::GoogleCloudDialogflowV2beta1ResponseMessageLiveAgentHandoff]
         attr_accessor :live_agent_handoff
@@ -21324,9 +21490,9 @@ module Google
       # Dialogflow only uses this to determine which conversations were handed off to
       # a human agent for measurement purposes. What else to do with this signal is up
       # to you and your handoff procedures. You may set this, for example: * In the
-      # entry fulfillment of a CX Page if entering the page indicates something went
-      # extremely wrong in the conversation. * In a webhook response when you
-      # determine that the customer issue can only be handled by a human.
+      # entry fulfillment of a Dialogflow CX Page if entering the page indicates
+      # something went extremely wrong in the conversation. * In a webhook response
+      # when you determine that the customer issue can only be handled by a human.
       class GoogleCloudDialogflowV2beta1ResponseMessageLiveAgentHandoff
         include Google::Apis::Core::Hashable