google-cloud-ces-v1 0.2.1 → 0.3.0

data/lib/google/cloud/ces/v1/widget_tool_pb.rb

@@ -10,7 +10,7 @@ require 'google/cloud/ces/v1/schema_pb'
 require 'google/protobuf/struct_pb'
 
 
-descriptor_data = "\n%google/cloud/ces/v1/widget_tool.proto\x12\x13google.cloud.ces.v1\x1a\x1fgoogle/api/field_behavior.proto\x1a)google/cloud/ces/v1/python_function.proto\x1a google/cloud/ces/v1/schema.proto\x1a\x1cgoogle/protobuf/struct.proto\"\x91\x08\n\nWidgetTool\x12\x36\n\nparameters\x18\x04 \x01(\x0b\x32\x1b.google.cloud.ces.v1.SchemaB\x03\xe0\x41\x01H\x00\x12\x11\n\x04name\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x18\n\x0b\x64\x65scription\x18\x02 \x01(\tB\x03\xe0\x41\x01\x12\x44\n\x0bwidget_type\x18\x03 \x01(\x0e\x32*.google.cloud.ces.v1.WidgetTool.WidgetTypeB\x03\xe0\x41\x01\x12/\n\tui_config\x18\x05 \x01(\x0b\x32\x17.google.protobuf.StructB\x03\xe0\x41\x01\x12\x46\n\x0c\x64\x61ta_mapping\x18\x06 \x01(\x0b\x32+.google.cloud.ces.v1.WidgetTool.DataMappingB\x03\xe0\x41\x01\x1a\xa6\x03\n\x0b\x44\x61taMapping\x12\x1d\n\x10source_tool_name\x18\x01 \x01(\tB\x03\xe0\x41\x01\x12[\n\x0e\x66ield_mappings\x18\x02 \x03(\x0b\x32>.google.cloud.ces.v1.WidgetTool.DataMapping.FieldMappingsEntryB\x03\xe0\x41\x01\x12\x41\n\x0fpython_function\x18\x05 \x01(\x0b\x32#.google.cloud.ces.v1.PythonFunctionB\x03\xe0\x41\x01\x12\x43\n\x04mode\x18\x04 \x01(\x0e\x32\x30.google.cloud.ces.v1.WidgetTool.DataMapping.ModeB\x03\xe0\x41\x01\x12\x19\n\rpython_script\x18\x03 \x01(\tB\x02\x18\x01\x1a\x34\n\x12\x46ieldMappingsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"B\n\x04Mode\x12\x14\n\x10MODE_UNSPECIFIED\x10\x00\x12\x11\n\rFIELD_MAPPING\x10\x01\x12\x11\n\rPYTHON_SCRIPT\x10\x02\"\xac\x02\n\nWidgetType\x12\x1b\n\x17WIDGET_TYPE_UNSPECIFIED\x10\x00\x12\n\n\x06\x43USTOM\x10\x01\x12\x14\n\x10PRODUCT_CAROUSEL\x10\x02\x12\x13\n\x0fPRODUCT_DETAILS\x10\x03\x12\x11\n\rQUICK_ACTIONS\x10\x04\x12\x16\n\x12PRODUCT_COMPARISON\x10\x05\x12\x1c\n\x18\x41\x44VANCED_PRODUCT_DETAILS\x10\x06\x12\x0e\n\nSHORT_FORM\x10\x07\x12\x18\n\x14OVERALL_SATISFACTION\x10\x08\x12\x11\n\rORDER_SUMMARY\x10\t\x12\x17\n\x13\x41PPOINTMENT_DETAILS\x10\n\x12\x19\n\x15\x41PPOINTMENT_SCHEDULER\x10\x0b\x12\x10\n\x0c\x43ONTACT_FORM\x10\x0c\x42\x07\n\x05inputBW\n\x17\x63om.google.cloud.ces.v1B\x0fWidgetToolProtoP\x01Z)cloud.google.com/go/ces/apiv1/cespb;cespbb\x06proto3"
+descriptor_data = "\n%google/cloud/ces/v1/widget_tool.proto\x12\x13google.cloud.ces.v1\x1a\x1fgoogle/api/field_behavior.proto\x1a)google/cloud/ces/v1/python_function.proto\x1a google/cloud/ces/v1/schema.proto\x1a\x1cgoogle/protobuf/struct.proto\"\xd4\n\n\nWidgetTool\x12\x36\n\nparameters\x18\x04 \x01(\x0b\x32\x1b.google.cloud.ces.v1.SchemaB\x03\xe0\x41\x01H\x00\x12\x11\n\x04name\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x18\n\x0b\x64\x65scription\x18\x02 \x01(\tB\x03\xe0\x41\x01\x12\x44\n\x0bwidget_type\x18\x03 \x01(\x0e\x32*.google.cloud.ces.v1.WidgetTool.WidgetTypeB\x03\xe0\x41\x01\x12/\n\tui_config\x18\x05 \x01(\x0b\x32\x17.google.protobuf.StructB\x03\xe0\x41\x01\x12\x46\n\x0c\x64\x61ta_mapping\x18\x06 \x01(\x0b\x32+.google.cloud.ces.v1.WidgetTool.DataMappingB\x03\xe0\x41\x01\x12U\n\x14text_response_config\x18\x07 \x01(\x0b\x32\x32.google.cloud.ces.v1.WidgetTool.TextResponseConfigB\x03\xe0\x41\x01\x1a\xe9\x01\n\x12TextResponseConfig\x12J\n\x04type\x18\x01 \x01(\x0e\x32\x37.google.cloud.ces.v1.WidgetTool.TextResponseConfig.TypeB\x03\xe0\x41\x01\x12\x18\n\x0bstatic_text\x18\x02 \x01(\tB\x03\xe0\x41\x01\x12&\n\x19text_response_instruction\x18\x03 \x01(\tB\x03\xe0\x41\x01\"E\n\x04Type\x12\x14\n\x10TYPE_UNSPECIFIED\x10\x00\x12\x08\n\x04NONE\x10\x01\x12\x11\n\rLLM_GENERATED\x10\x02\x12\n\n\x06STATIC\x10\x03\x1a\xa6\x03\n\x0b\x44\x61taMapping\x12\x1d\n\x10source_tool_name\x18\x01 \x01(\tB\x03\xe0\x41\x01\x12[\n\x0e\x66ield_mappings\x18\x02 \x03(\x0b\x32>.google.cloud.ces.v1.WidgetTool.DataMapping.FieldMappingsEntryB\x03\xe0\x41\x01\x12\x41\n\x0fpython_function\x18\x05 \x01(\x0b\x32#.google.cloud.ces.v1.PythonFunctionB\x03\xe0\x41\x01\x12\x43\n\x04mode\x18\x04 \x01(\x0e\x32\x30.google.cloud.ces.v1.WidgetTool.DataMapping.ModeB\x03\xe0\x41\x01\x12\x19\n\rpython_script\x18\x03 \x01(\tB\x02\x18\x01\x1a\x34\n\x12\x46ieldMappingsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"B\n\x04Mode\x12\x14\n\x10MODE_UNSPECIFIED\x10\x00\x12\x11\n\rFIELD_MAPPING\x10\x01\x12\x11\n\rPYTHON_SCRIPT\x10\x02\"\xac\x02\n\nWidgetType\x12\x1b\n\x17WIDGET_TYPE_UNSPECIFIED\x10\x00\x12\n\n\x06\x43USTOM\x10\x01\x12\x14\n\x10PRODUCT_CAROUSEL\x10\x02\x12\x13\n\x0fPRODUCT_DETAILS\x10\x03\x12\x11\n\rQUICK_ACTIONS\x10\x04\x12\x16\n\x12PRODUCT_COMPARISON\x10\x05\x12\x1c\n\x18\x41\x44VANCED_PRODUCT_DETAILS\x10\x06\x12\x0e\n\nSHORT_FORM\x10\x07\x12\x18\n\x14OVERALL_SATISFACTION\x10\x08\x12\x11\n\rORDER_SUMMARY\x10\t\x12\x17\n\x13\x41PPOINTMENT_DETAILS\x10\n\x12\x19\n\x15\x41PPOINTMENT_SCHEDULER\x10\x0b\x12\x10\n\x0c\x43ONTACT_FORM\x10\x0c\x42\x07\n\x05inputBW\n\x17\x63om.google.cloud.ces.v1B\x0fWidgetToolProtoP\x01Z)cloud.google.com/go/ces/apiv1/cespb;cespbb\x06proto3"
 
 pool = ::Google::Protobuf::DescriptorPool.generated_pool
 pool.add_serialized_file(descriptor_data)
@@ -20,6 +20,8 @@ module Google
     module Ces
       module V1
         WidgetTool = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.ces.v1.WidgetTool").msgclass
+        WidgetTool::TextResponseConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.ces.v1.WidgetTool.TextResponseConfig").msgclass
+        WidgetTool::TextResponseConfig::Type = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.ces.v1.WidgetTool.TextResponseConfig.Type").enummodule
         WidgetTool::DataMapping = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.ces.v1.WidgetTool.DataMapping").msgclass
         WidgetTool::DataMapping::Mode = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.ces.v1.WidgetTool.DataMapping.Mode").enummodule
         WidgetTool::WidgetType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.ces.v1.WidgetTool.WidgetType").enummodule

data/proto_docs/google/cloud/ces/v1/agent.rb

@@ -131,6 +131,10 @@ module Google
         #   @return [::Array<::Google::Cloud::Ces::V1::TransferRule>]
         #     Optional. Agent transfer rules.
         #     If multiple rules match, the first one in the list will be used.
+        # @!attribute [r] validation_errors
+        #   @return [::Array<::String>]
+        #     Output only. Misconfigurations or errors in the agent that may affect agent
+        #     quality.
         class Agent
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -181,6 +185,11 @@ module Google
           #     [`allow_playback_interruption`](https://docs.cloud.google.com/dialogflow/cx/docs/reference/rpc/google.cloud.dialogflow.cx.v3#text)
           #     set to true will be interruptable, all other messages follow the
           #     app-level barge-in settings.
+          # @!attribute [rw] language_code_variable
+          #   @return [::String]
+          #     Optional. The name of the variable that contains the language code to be
+          #     used for the Dialogflow session. If unspecified, the default language
+          #     code of the Dialogflow agent will be used.
           class RemoteDialogflowAgent
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/ces/v1/agent_card.rb

@@ -0,0 +1,122 @@
+# frozen_string_literal: true
+
+# Copyright 2026 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Ces
+      module V1
+        # AgentCard conveys key information about a remote agent.
+        # It is a trimmed version of the AgentCard defined in the A2A protocol
+        # https://a2a-protocol.org/dev/specification/#441-agentcard
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. A human-readable name for the agent.
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     Required. A description of the agent's domain of action/solution space.
+        # @!attribute [rw] supported_interfaces
+        #   @return [::Array<::Google::Cloud::Ces::V1::AgentInterface>]
+        #     Required. Ordered list of supported interfaces. The first entry is
+        #     preferred.
+        # @!attribute [rw] version
+        #   @return [::String]
+        #     Required. The version of the agent.
+        # @!attribute [rw] skills
+        #   @return [::Array<::Google::Cloud::Ces::V1::AgentSkill>]
+        #     Required. Skills represent a unit of ability an agent can perform. This may
+        #     somewhat abstract but represents a more focused set of actions that the
+        #     agent is highly likely to succeed at.
+        class AgentCard
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Declares a combination of a target URL, transport and protocol version for
+        # interacting with the agent. This allows agents to expose the same
+        # functionality over multiple protocol binding mechanisms.
+        # @!attribute [rw] url
+        #   @return [::String]
+        #     Required. The URL where this interface is available. Must be a valid
+        #     absolute HTTPS URL in production. Example:
+        #     "https://api.example.com/a2a/v1", "https://grpc.example.com/a2a"
+        # @!attribute [rw] protocol_binding
+        #   @return [::String]
+        #     Required. The protocol binding supported at this URL. This is an open form
+        #     string, to be easily extended for other protocol bindings. The core ones
+        #     officially supported are `JSONRPC`, `GRPC` and `HTTP+JSON`.
+        # @!attribute [rw] tenant
+        #   @return [::String]
+        #     Tenant ID to be used in the request when calling the agent.
+        # @!attribute [rw] protocol_version
+        #   @return [::String]
+        #     Required. The version of the A2A protocol this interface exposes.
+        #     Use the latest supported minor version per major version.
+        #     Examples: "0.3", "1.0"
+        class AgentInterface
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Represents a distinct capability or function that an agent can perform.
+        # @!attribute [rw] id
+        #   @return [::String]
+        #     Required. A unique identifier for the agent's skill.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. A human-readable name for the skill.
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     Required. A detailed description of the skill.
+        # @!attribute [rw] tags
+        #   @return [::Array<::String>]
+        #     Required. A set of keywords describing the skill's capabilities.
+        # @!attribute [rw] examples
+        #   @return [::Array<::String>]
+        #     Example prompts or scenarios that this skill can handle.
+        # @!attribute [rw] input_modes
+        #   @return [::Array<::String>]
+        #     The set of supported input media types for this skill, overriding the
+        #     agent's defaults.
+        # @!attribute [rw] output_modes
+        #   @return [::Array<::String>]
+        #     The set of supported output media types for this skill, overriding the
+        #     agent's defaults.
+        class AgentSkill
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Represents a tool that allows the agent to call another remote agent.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the tool.
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     Required. The description of the tool.
+        # @!attribute [rw] agent_card
+        #   @return [::Google::Cloud::Ces::V1::AgentCard]
+        #     Required. The agent card of the remote agent that this tool invokes.
+        class RemoteAgentTool
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/ces/v1/app.rb

@@ -112,10 +112,16 @@ module Google
         # @!attribute [rw] client_certificate_settings
         #   @return [::Google::Cloud::Ces::V1::ClientCertificateSettings]
         #     Optional. The default client certificate settings for the app.
+        # @!attribute [rw] vpc_sc_settings
+        #   @return [::Google::Cloud::Ces::V1::VpcScSettings]
+        #     Optional. VPC-SC settings for the app.
         # @!attribute [rw] locked
         #   @return [::Boolean]
         #     Optional. Indicates whether the app is locked for changes. If the app is
         #     locked, modifications to the app resources will be rejected.
+        # @!attribute [r] validation_errors
+        #   @return [::Array<::String>]
+        #     Output only. Misconfigurations or warnings in the app.
         class App
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -321,12 +327,12 @@ module Google
         # @!attribute [rw] disable_barge_in
         #   @deprecated This field is deprecated and may be removed in the next major version update.
         #   @return [::Boolean]
-        #     Optional. Disables user barge-in while the agent is speaking. If true, user
-        #     input during agent response playback will be ignored.
-        #
-        #     Deprecated: `disable_barge_in` is deprecated in favor of
+        #     Optional. Deprecated: `disable_barge_in` is deprecated in favor of
         #     {::Google::Cloud::Ces::V1::ChannelProfile#disable_barge_in_control `disable_barge_in_control`}
         #     in ChannelProfile.
+        #
+        #     Disables user barge-in while the agent is speaking. If true, user input
+        #     during agent response playback will be ignored.
         # @!attribute [rw] barge_in_awareness
         #   @return [::Boolean]
         #     Optional. If enabled, the agent will adapt its next response based on the
@@ -347,12 +353,30 @@ module Google
         #     For the list of available voices, please refer to [Supported voices and
         #     languages](https://cloud.google.com/text-to-speech/docs/voices) from Cloud
         #     Text-to-Speech.
+        # @!attribute [rw] voice_sample_gcs_uri
+        #   @return [::String]
+        #     Optional. The Cloud Storage URI to the audio sample for voice cloning. The
+        #     audio sample should be a mono-channel, 24kHz WAV file.
+        #
+        #     Note: Please make sure the CES service agent
+        #     `service-<PROJECT-NUMBER>@gcp-sa-ces.iam.gserviceaccount.com` has
+        #     `storage.objects.get` permission to the Cloud Storage object.
         # @!attribute [rw] speaking_rate
         #   @return [::Float]
         #     Optional. The speaking rate/speed in the range [0.25, 2.0]. 1.0 is the
         #     normal native speed supported by the specific voice. 2.0 is twice as fast,
         #     and 0.5 is half as fast. Values outside of the range [0.25, 2.0] will
         #     return an error.
+        # @!attribute [rw] model
+        #   @return [::String]
+        #     Optional. The model used to synthesize audio.
+        #     Currently supported values:
+        #     - "gemini-3.1-flash-tts-preview"
+        #     If empty, Chirp3-HD is used.
+        # @!attribute [rw] instruction
+        #   @return [::String]
+        #     Optional. The instruction used to synthesize speech when using a generative
+        #     model.
         class SynthesizeSpeechConfig
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -376,11 +400,25 @@ module Google
         #     Optional. Configuration for how sensitive data should be redacted.
         # @!attribute [rw] audio_recording_config
         #   @return [::Google::Cloud::Ces::V1::AudioRecordingConfig]
-        #     Optional. Configuration for how audio interactions should be recorded.
+        #     Optional. Configuration for how audio interactions should be recorded. The
+        #     audio is subject to redaction as configured in
+        #     {::Google::Cloud::Ces::V1::LoggingSettings#redaction_config RedactionConfig}.
+        # @!attribute [rw] unredacted_audio_recording_config
+        #   @return [::Google::Cloud::Ces::V1::AudioRecordingConfig]
+        #     Optional. Configures an additional recording of unredacted audio. This can
+        #     be used to maintain a raw audio copy when audio redaction is
+        #     {::Google::Cloud::Ces::V1::RedactionConfig#enable_redaction enabled}, typically
+        #     for auditing or monitoring purposes.
         # @!attribute [rw] bigquery_export_settings
         #   @return [::Google::Cloud::Ces::V1::BigQueryExportSettings]
-        #     Optional. Settings to describe the BigQuery export behaviors for the app.
-        #     The conversation data will be exported to BigQuery tables if it is enabled.
+        #     Optional. Configures the BigQuery export behaviors for the app. The
+        #     conversation data is subject to redaction as configured in
+        #     {::Google::Cloud::Ces::V1::LoggingSettings#redaction_config RedactionConfig}.
+        # @!attribute [rw] unredacted_bigquery_export_settings
+        #   @return [::Google::Cloud::Ces::V1::BigQueryExportSettings]
+        #     Optional. Configures the BigQuery export behaviors for the app.
+        #     The unredacted conversation data will be exported to BigQuery tables if it
+        #     is enabled.
         # @!attribute [rw] cloud_logging_settings
         #   @return [::Google::Cloud::Ces::V1::CloudLoggingSettings]
         #     Optional. Settings to describe the Cloud Logging behaviors for the app.
@@ -406,10 +444,56 @@ module Google
         # @!attribute [rw] error_handling_strategy
         #   @return [::Google::Cloud::Ces::V1::ErrorHandlingSettings::ErrorHandlingStrategy]
         #     Optional. The strategy to use for error handling.
+        # @!attribute [rw] fallback_response_config
+        #   @return [::Google::Cloud::Ces::V1::ErrorHandlingSettings::FallbackResponseConfig]
+        #     Optional. Configuration for handling fallback responses.
+        # @!attribute [rw] end_session_config
+        #   @return [::Google::Cloud::Ces::V1::ErrorHandlingSettings::EndSessionConfig]
+        #     Optional. Configuration for ending the session in case of system errors
+        #     (e.g. LLM errors).
         class ErrorHandlingSettings
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
 
+          # Configuration for handling fallback responses.
+          # @!attribute [rw] custom_fallback_messages
+          #   @return [::Google::Protobuf::Map{::String => ::String}]
+          #     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).
+          # @!attribute [rw] max_fallback_attempts
+          #   @return [::Integer]
+          #     Optional. The maximum number of fallback attempts to make before the
+          #     agent emitting {::Google::Cloud::Ces::V1::EndSession EndSession} Signal.
+          class FallbackResponseConfig
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # @!attribute [rw] key
+            #   @return [::String]
+            # @!attribute [rw] value
+            #   @return [::String]
+            class CustomFallbackMessagesEntry
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+          end
+
+          # Configuration for ending the session in case of system errors (e.g. LLM
+          # errors).
+          # @!attribute [rw] escalate_session
+          #   @return [::Boolean]
+          #     Optional. Whether to escalate the session in
+          #     {::Google::Cloud::Ces::V1::EndSession EndSession}. If session is escalated,
+          #     {::Google::Cloud::Ces::V1::EndSession#metadata 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.
+          class EndSessionConfig
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
           # Defines the strategy for handling errors.
           module ErrorHandlingStrategy
             # Unspecified error handling strategy.
@@ -563,10 +647,27 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # VPC-SC settings for the app.
+        # @!attribute [rw] allowed_origins
+        #   @return [::Array<::String>]
+        #     Optional. The allowed HTTP(s) origins that OpenAPI tools in the App are
+        #     able to directly call when VPC Service Controls are enabled. These strings
+        #     must match the origin exactly, including the port if specified. For
+        #     example, "https://example.com" or "https://example.com:443". This list does
+        #     not yet apply to Python tools that may make direct HTTP calls.
+        class VpcScSettings
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Settings to describe the conversation logging behaviors for the app.
         # @!attribute [rw] disable_conversation_logging
         #   @return [::Boolean]
         #     Optional. Whether to disable conversation logging for the sessions.
+        # @!attribute [rw] retention_window
+        #   @return [::Google::Protobuf::Duration]
+        #     Optional. Controls the retention window for the conversation.
+        #     If not set, the conversation will be retained for 365 days.
         class ConversationLoggingSettings
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/ces/v1/common.rb

@@ -202,6 +202,12 @@ module Google
         #   @return [::String]
         #     Optional. The noise suppression level of the channel profile.
         #     Available values are "low", "moderate", "high", "very_high".
+        # @!attribute [rw] whatsapp_config
+        #   @return [::Google::Cloud::Ces::V1::ChannelProfile::WhatsAppConfig]
+        #     Optional. Configuration specific to WhatsApp deployments.
+        # @!attribute [rw] instagram_config
+        #   @return [::Google::Cloud::Ces::V1::ChannelProfile::InstagramConfig]
+        #     Optional. Configuration specific to Instagram deployments.
         class ChannelProfile
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -303,6 +309,48 @@ module Google
             end
           end
 
+          # Configuration specific to WhatsApp deployments.
+          # @!attribute [rw] waba_id
+          #   @return [::String]
+          #     Required. The WhatsApp Business Account ID.
+          # @!attribute [rw] phone_number_id
+          #   @return [::String]
+          #     Required. The Meta phone number ID.
+          # @!attribute [rw] phone_number
+          #   @return [::String]
+          #     Optional. The phone number in E.164 format.
+          # @!attribute [r] display_name
+          #   @return [::String]
+          #     Output only. The fetched Meta business page name.
+          # @!attribute [r] thumbnail_url
+          #   @return [::String]
+          #     Output only. The fetched Meta business profile thumbnail URL.
+          # @!attribute [r] description
+          #   @return [::String]
+          #     Output only. The description of the Meta business page or profile.
+          class WhatsAppConfig
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Configuration specific to Instagram deployments.
+          # @!attribute [rw] instagram_account_id
+          #   @return [::String]
+          #     Required. The Instagram Account ID.
+          # @!attribute [r] display_name
+          #   @return [::String]
+          #     Output only. The fetched Meta business page name.
+          # @!attribute [r] thumbnail_url
+          #   @return [::String]
+          #     Output only. The fetched Meta business profile thumbnail URL.
+          # @!attribute [r] description
+          #   @return [::String]
+          #     Output only. The description of the Meta business page or profile.
+          class InstagramConfig
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
           # The type of the channel profile.
           module ChannelType
             # Unknown channel type.
@@ -323,11 +371,20 @@ module Google
             # Contact Center as a Service (CCaaS) channel.
             CONTACT_CENTER_AS_A_SERVICE = 6
 
+            # Contact Center as a Service (CCaaS Chat) channel.
+            CONTACT_CENTER_AS_A_SERVICE_CHAT = 11
+
             # Five9 channel.
             FIVE9 = 7
 
             # Third party contact center integration channel.
             CONTACT_CENTER_INTEGRATION = 8
+
+            # WhatsApp channel.
+            WHATSAPP = 9
+
+            # Instagram channel.
+            INSTAGRAM = 10
           end
         end
 

data/proto_docs/google/cloud/ces/v1/conversation.rb

@@ -120,6 +120,10 @@ module Google
 
             # The conversation is from the evaluation.
             EVAL = 3
+
+            # The conversation is from an agent tool. Agent tool runs the agent in a
+            # separate session, which is persisted for testing and debugging purposes.
+            AGENT_TOOL = 4
           end
 
           # Type of the input message.
@@ -127,22 +131,25 @@ module Google
             # Unspecified input type.
             INPUT_TYPE_UNSPECIFIED = 0
 
-            # The input message is text.
+            # Text input.
             INPUT_TYPE_TEXT = 1
 
-            # The input message is audio.
+            # Event input.
+            INPUT_TYPE_EVENT = 7
+
+            # Audio input.
             INPUT_TYPE_AUDIO = 2
 
-            # The input message is image.
+            # Image input.
             INPUT_TYPE_IMAGE = 3
 
-            # The input message is blob file.
+            # Blob input.
             INPUT_TYPE_BLOB = 4
 
-            # The input message is client function tool response.
+            # Client function tool response input.
             INPUT_TYPE_TOOL_RESPONSE = 5
 
-            # The input message are variables.
+            # Variables input.
             INPUT_TYPE_VARIABLES = 6
           end
         end

data/proto_docs/google/cloud/ces/v1/deployment.rb

@@ -21,6 +21,64 @@ module Google
   module Cloud
     module Ces
       module V1
+        # Experiment for the deployment.
+        # @!attribute [rw] version_release
+        #   @return [::Google::Cloud::Ces::V1::ExperimentConfig::VersionRelease]
+        #     Optional. Version release for the experiment.
+        class ExperimentConfig
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Version release for the experiment.
+          # @!attribute [rw] state
+          #   @return [::Google::Cloud::Ces::V1::ExperimentConfig::State]
+          #     Optional. State of the version release.
+          # @!attribute [rw] traffic_allocations
+          #   @return [::Array<::Google::Cloud::Ces::V1::ExperimentConfig::VersionRelease::TrafficAllocation>]
+          #     Optional. Traffic allocations for the version release.
+          class VersionRelease
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Traffic allocation for the version release.
+            # @!attribute [rw] id
+            #   @return [::String]
+            #     Optional. Id of the traffic allocation.
+            #     Free format string, up to 128 characters.
+            # @!attribute [rw] traffic_percentage
+            #   @return [::Integer]
+            #     Optional. Traffic percentage of the traffic allocation.
+            #     Must be between 0 and 100.
+            # @!attribute [rw] app_version
+            #   @return [::String]
+            #     Optional. App version of the traffic allocation.
+            #     Format:
+            #     `projects/{project}/locations/{location}/apps/{app}/versions/{version}`
+            class TrafficAllocation
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+          end
+
+          # State of the experiment.
+          module State
+            # Unspecified state.
+            STATE_UNSPECIFIED = 0
+
+            # Deprecated: This state is no longer used.
+            PENDING = 1
+
+            # Running state. Experiment is running and valid.
+            RUNNING = 2
+
+            # Deprecated: This state is no longer used.
+            DONE = 3
+
+            # Deprecated: This state is no longer used.
+            EXPIRED = 4
+          end
+        end
+
         # A deployment represents an immutable, queryable version of the app.
         # It is used to deploy an app version with a specific channel profile.
         # @!attribute [rw] name
@@ -52,10 +110,57 @@ module Google
         #     Output only. Etag used to ensure the object hasn't changed during a
         #     read-modify-write operation. If the etag is empty, the update will
         #     overwrite any concurrent changes.
+        # @!attribute [rw] experiment_config
+        #   @return [::Google::Cloud::Ces::V1::ExperimentConfig]
+        #     Optional. Experiment configuration for the deployment.
+        # @!attribute [rw] whatsapp_credentials
+        #   @return [::Google::Cloud::Ces::V1::WhatsAppCredentials]
+        #     Optional. Input only. Ephemeral WhatsApp credentials required when
+        #     configuring a WhatsApp channel profile.
+        # @!attribute [rw] instagram_credentials
+        #   @return [::Google::Cloud::Ces::V1::InstagramCredentials]
+        #     Optional. Input only. Ephemeral Instagram credentials required when
+        #     configuring a Instagram channel profile.
         class Deployment
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
+
+        # Ephemeral Meta credentials for WhatsApp native integration.
+        # @!attribute [rw] auth_code
+        #   @return [::String]
+        #     Required. The Meta auth code provided by the embedded signup flow.
+        # @!attribute [rw] pin
+        #   @return [::String]
+        #     Required. The 6-digit PIN created by the user for two-step verification.
+        # @!attribute [rw] phone_number
+        #   @return [::String]
+        #     Required. The phone number to register with WhatsApp.
+        # @!attribute [rw] business_account_id
+        #   @return [::String]
+        #     Required. The Business Account ID to use for the phone number.
+        # @!attribute [rw] waba_id
+        #   @return [::String]
+        #     Required. The WhatsApp Business Account ID.
+        # @!attribute [rw] conversation_profile_id
+        #   @return [::String]
+        #     Required. The Conversation Profile ID to use for the deployment.
+        class WhatsAppCredentials
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Ephemeral Meta credentials for Instagram native integration.
+        # @!attribute [rw] auth_code
+        #   @return [::String]
+        #     Required. The Meta auth code provided by the embedded signup flow.
+        # @!attribute [rw] conversation_profile_id
+        #   @return [::String]
+        #     Required. The Conversation Profile ID to use for the deployment.
+        class InstagramCredentials
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
       end
     end
   end

data/proto_docs/google/cloud/ces/v1/mcp_tool.rb

@@ -27,6 +27,10 @@ module Google
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The name of the MCP tool.
+        # @!attribute [rw] name_override
+        #   @return [::String]
+        #     Optional. The name override of the MCP tool.
+        #     This is populated if the name was overridden by a Toolset override.
         # @!attribute [rw] description
         #   @return [::String]
         #     Optional. The description of the MCP tool.
@@ -66,6 +70,10 @@ module Google
         #     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.
+        # @!attribute [r] state
+        #   @return [::Google::Cloud::Ces::V1::McpTool::State]
+        #     Output only. The dynamic availability state of the tool on the external
+        #     server.
         class McpTool
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -78,6 +86,23 @@ module Google
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
+
+          # Represents the dynamic availability state of the tool.
+          module State
+            # Default state.
+            STATE_UNSPECIFIED = 0
+
+            # The tool is available and actively offered by the server.
+            ACTIVE = 1
+
+            # The tool is configured or pinned, but currently not offered by the
+            # server.
+            INACTIVE = 2
+
+            # The tool exists on the server, but does not match the version on the
+            # server.
+            STALE = 3
+          end
         end
       end
     end