google-apis-ces_v1 0.4.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9bc1b2541133ca9fa5fc618d0718d327745498fe274dd7f02f2ac0e098df68fd
-  data.tar.gz: 93c6f06caee89e04cd285e82139b683258ff6c6db23e9dd5ba098c74ee87941e
+  metadata.gz: 873278c671d2dd73502342cb7379aa4eba49f5517dfebfc9d926bea5e7e131b6
+  data.tar.gz: a87af2b5d2d64b8f52011862c8b78e7b4ddcaa11b985c5bd2b5b3b477b324c22
 SHA512:
-  metadata.gz: 5939499dc9722cdd27629556ceec809ef43a0ba5f5386a02a87decab0a439620cbb3f9f3202ad96e47217bd9e5766055d59d42162c01114996a905acb5de4247
-  data.tar.gz: b7e5252f4e572a1a114fae6d9ad693c170a364728a9857f6a09a62af56a4e1fd5ce3a72171ac3685ce546dda7fa2194b6ef78dbfe815bb556e6cf680baabb620
+  metadata.gz: 53e24eb0fed81227aa3034e19bc3f09ee5f939290062c8ac19d83b221cbbf7eedb4734fe50d6d61aeb6a63984cf06ea6a1a7caa1ad32b40d4249354f66f872b7
+  data.tar.gz: 99e1c5ef68963bdc980ed20e1fc7e6bc1ce92a093a68631f223a3b149ab6f3bca869df12c9766df3abcee6b21026301906bb7868aee5f51db290525ba9c1a2fb

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-ces_v1
 
+### v0.6.0 (2026-04-26)
+
+* Regenerated from discovery document revision 20260422
+
+### v0.5.0 (2026-03-15)
+
+* Regenerated from discovery document revision 20260312
+
 ### v0.4.0 (2026-03-08)
 
 * Regenerated from discovery document revision 20260227

data/OVERVIEW.md

@@ -79,7 +79,7 @@ Gem names for modern clients are often of the form `google-cloud-<service_name>`
 
 **For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure.
 
-The [product documentation](https://cloud.google.com/customer-engagement-ai/conversational-agents/ps/reference) may provide guidance regarding the preferred client library to use.
+The [product documentation](https://docs.cloud.google.com/customer-engagement-ai/conversational-agents/ps) may provide guidance regarding the preferred client library to use.
 
 ## Supported Ruby versions
 

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

@@ -373,6 +373,46 @@ module Google
         end
       end
       
+      # Represents a tool that allows the agent to call another agent.
+      class AgentTool
+        include Google::Apis::Core::Hashable
+      
+        # Optional. The resource name of the agent that is the entry point of the tool.
+        # Format: `projects/`project`/locations/`location`/agents/`agent``
+        # Corresponds to the JSON property `agent`
+        # @return [String]
+        attr_accessor :agent
+      
+        # Optional. Description of the tool's purpose.
+        # Corresponds to the JSON property `description`
+        # @return [String]
+        attr_accessor :description
+      
+        # Required. The name of the agent tool.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Optional. Deprecated: Use `agent` instead. The resource name of the root agent
+        # that is the entry point of the tool. Format: `projects/`project`/locations/`
+        # location`/agents/`agent``
+        # Corresponds to the JSON property `rootAgent`
+        # @return [String]
+        attr_accessor :root_agent
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @agent = args[:agent] if args.key?(:agent)
+          @description = args[:description] if args.key?(:description)
+          @name = args[:name] if args.key?(:name)
+          @root_agent = args[:root_agent] if args.key?(:root_agent)
+        end
+      end
+      
       # Represents an event indicating the transfer of a conversation to a different
       # agent.
       class AgentTransfer
@@ -1013,7 +1053,7 @@ module Google
       class BigQueryExportSettings
         include Google::Apis::Core::Hashable
       
-        # Optional. The BigQuery dataset to export the data to.
+        # Optional. The BigQuery **dataset ID** to export the data to.
         # Corresponds to the JSON property `dataset`
         # @return [String]
         attr_accessor :dataset
@@ -1024,10 +1064,10 @@ module Google
         attr_accessor :enabled
         alias_method :enabled?, :enabled
       
-        # Optional. The project ID of the BigQuery dataset to export the data to. Note:
-        # If the BigQuery dataset is in a different project from the app, you should
-        # grant `roles/bigquery.admin` role to the CES service agent `service-@gcp-sa-
-        # ces.iam.gserviceaccount.com`.
+        # Optional. The **project ID** of the BigQuery dataset to export the data to.
+        # Note: If the BigQuery dataset is in a different project from the app, you
+        # should grant `roles/bigquery.admin` role to the CES service agent `service-@
+        # gcp-sa-ces.iam.gserviceaccount.com`.
         # Corresponds to the JSON property `project`
         # @return [String]
         attr_accessor :project
@@ -1825,6 +1865,12 @@ module Google
         attr_accessor :disable_conversation_logging
         alias_method :disable_conversation_logging?, :disable_conversation_logging
       
+        # Optional. Controls the retention window for the conversation. If not set, the
+        # conversation will be retained for 365 days.
+        # Corresponds to the JSON property `retentionWindow`
+        # @return [String]
+        attr_accessor :retention_window
+      
         def initialize(**args)
            update!(**args)
         end
@@ -1832,6 +1878,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @disable_conversation_logging = args[:disable_conversation_logging] if args.key?(:disable_conversation_logging)
+          @retention_window = args[:retention_window] if args.key?(:retention_window)
         end
       end
       
@@ -2446,6 +2493,11 @@ module Google
         # @return [String]
         attr_accessor :etag
       
+        # Experiment for the deployment.
+        # Corresponds to the JSON property `experimentConfig`
+        # @return [Google::Apis::CesV1::ExperimentConfig]
+        attr_accessor :experiment_config
+      
         # Identifier. The resource name of the deployment. Format: `projects/`project`/
         # locations/`location`/apps/`app`/deployments/`deployment``
         # Corresponds to the JSON property `name`
@@ -2468,6 +2520,7 @@ module Google
           @create_time = args[:create_time] if args.key?(:create_time)
           @display_name = args[:display_name] if args.key?(:display_name)
           @etag = args[:etag] if args.key?(:etag)
+          @experiment_config = args[:experiment_config] if args.key?(:experiment_config)
           @name = args[:name] if args.key?(:name)
           @update_time = args[:update_time] if args.key?(:update_time)
         end
@@ -2627,18 +2680,83 @@ module Google
       class ErrorHandlingSettings
         include Google::Apis::Core::Hashable
       
+        # Configuration for ending the session in case of system errors (e.g. LLM errors)
+        # .
+        # Corresponds to the JSON property `endSessionConfig`
+        # @return [Google::Apis::CesV1::ErrorHandlingSettingsEndSessionConfig]
+        attr_accessor :end_session_config
+      
         # Optional. The strategy to use for error handling.
         # Corresponds to the JSON property `errorHandlingStrategy`
         # @return [String]
         attr_accessor :error_handling_strategy
       
+        # Configuration for handling fallback responses.
+        # Corresponds to the JSON property `fallbackResponseConfig`
+        # @return [Google::Apis::CesV1::ErrorHandlingSettingsFallbackResponseConfig]
+        attr_accessor :fallback_response_config
+      
         def initialize(**args)
            update!(**args)
         end
       
         # Update properties of this object
         def update!(**args)
+          @end_session_config = args[:end_session_config] if args.key?(:end_session_config)
           @error_handling_strategy = args[:error_handling_strategy] if args.key?(:error_handling_strategy)
+          @fallback_response_config = args[:fallback_response_config] if args.key?(:fallback_response_config)
+        end
+      end
+      
+      # Configuration for ending the session in case of system errors (e.g. LLM errors)
+      # .
+      class ErrorHandlingSettingsEndSessionConfig
+        include Google::Apis::Core::Hashable
+      
+        # Optional. Whether to escalate the session in EndSession. If session is
+        # escalated, metadata in EndSession will contain `session_escalated = true`. See
+        # https://docs.cloud.google.com/customer-engagement-ai/conversational-agents/ps/
+        # deploy/google-telephony-platform#transfer_a_call_to_a_human_agent for details.
+        # Corresponds to the JSON property `escalateSession`
+        # @return [Boolean]
+        attr_accessor :escalate_session
+        alias_method :escalate_session?, :escalate_session
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @escalate_session = args[:escalate_session] if args.key?(:escalate_session)
+        end
+      end
+      
+      # Configuration for handling fallback responses.
+      class ErrorHandlingSettingsFallbackResponseConfig
+        include Google::Apis::Core::Hashable
+      
+        # Optional. The fallback messages in case of system errors (e.g. LLM errors),
+        # mapped by [supported language code](https://docs.cloud.google.com/customer-
+        # engagement-ai/conversational-agents/ps/reference/language).
+        # Corresponds to the JSON property `customFallbackMessages`
+        # @return [Hash<String,String>]
+        attr_accessor :custom_fallback_messages
+      
+        # Optional. The maximum number of fallback attempts to make before the agent
+        # emitting EndSession Signal.
+        # Corresponds to the JSON property `maxFallbackAttempts`
+        # @return [Fixnum]
+        attr_accessor :max_fallback_attempts
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @custom_fallback_messages = args[:custom_fallback_messages] if args.key?(:custom_fallback_messages)
+          @max_fallback_attempts = args[:max_fallback_attempts] if args.key?(:max_fallback_attempts)
         end
       end
       
@@ -2885,6 +3003,18 @@ module Google
         # @return [Hash<String,Object>]
         attr_accessor :args
       
+        # Optional. The [ToolCallContext](https://docs.cloud.google.com/customer-
+        # engagement-ai/conversational-agents/ps/tool/python#environment for details) to
+        # be passed to the Python tool.
+        # Corresponds to the JSON property `context`
+        # @return [Hash<String,Object>]
+        attr_accessor :context
+      
+        # Mock tool calls configuration for the session.
+        # Corresponds to the JSON property `mockConfig`
+        # @return [Google::Apis::CesV1::MockConfig]
+        attr_accessor :mock_config
+      
         # Optional. The name of the tool to execute. Format: projects/`project`/
         # locations/`location`/apps/`app`/tools/`tool`
         # Corresponds to the JSON property `tool`
@@ -2908,6 +3038,8 @@ module Google
         # Update properties of this object
         def update!(**args)
           @args = args[:args] if args.key?(:args)
+          @context = args[:context] if args.key?(:context)
+          @mock_config = args[:mock_config] if args.key?(:mock_config)
           @tool = args[:tool] if args.key?(:tool)
           @toolset_tool = args[:toolset_tool] if args.key?(:toolset_tool)
           @variables = args[:variables] if args.key?(:variables)
@@ -2955,10 +3087,94 @@ module Google
         end
       end
       
+      # Experiment for the deployment.
+      class ExperimentConfig
+        include Google::Apis::Core::Hashable
+      
+        # Version release for the experiment.
+        # Corresponds to the JSON property `versionRelease`
+        # @return [Google::Apis::CesV1::ExperimentConfigVersionRelease]
+        attr_accessor :version_release
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @version_release = args[:version_release] if args.key?(:version_release)
+        end
+      end
+      
+      # Version release for the experiment.
+      class ExperimentConfigVersionRelease
+        include Google::Apis::Core::Hashable
+      
+        # Optional. State of the version release.
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
+        # Optional. Traffic allocations for the version release.
+        # Corresponds to the JSON property `trafficAllocations`
+        # @return [Array<Google::Apis::CesV1::ExperimentConfigVersionReleaseTrafficAllocation>]
+        attr_accessor :traffic_allocations
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @state = args[:state] if args.key?(:state)
+          @traffic_allocations = args[:traffic_allocations] if args.key?(:traffic_allocations)
+        end
+      end
+      
+      # Traffic allocation for the version release.
+      class ExperimentConfigVersionReleaseTrafficAllocation
+        include Google::Apis::Core::Hashable
+      
+        # Optional. App version of the traffic allocation. Format: `projects/`project`/
+        # locations/`location`/apps/`app`/versions/`version``
+        # Corresponds to the JSON property `appVersion`
+        # @return [String]
+        attr_accessor :app_version
+      
+        # Optional. Id of the traffic allocation. Free format string, up to 128
+        # characters.
+        # Corresponds to the JSON property `id`
+        # @return [String]
+        attr_accessor :id
+      
+        # Optional. Traffic percentage of the traffic allocation. Must be between 0 and
+        # 100.
+        # Corresponds to the JSON property `trafficPercentage`
+        # @return [Fixnum]
+        attr_accessor :traffic_percentage
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @app_version = args[:app_version] if args.key?(:app_version)
+          @id = args[:id] if args.key?(:id)
+          @traffic_percentage = args[:traffic_percentage] if args.key?(:traffic_percentage)
+        end
+      end
+      
       # Request message for AgentService.ExportApp.
       class ExportAppRequest
         include Google::Apis::Core::Hashable
       
+        # Optional. The resource name of the app version to export. Format: `projects/`
+        # project`/locations/`location`/apps/`app`/versions/`version``.
+        # Corresponds to the JSON property `appVersion`
+        # @return [String]
+        attr_accessor :app_version
+      
         # Required. The format to export the app in.
         # Corresponds to the JSON property `exportFormat`
         # @return [String]
@@ -2977,6 +3193,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @app_version = args[:app_version] if args.key?(:app_version)
           @export_format = args[:export_format] if args.key?(:export_format)
           @gcs_uri = args[:gcs_uri] if args.key?(:gcs_uri)
         end
@@ -3078,6 +3295,12 @@ module Google
         # @return [String]
         attr_accessor :deployment
       
+        # Optional. Indicates if live handoff is enabled for the session.
+        # Corresponds to the JSON property `liveHandoffEnabled`
+        # @return [Boolean]
+        attr_accessor :live_handoff_enabled
+        alias_method :live_handoff_enabled?, :live_handoff_enabled
+      
         # Optional. The reCAPTCHA token generated by the client-side chat widget.
         # Corresponds to the JSON property `recaptchaToken`
         # @return [String]
@@ -3090,6 +3313,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @deployment = args[:deployment] if args.key?(:deployment)
+          @live_handoff_enabled = args[:live_handoff_enabled] if args.key?(:live_handoff_enabled)
           @recaptcha_token = args[:recaptcha_token] if args.key?(:recaptcha_token)
         end
       end
@@ -3766,10 +3990,12 @@ module Google
         attr_accessor :enable_multilingual_support
         alias_method :enable_multilingual_support?, :enable_multilingual_support
       
-        # Optional. The action to perform when an agent receives input in an unsupported
-        # language. This can be a predefined action or a custom tool call. Valid values
-        # are: - A tool's full resource name, which triggers a specific tool execution. -
-        # A predefined system action, such as "escalate" or "exit", which triggers an
+        # Optional. Deprecated: This feature is no longer supported. Use `
+        # enable_multilingual_support` instead to improve handling of multilingual input.
+        # The action to perform when an agent receives input in an unsupported language.
+        # This can be a predefined action or a custom tool call. Valid values are: - A
+        # tool's full resource name, which triggers a specific tool execution. - A
+        # predefined system action, such as "escalate" or "exit", which triggers an
         # EndSession signal with corresponding metadata to terminate the conversation.
         # Corresponds to the JSON property `fallbackAction`
         # @return [String]
@@ -4206,6 +4432,11 @@ module Google
         # @return [Google::Apis::CesV1::RedactionConfig]
         attr_accessor :redaction_config
       
+        # Configuration for how the audio interactions should be recorded.
+        # Corresponds to the JSON property `unredactedAudioRecordingConfig`
+        # @return [Google::Apis::CesV1::AudioRecordingConfig]
+        attr_accessor :unredacted_audio_recording_config
+      
         def initialize(**args)
            update!(**args)
         end
@@ -4219,6 +4450,7 @@ module Google
           @evaluation_audio_recording_config = args[:evaluation_audio_recording_config] if args.key?(:evaluation_audio_recording_config)
           @metric_analysis_settings = args[:metric_analysis_settings] if args.key?(:metric_analysis_settings)
           @redaction_config = args[:redaction_config] if args.key?(:redaction_config)
+          @unredacted_audio_recording_config = args[:unredacted_audio_recording_config] if args.key?(:unredacted_audio_recording_config)
         end
       end
       
@@ -4232,6 +4464,14 @@ module Google
         # @return [Google::Apis::CesV1::ApiAuthentication]
         attr_accessor :api_authentication
       
+        # Optional. The custom headers to send in the request to the MCP server. The
+        # values must be in the format `$context.variables.` and can be set in the
+        # session variables. See https://docs.cloud.google.com/customer-engagement-ai/
+        # conversational-agents/ps/tool/open-api#openapi-injection for more details.
+        # Corresponds to the JSON property `customHeaders`
+        # @return [Hash<String,String>]
+        attr_accessor :custom_headers
+      
         # Optional. The description of the MCP tool.
         # Corresponds to the JSON property `description`
         # @return [String]
@@ -4278,6 +4518,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @api_authentication = args[:api_authentication] if args.key?(:api_authentication)
+          @custom_headers = args[:custom_headers] if args.key?(:custom_headers)
           @description = args[:description] if args.key?(:description)
           @input_schema = args[:input_schema] if args.key?(:input_schema)
           @name = args[:name] if args.key?(:name)
@@ -4297,6 +4538,14 @@ module Google
         # @return [Google::Apis::CesV1::ApiAuthentication]
         attr_accessor :api_authentication
       
+        # Optional. The custom headers to send in the request to the MCP server. The
+        # values must be in the format `$context.variables.` and can be set in the
+        # session variables. See https://docs.cloud.google.com/customer-engagement-ai/
+        # conversational-agents/ps/tool/open-api#openapi-injection for more details.
+        # Corresponds to the JSON property `customHeaders`
+        # @return [Hash<String,String>]
+        attr_accessor :custom_headers
+      
         # Required. The address of the MCP server, for example, "https://example.com/mcp/
         # ". If the server is built with the MCP SDK, the url should be suffixed with "/
         # mcp/". Only Streamable HTTP transport based servers are supported. See https://
@@ -4323,6 +4572,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @api_authentication = args[:api_authentication] if args.key?(:api_authentication)
+          @custom_headers = args[:custom_headers] if args.key?(:custom_headers)
           @server_address = args[:server_address] if args.key?(:server_address)
           @service_directory_config = args[:service_directory_config] if args.key?(:service_directory_config)
           @tls_config = args[:tls_config] if args.key?(:tls_config)
@@ -4384,6 +4634,81 @@ module Google
         end
       end
       
+      # Mock tool calls configuration for the session.
+      class MockConfig
+        include Google::Apis::Core::Hashable
+      
+        # Optional. All tool calls to mock for the duration of the session.
+        # Corresponds to the JSON property `mockedToolCalls`
+        # @return [Array<Google::Apis::CesV1::MockedToolCall>]
+        attr_accessor :mocked_tool_calls
+      
+        # Required. Beavhior for tool calls that don't match any args patterns in
+        # mocked_tool_calls.
+        # Corresponds to the JSON property `unmatchedToolCallBehavior`
+        # @return [String]
+        attr_accessor :unmatched_tool_call_behavior
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @mocked_tool_calls = args[:mocked_tool_calls] if args.key?(:mocked_tool_calls)
+          @unmatched_tool_call_behavior = args[:unmatched_tool_call_behavior] if args.key?(:unmatched_tool_call_behavior)
+        end
+      end
+      
+      # A mocked tool call. Expresses the target tool + a pattern to match against
+      # that tool's args / inputs. If the pattern matches, then the mock response will
+      # be returned.
+      class MockedToolCall
+        include Google::Apis::Core::Hashable
+      
+        # Required. A pattern to match against the args / inputs of all dispatched tool
+        # calls. If the tool call inputs match this pattern, then mock output will be
+        # returned.
+        # Corresponds to the JSON property `expectedArgsPattern`
+        # @return [Hash<String,Object>]
+        attr_accessor :expected_args_pattern
+      
+        # Optional. The mock response / output to return if the tool call args / inputs
+        # match the pattern.
+        # Corresponds to the JSON property `mockResponse`
+        # @return [Hash<String,Object>]
+        attr_accessor :mock_response
+      
+        # Optional. Deprecated. Use tool_identifier instead.
+        # Corresponds to the JSON property `tool`
+        # @return [String]
+        attr_accessor :tool
+      
+        # Optional. The name of the tool to mock. Format: `projects/`project`/locations/`
+        # location`/apps/`app`/tools/`tool``
+        # Corresponds to the JSON property `toolId`
+        # @return [String]
+        attr_accessor :tool_id
+      
+        # A tool that is created from a toolset.
+        # Corresponds to the JSON property `toolset`
+        # @return [Google::Apis::CesV1::ToolsetTool]
+        attr_accessor :toolset
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @expected_args_pattern = args[:expected_args_pattern] if args.key?(:expected_args_pattern)
+          @mock_response = args[:mock_response] if args.key?(:mock_response)
+          @tool = args[:tool] if args.key?(:tool)
+          @tool_id = args[:tool_id] if args.key?(:tool_id)
+          @toolset = args[:toolset] if args.key?(:toolset)
+        end
+      end
+      
       # Model settings contains various configurations for the LLM model.
       class ModelSettings
         include Google::Apis::Core::Hashable
@@ -5481,6 +5806,15 @@ module Google
         # @return [String]
         attr_accessor :deployment
       
+        # Optional. Whether to enable streaming text outputs from the model. By default,
+        # text outputs from the model are collected before sending to the client. NOTE:
+        # This is only supported for text (non-voice) sessions via StreamRunSession or
+        # BidiRunSession.
+        # Corresponds to the JSON property `enableTextStreaming`
+        # @return [Boolean]
+        attr_accessor :enable_text_streaming
+        alias_method :enable_text_streaming?, :enable_text_streaming
+      
         # Optional. The entry agent to handle the session. If not specified, the session
         # will be handled by the root agent of the app. Format: `projects/`project`/
         # locations/`location`/apps/`app`/agents/`agent``
@@ -5540,6 +5874,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @deployment = args[:deployment] if args.key?(:deployment)
+          @enable_text_streaming = args[:enable_text_streaming] if args.key?(:enable_text_streaming)
           @entry_agent = args[:entry_agent] if args.key?(:entry_agent)
           @historical_contexts = args[:historical_contexts] if args.key?(:historical_contexts)
           @input_audio_config = args[:input_audio_config] if args.key?(:input_audio_config)
@@ -5995,6 +6330,11 @@ module Google
       class Tool
         include Google::Apis::Core::Hashable
       
+        # Represents a tool that allows the agent to call another agent.
+        # Corresponds to the JSON property `agentTool`
+        # @return [Google::Apis::CesV1::AgentTool]
+        attr_accessor :agent_tool
+      
         # Represents a client-side function that the agent can invoke. When the tool is
         # chosen by the agent, control is handed off to the client. The client is
         # responsible for executing the function and returning the result as a
@@ -6115,6 +6455,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @agent_tool = args[:agent_tool] if args.key?(:agent_tool)
           @client_function = args[:client_function] if args.key?(:client_function)
           @connector_tool = args[:connector_tool] if args.key?(:connector_tool)
           @create_time = args[:create_time] if args.key?(:create_time)
@@ -6636,6 +6977,12 @@ module Google
       class WidgetTool
         include Google::Apis::Core::Hashable
       
+        # Configuration for mapping data from a source tool to the widget's input
+        # parameters.
+        # Corresponds to the JSON property `dataMapping`
+        # @return [Google::Apis::CesV1::WidgetToolDataMapping]
+        attr_accessor :data_mapping
+      
         # Optional. The description of the widget tool.
         # Corresponds to the JSON property `description`
         # @return [String]
@@ -6651,6 +6998,16 @@ module Google
         # @return [Google::Apis::CesV1::Schema]
         attr_accessor :parameters
       
+        # Configuration for the text response returned with the widget.
+        # Corresponds to the JSON property `textResponseConfig`
+        # @return [Google::Apis::CesV1::WidgetToolTextResponseConfig]
+        attr_accessor :text_response_config
+      
+        # Optional. Configuration for rendering the widget.
+        # Corresponds to the JSON property `uiConfig`
+        # @return [Hash<String,Object>]
+        attr_accessor :ui_config
+      
         # Optional. The type of the widget tool. If not specified, the default type will
         # be CUSTOMIZED.
         # Corresponds to the JSON property `widgetType`
@@ -6663,12 +7020,94 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @data_mapping = args[:data_mapping] if args.key?(:data_mapping)
           @description = args[:description] if args.key?(:description)
           @name = args[:name] if args.key?(:name)
           @parameters = args[:parameters] if args.key?(:parameters)
+          @text_response_config = args[:text_response_config] if args.key?(:text_response_config)
+          @ui_config = args[:ui_config] if args.key?(:ui_config)
           @widget_type = args[:widget_type] if args.key?(:widget_type)
         end
       end
+      
+      # Configuration for mapping data from a source tool to the widget's input
+      # parameters.
+      class WidgetToolDataMapping
+        include Google::Apis::Core::Hashable
+      
+        # Optional. A map of widget input parameter fields to the corresponding output
+        # fields of the source tool.
+        # Corresponds to the JSON property `fieldMappings`
+        # @return [Hash<String,String>]
+        attr_accessor :field_mappings
+      
+        # Optional. The mode of the data mapping.
+        # Corresponds to the JSON property `mode`
+        # @return [String]
+        attr_accessor :mode
+      
+        # A Python function tool.
+        # Corresponds to the JSON property `pythonFunction`
+        # @return [Google::Apis::CesV1::PythonFunction]
+        attr_accessor :python_function
+      
+        # Deprecated: Use `python_function` instead.
+        # Corresponds to the JSON property `pythonScript`
+        # @return [String]
+        attr_accessor :python_script
+      
+        # Optional. The resource name of the tool that provides the data for the widget (
+        # e.g., a search tool or a custom function). Format: `projects/`project`/
+        # locations/`location`/agents/`agent`/tools/`tool``
+        # Corresponds to the JSON property `sourceToolName`
+        # @return [String]
+        attr_accessor :source_tool_name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @field_mappings = args[:field_mappings] if args.key?(:field_mappings)
+          @mode = args[:mode] if args.key?(:mode)
+          @python_function = args[:python_function] if args.key?(:python_function)
+          @python_script = args[:python_script] if args.key?(:python_script)
+          @source_tool_name = args[:source_tool_name] if args.key?(:source_tool_name)
+        end
+      end
+      
+      # Configuration for the text response returned with the widget.
+      class WidgetToolTextResponseConfig
+        include Google::Apis::Core::Hashable
+      
+        # Optional. The static text response to return when type is STATIC.
+        # Corresponds to the JSON property `staticText`
+        # @return [String]
+        attr_accessor :static_text
+      
+        # Optional. Instruction for the LLM on how to generate the text response. Used
+        # as the description for the text response parameter if type is LLM_GENERATED.
+        # Corresponds to the JSON property `textResponseInstruction`
+        # @return [String]
+        attr_accessor :text_response_instruction
+      
+        # Optional. The strategy for providing the text response.
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @static_text = args[:static_text] if args.key?(:static_text)
+          @text_response_instruction = args[:text_response_instruction] if args.key?(:text_response_instruction)
+          @type = args[:type] if args.key?(:type)
+        end
+      end
     end
   end
 end

data/lib/google/apis/ces_v1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module CesV1
       # Version of the google-apis-ces_v1 gem
-      GEM_VERSION = "0.4.0"
+      GEM_VERSION = "0.6.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.18.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20260227"
+      REVISION = "20260422"
     end
   end
 end

data/lib/google/apis/ces_v1/representations.rb

@@ -58,6 +58,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class AgentTool
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class AgentTransfer
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -406,6 +412,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ErrorHandlingSettingsEndSessionConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class ErrorHandlingSettingsFallbackResponseConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class EvaluationMetricsThresholds
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -460,6 +478,24 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ExperimentConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class ExperimentConfigVersionRelease
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class ExperimentConfigVersionReleaseTrafficAllocation
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ExportAppRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -706,6 +742,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class MockConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class MockedToolCall
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ModelSettings
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1066,6 +1114,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class WidgetToolDataMapping
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class WidgetToolTextResponseConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Action
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1150,6 +1210,16 @@ module Google
         end
       end
       
+      class AgentTool
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :agent, as: 'agent'
+          property :description, as: 'description'
+          property :name, as: 'name'
+          property :root_agent, as: 'rootAgent'
+        end
+      end
+      
       class AgentTransfer
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1538,6 +1608,7 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :disable_conversation_logging, as: 'disableConversationLogging'
+          property :retention_window, as: 'retentionWindow'
         end
       end
       
@@ -1721,6 +1792,8 @@ module Google
           property :create_time, as: 'createTime'
           property :display_name, as: 'displayName'
           property :etag, as: 'etag'
+          property :experiment_config, as: 'experimentConfig', class: Google::Apis::CesV1::ExperimentConfig, decorator: Google::Apis::CesV1::ExperimentConfig::Representation
+      
           property :name, as: 'name'
           property :update_time, as: 'updateTime'
         end
@@ -1776,7 +1849,26 @@ module Google
       class ErrorHandlingSettings
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :end_session_config, as: 'endSessionConfig', class: Google::Apis::CesV1::ErrorHandlingSettingsEndSessionConfig, decorator: Google::Apis::CesV1::ErrorHandlingSettingsEndSessionConfig::Representation
+      
           property :error_handling_strategy, as: 'errorHandlingStrategy'
+          property :fallback_response_config, as: 'fallbackResponseConfig', class: Google::Apis::CesV1::ErrorHandlingSettingsFallbackResponseConfig, decorator: Google::Apis::CesV1::ErrorHandlingSettingsFallbackResponseConfig::Representation
+      
+        end
+      end
+      
+      class ErrorHandlingSettingsEndSessionConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :escalate_session, as: 'escalateSession'
+        end
+      end
+      
+      class ErrorHandlingSettingsFallbackResponseConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          hash :custom_fallback_messages, as: 'customFallbackMessages'
+          property :max_fallback_attempts, as: 'maxFallbackAttempts'
         end
       end
       
@@ -1853,6 +1945,9 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           hash :args, as: 'args'
+          hash :context, as: 'context'
+          property :mock_config, as: 'mockConfig', class: Google::Apis::CesV1::MockConfig, decorator: Google::Apis::CesV1::MockConfig::Representation
+      
           property :tool, as: 'tool'
           property :toolset_tool, as: 'toolsetTool', class: Google::Apis::CesV1::ToolsetTool, decorator: Google::Apis::CesV1::ToolsetTool::Representation
       
@@ -1871,9 +1966,36 @@ module Google
         end
       end
       
+      class ExperimentConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :version_release, as: 'versionRelease', class: Google::Apis::CesV1::ExperimentConfigVersionRelease, decorator: Google::Apis::CesV1::ExperimentConfigVersionRelease::Representation
+      
+        end
+      end
+      
+      class ExperimentConfigVersionRelease
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :state, as: 'state'
+          collection :traffic_allocations, as: 'trafficAllocations', class: Google::Apis::CesV1::ExperimentConfigVersionReleaseTrafficAllocation, decorator: Google::Apis::CesV1::ExperimentConfigVersionReleaseTrafficAllocation::Representation
+      
+        end
+      end
+      
+      class ExperimentConfigVersionReleaseTrafficAllocation
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :app_version, as: 'appVersion'
+          property :id, as: 'id'
+          property :traffic_percentage, as: 'trafficPercentage'
+        end
+      end
+      
       class ExportAppRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :app_version, as: 'appVersion'
           property :export_format, as: 'exportFormat'
           property :gcs_uri, as: 'gcsUri'
         end
@@ -1908,6 +2030,7 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :deployment, as: 'deployment'
+          property :live_handoff_enabled, as: 'liveHandoffEnabled'
           property :recaptcha_token, as: 'recaptchaToken'
         end
       end
@@ -2240,6 +2363,8 @@ module Google
       
           property :redaction_config, as: 'redactionConfig', class: Google::Apis::CesV1::RedactionConfig, decorator: Google::Apis::CesV1::RedactionConfig::Representation
       
+          property :unredacted_audio_recording_config, as: 'unredactedAudioRecordingConfig', class: Google::Apis::CesV1::AudioRecordingConfig, decorator: Google::Apis::CesV1::AudioRecordingConfig::Representation
+      
         end
       end
       
@@ -2248,6 +2373,7 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           property :api_authentication, as: 'apiAuthentication', class: Google::Apis::CesV1::ApiAuthentication, decorator: Google::Apis::CesV1::ApiAuthentication::Representation
       
+          hash :custom_headers, as: 'customHeaders'
           property :description, as: 'description'
           property :input_schema, as: 'inputSchema', class: Google::Apis::CesV1::Schema, decorator: Google::Apis::CesV1::Schema::Representation
       
@@ -2267,6 +2393,7 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           property :api_authentication, as: 'apiAuthentication', class: Google::Apis::CesV1::ApiAuthentication, decorator: Google::Apis::CesV1::ApiAuthentication::Representation
       
+          hash :custom_headers, as: 'customHeaders'
           property :server_address, as: 'serverAddress'
           property :service_directory_config, as: 'serviceDirectoryConfig', class: Google::Apis::CesV1::ServiceDirectoryConfig, decorator: Google::Apis::CesV1::ServiceDirectoryConfig::Representation
       
@@ -2292,6 +2419,27 @@ module Google
         end
       end
       
+      class MockConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :mocked_tool_calls, as: 'mockedToolCalls', class: Google::Apis::CesV1::MockedToolCall, decorator: Google::Apis::CesV1::MockedToolCall::Representation
+      
+          property :unmatched_tool_call_behavior, as: 'unmatchedToolCallBehavior'
+        end
+      end
+      
+      class MockedToolCall
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          hash :expected_args_pattern, as: 'expectedArgsPattern'
+          hash :mock_response, as: 'mockResponse'
+          property :tool, as: 'tool'
+          property :tool_id, as: 'toolId'
+          property :toolset, as: 'toolset', class: Google::Apis::CesV1::ToolsetTool, decorator: Google::Apis::CesV1::ToolsetTool::Representation
+      
+        end
+      end
+      
       class ModelSettings
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -2605,6 +2753,7 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :deployment, as: 'deployment'
+          property :enable_text_streaming, as: 'enableTextStreaming'
           property :entry_agent, as: 'entryAgent'
           collection :historical_contexts, as: 'historicalContexts', class: Google::Apis::CesV1::Message, decorator: Google::Apis::CesV1::Message::Representation
       
@@ -2742,6 +2891,8 @@ module Google
       class Tool
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :agent_tool, as: 'agentTool', class: Google::Apis::CesV1::AgentTool, decorator: Google::Apis::CesV1::AgentTool::Representation
+      
           property :client_function, as: 'clientFunction', class: Google::Apis::CesV1::ClientFunction, decorator: Google::Apis::CesV1::ClientFunction::Representation
       
           property :connector_tool, as: 'connectorTool', class: Google::Apis::CesV1::ConnectorTool, decorator: Google::Apis::CesV1::ConnectorTool::Representation
@@ -2935,13 +3086,39 @@ module Google
       class WidgetTool
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :data_mapping, as: 'dataMapping', class: Google::Apis::CesV1::WidgetToolDataMapping, decorator: Google::Apis::CesV1::WidgetToolDataMapping::Representation
+      
           property :description, as: 'description'
           property :name, as: 'name'
           property :parameters, as: 'parameters', class: Google::Apis::CesV1::Schema, decorator: Google::Apis::CesV1::Schema::Representation
       
+          property :text_response_config, as: 'textResponseConfig', class: Google::Apis::CesV1::WidgetToolTextResponseConfig, decorator: Google::Apis::CesV1::WidgetToolTextResponseConfig::Representation
+      
+          hash :ui_config, as: 'uiConfig'
           property :widget_type, as: 'widgetType'
         end
       end
+      
+      class WidgetToolDataMapping
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          hash :field_mappings, as: 'fieldMappings'
+          property :mode, as: 'mode'
+          property :python_function, as: 'pythonFunction', class: Google::Apis::CesV1::PythonFunction, decorator: Google::Apis::CesV1::PythonFunction::Representation
+      
+          property :python_script, as: 'pythonScript'
+          property :source_tool_name, as: 'sourceToolName'
+        end
+      end
+      
+      class WidgetToolTextResponseConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :static_text, as: 'staticText'
+          property :text_response_instruction, as: 'textResponseInstruction'
+          property :type, as: 'type'
+        end
+      end
     end
   end
 end

data/lib/google/apis/ces_v1/service.rb

@@ -30,7 +30,7 @@ module Google
       #    Ces = Google::Apis::CesV1 # Alias the module
       #    service = Ces::CustomerEngagementSuiteService.new
       #
-      # @see https://cloud.google.com/customer-engagement-ai/conversational-agents/ps/reference
+      # @see https://docs.cloud.google.com/customer-engagement-ai/conversational-agents/ps
       class CustomerEngagementSuiteService < Google::Apis::Core::BaseService
         DEFAULT_ENDPOINT_TEMPLATE = "https://ces.$UNIVERSE_DOMAIN$/"
 
@@ -82,15 +82,20 @@ module Google
         end
         
         # Lists information about the supported locations for this service. This method
-        # can be called in two ways: * **List all public locations:** Use the path `GET /
-        # v1/locations`. * **List project-visible locations:** Use the path `GET /v1/
-        # projects/`project_id`/locations`. This may include public locations as well as
-        # private or other locations specifically visible to the project.
+        # lists locations based on the resource scope provided in the
+        # ListLocationsRequest.name field: * **Global locations**: If `name` is empty,
+        # the method lists the public locations available to all projects. * **Project-
+        # specific locations**: If `name` follows the format `projects/`project``, the
+        # method lists locations visible to that specific project. This includes public,
+        # private, or other project-specific locations enabled for the project. For gRPC
+        # and client library implementations, the resource name is passed as the `name`
+        # field. For direct service calls, the resource name is incorporated into the
+        # request path based on the specific service implementation and version.
         # @param [String] name
         #   The resource that owns the locations collection, if applicable.
         # @param [Array<String>, String] extra_location_types
-        #   Optional. Do not use this field. It is unsupported and is ignored unless
-        #   explicitly documented otherwise. This is primarily for internal usage.
+        #   Optional. Do not use this field unless explicitly documented otherwise. This
+        #   is primarily for internal usage.
         # @param [String] filter
         #   A filter to narrow down results to a preferred subset. The filtering language
         #   accepts strings like `"displayName=tokyo"`, and is documented in more detail
@@ -1491,7 +1496,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Initiates a single turn interaction with the CES agent within a session.
+        # Initiates a single-turn interaction with the CES agent within a session.
         # @param [String] session
         #   Required. The unique identifier of the session. Format: `projects/`project`/
         #   locations/`location`/apps/`app`/sessions/`session``
@@ -1525,6 +1530,45 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Initiates a single-turn interaction with the CES agent. Uses server-side
+        # streaming to deliver incremental results and partial responses as they are
+        # generated. By default, complete responses (e.g., messages from callbacks or
+        # full LLM responses) are sent to the client as soon as they are available. To
+        # enable streaming individual text chunks directly from the model, set
+        # enable_text_streaming to true.
+        # @param [String] session
+        #   Required. The unique identifier of the session. Format: `projects/`project`/
+        #   locations/`location`/apps/`app`/sessions/`session``
+        # @param [Google::Apis::CesV1::RunSessionRequest] run_session_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CesV1::RunSessionResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CesV1::RunSessionResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def stream_project_location_app_session_run_session(session, run_session_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+session}:streamRunSession', options)
+          command.request_representation = Google::Apis::CesV1::RunSessionRequest::Representation
+          command.request_object = run_session_request_object
+          command.response_representation = Google::Apis::CesV1::RunSessionResponse::Representation
+          command.response_class = Google::Apis::CesV1::RunSessionResponse
+          command.params['session'] = session unless session.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Creates a new tool in the given app.
         # @param [String] parent
         #   Required. The resource name of the app to create a tool in.

data/lib/google/apis/ces_v1.rb

@@ -23,7 +23,7 @@ module Google
     #
     # 
     #
-    # @see https://cloud.google.com/customer-engagement-ai/conversational-agents/ps/reference
+    # @see https://docs.cloud.google.com/customer-engagement-ai/conversational-agents/ps
     module CesV1
       # Version of the Gemini Enterprise for Customer Experience API this client connects to.
       # This is NOT the gem version.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-ces_v1
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Google LLC
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-ces_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-ces_v1/v0.4.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-ces_v1/v0.6.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-ces_v1
 rdoc_options: []
 require_paths: