Skip to content

Commit 0e80254

Browse files
gcf-owl-bot[bot]gcf-owl-bot[bot]
authored
feat: [ces] update public libraries for CES v1 (#7845)
* feat: update public libraries for CES v1beta docs: A comment for field `fallback_action` in message `.google.cloud.ces.v1beta.LanguageSettings` is changed docs: A comment for enum value `ERROR_HANDLING_STRATEGY_UNSPECIFIED` in enum `ErrorHandlingStrategy` is changed docs: A comment for enum value `FALLBACK_RESPONSE` in enum `ErrorHandlingStrategy` is changed docs: A comment for field `project` in message `.google.cloud.ces.v1beta.BigQueryExportSettings` is changed docs: A comment for field `dataset` in message `.google.cloud.ces.v1beta.BigQueryExportSettings` is changed docs: A comment for message `RunEvaluationOperationMetadata` is changed docs: A comment for method `RunSession` in service `SessionService` is changed PiperOrigin-RevId: 886993231 Source-Link: googleapis/googleapis@83e03cd Source-Link: googleapis/googleapis-gen@c5bab79 Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWNlcy8uT3dsQm90LnlhbWwiLCJoIjoiYzViYWI3OTMwMzBhNGE0MjdhY2I5YjBiNWIwNzlhYjkzY2Q3YjlhZSJ9 * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md * feat: update public libraries for CES v1 docs: A comment for field `fallback_action` in message `.google.cloud.ces.v1.LanguageSettings` is changed docs: A comment for field `project` in message `.google.cloud.ces.v1.BigQueryExportSettings` is changed docs: A comment for field `dataset` in message `.google.cloud.ces.v1.BigQueryExportSettings` is changed docs: A comment for field `cert` in message `.google.cloud.ces.v1.TlsConfig` is changed docs: A comment for field `name` in message `.google.cloud.ces.v1.Deployment` is changed docs: A comment for field `app_version` in message `.google.cloud.ces.v1.Deployment` is changed docs: A comment for method `RunSession` in service `SessionService` is changed docs: A comment for field `entry_agent` in message `.google.cloud.ces.v1.SessionConfig` is changed docs: A comment for field `will_continue` in message `.google.cloud.ces.v1.SessionInput` is changed docs: A comment for field `interruption_signal` in message `.google.cloud.ces.v1.BidiSessionServerMessage` is changed docs: A comment for field `name` in message `.google.cloud.ces.v1.Tool` is changed docs: A comment for field `response` in message `.google.cloud.ces.v1.ExecuteToolResponse` is changed docs: A comment for field `input_schema` in message `.google.cloud.ces.v1.RetrieveToolSchemaResponse` is changed docs: A comment for field `output_schema` in message `.google.cloud.ces.v1.RetrieveToolSchemaResponse` is changed docs: A comment for field `tools` in message `.google.cloud.ces.v1.RetrieveToolsResponse` is changed PiperOrigin-RevId: 888197844 Source-Link: googleapis/googleapis@ffe6fc5 Source-Link: googleapis/googleapis-gen@d046db1 Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWNlcy8uT3dsQm90LnlhbWwiLCJoIjoiZDA0NmRiMWYyYjIzNjI2OTM5MzVmNjlmMWJjNTczNDczZTQ2MzhhYiJ9 * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md --------- Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
1 parent 147f9e7 commit 0e80254

58 files changed

Lines changed: 6815 additions & 99 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎packages/google-cloud-ces/README.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -107,6 +107,7 @@ Samples are in the [`samples/`][homepage_samples] directory. Each sample's `READ
107107
| update toolset | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-ces/samples/generated/v1/agent_service.update_toolset.js) |
108108
| bidi run session | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-ces/samples/generated/v1/session_service.bidi_run_session.js) |
109109
| run session | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-ces/samples/generated/v1/session_service.run_session.js) |
110+
| stream run session | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-ces/samples/generated/v1/session_service.stream_run_session.js) |
110111
| cloud | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-ces/samples/generated/v1/snippet_metadata_google.cloud.ces.v1.json) |
111112
| execute tool | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-ces/samples/generated/v1/tool_service.execute_tool.js) |
112113
| retrieve tool schema | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-ces/samples/generated/v1/tool_service.retrieve_tool_schema.js) |
@@ -195,6 +196,7 @@ Samples are in the [`samples/`][homepage_samples] directory. Each sample's `READ
195196
| upload evaluation audio | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-ces/samples/generated/v1beta/evaluation_service.upload_evaluation_audio.js) |
196197
| bidi run session | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-ces/samples/generated/v1beta/session_service.bidi_run_session.js) |
197198
| run session | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-ces/samples/generated/v1beta/session_service.run_session.js) |
199+
| stream run session | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-ces/samples/generated/v1beta/session_service.stream_run_session.js) |
198200
| cloud | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-ces/samples/generated/v1beta/snippet_metadata_google.cloud.ces.v1beta.json) |
199201
| execute tool | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-ces/samples/generated/v1beta/tool_service.execute_tool.js) |
200202
| retrieve tool schema | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-ces/samples/generated/v1beta/tool_service.retrieve_tool_schema.js) |

‎packages/google-cloud-ces/protos/google/cloud/ces/v1/agent_service.proto‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -628,6 +628,14 @@ message ExportAppRequest {
628628
// app. The format of this URI must be `gs://<bucket-name>/<object-name>`. The
629629
// exported app archive will be written directly to the specified GCS object.
630630
string gcs_uri = 3 [(google.api.field_behavior) = OPTIONAL];
631+
632+
// Optional. The resource name of the app version to export.
633+
// Format:
634+
// `projects/{project}/locations/{location}/apps/{app}/versions/{version}`.
635+
string app_version = 4 [
636+
(google.api.field_behavior) = OPTIONAL,
637+
(google.api.resource_reference) = { type: "ces.googleapis.com/AppVersion" }
638+
];
631639
}
632640

633641
// Response message for

‎packages/google-cloud-ces/protos/google/cloud/ces/v1/agent_tool.proto‎

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
// Copyright 2026 Google LLC
2+
//
3+
// Licensed under the Apache License, Version 2.0 (the "License");
4+
// you may not use this file except in compliance with the License.
5+
// You may obtain a copy of the License at
6+
//
7+
// http://www.apache.org/licenses/LICENSE-2.0
8+
//
9+
// Unless required by applicable law or agreed to in writing, software
10+
// distributed under the License is distributed on an "AS IS" BASIS,
11+
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12+
// See the License for the specific language governing permissions and
13+
// limitations under the License.
14+
15+
syntax = "proto3";
16+
17+
package google.cloud.ces.v1;
18+
19+
import "google/api/field_behavior.proto";
20+
import "google/api/resource.proto";
21+
22+
option go_package = "cloud.google.com/go/ces/apiv1/cespb;cespb";
23+
option java_multiple_files = true;
24+
option java_outer_classname = "AgentToolProto";
25+
option java_package = "com.google.cloud.ces.v1";
26+
27+
// Represents a tool that allows the agent to call another agent.
28+
message AgentTool {
29+
// Required. The name of the agent tool.
30+
string name = 1 [(google.api.field_behavior) = REQUIRED];
31+
32+
// Optional. Description of the tool's purpose.
33+
string description = 2 [(google.api.field_behavior) = OPTIONAL];
34+
35+
// Optional. The resource name of the root agent that is the entry point of
36+
// the tool. Format: `projects/{project}/locations/{location}/agents/{agent}`
37+
string root_agent = 3 [
38+
(google.api.field_behavior) = OPTIONAL,
39+
(google.api.resource_reference) = { type: "ces.googleapis.com/Agent" }
40+
];
41+
}

‎packages/google-cloud-ces/protos/google/cloud/ces/v1/app.proto‎

Lines changed: 35 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -122,6 +122,10 @@ message App {
122122
// Optional. Logging settings of the app.
123123
LoggingSettings logging_settings = 8 [(google.api.field_behavior) = OPTIONAL];
124124

125+
// Optional. Error handling settings of the app.
126+
ErrorHandlingSettings error_handling_settings = 34
127+
[(google.api.field_behavior) = OPTIONAL];
128+
125129
// Optional. The default LLM model settings for the app.
126130
// Individual resources (e.g. agents, guardrails) can override these
127131
// configurations as needed.
@@ -216,8 +220,11 @@ message LanguageSettings {
216220
// pre-built instructions to improve handling of multilingual input.
217221
bool enable_multilingual_support = 3 [(google.api.field_behavior) = OPTIONAL];
218222

219-
// Optional. The action to perform when an agent receives input in an
220-
// unsupported language.
223+
// Optional. Deprecated: This feature is no longer supported. Use
224+
// `enable_multilingual_support` instead to improve handling of multilingual
225+
// input.
226+
// The action to perform when an agent receives input in an unsupported
227+
// language.
221228
//
222229
// This can be a predefined action or a custom tool call.
223230
// Valid values are:
@@ -226,7 +233,8 @@ message LanguageSettings {
226233
// an [EndSession][google.cloud.ces.v1.EndSession] signal with corresponding
227234
// [metadata][google.cloud.ces.v1.EndSession.metadata] to terminate the
228235
// conversation.
229-
string fallback_action = 4 [(google.api.field_behavior) = OPTIONAL];
236+
string fallback_action = 4
237+
[deprecated = true, (google.api.field_behavior) = OPTIONAL];
230238
}
231239

232240
// Configuration for how the input and output audio should be processed and
@@ -402,6 +410,30 @@ message LoggingSettings {
402410
[(google.api.field_behavior) = OPTIONAL];
403411
}
404412

413+
// Settings to describe how errors should be handled in the app.
414+
message ErrorHandlingSettings {
415+
// Defines the strategy for handling errors.
416+
enum ErrorHandlingStrategy {
417+
// Unspecified error handling strategy.
418+
ERROR_HANDLING_STRATEGY_UNSPECIFIED = 0;
419+
420+
// No specific handling is enabled.
421+
NONE = 1;
422+
423+
// A fallback message will be returned to the user in case of
424+
// system errors (e.g. LLM errors).
425+
FALLBACK_RESPONSE = 2;
426+
427+
// An [EndSession][google.cloud.ces.v1.EndSession] signal will be emitted in
428+
// case of system errors (e.g. LLM errors).
429+
END_SESSION = 3;
430+
}
431+
432+
// Optional. The strategy to use for error handling.
433+
ErrorHandlingStrategy error_handling_strategy = 1
434+
[(google.api.field_behavior) = OPTIONAL];
435+
}
436+
405437
// Threshold settings for metrics in an Evaluation.
406438
message EvaluationMetricsThresholds {
407439
// Settings for golden evaluations.

‎packages/google-cloud-ces/protos/google/cloud/ces/v1/bigquery_export.proto‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -28,13 +28,13 @@ message BigQueryExportSettings {
2828
// Optional. Indicates whether the BigQuery export is enabled.
2929
bool enabled = 1 [(google.api.field_behavior) = OPTIONAL];
3030

31-
// Optional. The project ID of the BigQuery dataset to export the data to.
31+
// Optional. The **project ID** of the BigQuery dataset to export the data to.
3232
//
3333
// Note: If the BigQuery dataset is in a different project from the app,
3434
// you should grant `roles/bigquery.admin` role to the CES service agent
3535
// `service-<PROJECT-NUMBER>@gcp-sa-ces.iam.gserviceaccount.com`.
3636
string project = 2 [(google.api.field_behavior) = OPTIONAL];
3737

38-
// Optional. The BigQuery dataset to export the data to.
38+
// Optional. The BigQuery **dataset ID** to export the data to.
3939
string dataset = 3 [(google.api.field_behavior) = OPTIONAL];
4040
}

‎packages/google-cloud-ces/protos/google/cloud/ces/v1/common.proto‎

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -148,11 +148,14 @@ message TlsConfig {
148148
// is empty or unspecified, CES will use Google's default trust
149149
// store to verify certificates. N.B. Make sure the HTTPS server
150150
// certificates are signed with "subject alt name". For instance a
151-
// certificate can be self-signed using the following command,
151+
// certificate can be self-signed using the following command:
152+
//
153+
// ```
152154
// openssl x509 -req -days 200 -in example.com.csr \
153155
// -signkey example.com.key \
154156
// -out example.com.crt \
155157
// -extfile <(printf "\nsubjectAltName='DNS:www.example.com'")
158+
// ```
156159
bytes cert = 2 [(google.api.field_behavior) = REQUIRED];
157160
}
158161

@@ -239,6 +242,9 @@ message ChannelProfile {
239242

240243
// Widget supports only chat input.
241244
CHAT_ONLY = 3;
245+
246+
// Widget supports chat, voice, and video input.
247+
CHAT_VOICE_AND_VIDEO = 4;
242248
}
243249

244250
// Theme of the web widget.
@@ -289,6 +295,9 @@ message ChannelProfile {
289295

290296
// Five9 channel.
291297
FIVE9 = 7;
298+
299+
// Third party contact center integration channel.
300+
CONTACT_CENTER_INTEGRATION = 8;
292301
}
293302

294303
// Optional. The unique identifier of the channel profile.

‎packages/google-cloud-ces/protos/google/cloud/ces/v1/deployment.proto‎

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -38,17 +38,19 @@ message Deployment {
3838

3939
// Identifier. The resource name of the deployment.
4040
// Format:
41-
// projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}
41+
// `projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}`
4242
string name = 1 [(google.api.field_behavior) = IDENTIFIER];
4343

4444
// Required. Display name of the deployment.
4545
string display_name = 8 [(google.api.field_behavior) = REQUIRED];
4646

47-
// Required. The resource name of the app version to deploy.
47+
// Optional. The resource name of the app version to deploy.
4848
// Format:
49-
// projects/{project}/locations/{location}/apps/{app}/versions/{version}
49+
// `projects/{project}/locations/{location}/apps/{app}/versions/{version}`
50+
// Use `projects/{project}/locations/{location}/apps/{app}/versions/-` to use
51+
// the draft app.
5052
string app_version = 2 [
51-
(google.api.field_behavior) = REQUIRED,
53+
(google.api.field_behavior) = OPTIONAL,
5254
(google.api.resource_reference) = { type: "ces.googleapis.com/AppVersion" }
5355
];
5456

‎packages/google-cloud-ces/protos/google/cloud/ces/v1/example.proto‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -102,6 +102,9 @@ message Chunk {
102102
// Optional. Transcript associated with the audio.
103103
string transcript = 9 [(google.api.field_behavior) = OPTIONAL];
104104

105+
// Optional. Blob data.
106+
Blob blob = 7 [(google.api.field_behavior) = OPTIONAL];
107+
105108
// Optional. Custom payload data.
106109
google.protobuf.Struct payload = 11
107110
[(google.api.field_behavior) = OPTIONAL];

‎packages/google-cloud-ces/protos/google/cloud/ces/v1/mcp_tool.proto‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -66,4 +66,12 @@ message McpTool {
6666
// service names within a perimeter.
6767
ServiceDirectoryConfig service_directory_config = 8
6868
[(google.api.field_behavior) = OPTIONAL];
69+
70+
// Optional. The custom headers to send in the request to the MCP server. The
71+
// values must be in the format `$context.variables.<name_of_variable>` and
72+
// can be set in the session variables. See
73+
// https://docs.cloud.google.com/customer-engagement-ai/conversational-agents/ps/tool/open-api#openapi-injection
74+
// for more details.
75+
map<string, string> custom_headers = 9
76+
[(google.api.field_behavior) = OPTIONAL];
6977
}

‎packages/google-cloud-ces/protos/google/cloud/ces/v1/mcp_toolset.proto‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -51,4 +51,12 @@ message McpToolset {
5151
// Optional. The TLS configuration. Includes the custom server certificates
5252
// that the client should trust.
5353
TlsConfig tls_config = 4 [(google.api.field_behavior) = OPTIONAL];
54+
55+
// Optional. The custom headers to send in the request to the MCP server. The
56+
// values must be in the format `$context.variables.<name_of_variable>` and
57+
// can be set in the session variables. See
58+
// https://docs.cloud.google.com/customer-engagement-ai/conversational-agents/ps/tool/open-api#openapi-injection
59+
// for more details.
60+
map<string, string> custom_headers = 5
61+
[(google.api.field_behavior) = OPTIONAL];
5462
}

0 commit comments

Comments
 (0)