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.
- checksums.yaml +4 -4
- data/lib/google/cloud/ces/v1/agent_card_pb.rb +26 -0
- data/lib/google/cloud/ces/v1/agent_pb.rb +1 -1
- data/lib/google/cloud/ces/v1/app_pb.rb +4 -1
- data/lib/google/cloud/ces/v1/common_pb.rb +3 -1
- data/lib/google/cloud/ces/v1/conversation_pb.rb +1 -1
- data/lib/google/cloud/ces/v1/deployment_pb.rb +7 -1
- data/lib/google/cloud/ces/v1/mcp_tool_pb.rb +2 -1
- data/lib/google/cloud/ces/v1/mcp_toolset_pb.rb +4 -1
- data/lib/google/cloud/ces/v1/mocks_pb.rb +26 -0
- data/lib/google/cloud/ces/v1/python_function_pb.rb +2 -1
- data/lib/google/cloud/ces/v1/session_service_pb.rb +5 -1
- data/lib/google/cloud/ces/v1/tool_pb.rb +3 -1
- data/lib/google/cloud/ces/v1/tool_service/client.rb +10 -2
- data/lib/google/cloud/ces/v1/tool_service/rest/client.rb +10 -2
- data/lib/google/cloud/ces/v1/tool_service_pb.rb +3 -1
- data/lib/google/cloud/ces/v1/toolset_pb.rb +2 -1
- data/lib/google/cloud/ces/v1/version.rb +1 -1
- data/lib/google/cloud/ces/v1/widget_tool_pb.rb +3 -1
- data/proto_docs/google/cloud/ces/v1/agent.rb +9 -0
- data/proto_docs/google/cloud/ces/v1/agent_card.rb +122 -0
- data/proto_docs/google/cloud/ces/v1/app.rb +108 -7
- data/proto_docs/google/cloud/ces/v1/common.rb +57 -0
- data/proto_docs/google/cloud/ces/v1/conversation.rb +13 -6
- data/proto_docs/google/cloud/ces/v1/deployment.rb +105 -0
- data/proto_docs/google/cloud/ces/v1/mcp_tool.rb +25 -0
- data/proto_docs/google/cloud/ces/v1/mcp_toolset.rb +47 -0
- data/proto_docs/google/cloud/ces/v1/mocks.rb +60 -0
- data/proto_docs/google/cloud/ces/v1/python_function.rb +3 -0
- data/proto_docs/google/cloud/ces/v1/session_service.rb +32 -0
- data/proto_docs/google/cloud/ces/v1/tool.rb +21 -11
- data/proto_docs/google/cloud/ces/v1/tool_service.rb +17 -0
- data/proto_docs/google/cloud/ces/v1/toolset.rb +5 -0
- data/proto_docs/google/cloud/ces/v1/widget_tool.rb +36 -0
- 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.
|
|
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
|