google-cloud-ces-v1 0.2.1 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (35) hide show
  1. checksums.yaml +4 -4
  2. data/lib/google/cloud/ces/v1/agent_card_pb.rb +26 -0
  3. data/lib/google/cloud/ces/v1/agent_pb.rb +1 -1
  4. data/lib/google/cloud/ces/v1/app_pb.rb +4 -1
  5. data/lib/google/cloud/ces/v1/common_pb.rb +3 -1
  6. data/lib/google/cloud/ces/v1/conversation_pb.rb +1 -1
  7. data/lib/google/cloud/ces/v1/deployment_pb.rb +7 -1
  8. data/lib/google/cloud/ces/v1/mcp_tool_pb.rb +2 -1
  9. data/lib/google/cloud/ces/v1/mcp_toolset_pb.rb +4 -1
  10. data/lib/google/cloud/ces/v1/mocks_pb.rb +26 -0
  11. data/lib/google/cloud/ces/v1/python_function_pb.rb +2 -1
  12. data/lib/google/cloud/ces/v1/session_service_pb.rb +5 -1
  13. data/lib/google/cloud/ces/v1/tool_pb.rb +3 -1
  14. data/lib/google/cloud/ces/v1/tool_service/client.rb +10 -2
  15. data/lib/google/cloud/ces/v1/tool_service/rest/client.rb +10 -2
  16. data/lib/google/cloud/ces/v1/tool_service_pb.rb +3 -1
  17. data/lib/google/cloud/ces/v1/toolset_pb.rb +2 -1
  18. data/lib/google/cloud/ces/v1/version.rb +1 -1
  19. data/lib/google/cloud/ces/v1/widget_tool_pb.rb +3 -1
  20. data/proto_docs/google/cloud/ces/v1/agent.rb +9 -0
  21. data/proto_docs/google/cloud/ces/v1/agent_card.rb +122 -0
  22. data/proto_docs/google/cloud/ces/v1/app.rb +108 -7
  23. data/proto_docs/google/cloud/ces/v1/common.rb +57 -0
  24. data/proto_docs/google/cloud/ces/v1/conversation.rb +13 -6
  25. data/proto_docs/google/cloud/ces/v1/deployment.rb +105 -0
  26. data/proto_docs/google/cloud/ces/v1/mcp_tool.rb +25 -0
  27. data/proto_docs/google/cloud/ces/v1/mcp_toolset.rb +47 -0
  28. data/proto_docs/google/cloud/ces/v1/mocks.rb +60 -0
  29. data/proto_docs/google/cloud/ces/v1/python_function.rb +3 -0
  30. data/proto_docs/google/cloud/ces/v1/session_service.rb +32 -0
  31. data/proto_docs/google/cloud/ces/v1/tool.rb +21 -11
  32. data/proto_docs/google/cloud/ces/v1/tool_service.rb +17 -0
  33. data/proto_docs/google/cloud/ces/v1/toolset.rb +5 -0
  34. data/proto_docs/google/cloud/ces/v1/widget_tool.rb +36 -0
  35. metadata +5 -1
@@ -52,6 +52,11 @@ module Google
52
52
  # can be set in the session variables. See
53
53
  # https://docs.cloud.google.com/customer-engagement-ai/conversational-agents/ps/tool/open-api#openapi-injection
54
54
  # for more details.
55
+ # @!attribute [rw] tool_overrides
56
+ # @return [::Array<::Google::Cloud::Ces::V1::McpToolOverride>]
57
+ # Optional. Overrides for individual tools within this toolset.
58
+ # This allows overriding specific details like descriptions, names,
59
+ # or pinning the tools' states so they aren't fully dynamic.
55
60
  class McpToolset
56
61
  include ::Google::Protobuf::MessageExts
57
62
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -65,6 +70,48 @@ module Google
65
70
  extend ::Google::Protobuf::MessageExts::ClassMethods
66
71
  end
67
72
  end
73
+
74
+ # Overrides associated with a given tool in a Toolset.
75
+ # This enables "pinning" or "overriding" of tool definitions from the external
76
+ # dynamic server.
77
+ # @!attribute [rw] tool
78
+ # @return [::String]
79
+ # Required. The original name of the tool as it is emitted by the MCP server.
80
+ # @!attribute [rw] name_override
81
+ # @return [::String]
82
+ # Optional. If present, this tool uses this name in the Agent instead of the
83
+ # original name. This is primarily used as an alias if the MCP server offers
84
+ # poorly named tools.
85
+ # @!attribute [rw] description_override
86
+ # @return [::String]
87
+ # Optional. If present, this tool uses this description instead of the
88
+ # original description from the server.
89
+ # @!attribute [r] snapshot
90
+ # @return [::Google::Cloud::Ces::V1::McpToolDefinition]
91
+ # Output only. If present, this tool is "Pinned" and uses the snapshot values
92
+ # as fallbacks if the server becomes temporarily unavailable or if no
93
+ # Override is present.
94
+ class McpToolOverride
95
+ include ::Google::Protobuf::MessageExts
96
+ extend ::Google::Protobuf::MessageExts::ClassMethods
97
+ end
98
+
99
+ # Container for a tool's core definition elements that are snapshot.
100
+ # Schemas in the snapshot are used as-is and cannot be overridden.
101
+ # @!attribute [r] description
102
+ # @return [::String]
103
+ # Output only. The description of the MCP tool. This can be overridden
104
+ # by `description_override` in `McpToolOverride`.
105
+ # @!attribute [r] input_schema
106
+ # @return [::Google::Cloud::Ces::V1::Schema]
107
+ # Output only. The schema of the input arguments of the MCP tool.
108
+ # @!attribute [r] output_schema
109
+ # @return [::Google::Cloud::Ces::V1::Schema]
110
+ # Output only. The schema of the output arguments of the MCP tool.
111
+ class McpToolDefinition
112
+ include ::Google::Protobuf::MessageExts
113
+ extend ::Google::Protobuf::MessageExts::ClassMethods
114
+ end
68
115
  end
69
116
  end
70
117
  end
@@ -0,0 +1,60 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2026 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+
20
+ module Google
21
+ module Cloud
22
+ module Ces
23
+ module V1
24
+ # A mocked tool call.
25
+ #
26
+ # Expresses the target tool + a pattern to match against that tool's
27
+ # args / inputs. If the pattern matches, then the mock response will be
28
+ # returned.
29
+ # @!attribute [rw] tool_id
30
+ # @return [::String]
31
+ # Optional. The name of the tool to mock.
32
+ # Format: `projects/{project}/locations/{location}/apps/{app}/tools/{tool}`
33
+ #
34
+ # Note: The following fields are mutually exclusive: `tool_id`, `toolset`. If a field in that set is populated, all other fields in the set will automatically be cleared.
35
+ # @!attribute [rw] toolset
36
+ # @return [::Google::Cloud::Ces::V1::ToolsetTool]
37
+ # Optional. The toolset to mock.
38
+ #
39
+ # Note: The following fields are mutually exclusive: `toolset`, `tool_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.
40
+ # @!attribute [rw] tool
41
+ # @deprecated This field is deprecated and may be removed in the next major version update.
42
+ # @return [::String]
43
+ # Optional. Deprecated. Use tool_identifier instead.
44
+ # @!attribute [rw] expected_args_pattern
45
+ # @return [::Google::Protobuf::Struct]
46
+ # Required. A pattern to match against the args / inputs of all dispatched
47
+ # tool calls. If the tool call inputs match this pattern, then mock output
48
+ # will be returned.
49
+ # @!attribute [rw] mock_response
50
+ # @return [::Google::Protobuf::Struct]
51
+ # Optional. The mock response / output to return if the tool call args /
52
+ # inputs match the pattern.
53
+ class MockedToolCall
54
+ include ::Google::Protobuf::MessageExts
55
+ extend ::Google::Protobuf::MessageExts::ClassMethods
56
+ end
57
+ end
58
+ end
59
+ end
60
+ end
@@ -34,6 +34,9 @@ module Google
34
34
  # @return [::String]
35
35
  # Output only. The description of the Python function, parsed from the python
36
36
  # code's docstring.
37
+ # @!attribute [rw] service_directory_config
38
+ # @return [::Google::Cloud::Ces::V1::ServiceDirectoryConfig]
39
+ # Optional. Service Directory configuration for the tool.
37
40
  class PythonFunction
38
41
  include ::Google::Protobuf::MessageExts
39
42
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -21,6 +21,32 @@ module Google
21
21
  module Cloud
22
22
  module Ces
23
23
  module V1
24
+ # Mock tool calls configuration for the session.
25
+ # @!attribute [rw] mocked_tool_calls
26
+ # @return [::Array<::Google::Cloud::Ces::V1::MockedToolCall>]
27
+ # Optional. All tool calls to mock for the duration of the session.
28
+ # @!attribute [rw] unmatched_tool_call_behavior
29
+ # @return [::Google::Cloud::Ces::V1::MockConfig::UnmatchedToolCallBehavior]
30
+ # Required. Beavhior for tool calls that don't match any args patterns in
31
+ # mocked_tool_calls.
32
+ class MockConfig
33
+ include ::Google::Protobuf::MessageExts
34
+ extend ::Google::Protobuf::MessageExts::ClassMethods
35
+
36
+ # What to do when a tool call doesn't match any mocked tool calls.
37
+ module UnmatchedToolCallBehavior
38
+ # Default value. This value is unused.
39
+ UNMATCHED_TOOL_CALL_BEHAVIOR_UNSPECIFIED = 0
40
+
41
+ # Throw an error for any tool calls that don't match a mock expected input
42
+ # pattern.
43
+ FAIL = 1
44
+
45
+ # For unmatched tool calls, pass the tool call through to real tool.
46
+ PASS_THROUGH = 2
47
+ end
48
+ end
49
+
24
50
  # InputAudioConfig configures how the CES agent should interpret the incoming
25
51
  # audio data.
26
52
  # @!attribute [rw] audio_encoding
@@ -181,6 +207,9 @@ module Google
181
207
  # @!attribute [rw] text
182
208
  # @return [::String]
183
209
  # Text used for citation.
210
+ # @!attribute [rw] requires_attribution
211
+ # @return [::Boolean]
212
+ # Whether this citation requires attribution to be shown to the end users.
184
213
  class CitedChunk
185
214
  include ::Google::Protobuf::MessageExts
186
215
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -308,6 +337,9 @@ module Google
308
337
  # Optional. Diagnostic information contains execution details during the
309
338
  # processing of the input. Only populated in the last SessionOutput (with
310
339
  # `turn_completed=true`) for each turn.
340
+ # @!attribute [rw] context
341
+ # @return [::Array<::Google::Protobuf::Any>]
342
+ # Context messages for external supervision guardrails.
311
343
  class SessionOutput
312
344
  include ::Google::Protobuf::MessageExts
313
345
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -27,58 +27,63 @@ module Google
27
27
  # @return [::Google::Cloud::Ces::V1::ClientFunction]
28
28
  # Optional. The client function.
29
29
  #
30
- # 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.
30
+ # 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.
31
31
  # @!attribute [rw] open_api_tool
32
32
  # @return [::Google::Cloud::Ces::V1::OpenApiTool]
33
33
  # Optional. The open API tool.
34
34
  #
35
- # 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.
35
+ # 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.
36
36
  # @!attribute [rw] google_search_tool
37
37
  # @return [::Google::Cloud::Ces::V1::GoogleSearchTool]
38
38
  # Optional. The google search tool.
39
39
  #
40
- # 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.
40
+ # 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.
41
41
  # @!attribute [rw] connector_tool
42
42
  # @return [::Google::Cloud::Ces::V1::ConnectorTool]
43
43
  # Optional. The Integration Connector tool.
44
44
  #
45
- # 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.
45
+ # 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.
46
46
  # @!attribute [rw] data_store_tool
47
47
  # @return [::Google::Cloud::Ces::V1::DataStoreTool]
48
48
  # Optional. The data store tool.
49
49
  #
50
- # 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.
50
+ # 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.
51
51
  # @!attribute [rw] python_function
52
52
  # @return [::Google::Cloud::Ces::V1::PythonFunction]
53
53
  # Optional. The python function tool.
54
54
  #
55
- # 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.
55
+ # 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.
56
56
  # @!attribute [rw] mcp_tool
57
57
  # @return [::Google::Cloud::Ces::V1::McpTool]
58
58
  # Optional. The MCP tool. An MCP tool cannot be created or updated directly
59
59
  # and is managed by the MCP toolset.
60
60
  #
61
- # 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.
61
+ # 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.
62
62
  # @!attribute [rw] file_search_tool
63
63
  # @return [::Google::Cloud::Ces::V1::FileSearchTool]
64
64
  # Optional. The file search tool.
65
65
  #
66
- # 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.
66
+ # 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.
67
67
  # @!attribute [rw] system_tool
68
68
  # @return [::Google::Cloud::Ces::V1::SystemTool]
69
69
  # Optional. The system tool.
70
70
  #
71
- # 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.
71
+ # 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.
72
72
  # @!attribute [rw] agent_tool
73
73
  # @return [::Google::Cloud::Ces::V1::AgentTool]
74
74
  # Optional. The agent tool.
75
75
  #
76
- # 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.
76
+ # 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.
77
77
  # @!attribute [rw] widget_tool
78
78
  # @return [::Google::Cloud::Ces::V1::WidgetTool]
79
79
  # Optional. The widget tool.
80
80
  #
81
- # 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.
81
+ # 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.
82
+ # @!attribute [rw] remote_agent_tool
83
+ # @return [::Google::Cloud::Ces::V1::RemoteAgentTool]
84
+ # Optional. The remote agent tool.
85
+ #
86
+ # 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.
82
87
  # @!attribute [rw] name
83
88
  # @return [::String]
84
89
  # Identifier. The resource name of the tool. Format:
@@ -98,6 +103,11 @@ module Google
98
103
  # @!attribute [rw] execution_type
99
104
  # @return [::Google::Cloud::Ces::V1::ExecutionType]
100
105
  # Optional. The execution type of the tool.
106
+ # @!attribute [rw] timeout
107
+ # @return [::Google::Protobuf::Duration]
108
+ # Optional. The timeout for the tool execution. If not set, the default
109
+ # timeout is 30 seconds for `SYNCHRONOUS` tools and 60 seconds for
110
+ # `ASYNCHRONOUS` tools.
101
111
  # @!attribute [r] create_time
102
112
  # @return [::Google::Protobuf::Timestamp]
103
113
  # Output only. Timestamp when the tool was created.
@@ -56,6 +56,11 @@ module Google
56
56
  # @return [::Google::Protobuf::Struct]
57
57
  # Optional. The input parameters and values for the tool in JSON object
58
58
  # format.
59
+ # @!attribute [rw] mock_config
60
+ # @return [::Google::Cloud::Ces::V1::MockConfig]
61
+ # Optional. Mock configuration for the tool execution.
62
+ # If this field is set, tools that call other tools will be
63
+ # mocked based on the provided patterns and responses.
59
64
  class ExecuteToolRequest
60
65
  include ::Google::Protobuf::MessageExts
61
66
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -83,6 +88,13 @@ module Google
83
88
  # @!attribute [rw] variables
84
89
  # @return [::Google::Protobuf::Struct]
85
90
  # The variable values at the end of the tool execution.
91
+ # @!attribute [rw] citations
92
+ # @return [::Google::Cloud::Ces::V1::Citations]
93
+ # Citations that provide the source information for the tool's execution.
94
+ # @!attribute [rw] google_search_suggestions
95
+ # @return [::Google::Cloud::Ces::V1::GoogleSearchSuggestions]
96
+ # The suggestions returned from Google Search as a result of invoking the
97
+ # Google Search Tool during the tool execution.
86
98
  class ExecuteToolResponse
87
99
  include ::Google::Protobuf::MessageExts
88
100
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -148,6 +160,11 @@ module Google
148
160
  # @return [::Array<::String>]
149
161
  # Optional. The identifiers of the tools to retrieve from the toolset.
150
162
  # If empty, all tools in the toolset will be returned.
163
+ # @!attribute [rw] bypass_persistence_config
164
+ # @return [::Boolean]
165
+ # Optional. If true, the returned tools will contain raw descriptions and
166
+ # schemas directly from the server, bypassing any stored persistence
167
+ # configurations (overrides/snapshots).
151
168
  class RetrieveToolsRequest
152
169
  include ::Google::Protobuf::MessageExts
153
170
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -53,6 +53,11 @@ module Google
53
53
  # @!attribute [rw] description
54
54
  # @return [::String]
55
55
  # Optional. The description of the toolset.
56
+ # @!attribute [rw] timeout
57
+ # @return [::Google::Protobuf::Duration]
58
+ # Optional. The timeout for the toolset execution. If not set, the default
59
+ # timeout is 30 seconds for `SYNCHRONOUS` toolsets and 60 seconds for
60
+ # `ASYNCHRONOUS` toolsets.
56
61
  # @!attribute [r] create_time
57
62
  # @return [::Google::Protobuf::Timestamp]
58
63
  # Output only. Timestamp when the toolset was created.
@@ -45,10 +45,46 @@ module Google
45
45
  # @return [::Google::Cloud::Ces::V1::WidgetTool::DataMapping]
46
46
  # Optional. The mapping that defines how data from a source tool is mapped to
47
47
  # the widget's input parameters.
48
+ # @!attribute [rw] text_response_config
49
+ # @return [::Google::Cloud::Ces::V1::WidgetTool::TextResponseConfig]
50
+ # Optional. Configuration for always-included text responses.
48
51
  class WidgetTool
49
52
  include ::Google::Protobuf::MessageExts
50
53
  extend ::Google::Protobuf::MessageExts::ClassMethods
51
54
 
55
+ # Configuration for the text response returned with the widget.
56
+ # @!attribute [rw] type
57
+ # @return [::Google::Cloud::Ces::V1::WidgetTool::TextResponseConfig::Type]
58
+ # Optional. The strategy for providing the text response.
59
+ # @!attribute [rw] static_text
60
+ # @return [::String]
61
+ # Optional. The static text response to return when type is STATIC.
62
+ # @!attribute [rw] text_response_instruction
63
+ # @return [::String]
64
+ # Optional. Instruction for the LLM on how to generate the text response.
65
+ # Used as the description for the text response parameter if type is
66
+ # LLM_GENERATED.
67
+ class TextResponseConfig
68
+ include ::Google::Protobuf::MessageExts
69
+ extend ::Google::Protobuf::MessageExts::ClassMethods
70
+
71
+ # Defines how the text response is produced.
72
+ module Type
73
+ # Unspecified type.
74
+ TYPE_UNSPECIFIED = 0
75
+
76
+ # The LLM dynamically decides whether to generate a text response
77
+ # alongside the widget based on the conversation context.
78
+ NONE = 1
79
+
80
+ # The LLM is explicitly required to generate a text response.
81
+ LLM_GENERATED = 2
82
+
83
+ # A pre-defined static text response is always used.
84
+ STATIC = 3
85
+ end
86
+ end
87
+
52
88
  # Configuration for mapping data from a source tool to the widget's input
53
89
  # parameters.
54
90
  # @!attribute [rw] source_tool_name
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-ces-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.2.1
4
+ version: 0.3.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
@@ -66,6 +66,7 @@ files:
66
66
  - README.md
67
67
  - lib/google-cloud-ces-v1.rb
68
68
  - lib/google/cloud/ces/v1.rb
69
+ - lib/google/cloud/ces/v1/agent_card_pb.rb
69
70
  - lib/google/cloud/ces/v1/agent_pb.rb
70
71
  - lib/google/cloud/ces/v1/agent_service.rb
71
72
  - lib/google/cloud/ces/v1/agent_service/client.rb
@@ -101,6 +102,7 @@ files:
101
102
  - lib/google/cloud/ces/v1/guardrail_pb.rb
102
103
  - lib/google/cloud/ces/v1/mcp_tool_pb.rb
103
104
  - lib/google/cloud/ces/v1/mcp_toolset_pb.rb
105
+ - lib/google/cloud/ces/v1/mocks_pb.rb
104
106
  - lib/google/cloud/ces/v1/omnichannel_pb.rb
105
107
  - lib/google/cloud/ces/v1/omnichannel_service_pb.rb
106
108
  - lib/google/cloud/ces/v1/open_api_tool_pb.rb
@@ -150,6 +152,7 @@ files:
150
152
  - proto_docs/google/api/resource.rb
151
153
  - proto_docs/google/api/routing.rb
152
154
  - proto_docs/google/cloud/ces/v1/agent.rb
155
+ - proto_docs/google/cloud/ces/v1/agent_card.rb
153
156
  - proto_docs/google/cloud/ces/v1/agent_service.rb
154
157
  - proto_docs/google/cloud/ces/v1/agent_tool.rb
155
158
  - proto_docs/google/cloud/ces/v1/agent_transfers.rb
@@ -173,6 +176,7 @@ files:
173
176
  - proto_docs/google/cloud/ces/v1/guardrail.rb
174
177
  - proto_docs/google/cloud/ces/v1/mcp_tool.rb
175
178
  - proto_docs/google/cloud/ces/v1/mcp_toolset.rb
179
+ - proto_docs/google/cloud/ces/v1/mocks.rb
176
180
  - proto_docs/google/cloud/ces/v1/omnichannel.rb
177
181
  - proto_docs/google/cloud/ces/v1/omnichannel_service.rb
178
182
  - proto_docs/google/cloud/ces/v1/open_api_tool.rb