google-cloud-ces-v1beta 0.1.0 → 0.2.0

data/proto_docs/google/cloud/ces/v1beta/evaluation_metrics_config.rb

@@ -0,0 +1,151 @@
+# 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 V1beta
+        # Configures the metrics for an evaluation.
+        # @!attribute [rw] golden_metrics_config
+        #   @return [::Google::Cloud::Ces::V1beta::EvaluationMetricsConfig::GoldenMetricsConfig]
+        #     Optional. Configuration for the golden metrics for the evaluation.
+        # @!attribute [rw] scenario_metrics_config
+        #   @return [::Google::Cloud::Ces::V1beta::EvaluationMetricsConfig::ScenarioMetricsConfig]
+        #     Optional. Configuration for the scenario metrics for the evaluation.
+        class EvaluationMetricsConfig
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Configuration for similarity metrics for the evaluation.
+          # To disable the metric, set the message but do not set the
+          # `enable_semantic_similarity_metrics` field to true (or explicitly set it to
+          # false). To unset the configuration and fallback to the default behavior,
+          # omit the message entirely.
+          # @!attribute [rw] enable_semantic_similarity_metrics
+          #   @return [::Boolean]
+          #     Optional. Whether to calculate semantic similarity metrics for the
+          #     evaluation.
+          class SemanticSimilarityMetricsConfig
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Configuration for correctness metrics for the evaluation.
+          # To disable the metric, set the message but do not set the
+          # `enable_tool_correctness_metrics` field to true (or explicitly set it to
+          # false). To unset the configuration and fallback to the default behavior,
+          # omit the message entirely.
+          # @!attribute [rw] enable_tool_correctness_metrics
+          #   @return [::Boolean]
+          #     Optional. Whether to calculate tool correctness metrics for the
+          #     evaluation.
+          class ToolCorrectnessMetricsConfig
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Configuration for the hallucination metrics for the evaluation.
+          # To disable the metric, set the message but do not set the
+          # `enable_hallucination_metrics` field to true (or explicitly set it to
+          # false). To unset the configuration and fallback to the default behavior,
+          # omit the message entirely.
+          # @!attribute [rw] enable_hallucination_metrics
+          #   @return [::Boolean]
+          #     Optional. Whether to calculate hallucination metrics for the evaluation.
+          class HallucinationMetricsConfig
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Configuration for the user goal met metrics for the evaluation.
+          # To disable the metric, set the message but do not set the
+          # `enable_user_goal_met_metrics` field to true (or explicitly set it to
+          # false). To unset the configuration and fallback to the default behavior,
+          # omit the message entirely.
+          # @!attribute [rw] enable_user_goal_met_metrics
+          #   @return [::Boolean]
+          #     Optional. Whether to calculate the user goal met metrics for the
+          #     evaluation.
+          class UserGoalMetMetricsConfig
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Configuration for the expectation level metrics for the evaluation.
+          # To disable the metric, set the message but do not set the
+          # `enable_expectations_met_metrics` field to true (or explicitly set it to
+          # false). To unset the configuration and fallback to the default behavior,
+          # omit the message entirely.
+          # @!attribute [rw] enable_expectations_met_metrics
+          #   @return [::Boolean]
+          #     Optional. Whether to calculate the expectation level metrics for the
+          #     evaluation.
+          class ExpectationsMetMetricsConfig
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Configuration for the golden metrics for the evaluation.
+          # @!attribute [rw] semantic_similarity_metrics_config
+          #   @return [::Google::Cloud::Ces::V1beta::EvaluationMetricsConfig::SemanticSimilarityMetricsConfig]
+          #     Optional. Global configuration for semantic similarity metrics.
+          # @!attribute [rw] tool_correctness_metrics_config
+          #   @return [::Google::Cloud::Ces::V1beta::EvaluationMetricsConfig::ToolCorrectnessMetricsConfig]
+          #     Optional. Configuration for turn level tool correctness metrics.
+          # @!attribute [rw] step_tool_correctness_metrics_config
+          #   @return [::Google::Cloud::Ces::V1beta::EvaluationMetricsConfig::ToolCorrectnessMetricsConfig]
+          #     Optional. Configuration for step level tool correctness metrics.
+          class GoldenMetricsConfig
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Configuration for the scenario metrics for the evaluation.
+          # @!attribute [rw] user_goal_met_metrics_config
+          #   @return [::Google::Cloud::Ces::V1beta::EvaluationMetricsConfig::UserGoalMetMetricsConfig]
+          #     Optional. Configuration for user goal met metrics.
+          # @!attribute [rw] expectations_met_metrics_config
+          #   @return [::Google::Cloud::Ces::V1beta::EvaluationMetricsConfig::ExpectationsMetMetricsConfig]
+          #     Optional. Configuration for expectation level metrics.
+          class ScenarioMetricsConfig
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Supported comparison types for checking the agent's response.
+          module ComparisonType
+            # Unspecified comparison type. Behavior defaults to SEMANTIC_SIMILARITY
+            # for agent responses and tool calls.
+            COMPARISON_TYPE_UNSPECIFIED = 0
+
+            # Exact string match.
+            EQUALS = 1
+
+            # Substring match (checks if the expected string is contained in the
+            # actual response).
+            CONTAINS = 2
+
+            # Semantic similarity match (evaluates meaning similarity using an LLM).
+            SEMANTIC_SIMILARITY = 3
+          end
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/ces/v1beta/evaluation_service.rb

@@ -21,6 +21,28 @@ module Google
   module Cloud
     module Ces
       module V1beta
+        # Request message for
+        # {::Google::Cloud::Ces::V1beta::EvaluationService::Client#run_evaluation_result_metrics EvaluationService.RunEvaluationResultMetrics}.
+        # @!attribute [rw] evaluation_result_id
+        #   @return [::String]
+        #     Required. The evaluation result to run metrics for.
+        #     Format:
+        #     `projects/{project}/locations/{location}/apps/{app}/evaluations/{evaluation}/results/{evaluation_result_id}`
+        class RunEvaluationResultMetricsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for
+        # {::Google::Cloud::Ces::V1beta::EvaluationService::Client#run_evaluation_result_metrics EvaluationService.RunEvaluationResultMetrics}.
+        # @!attribute [r] status
+        #   @return [::Google::Cloud::Ces::V1beta::EvaluationResult::Outcome]
+        #     Output only. The status of the evaluation result metrics calculation.
+        class RunEvaluationResultMetricsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Response message for
         # {::Google::Cloud::Ces::V1beta::EvaluationService::Client#run_evaluation EvaluationService.RunEvaluation}.
         # @!attribute [rw] evaluation_run
@@ -964,8 +986,26 @@ module Google
           end
         end
 
+        # Request message for
+        # {::Google::Cloud::Ces::V1beta::EvaluationService::Client#export_evaluation_results EvaluationService.ExportEvaluationResults}.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The resource name of the evaluation to export evaluation results
+        #     from. Format:
+        #     `projects/{project}/locations/{location}/apps/{app}/evaluations/{evaluation}`
+        # @!attribute [rw] names
+        #   @return [::Array<::String>]
+        #     Required. The resource names of the evaluation results to export.
+        # @!attribute [rw] export_options
+        #   @return [::Google::Cloud::Ces::V1beta::ExportOptions]
+        #     Optional. The export options for the evaluation results.
+        class ExportEvaluationResultsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Response message for
-        # [EvaluationService.ExportEvaluationResults][google.cloud.ces.v1beta.EvaluationService.ExportEvaluationResults].
+        # {::Google::Cloud::Ces::V1beta::EvaluationService::Client#export_evaluation_results EvaluationService.ExportEvaluationResults}.
         # @!attribute [rw] evaluation_results_content
         #   @return [::String]
         #     The content of the exported Evaluation Results. This will be populated if
@@ -984,8 +1024,25 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Request message for
+        # {::Google::Cloud::Ces::V1beta::EvaluationService::Client#export_evaluation_runs EvaluationService.ExportEvaluationRuns}.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The resource name of the app to export evaluation runs from.
+        #     Format: `projects/{project}/locations/{location}/apps/{app}`
+        # @!attribute [rw] names
+        #   @return [::Array<::String>]
+        #     Required. The resource names of the evaluation runs to export.
+        # @!attribute [rw] export_options
+        #   @return [::Google::Cloud::Ces::V1beta::ExportOptions]
+        #     Optional. The export options for the evaluation runs.
+        class ExportEvaluationRunsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Response message for
-        # [EvaluationService.ExportEvaluationRuns][google.cloud.ces.v1beta.EvaluationService.ExportEvaluationRuns].
+        # {::Google::Cloud::Ces::V1beta::EvaluationService::Client#export_evaluation_runs EvaluationService.ExportEvaluationRuns}.
         # @!attribute [rw] evaluation_runs_content
         #   @return [::String]
         #     The content of the exported Evaluation Runs. This will be populated if
@@ -1003,6 +1060,27 @@ module Google
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
+
+        # Operation metadata for
+        # {::Google::Cloud::Ces::V1beta::EvaluationService::Client#export_evaluation_runs EvaluationService.ExportEvaluationRuns}.
+        class ExportEvaluationRunsOperationMetadata
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Operation metadata for
+        # {::Google::Cloud::Ces::V1beta::EvaluationService::Client#export_evaluation_results EvaluationService.ExportEvaluationResults}.
+        class ExportEvaluationResultsOperationMetadata
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Operation metadata for
+        # {::Google::Cloud::Ces::V1beta::EvaluationService::Client#run_evaluation_result_metrics EvaluationService.RunEvaluationResultMetrics}.
+        class RunEvaluationResultMetricsOperationMetadata
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
       end
     end
   end

data/proto_docs/google/cloud/ces/v1beta/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::V1beta::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

data/proto_docs/google/cloud/ces/v1beta/mcp_toolset.rb

@@ -52,6 +52,11 @@ 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 [rw] tool_overrides
+        #   @return [::Array<::Google::Cloud::Ces::V1beta::McpToolOverride>]
+        #     Optional. Overrides for individual tools within this toolset.
+        #     This allows overriding specific details like descriptions, names,
+        #     or pinning the tools' states so they aren't fully dynamic.
         class McpToolset
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -65,6 +70,48 @@ module Google
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
         end
+
+        # Overrides associated with a given tool in a Toolset.
+        # This enables "pinning" or "overriding" of tool definitions from the external
+        # dynamic server.
+        # @!attribute [rw] tool
+        #   @return [::String]
+        #     Required. The original name of the tool as it is emitted by the MCP server.
+        # @!attribute [rw] name_override
+        #   @return [::String]
+        #     Optional. If present, this tool uses this name in the Agent instead of the
+        #     original name. This is primarily used as an alias if the MCP server offers
+        #     poorly named tools.
+        # @!attribute [rw] description_override
+        #   @return [::String]
+        #     Optional. If present, this tool uses this description instead of the
+        #     original description from the server.
+        # @!attribute [r] snapshot
+        #   @return [::Google::Cloud::Ces::V1beta::McpToolDefinition]
+        #     Output only. If present, this tool is "Pinned" and uses the snapshot values
+        #     as fallbacks if the server becomes temporarily unavailable or if no
+        #     Override is present.
+        class McpToolOverride
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Container for a tool's core definition elements that are snapshot.
+        # Schemas in the snapshot are used as-is and cannot be overridden.
+        # @!attribute [r] description
+        #   @return [::String]
+        #     Output only. The description of the MCP tool. This can be overridden
+        #     by `description_override` in `McpToolOverride`.
+        # @!attribute [r] input_schema
+        #   @return [::Google::Cloud::Ces::V1beta::Schema]
+        #     Output only. The schema of the input arguments of the MCP tool.
+        # @!attribute [r] output_schema
+        #   @return [::Google::Cloud::Ces::V1beta::Schema]
+        #     Output only. The schema of the output arguments of the MCP tool.
+        class McpToolDefinition
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
       end
     end
   end

data/proto_docs/google/cloud/ces/v1beta/python_function.rb

@@ -34,6 +34,9 @@ module Google
         #   @return [::String]
         #     Output only. The description of the Python function, parsed from the python
         #     code's docstring.
+        # @!attribute [rw] service_directory_config
+        #   @return [::Google::Cloud::Ces::V1beta::ServiceDirectoryConfig]
+        #     Optional. Service Directory configuration for the tool.
         class PythonFunction
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/ces/v1beta/session_service.rb

@@ -207,6 +207,9 @@ module Google
           # @!attribute [rw] text
           #   @return [::String]
           #     Text used for citation.
+          # @!attribute [rw] requires_attribution
+          #   @return [::Boolean]
+          #     Whether this citation requires attribution to be shown to the end users.
           class CitedChunk
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/ces/v1beta/tool.rb

@@ -27,58 +27,63 @@ module Google
         #   @return [::Google::Cloud::Ces::V1beta::ClientFunction]
         #     Optional. The client function.
         #
-        #     Note: The following fields are mutually exclusive: `client_function`, `open_api_tool`, `google_search_tool`, `connector_tool`, `data_store_tool`, `python_function`, `mcp_tool`, `file_search_tool`, `system_tool`, `agent_tool`, `widget_tool`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `client_function`, `open_api_tool`, `google_search_tool`, `connector_tool`, `data_store_tool`, `python_function`, `mcp_tool`, `file_search_tool`, `system_tool`, `agent_tool`, `widget_tool`, `remote_agent_tool`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] open_api_tool
         #   @return [::Google::Cloud::Ces::V1beta::OpenApiTool]
         #     Optional. The open API tool.
         #
-        #     Note: The following fields are mutually exclusive: `open_api_tool`, `client_function`, `google_search_tool`, `connector_tool`, `data_store_tool`, `python_function`, `mcp_tool`, `file_search_tool`, `system_tool`, `agent_tool`, `widget_tool`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `open_api_tool`, `client_function`, `google_search_tool`, `connector_tool`, `data_store_tool`, `python_function`, `mcp_tool`, `file_search_tool`, `system_tool`, `agent_tool`, `widget_tool`, `remote_agent_tool`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] google_search_tool
         #   @return [::Google::Cloud::Ces::V1beta::GoogleSearchTool]
         #     Optional. The google search tool.
         #
-        #     Note: The following fields are mutually exclusive: `google_search_tool`, `client_function`, `open_api_tool`, `connector_tool`, `data_store_tool`, `python_function`, `mcp_tool`, `file_search_tool`, `system_tool`, `agent_tool`, `widget_tool`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `google_search_tool`, `client_function`, `open_api_tool`, `connector_tool`, `data_store_tool`, `python_function`, `mcp_tool`, `file_search_tool`, `system_tool`, `agent_tool`, `widget_tool`, `remote_agent_tool`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] connector_tool
         #   @return [::Google::Cloud::Ces::V1beta::ConnectorTool]
         #     Optional. The Integration Connector tool.
         #
-        #     Note: The following fields are mutually exclusive: `connector_tool`, `client_function`, `open_api_tool`, `google_search_tool`, `data_store_tool`, `python_function`, `mcp_tool`, `file_search_tool`, `system_tool`, `agent_tool`, `widget_tool`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `connector_tool`, `client_function`, `open_api_tool`, `google_search_tool`, `data_store_tool`, `python_function`, `mcp_tool`, `file_search_tool`, `system_tool`, `agent_tool`, `widget_tool`, `remote_agent_tool`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] data_store_tool
         #   @return [::Google::Cloud::Ces::V1beta::DataStoreTool]
         #     Optional. The data store tool.
         #
-        #     Note: The following fields are mutually exclusive: `data_store_tool`, `client_function`, `open_api_tool`, `google_search_tool`, `connector_tool`, `python_function`, `mcp_tool`, `file_search_tool`, `system_tool`, `agent_tool`, `widget_tool`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `data_store_tool`, `client_function`, `open_api_tool`, `google_search_tool`, `connector_tool`, `python_function`, `mcp_tool`, `file_search_tool`, `system_tool`, `agent_tool`, `widget_tool`, `remote_agent_tool`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] python_function
         #   @return [::Google::Cloud::Ces::V1beta::PythonFunction]
         #     Optional. The python function tool.
         #
-        #     Note: The following fields are mutually exclusive: `python_function`, `client_function`, `open_api_tool`, `google_search_tool`, `connector_tool`, `data_store_tool`, `mcp_tool`, `file_search_tool`, `system_tool`, `agent_tool`, `widget_tool`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `python_function`, `client_function`, `open_api_tool`, `google_search_tool`, `connector_tool`, `data_store_tool`, `mcp_tool`, `file_search_tool`, `system_tool`, `agent_tool`, `widget_tool`, `remote_agent_tool`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] mcp_tool
         #   @return [::Google::Cloud::Ces::V1beta::McpTool]
         #     Optional. The MCP tool. An MCP tool cannot be created or updated directly
         #     and is managed by the MCP toolset.
         #
-        #     Note: The following fields are mutually exclusive: `mcp_tool`, `client_function`, `open_api_tool`, `google_search_tool`, `connector_tool`, `data_store_tool`, `python_function`, `file_search_tool`, `system_tool`, `agent_tool`, `widget_tool`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `mcp_tool`, `client_function`, `open_api_tool`, `google_search_tool`, `connector_tool`, `data_store_tool`, `python_function`, `file_search_tool`, `system_tool`, `agent_tool`, `widget_tool`, `remote_agent_tool`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] file_search_tool
         #   @return [::Google::Cloud::Ces::V1beta::FileSearchTool]
         #     Optional. The file search tool.
         #
-        #     Note: The following fields are mutually exclusive: `file_search_tool`, `client_function`, `open_api_tool`, `google_search_tool`, `connector_tool`, `data_store_tool`, `python_function`, `mcp_tool`, `system_tool`, `agent_tool`, `widget_tool`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `file_search_tool`, `client_function`, `open_api_tool`, `google_search_tool`, `connector_tool`, `data_store_tool`, `python_function`, `mcp_tool`, `system_tool`, `agent_tool`, `widget_tool`, `remote_agent_tool`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] system_tool
         #   @return [::Google::Cloud::Ces::V1beta::SystemTool]
         #     Optional. The system tool.
         #
-        #     Note: The following fields are mutually exclusive: `system_tool`, `client_function`, `open_api_tool`, `google_search_tool`, `connector_tool`, `data_store_tool`, `python_function`, `mcp_tool`, `file_search_tool`, `agent_tool`, `widget_tool`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `system_tool`, `client_function`, `open_api_tool`, `google_search_tool`, `connector_tool`, `data_store_tool`, `python_function`, `mcp_tool`, `file_search_tool`, `agent_tool`, `widget_tool`, `remote_agent_tool`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] agent_tool
         #   @return [::Google::Cloud::Ces::V1beta::AgentTool]
         #     Optional. The agent tool.
         #
-        #     Note: The following fields are mutually exclusive: `agent_tool`, `client_function`, `open_api_tool`, `google_search_tool`, `connector_tool`, `data_store_tool`, `python_function`, `mcp_tool`, `file_search_tool`, `system_tool`, `widget_tool`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `agent_tool`, `client_function`, `open_api_tool`, `google_search_tool`, `connector_tool`, `data_store_tool`, `python_function`, `mcp_tool`, `file_search_tool`, `system_tool`, `widget_tool`, `remote_agent_tool`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] widget_tool
         #   @return [::Google::Cloud::Ces::V1beta::WidgetTool]
         #     Optional. The widget tool.
         #
-        #     Note: The following fields are mutually exclusive: `widget_tool`, `client_function`, `open_api_tool`, `google_search_tool`, `connector_tool`, `data_store_tool`, `python_function`, `mcp_tool`, `file_search_tool`, `system_tool`, `agent_tool`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `widget_tool`, `client_function`, `open_api_tool`, `google_search_tool`, `connector_tool`, `data_store_tool`, `python_function`, `mcp_tool`, `file_search_tool`, `system_tool`, `agent_tool`, `remote_agent_tool`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] remote_agent_tool
+        #   @return [::Google::Cloud::Ces::V1beta::RemoteAgentTool]
+        #     Optional. The remote agent tool.
+        #
+        #     Note: The following fields are mutually exclusive: `remote_agent_tool`, `client_function`, `open_api_tool`, `google_search_tool`, `connector_tool`, `data_store_tool`, `python_function`, `mcp_tool`, `file_search_tool`, `system_tool`, `agent_tool`, `widget_tool`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] name
         #   @return [::String]
         #     Identifier. The resource name of the tool. Format:
@@ -98,6 +103,11 @@ module Google
         # @!attribute [rw] execution_type
         #   @return [::Google::Cloud::Ces::V1beta::ExecutionType]
         #     Optional. The execution type of the tool.
+        # @!attribute [rw] timeout
+        #   @return [::Google::Protobuf::Duration]
+        #     Optional. The timeout for the tool execution. If not set, the default
+        #     timeout is 30 seconds for `SYNCHRONOUS` tools and 60 seconds for
+        #     `ASYNCHRONOUS` tools.
         # @!attribute [r] create_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Output only. Timestamp when the tool was created.

data/proto_docs/google/cloud/ces/v1beta/tool_service.rb

@@ -88,6 +88,13 @@ module Google
         # @!attribute [rw] variables
         #   @return [::Google::Protobuf::Struct]
         #     The variable values at the end of the tool execution.
+        # @!attribute [rw] citations
+        #   @return [::Google::Cloud::Ces::V1beta::Citations]
+        #     Citations that provide the source information for the tool's execution.
+        # @!attribute [rw] google_search_suggestions
+        #   @return [::Google::Cloud::Ces::V1beta::GoogleSearchSuggestions]
+        #     The suggestions returned from Google Search as a result of invoking the
+        #     Google Search Tool during the tool execution.
         class ExecuteToolResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -153,6 +160,11 @@ module Google
         #   @return [::Array<::String>]
         #     Optional. The identifiers of the tools to retrieve from the toolset.
         #     If empty, all tools in the toolset will be returned.
+        # @!attribute [rw] bypass_persistence_config
+        #   @return [::Boolean]
+        #     Optional. If true, the returned tools will contain raw descriptions and
+        #     schemas directly from the server, bypassing any stored persistence
+        #     configurations (overrides/snapshots).
         class RetrieveToolsRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/ces/v1beta/widget_tool.rb

@@ -45,10 +45,46 @@ module Google
         #   @return [::Google::Cloud::Ces::V1beta::WidgetTool::DataMapping]
         #     Optional. The mapping that defines how data from a source tool is mapped to
         #     the widget's input parameters.
+        # @!attribute [rw] text_response_config
+        #   @return [::Google::Cloud::Ces::V1beta::WidgetTool::TextResponseConfig]
+        #     Optional. Configuration for always-included text responses.
         class WidgetTool
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
 
+          # Configuration for the text response returned with the widget.
+          # @!attribute [rw] type
+          #   @return [::Google::Cloud::Ces::V1beta::WidgetTool::TextResponseConfig::Type]
+          #     Optional. The strategy for providing the text response.
+          # @!attribute [rw] static_text
+          #   @return [::String]
+          #     Optional. The static text response to return when type is STATIC.
+          # @!attribute [rw] text_response_instruction
+          #   @return [::String]
+          #     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.
+          class TextResponseConfig
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Defines how the text response is produced.
+            module Type
+              # Unspecified type.
+              TYPE_UNSPECIFIED = 0
+
+              # The LLM dynamically decides whether to generate a text response
+              # alongside the widget based on the conversation context.
+              NONE = 1
+
+              # The LLM is explicitly required to generate a text response.
+              LLM_GENERATED = 2
+
+              # A pre-defined static text response is always used.
+              STATIC = 3
+            end
+          end
+
           # Configuration for mapping data from a source tool to the widget's input
           # parameters.
           # @!attribute [rw] source_tool_name

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-ces-v1beta
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Google LLC
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: '1.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: '1.3'
 - !ruby/object:Gem::Dependency
   name: google-cloud-errors
   requirement: !ruby/object:Gem::Requirement
@@ -66,6 +66,7 @@ files:
 - README.md
 - lib/google-cloud-ces-v1beta.rb
 - lib/google/cloud/ces/v1beta.rb
+- lib/google/cloud/ces/v1beta/agent_card_pb.rb
 - lib/google/cloud/ces/v1beta/agent_pb.rb
 - lib/google/cloud/ces/v1beta/agent_service.rb
 - lib/google/cloud/ces/v1beta/agent_service/client.rb
@@ -94,6 +95,7 @@ files:
 - lib/google/cloud/ces/v1beta/data_store_pb.rb
 - lib/google/cloud/ces/v1beta/data_store_tool_pb.rb
 - lib/google/cloud/ces/v1beta/deployment_pb.rb
+- lib/google/cloud/ces/v1beta/evaluation_metrics_config_pb.rb
 - lib/google/cloud/ces/v1beta/evaluation_pb.rb
 - lib/google/cloud/ces/v1beta/evaluation_service.rb
 - lib/google/cloud/ces/v1beta/evaluation_service/client.rb
@@ -164,6 +166,7 @@ files:
 - proto_docs/google/api/launch_stage.rb
 - proto_docs/google/api/resource.rb
 - proto_docs/google/cloud/ces/v1beta/agent.rb
+- proto_docs/google/cloud/ces/v1beta/agent_card.rb
 - proto_docs/google/cloud/ces/v1beta/agent_service.rb
 - proto_docs/google/cloud/ces/v1beta/agent_tool.rb
 - proto_docs/google/cloud/ces/v1beta/agent_transfers.rb
@@ -181,6 +184,7 @@ files:
 - proto_docs/google/cloud/ces/v1beta/data_store_tool.rb
 - proto_docs/google/cloud/ces/v1beta/deployment.rb
 - proto_docs/google/cloud/ces/v1beta/evaluation.rb
+- proto_docs/google/cloud/ces/v1beta/evaluation_metrics_config.rb
 - proto_docs/google/cloud/ces/v1beta/evaluation_service.rb
 - proto_docs/google/cloud/ces/v1beta/example.rb
 - proto_docs/google/cloud/ces/v1beta/fakes.rb