google-cloud-ces-v1 0.2.0 → 0.3.0

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

@@ -27,58 +27,63 @@ module Google
         #   @return [::Google::Cloud::Ces::V1::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::V1::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::V1::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::V1::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::V1::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::V1::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::V1::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::V1::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::V1::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::V1::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::V1::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::V1::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::V1::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/v1/tool_service.rb

@@ -56,6 +56,11 @@ module Google
         #   @return [::Google::Protobuf::Struct]
         #     Optional. The input parameters and values for the tool in JSON object
         #     format.
+        # @!attribute [rw] mock_config
+        #   @return [::Google::Cloud::Ces::V1::MockConfig]
+        #     Optional. Mock configuration for the tool execution.
+        #     If this field is set, tools that call other tools will be
+        #     mocked based on the provided patterns and responses.
         class ExecuteToolRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -83,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::V1::Citations]
+        #     Citations that provide the source information for the tool's execution.
+        # @!attribute [rw] google_search_suggestions
+        #   @return [::Google::Cloud::Ces::V1::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
@@ -148,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/v1/toolset.rb

@@ -53,6 +53,11 @@ module Google
         # @!attribute [rw] description
         #   @return [::String]
         #     Optional. The description of the toolset.
+        # @!attribute [rw] timeout
+        #   @return [::Google::Protobuf::Duration]
+        #     Optional. The timeout for the toolset execution. If not set, the default
+        #     timeout is 30 seconds for `SYNCHRONOUS` toolsets and 60 seconds for
+        #     `ASYNCHRONOUS` toolsets.
         # @!attribute [r] create_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Output only. Timestamp when the toolset was created.

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

@@ -45,10 +45,46 @@ module Google
         #   @return [::Google::Cloud::Ces::V1::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::V1::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::V1::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-v1
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Google LLC
@@ -66,6 +66,7 @@ files:
 - README.md
 - lib/google-cloud-ces-v1.rb
 - lib/google/cloud/ces/v1.rb
+- lib/google/cloud/ces/v1/agent_card_pb.rb
 - lib/google/cloud/ces/v1/agent_pb.rb
 - lib/google/cloud/ces/v1/agent_service.rb
 - lib/google/cloud/ces/v1/agent_service/client.rb
@@ -101,6 +102,7 @@ files:
 - lib/google/cloud/ces/v1/guardrail_pb.rb
 - lib/google/cloud/ces/v1/mcp_tool_pb.rb
 - lib/google/cloud/ces/v1/mcp_toolset_pb.rb
+- lib/google/cloud/ces/v1/mocks_pb.rb
 - lib/google/cloud/ces/v1/omnichannel_pb.rb
 - lib/google/cloud/ces/v1/omnichannel_service_pb.rb
 - lib/google/cloud/ces/v1/open_api_tool_pb.rb
@@ -148,7 +150,9 @@ files:
 - proto_docs/google/api/field_behavior.rb
 - proto_docs/google/api/launch_stage.rb
 - proto_docs/google/api/resource.rb
+- proto_docs/google/api/routing.rb
 - proto_docs/google/cloud/ces/v1/agent.rb
+- proto_docs/google/cloud/ces/v1/agent_card.rb
 - proto_docs/google/cloud/ces/v1/agent_service.rb
 - proto_docs/google/cloud/ces/v1/agent_tool.rb
 - proto_docs/google/cloud/ces/v1/agent_transfers.rb
@@ -172,6 +176,7 @@ files:
 - proto_docs/google/cloud/ces/v1/guardrail.rb
 - proto_docs/google/cloud/ces/v1/mcp_tool.rb
 - proto_docs/google/cloud/ces/v1/mcp_toolset.rb
+- proto_docs/google/cloud/ces/v1/mocks.rb
 - proto_docs/google/cloud/ces/v1/omnichannel.rb
 - proto_docs/google/cloud/ces/v1/omnichannel_service.rb
 - proto_docs/google/cloud/ces/v1/open_api_tool.rb