Skip to content

Commit 83e03cd

Browse files
Google APIscopybara-github
Google APIs
authored and
copybara-github
committed
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
1 parent 77291a3 commit 83e03cd

12 files changed

Lines changed: 174 additions & 22 deletions

‎google/cloud/ces/v1beta/BUILD.bazel‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -390,6 +390,7 @@ load(
390390

391391
csharp_proto_library(
392392
name = "ces_csharp_proto",
393+
extra_opts = [],
393394
deps = [":ces_proto"],
394395
)
395396

‎google/cloud/ces/v1beta/agent_service.proto‎

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -650,6 +650,14 @@ message ExportAppRequest {
650650
// app. The format of this URI must be `gs://<bucket-name>/<object-name>`. The
651651
// exported app archive will be written directly to the specified GCS object.
652652
string gcs_uri = 3 [(google.api.field_behavior) = OPTIONAL];
653+
654+
// Optional. The resource name of the app version to export.
655+
// Format:
656+
// `projects/{project}/locations/{location}/apps/{app}/versions/{version}`.
657+
string app_version = 4 [
658+
(google.api.field_behavior) = OPTIONAL,
659+
(google.api.resource_reference) = { type: "ces.googleapis.com/AppVersion" }
660+
];
653661
}
654662

655663
// Response message for
@@ -1701,12 +1709,53 @@ message GenerateAppResourceResponse {
17011709

17021710
// The app resources generated by the LLM assistant.
17031711
AppResources app_resources = 7;
1712+
1713+
// The quality report generated by the LLM assistant.
1714+
QualityReport quality_report = 8;
17041715
}
17051716

17061717
// Additional information about the generated result.
17071718
GenerateResultInfo generate_result_info = 2;
17081719
}
17091720

1721+
// The report describing any identified quality issues in the app.
1722+
message QualityReport {
1723+
// The issue identified.
1724+
message Issue {
1725+
// Optional. Description of the issue found.
1726+
string description = 1 [(google.api.field_behavior) = OPTIONAL];
1727+
1728+
// Optional. How many times this issue occurred.
1729+
int32 occurrence_count = 2 [(google.api.field_behavior) = OPTIONAL];
1730+
1731+
// Optional. Proposed solution to fix the issue by modifying instructions or
1732+
// tools.
1733+
string proposed_solution = 3 [(google.api.field_behavior) = OPTIONAL];
1734+
}
1735+
1736+
// Issues identified for a single agent.
1737+
message AgentIssues {
1738+
// Optional. The name of the agent to which the issues are related.
1739+
// Format:
1740+
// `projects/{project}/locations/{location}/apps/{app}/agents/{agent}`
1741+
string agent = 1 [(google.api.field_behavior) = OPTIONAL];
1742+
1743+
// Optional. List of issues found for this agent.
1744+
repeated Issue issues = 2 [(google.api.field_behavior) = OPTIONAL];
1745+
}
1746+
1747+
// Optional. The issues grouped by agent.
1748+
repeated AgentIssues issues = 1 [(google.api.field_behavior) = OPTIONAL];
1749+
1750+
// Optional. A list of evaluation runs used to generate the quality report.
1751+
// Format:
1752+
// `projects/{project}/locations/{location}/evaluationRuns/{evaluationRun}`.
1753+
repeated string evaluation_runs = 2 [(google.api.field_behavior) = OPTIONAL];
1754+
1755+
// Optional. General issues not specific to any agent.
1756+
repeated Issue general_issues = 3 [(google.api.field_behavior) = OPTIONAL];
1757+
}
1758+
17101759
// Request message for
17111760
// [AgentService.ListChangelogs][google.cloud.ces.v1beta.AgentService.ListChangelogs].
17121761
message ListChangelogsRequest {

‎google/cloud/ces/v1beta/app.proto‎

Lines changed: 13 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -232,8 +232,11 @@ message LanguageSettings {
232232
// pre-built instructions to improve handling of multilingual input.
233233
bool enable_multilingual_support = 3 [(google.api.field_behavior) = OPTIONAL];
234234

235-
// Optional. The action to perform when an agent receives input in an
236-
// unsupported language.
235+
// Optional. Deprecated: This feature is no longer supported. Use
236+
// `enable_multilingual_support` instead to improve handling of multilingual
237+
// input.
238+
// The action to perform when an agent receives input in an unsupported
239+
// language.
237240
//
238241
// This can be a predefined action or a custom tool call.
239242
// Valid values are:
@@ -242,7 +245,8 @@ message LanguageSettings {
242245
// an [EndSession][google.cloud.ces.v1beta.EndSession] signal with
243246
// corresponding [metadata][google.cloud.ces.v1beta.EndSession.metadata] to
244247
// terminate the conversation.
245-
string fallback_action = 4 [(google.api.field_behavior) = OPTIONAL];
248+
string fallback_action = 4
249+
[deprecated = true, (google.api.field_behavior) = OPTIONAL];
246250
}
247251

248252
// Configuration for how the input and output audio should be processed and
@@ -422,15 +426,19 @@ message LoggingSettings {
422426
message ErrorHandlingSettings {
423427
// Defines the strategy for handling errors.
424428
enum ErrorHandlingStrategy {
425-
// Unspecified error handling strategy. Defaults to FALLBACK_RESPONSE.
429+
// Unspecified error handling strategy.
426430
ERROR_HANDLING_STRATEGY_UNSPECIFIED = 0;
427431

428432
// No specific handling is enabled.
429433
NONE = 1;
430434

431435
// A fallback message will be returned to the user in case of
432-
// LLM errors.
436+
// system errors (e.g. LLM errors).
433437
FALLBACK_RESPONSE = 2;
438+
439+
// An [EndSession][google.cloud.ces.v1beta.EndSession] signal will be
440+
// emitted in case of system errors (e.g. LLM errors).
441+
END_SESSION = 3;
434442
}
435443

436444
// Optional. The strategy to use for error handling.

‎google/cloud/ces/v1beta/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
}

‎google/cloud/ces/v1beta/ces_v1beta.yaml‎

Lines changed: 16 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -34,13 +34,22 @@ documentation:
3434
- selector: google.cloud.location.Locations.ListLocations
3535
description: |-
3636
Lists information about the supported locations for this service.
37-
This method can be called in two ways:
3837
39-
* **List all public locations:** Use the path `GET /v1/locations`.
40-
* **List project-visible locations:** Use the path
41-
`GET /v1/projects/{project_id}/locations`. This may include public
42-
locations as well as private or other locations specifically visible
43-
to the project.
38+
This method lists locations based on the resource scope provided in
39+
the [ListLocationsRequest.name] field:
40+
41+
* **Global locations**: If `name` is empty, the method lists the
42+
public locations available to all projects. * **Project-specific
43+
locations**: If `name` follows the format
44+
`projects/{project}`, the method lists locations visible to that
45+
specific project. This includes public, private, or other
46+
project-specific locations enabled for the project.
47+
48+
For gRPC and client library implementations, the resource name is
49+
passed as the `name` field. For direct service calls, the resource
50+
name is
51+
incorporated into the request path based on the specific service
52+
implementation and version.
4453
4554
http:
4655
rules:
@@ -70,12 +79,7 @@ authentication:
7079
canonical_scopes: |-
7180
https://www.googleapis.com/auth/ces,
7281
https://www.googleapis.com/auth/cloud-platform
73-
- selector: google.cloud.ces.v1beta.SessionService.BidiRunSession
74-
oauth:
75-
canonical_scopes: |-
76-
https://www.googleapis.com/auth/ces,
77-
https://www.googleapis.com/auth/cloud-platform
78-
- selector: google.cloud.ces.v1beta.SessionService.RunSession
82+
- selector: 'google.cloud.ces.v1beta.SessionService.*'
7983
oauth:
8084
canonical_scopes: |-
8185
https://www.googleapis.com/auth/ces,

‎google/cloud/ces/v1beta/common.proto‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -242,6 +242,9 @@ message ChannelProfile {
242242

243243
// Widget supports only chat input.
244244
CHAT_ONLY = 3;
245+
246+
// Widget supports chat, voice, and video input.
247+
CHAT_VOICE_AND_VIDEO = 4;
245248
}
246249

247250
// Theme of the web widget.

‎google/cloud/ces/v1beta/evaluation_service.proto‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -368,7 +368,7 @@ message RunEvaluationResponse {
368368
}
369369

370370
// Operation metadata for
371-
// [EvaluationService.RunEvaluation][google.cloud.ces.v1beta.EvaluationService.RunEvaluation]
371+
// [EvaluationService.RunEvaluation][google.cloud.ces.v1beta.EvaluationService.RunEvaluation].
372372
message RunEvaluationOperationMetadata {
373373
// Output only. The list of evaluations that were run.
374374
// Format:

‎google/cloud/ces/v1beta/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
}

‎google/cloud/ces/v1beta/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
}

‎google/cloud/ces/v1beta/session_service.proto‎

Lines changed: 25 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -41,15 +41,30 @@ service SessionService {
4141
"https://www.googleapis.com/auth/ces,"
4242
"https://www.googleapis.com/auth/cloud-platform";
4343

44-
// Initiates a single turn interaction with the CES agent within a
45-
// session.
44+
// Initiates a single-turn interaction with the CES agent within a session.
4645
rpc RunSession(RunSessionRequest) returns (RunSessionResponse) {
4746
option (google.api.http) = {
4847
post: "/v1beta/{config.session=projects/*/locations/*/apps/*/sessions/*}:runSession"
4948
body: "*"
5049
};
5150
}
5251

52+
// Initiates a single-turn interaction with the CES agent. Uses server-side
53+
// streaming to deliver incremental results and partial responses as they are
54+
// generated.
55+
//
56+
// By default, complete responses (e.g., messages from callbacks or full LLM
57+
// responses) are sent to the client as soon as they are available. To enable
58+
// streaming individual text chunks directly from the model, set
59+
// [enable_text_streaming][google.cloud.ces.v1beta.SessionConfig.enable_text_streaming]
60+
// to true.
61+
rpc StreamRunSession(RunSessionRequest) returns (stream RunSessionResponse) {
62+
option (google.api.http) = {
63+
post: "/v1beta/{config.session=projects/*/locations/*/apps/*/sessions/*}:streamRunSession"
64+
body: "*"
65+
};
66+
}
67+
5368
// Establishes a bidirectional streaming connection with the CES agent.
5469
// The agent processes continuous multimodal inputs (e.g., text, audio) and
5570
// generates real-time multimodal output streams.
@@ -237,6 +252,14 @@ message SessionConfig {
237252
// agent when the session control is transferred to the remote agent.
238253
RemoteDialogflowQueryParameters remote_dialogflow_query_parameters = 15
239254
[(google.api.field_behavior) = OPTIONAL];
255+
256+
// Optional. Whether to enable streaming text outputs from the model.
257+
// By default, text outputs from the model are collected before sending to the
258+
// client.
259+
// NOTE: This is only supported for text (non-voice) sessions via
260+
// [StreamRunSession][google.cloud.ces.v1beta.SessionService.StreamRunSession]
261+
// or [BidiRunSession][google.cloud.ces.v1beta.SessionService.BidiRunSession].
262+
bool enable_text_streaming = 18 [(google.api.field_behavior) = OPTIONAL];
240263
}
241264

242265
// Request for the client to execute the tools and return the execution results

0 commit comments

Comments
 (0)