google-api-python-client 2.196.0__py3-none-any.whl → 2.198.0__py3-none-any.whl

googleapiclient/discovery_cache/documents/ces.v1beta.json

@@ -1718,6 +1718,35 @@
 "https://www.googleapis.com/auth/cloud-platform"
 ]
 },
+"export": {
+"description": "Exports evaluations runs.",
+"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/evaluationRuns:export",
+"httpMethod": "POST",
+"id": "ces.projects.locations.apps.evaluationRuns.export",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"parent": {
+"description": "Required. The resource name of the app to export evaluation runs from. Format: `projects/{project}/locations/{location}/apps/{app}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1beta/{+parent}/evaluationRuns:export",
+"request": {
+"$ref": "ExportEvaluationRunsRequest"
+},
+"response": {
+"$ref": "Operation"
+},
+"scopes": [
+"https://www.googleapis.com/auth/ces",
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
 "get": {
 "description": "Gets details of the specified evaluation run.",
 "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/evaluationRuns/{evaluationRunsId}",
@@ -2077,6 +2106,35 @@
 "https://www.googleapis.com/auth/cloud-platform"
 ]
 },
+"export": {
+"description": "Exports evaluations results.",
+"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/evaluations/{evaluationsId}/results:export",
+"httpMethod": "POST",
+"id": "ces.projects.locations.apps.evaluations.results.export",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"parent": {
+"description": "Required. The resource name of the evaluation to export evaluation results from. Format: `projects/{project}/locations/{location}/apps/{app}/evaluations/{evaluation}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/evaluations/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1beta/{+parent}/results:export",
+"request": {
+"$ref": "ExportEvaluationResultsRequest"
+},
+"response": {
+"$ref": "Operation"
+},
+"scopes": [
+"https://www.googleapis.com/auth/ces",
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
 "get": {
 "description": "Gets details of the specified evaluation result.",
 "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/evaluations/{evaluationsId}/results/{resultsId}",
@@ -2513,6 +2571,39 @@
 }
 }
 },
+"message": {
+"methods": {
+"send": {
+"description": "Sends a message to an agent.",
+"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/message:send",
+"httpMethod": "POST",
+"id": "ces.projects.locations.apps.message.send",
+"parameterOrder": [
+"tenant"
+],
+"parameters": {
+"tenant": {
+"description": "Optional. Tenant ID, provided as a path parameter.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1beta/{+tenant}/message:send",
+"request": {
+"$ref": "LfA2aV1SendMessageRequest"
+},
+"response": {
+"$ref": "LfA2aV1SendMessageResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/ces",
+"https://www.googleapis.com/auth/cloud-platform"
+]
+}
+}
+},
 "scheduledEvaluationRuns": {
 "methods": {
 "create": {
@@ -3484,7 +3575,7 @@
 }
 }
 },
-"revision": "20260422",
+"revision": "20260513",
 "rootUrl": "https://ces.googleapis.com/",
 "schemas": {
 "Action": {
@@ -3676,6 +3767,14 @@
 "format": "google-datetime",
 "readOnly": true,
 "type": "string"
+},
+"validationErrors": {
+"description": "Output only. Misconfigurations or errors in the agent that may affect agent quality.",
+"items": {
+"type": "string"
+},
+"readOnly": true,
+"type": "array"
 }
 },
 "type": "object"
@@ -3698,6 +3797,62 @@
 },
 "type": "object"
 },
+"AgentCard": {
+"description": "AgentCard conveys key information about a remote agent. It is a trimmed version of the AgentCard defined in the A2A protocol https://a2a-protocol.org/dev/specification/#441-agentcard",
+"id": "AgentCard",
+"properties": {
+"description": {
+"description": "Required. A description of the agent's domain of action/solution space.",
+"type": "string"
+},
+"name": {
+"description": "Required. A human-readable name for the agent.",
+"type": "string"
+},
+"skills": {
+"description": "Required. Skills represent a unit of ability an agent can perform. This may somewhat abstract but represents a more focused set of actions that the agent is highly likely to succeed at.",
+"items": {
+"$ref": "AgentSkill"
+},
+"type": "array"
+},
+"supportedInterfaces": {
+"description": "Required. Ordered list of supported interfaces. The first entry is preferred.",
+"items": {
+"$ref": "AgentInterface"
+},
+"type": "array"
+},
+"version": {
+"description": "Required. The version of the agent.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"AgentInterface": {
+"description": "Declares a combination of a target URL, transport and protocol version for interacting with the agent. This allows agents to expose the same functionality over multiple protocol binding mechanisms.",
+"id": "AgentInterface",
+"properties": {
+"protocolBinding": {
+"description": "Required. The protocol binding supported at this URL. This is an open form string, to be easily extended for other protocol bindings. The core ones officially supported are `JSONRPC`, `GRPC` and `HTTP+JSON`.",
+"type": "string"
+},
+"protocolVersion": {
+"description": "Required. The version of the A2A protocol this interface exposes. Use the latest supported minor version per major version. Examples: \"0.3\", \"1.0\"",
+"type": "string"
+},
+"tenant": {
+"description": "Tenant ID to be used in the request when calling the agent.",
+"type": "string"
+},
+"url": {
+"description": "Required. The URL where this interface is available. Must be a valid absolute HTTPS URL in production. Example: \"https://api.example.com/a2a/v1\", \"https://grpc.example.com/a2a\"",
+"type": "string"
+}
+},
+"type": "object"
+},
 "AgentLlmAgent": {
 "description": "Default agent type. The agent uses instructions and callbacks specified in the agent to perform the task using a large language model.",
 "id": "AgentLlmAgent",
@@ -3727,6 +3882,10 @@
 "description": "Optional. The mapping of the app variables names to the Dialogflow session parameters names to be sent to the Dialogflow agent as input.",
 "type": "object"
 },
+"languageCodeVariable": {
+"description": "Optional. The name of the variable that contains the language code to be used for the Dialogflow session. If unspecified, the default language code of the Dialogflow agent will be used.",
+"type": "string"
+},
 "outputVariableMapping": {
 "additionalProperties": {
 "type": "string"
@@ -3741,6 +3900,53 @@
 },
 "type": "object"
 },
+"AgentSkill": {
+"description": "Represents a distinct capability or function that an agent can perform.",
+"id": "AgentSkill",
+"properties": {
+"description": {
+"description": "Required. A detailed description of the skill.",
+"type": "string"
+},
+"examples": {
+"description": "Example prompts or scenarios that this skill can handle.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"id": {
+"description": "Required. A unique identifier for the agent's skill.",
+"type": "string"
+},
+"inputModes": {
+"description": "The set of supported input media types for this skill, overriding the agent's defaults.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"name": {
+"description": "Required. A human-readable name for the skill.",
+"type": "string"
+},
+"outputModes": {
+"description": "The set of supported output media types for this skill, overriding the agent's defaults.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"tags": {
+"description": "Required. A set of keywords describing the skill's capabilities.",
+"items": {
+"type": "string"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
 "AgentTool": {
 "description": "Represents a tool that allows the agent to call another agent.",
 "id": "AgentTool",
@@ -4237,12 +4443,24 @@
 "readOnly": true,
 "type": "string"
 },
+"validationErrors": {
+"description": "Output only. Misconfigurations or warnings in the app.",
+"items": {
+"type": "string"
+},
+"readOnly": true,
+"type": "array"
+},
 "variableDeclarations": {
 "description": "Optional. The declarations of the variables.",
 "items": {
 "$ref": "AppVariableDeclaration"
 },
 "type": "array"
+},
+"vpcScSettings": {
+"$ref": "VpcScSettings",
+"description": "Optional. VPC-SC settings for the app."
 }
 },
 "type": "object"
@@ -5784,6 +6002,14 @@
 "readOnly": true,
 "type": "array"
 },
+"evaluationMetricsConfigOverride": {
+"$ref": "EvaluationMetricsConfig",
+"description": "Optional. Overrides metrics config for this specific evaluation."
+},
+"evaluationMetricsThresholdOverride": {
+"$ref": "EvaluationMetricsThresholds",
+"description": "Optional. Overrides metrics thresholds for this specific evaluation."
+},
 "evaluationRuns": {
 "description": "Output only. The EvaluationRuns that this Evaluation is associated with.",
 "items": {
@@ -5978,6 +6204,11 @@
 "description": "Output only. The session ID for the conversation that caused the error.",
 "readOnly": true,
 "type": "string"
+},
+"userFacingErrorMessage": {
+"description": "Output only. The user facing error message.",
+"readOnly": true,
+"type": "string"
 }
 },
 "type": "object"
@@ -6065,10 +6296,22 @@
 "$ref": "Message",
 "description": "Optional. Check that the agent responded with the correct response. The role \"agent\" is implied."
 },
+"agentResponseHallucinationMetricsConfigOverride": {
+"$ref": "EvaluationMetricsConfigHallucinationMetricsConfig",
+"description": "Optional. Overrides for agent_response hallucination metrics."
+},
+"agentResponseSemanticSimilarityMetricsConfigOverride": {
+"$ref": "EvaluationMetricsConfigSemanticSimilarityMetricsConfig",
+"description": "Optional. Overrides for agent_response semantic similarity metrics."
+},
 "agentTransfer": {
 "$ref": "AgentTransfer",
 "description": "Optional. Check that the agent transferred the conversation to a different agent."
 },
+"expectationLevelMetricsThresholdsOverride": {
+"$ref": "EvaluationMetricsThresholdsGoldenEvaluationMetricsThresholdsExpectationLevelMetricsThresholds",
+"description": "Optional. Overrides metrics at the step level."
+},
 "mockToolResponse": {
 "$ref": "ToolResponse",
 "description": "Optional. The tool response to mock, with the parameters of interest specified. Any parameters not specified will be hallucinated by the LLM."
@@ -6077,6 +6320,10 @@
 "description": "Optional. A note for this requirement, useful in reporting when specific checks fail. E.g., \"Check_Payment_Tool_Called\".",
 "type": "string"
 },
+"skipEvaluation": {
+"description": "Optional. If set to true, this specific expectation will not be evaluated.",
+"type": "boolean"
+},
 "toolCall": {
 "$ref": "ToolCall",
 "description": "Optional. Check that a specific tool was called with the parameters."
@@ -6100,9 +6347,23 @@
 "description": "A golden turn defines a single turn in a golden conversation.",
 "id": "EvaluationGoldenTurn",
 "properties": {
+"hallucinationMetricBehaviorOverride": {
+"description": "Optional. Override for turn-level hallucination metric behavior.",
+"enum": [
+"HALLUCINATION_METRIC_BEHAVIOR_UNSPECIFIED",
+"DISABLED",
+"ENABLED"
+],
+"enumDescriptions": [
+"Unspecified hallucination metric behavior.",
+"Disable hallucination metric.",
+"Enable hallucination metric."
+],
+"type": "string"
+},
 "rootSpan": {
 "$ref": "Span",
-"description": "Optional. The root span of the golden turn for processing and maintaining audio information."
+"description": "Optional. The root span of the golden turn for processing and maintaining audio information. The uri for the audio must contain audio saved in 16Khz sample rate."
 },
 "steps": {
 "description": "Required. The steps required to replay a golden conversation.",
@@ -6110,6 +6371,114 @@
 "$ref": "EvaluationStep"
 },
 "type": "array"
+},
+"turnLevelMetricsThresholdsOverride": {
+"$ref": "EvaluationMetricsThresholdsGoldenEvaluationMetricsThresholdsTurnLevelMetricsThresholds",
+"description": "Optional. Overrides for turn-level metric thresholds."
+}
+},
+"type": "object"
+},
+"EvaluationMetricsConfig": {
+"description": "Configures the metrics for an evaluation.",
+"id": "EvaluationMetricsConfig",
+"properties": {
+"goldenMetricsConfig": {
+"$ref": "EvaluationMetricsConfigGoldenMetricsConfig",
+"description": "Optional. Configuration for the golden metrics for the evaluation."
+},
+"scenarioMetricsConfig": {
+"$ref": "EvaluationMetricsConfigScenarioMetricsConfig",
+"description": "Optional. Configuration for the scenario metrics for the evaluation."
+}
+},
+"type": "object"
+},
+"EvaluationMetricsConfigExpectationsMetMetricsConfig": {
+"description": "Configuration for the expectation level metrics for the evaluation. To disable the metric, set the message but do not set the `enable_expectations_met_metrics` field to true (or explicitly set it to false). To unset the configuration and fallback to the default behavior, omit the message entirely.",
+"id": "EvaluationMetricsConfigExpectationsMetMetricsConfig",
+"properties": {
+"enableExpectationsMetMetrics": {
+"description": "Optional. Whether to calculate the expectation level metrics for the evaluation.",
+"type": "boolean"
+}
+},
+"type": "object"
+},
+"EvaluationMetricsConfigGoldenMetricsConfig": {
+"description": "Configuration for the golden metrics for the evaluation.",
+"id": "EvaluationMetricsConfigGoldenMetricsConfig",
+"properties": {
+"semanticSimilarityMetricsConfig": {
+"$ref": "EvaluationMetricsConfigSemanticSimilarityMetricsConfig",
+"description": "Optional. Global configuration for semantic similarity metrics."
+},
+"stepToolCorrectnessMetricsConfig": {
+"$ref": "EvaluationMetricsConfigToolCorrectnessMetricsConfig",
+"description": "Optional. Configuration for step level tool correctness metrics."
+},
+"toolCorrectnessMetricsConfig": {
+"$ref": "EvaluationMetricsConfigToolCorrectnessMetricsConfig",
+"description": "Optional. Configuration for turn level tool correctness metrics."
+}
+},
+"type": "object"
+},
+"EvaluationMetricsConfigHallucinationMetricsConfig": {
+"description": "Configuration for the hallucination metrics for the evaluation. To disable the metric, set the message but do not set the `enable_hallucination_metrics` field to true (or explicitly set it to false). To unset the configuration and fallback to the default behavior, omit the message entirely.",
+"id": "EvaluationMetricsConfigHallucinationMetricsConfig",
+"properties": {
+"enableHallucinationMetrics": {
+"description": "Optional. Whether to calculate hallucination metrics for the evaluation.",
+"type": "boolean"
+}
+},
+"type": "object"
+},
+"EvaluationMetricsConfigScenarioMetricsConfig": {
+"description": "Configuration for the scenario metrics for the evaluation.",
+"id": "EvaluationMetricsConfigScenarioMetricsConfig",
+"properties": {
+"expectationsMetMetricsConfig": {
+"$ref": "EvaluationMetricsConfigExpectationsMetMetricsConfig",
+"description": "Optional. Configuration for expectation level metrics."
+},
+"userGoalMetMetricsConfig": {
+"$ref": "EvaluationMetricsConfigUserGoalMetMetricsConfig",
+"description": "Optional. Configuration for user goal met metrics."
+}
+},
+"type": "object"
+},
+"EvaluationMetricsConfigSemanticSimilarityMetricsConfig": {
+"description": "Configuration for similarity metrics for the evaluation. To disable the metric, set the message but do not set the `enable_semantic_similarity_metrics` field to true (or explicitly set it to false). To unset the configuration and fallback to the default behavior, omit the message entirely.",
+"id": "EvaluationMetricsConfigSemanticSimilarityMetricsConfig",
+"properties": {
+"enableSemanticSimilarityMetrics": {
+"description": "Optional. Whether to calculate semantic similarity metrics for the evaluation.",
+"type": "boolean"
+}
+},
+"type": "object"
+},
+"EvaluationMetricsConfigToolCorrectnessMetricsConfig": {
+"description": "Configuration for correctness metrics for the evaluation. To disable the metric, set the message but do not set the `enable_tool_correctness_metrics` field to true (or explicitly set it to false). To unset the configuration and fallback to the default behavior, omit the message entirely.",
+"id": "EvaluationMetricsConfigToolCorrectnessMetricsConfig",
+"properties": {
+"enableToolCorrectnessMetrics": {
+"description": "Optional. Whether to calculate tool correctness metrics for the evaluation.",
+"type": "boolean"
+}
+},
+"type": "object"
+},
+"EvaluationMetricsConfigUserGoalMetMetricsConfig": {
+"description": "Configuration for the user goal met metrics for the evaluation. To disable the metric, set the message but do not set the `enable_user_goal_met_metrics` field to true (or explicitly set it to false). To unset the configuration and fallback to the default behavior, omit the message entirely.",
+"id": "EvaluationMetricsConfigUserGoalMetMetricsConfig",
+"properties": {
+"enableUserGoalMetMetrics": {
+"description": "Optional. Whether to calculate the user goal met metrics for the evaluation.",
+"type": "boolean"
 }
 },
 "type": "object"
@@ -6507,6 +6876,15 @@
 "description": "Output only. The result of the agent transfer expectation.",
 "readOnly": true
 },
+"observedPayload": {
+"additionalProperties": {
+"description": "Properties of the object.",
+"type": "any"
+},
+"description": "Output only. An observed custom payload. There are no expectations for custom payloads. This is only used for metrics calculation. The outcome is always SKIPPED.",
+"readOnly": true,
+"type": "object"
+},
 "observedToolCall": {
 "$ref": "ToolCall",
 "description": "Output only. The result of the tool call expectation.",
@@ -7222,6 +7600,11 @@
 "description": "Identifier. The unique identifier of the evaluation run. Format: `projects/{project}/locations/{location}/apps/{app}/evaluationRuns/{evaluationRun}`",
 "type": "string"
 },
+"operation": {
+"description": "Output only. The operation that created this evaluation run. Format: `projects/{project}/locations/{location}/operations/{operation}`",
+"readOnly": true,
+"type": "string"
+},
 "optimizationConfig": {
 "$ref": "OptimizationConfig",
 "description": "Optional. Configuration for running the optimization step after the evaluation run. If not set, the optimization step will not be run."
@@ -7492,6 +7875,10 @@
 ],
 "type": "string"
 },
+"metricsConfig": {
+"$ref": "EvaluationMetricsConfig",
+"description": "Optional. Configures the default metrics for evaluations."
+},
 "scenarioConversationInitiator": {
 "description": "Optional. Who starts the conversation in a scenario evaluation.",
 "enum": [
@@ -7786,6 +8173,24 @@
 },
 "type": "object"
 },
+"ExportEvaluationResultsRequest": {
+"description": "Request message for EvaluationService.ExportEvaluationResults.",
+"id": "ExportEvaluationResultsRequest",
+"properties": {
+"exportOptions": {
+"$ref": "ExportOptions",
+"description": "Optional. The export options for the evaluation results."
+},
+"names": {
+"description": "Required. The resource names of the evaluation results to export.",
+"items": {
+"type": "string"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
 "ExportEvaluationResultsResponse": {
 "description": "Response message for EvaluationService.ExportEvaluationResults.",
 "id": "ExportEvaluationResultsResponse",
@@ -7802,11 +8207,29 @@
 },
 "type": "object"
 },
-"ExportEvaluationRunsResponse": {
-"description": "Response message for EvaluationService.ExportEvaluationRuns.",
-"id": "ExportEvaluationRunsResponse",
+"ExportEvaluationRunsRequest": {
+"description": "Request message for EvaluationService.ExportEvaluationRuns.",
+"id": "ExportEvaluationRunsRequest",
 "properties": {
-"evaluationRunsContent": {
+"exportOptions": {
+"$ref": "ExportOptions",
+"description": "Optional. The export options for the evaluation runs."
+},
+"names": {
+"description": "Required. The resource names of the evaluation runs to export.",
+"items": {
+"type": "string"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"ExportEvaluationRunsResponse": {
+"description": "Response message for EvaluationService.ExportEvaluationRuns.",
+"id": "ExportEvaluationRunsResponse",
+"properties": {
+"evaluationRunsContent": {
 "description": "The content of the exported Evaluation Runs. This will be populated if gcs_uri was not specified in the request.",
 "format": "byte",
 "type": "string"
@@ -9123,6 +9546,343 @@
 },
 "type": "object"
 },
+"LfA2aV1Artifact": {
+"description": "Artifacts represent task outputs.",
+"id": "LfA2aV1Artifact",
+"properties": {
+"artifactId": {
+"description": "Required. Unique identifier (e.g. UUID) for the artifact. It must be unique within a task.",
+"type": "string"
+},
+"description": {
+"description": "Optional. A human readable description of the artifact.",
+"type": "string"
+},
+"extensions": {
+"description": "The URIs of extensions that are present or contributed to this Artifact.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"metadata": {
+"additionalProperties": {
+"description": "Properties of the object.",
+"type": "any"
+},
+"description": "Optional. Metadata included with the artifact.",
+"type": "object"
+},
+"name": {
+"description": "A human readable name for the artifact.",
+"type": "string"
+},
+"parts": {
+"description": "Required. The content of the artifact. Must contain at least one part.",
+"items": {
+"$ref": "LfA2aV1Part"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"LfA2aV1AuthenticationInfo": {
+"description": "Defines authentication details, used for push notifications.",
+"id": "LfA2aV1AuthenticationInfo",
+"properties": {
+"credentials": {
+"description": "Push Notification credentials. Format depends on the scheme (e.g., token for Bearer).",
+"type": "string"
+},
+"scheme": {
+"description": "Required. HTTP Authentication Scheme from the [IANA registry](https://www.iana.org/assignments/http-authschemes/). Examples: `Bearer`, `Basic`, `Digest`. Scheme names are case-insensitive per [RFC 9110 Section 11.1](https://www.rfc-editor.org/rfc/rfc9110#section-11.1).",
+"type": "string"
+}
+},
+"type": "object"
+},
+"LfA2aV1Message": {
+"description": "`Message` is one unit of communication between client and server. It can be associated with a context and/or a task. For server messages, `context_id` must be provided, and `task_id` only if a task was created. For client messages, both fields are optional, with the caveat that if both are provided, they have to match (the `context_id` has to be the one that is set on the task). If only `task_id` is provided, the server will infer `context_id` from it.",
+"id": "LfA2aV1Message",
+"properties": {
+"contextId": {
+"description": "Optional. The context id of the message. If set, the message will be associated with the given context.",
+"type": "string"
+},
+"extensions": {
+"description": "The URIs of extensions that are present or contributed to this Message.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"messageId": {
+"description": "Required. The unique identifier (e.g. UUID) of the message. This is created by the message creator.",
+"type": "string"
+},
+"metadata": {
+"additionalProperties": {
+"description": "Properties of the object.",
+"type": "any"
+},
+"description": "Optional. Any metadata to provide along with the message.",
+"type": "object"
+},
+"parts": {
+"description": "Required. Parts is the container of the message content.",
+"items": {
+"$ref": "LfA2aV1Part"
+},
+"type": "array"
+},
+"referenceTaskIds": {
+"description": "A list of task IDs that this message references for additional context.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"role": {
+"description": "Required. Identifies the sender of the message.",
+"enum": [
+"ROLE_UNSPECIFIED",
+"ROLE_USER",
+"ROLE_AGENT"
+],
+"enumDescriptions": [
+"The role is unspecified.",
+"The message is from the client to the server.",
+"The message is from the server to the client."
+],
+"type": "string"
+},
+"taskId": {
+"description": "Optional. The task id of the message. If set, the message will be associated with the given task.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"LfA2aV1Part": {
+"description": "`Part` represents a container for a section of communication content. Parts can be purely textual, some sort of file (image, video, etc) or a structured data blob (i.e. JSON).",
+"id": "LfA2aV1Part",
+"properties": {
+"data": {
+"description": "Arbitrary structured `data` as a JSON value (object, array, string, number, boolean, or null).",
+"type": "any"
+},
+"filename": {
+"description": "An optional `filename` for the file (e.g., \"document.pdf\").",
+"type": "string"
+},
+"mediaType": {
+"description": "The `media_type` (MIME type) of the part content (e.g., \"text/plain\", \"application/json\", \"image/png\"). This field is available for all part types.",
+"type": "string"
+},
+"metadata": {
+"additionalProperties": {
+"description": "Properties of the object.",
+"type": "any"
+},
+"description": "Optional. metadata associated with this part.",
+"type": "object"
+},
+"raw": {
+"description": "The `raw` byte content of a file. In JSON serialization, this is encoded as a base64 string.",
+"format": "byte",
+"type": "string"
+},
+"text": {
+"description": "The string content of the `text` part.",
+"type": "string"
+},
+"url": {
+"description": "A `url` pointing to the file's content.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"LfA2aV1SendMessageConfiguration": {
+"description": "Configuration of a send message request.",
+"id": "LfA2aV1SendMessageConfiguration",
+"properties": {
+"acceptedOutputModes": {
+"description": "A list of media types the client is prepared to accept for response parts. Agents SHOULD use this to tailor their output.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"historyLength": {
+"description": "The maximum number of most recent messages from the task's history to retrieve in the response. An unset value means the client does not impose any limit. A value of zero is a request to not include any messages. The server MUST NOT return more messages than the provided value, but MAY apply a lower limit.",
+"format": "int32",
+"type": "integer"
+},
+"returnImmediately": {
+"description": "If `true`, the operation returns immediately after creating the task, even if processing is still in progress. If `false` (default), the operation MUST wait until the task reaches a terminal (`COMPLETED`, `FAILED`, `CANCELED`, `REJECTED`) or interrupted (`INPUT_REQUIRED`, `AUTH_REQUIRED`) state before returning.",
+"type": "boolean"
+},
+"taskPushNotificationConfig": {
+"$ref": "LfA2aV1TaskPushNotificationConfig",
+"description": "Configuration for the agent to send push notifications for task updates. Task id should be empty when sending this configuration in a `SendMessage` request."
+}
+},
+"type": "object"
+},
+"LfA2aV1SendMessageRequest": {
+"description": "Represents a request for the `SendMessage` method.",
+"id": "LfA2aV1SendMessageRequest",
+"properties": {
+"configuration": {
+"$ref": "LfA2aV1SendMessageConfiguration",
+"description": "Configuration for the send request."
+},
+"message": {
+"$ref": "LfA2aV1Message",
+"description": "Required. The message to send to the agent."
+},
+"metadata": {
+"additionalProperties": {
+"description": "Properties of the object.",
+"type": "any"
+},
+"description": "A flexible key-value map for passing additional context or parameters.",
+"type": "object"
+}
+},
+"type": "object"
+},
+"LfA2aV1SendMessageResponse": {
+"description": "Represents the response for the `SendMessage` method.",
+"id": "LfA2aV1SendMessageResponse",
+"properties": {
+"message": {
+"$ref": "LfA2aV1Message",
+"description": "A message from the agent."
+},
+"task": {
+"$ref": "LfA2aV1Task",
+"description": "The task created or updated by the message."
+}
+},
+"type": "object"
+},
+"LfA2aV1Task": {
+"description": "`Task` is the core unit of action for A2A. It has a current status and when results are created for the task they are stored in the artifact. If there are multiple turns for a task, these are stored in history.",
+"id": "LfA2aV1Task",
+"properties": {
+"artifacts": {
+"description": "A set of output artifacts for a `Task`.",
+"items": {
+"$ref": "LfA2aV1Artifact"
+},
+"type": "array"
+},
+"contextId": {
+"description": "Unique identifier (e.g. UUID) for the contextual collection of interactions (tasks and messages).",
+"type": "string"
+},
+"history": {
+"description": "protolint:disable REPEATED_FIELD_NAMES_PLURALIZED The history of interactions from a `Task`.",
+"items": {
+"$ref": "LfA2aV1Message"
+},
+"type": "array"
+},
+"id": {
+"description": "Required. Unique identifier (e.g. UUID) for the task, generated by the server for a new task.",
+"type": "string"
+},
+"metadata": {
+"additionalProperties": {
+"description": "Properties of the object.",
+"type": "any"
+},
+"description": "protolint:enable REPEATED_FIELD_NAMES_PLURALIZED A key/value object to store custom metadata about a task.",
+"type": "object"
+},
+"status": {
+"$ref": "LfA2aV1TaskStatus",
+"description": "Required. The current status of a `Task`, including `state` and a `message`."
+}
+},
+"type": "object"
+},
+"LfA2aV1TaskPushNotificationConfig": {
+"description": "A container associating a push notification configuration with a specific task.",
+"id": "LfA2aV1TaskPushNotificationConfig",
+"properties": {
+"authentication": {
+"$ref": "LfA2aV1AuthenticationInfo",
+"description": "Authentication information required to send the notification."
+},
+"id": {
+"description": "The push notification configuration details. A unique identifier (e.g. UUID) for this push notification configuration.",
+"type": "string"
+},
+"taskId": {
+"description": "The ID of the task this configuration is associated with.",
+"type": "string"
+},
+"tenant": {
+"description": "Optional. Tenant ID.",
+"type": "string"
+},
+"token": {
+"description": "A token unique for this task or session.",
+"type": "string"
+},
+"url": {
+"description": "Required. The URL where the notification should be sent.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"LfA2aV1TaskStatus": {
+"description": "A container for the status of a task",
+"id": "LfA2aV1TaskStatus",
+"properties": {
+"message": {
+"$ref": "LfA2aV1Message",
+"description": "A message associated with the status."
+},
+"state": {
+"description": "Required. The current state of this task.",
+"enum": [
+"TASK_STATE_UNSPECIFIED",
+"TASK_STATE_SUBMITTED",
+"TASK_STATE_WORKING",
+"TASK_STATE_COMPLETED",
+"TASK_STATE_FAILED",
+"TASK_STATE_CANCELED",
+"TASK_STATE_INPUT_REQUIRED",
+"TASK_STATE_REJECTED",
+"TASK_STATE_AUTH_REQUIRED"
+],
+"enumDescriptions": [
+"The task is in an unknown or indeterminate state.",
+"Indicates that a task has been successfully submitted and acknowledged.",
+"Indicates that a task is actively being processed by the agent.",
+"Indicates that a task has finished successfully. This is a terminal state.",
+"Indicates that a task has finished with an error. This is a terminal state.",
+"Indicates that a task was canceled before completion. This is a terminal state.",
+"Indicates that the agent requires additional user input to proceed. This is an interrupted state.",
+"Indicates that the agent has decided to not perform the task. This may be done during initial task creation or later once an agent has determined it can't or won't proceed. This is a terminal state.",
+"Indicates that authentication is required to proceed. This is an interrupted state."
+],
+"type": "string"
+},
+"timestamp": {
+"description": "ISO 8601 Timestamp when the status was recorded. Example: \"2023-10-27T10:00:00Z\"",
+"format": "google-datetime",
+"type": "string"
+}
+},
+"type": "object"
+},
 "ListAgentsResponse": {
 "description": "Response message for AgentService.ListAgents.",
 "id": "ListAgentsResponse",
@@ -9501,11 +10261,11 @@
 "properties": {
 "audioRecordingConfig": {
 "$ref": "AudioRecordingConfig",
-"description": "Optional. Configuration for how audio interactions should be recorded."
+"description": "Optional. Configuration for how audio interactions should be recorded. The audio is subject to redaction as configured in RedactionConfig."
 },
 "bigqueryExportSettings": {
 "$ref": "BigQueryExportSettings",
-"description": "Optional. Settings to describe the BigQuery export behaviors for the app. The conversation data will be exported to BigQuery tables if it is enabled."
+"description": "Optional. Configures the BigQuery export behaviors for the app. The conversation data is subject to redaction as configured in RedactionConfig."
 },
 "cloudLoggingSettings": {
 "$ref": "CloudLoggingSettings",
@@ -9529,7 +10289,7 @@
 },
 "unredactedAudioRecordingConfig": {
 "$ref": "AudioRecordingConfig",
-"description": "Optional. Configures recording of unredacted audio. Use this to maintain a raw backup with restricted access when audio redaction is enabled, typically for auditing or monitoring purposes."
+"description": "Optional. Configures an additional recording of unredacted audio. This can be used to maintain a raw audio copy when audio redaction is enabled, typically for auditing or monitoring purposes."
 }
 },
 "type": "object"
@@ -9561,6 +10321,10 @@
 "description": "Required. The name of the MCP tool.",
 "type": "string"
 },
+"nameOverride": {
+"description": "Optional. The name override of the MCP tool. This is populated if the name was overridden by a Toolset override.",
+"type": "string"
+},
 "outputSchema": {
 "$ref": "Schema",
 "description": "Optional. The schema of the output arguments of the MCP tool."
@@ -9573,6 +10337,23 @@
 "$ref": "ServiceDirectoryConfig",
 "description": "Optional. Service Directory configuration for VPC-SC, used to resolve service names within a perimeter."
 },
+"state": {
+"description": "Output only. The dynamic availability state of the tool on the external server.",
+"enum": [
+"STATE_UNSPECIFIED",
+"ACTIVE",
+"INACTIVE",
+"STALE"
+],
+"enumDescriptions": [
+"Default state.",
+"The tool is available and actively offered by the server.",
+"The tool is configured or pinned, but currently not offered by the server.",
+"The tool exists on the server, but does not match the version on the server."
+],
+"readOnly": true,
+"type": "string"
+},
 "tlsConfig": {
 "$ref": "TlsConfig",
 "description": "Optional. The TLS configuration. Includes the custom server certificates that the client should trust."
@@ -9580,6 +10361,52 @@
 },
 "type": "object"
 },
+"McpToolDefinition": {
+"description": "Container for a tool's core definition elements that are snapshot. Schemas in the snapshot are used as-is and cannot be overridden.",
+"id": "McpToolDefinition",
+"properties": {
+"description": {
+"description": "Output only. The description of the MCP tool. This can be overridden by `description_override` in `McpToolOverride`.",
+"readOnly": true,
+"type": "string"
+},
+"inputSchema": {
+"$ref": "Schema",
+"description": "Output only. The schema of the input arguments of the MCP tool.",
+"readOnly": true
+},
+"outputSchema": {
+"$ref": "Schema",
+"description": "Output only. The schema of the output arguments of the MCP tool.",
+"readOnly": true
+}
+},
+"type": "object"
+},
+"McpToolOverride": {
+"description": "Overrides associated with a given tool in a Toolset. This enables \"pinning\" or \"overriding\" of tool definitions from the external dynamic server.",
+"id": "McpToolOverride",
+"properties": {
+"descriptionOverride": {
+"description": "Optional. If present, this tool uses this description instead of the original description from the server.",
+"type": "string"
+},
+"nameOverride": {
+"description": "Optional. If present, this tool uses this name in the Agent instead of the original name. This is primarily used as an alias if the MCP server offers poorly named tools.",
+"type": "string"
+},
+"snapshot": {
+"$ref": "McpToolDefinition",
+"description": "Output only. If present, this tool is \"Pinned\" and uses the snapshot values as fallbacks if the server becomes temporarily unavailable or if no Override is present.",
+"readOnly": true
+},
+"tool": {
+"description": "Required. The original name of the tool as it is emitted by the MCP server.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "McpToolset": {
 "description": "A toolset that contains a list of tools that are offered by the MCP server.",
 "id": "McpToolset",
@@ -9606,6 +10433,13 @@
 "tlsConfig": {
 "$ref": "TlsConfig",
 "description": "Optional. The TLS configuration. Includes the custom server certificates that the client should trust."
+},
+"toolOverrides": {
+"description": "Optional. Overrides for individual tools within this toolset. This allows overriding specific details like descriptions, names, or pinning the tools' states so they aren't fully dynamic.",
+"items": {
+"$ref": "McpToolOverride"
+},
+"type": "array"
 }
 },
 "type": "object"
@@ -9762,178 +10596,6 @@
 },
 "type": "object"
 },
-"Omnichannel": {
-"description": "Represents an Omnichannel resource.",
-"id": "Omnichannel",
-"properties": {
-"createTime": {
-"description": "Output only. Timestamp when the omnichannel resource was created.",
-"format": "google-datetime",
-"readOnly": true,
-"type": "string"
-},
-"description": {
-"description": "Optional. Human-readable description of the omnichannel resource.",
-"type": "string"
-},
-"displayName": {
-"description": "Required. Display name of the omnichannel resource.",
-"type": "string"
-},
-"etag": {
-"description": "Output only. Etag used to ensure the object hasn't changed during a read-modify-write operation.",
-"readOnly": true,
-"type": "string"
-},
-"integrationConfig": {
-"$ref": "OmnichannelIntegrationConfig",
-"description": "Optional. The integration config for the omnichannel resource."
-},
-"name": {
-"description": "Identifier. The unique identifier of the omnichannel resource. Format: `projects/{project}/locations/{location}/omnichannels/{omnichannel}`",
-"type": "string"
-},
-"updateTime": {
-"description": "Output only. Timestamp when the omnichannel resource was last updated.",
-"format": "google-datetime",
-"readOnly": true,
-"type": "string"
-}
-},
-"type": "object"
-},
-"OmnichannelIntegrationConfig": {
-"description": "OmnichannelIntegrationConfig contains all App integration configs.",
-"id": "OmnichannelIntegrationConfig",
-"properties": {
-"channelConfigs": {
-"additionalProperties": {
-"$ref": "OmnichannelIntegrationConfigChannelConfig"
-},
-"description": "Optional. Various of configuration for handling App events.",
-"type": "object"
-},
-"routingConfigs": {
-"additionalProperties": {
-"$ref": "OmnichannelIntegrationConfigRoutingConfig"
-},
-"description": "Optional. The key of routing_configs is a key of `app_configs`, value is a `RoutingConfig`, which contains subscriber's key.",
-"type": "object"
-},
-"subscriberConfigs": {
-"additionalProperties": {
-"$ref": "OmnichannelIntegrationConfigSubscriberConfig"
-},
-"description": "Optional. Various of subscribers configs.",
-"type": "object"
-}
-},
-"type": "object"
-},
-"OmnichannelIntegrationConfigCesAppConfig": {
-"description": "Configs for CES app.",
-"id": "OmnichannelIntegrationConfigCesAppConfig",
-"properties": {
-"app": {
-"description": "The unique identifier of the CES app. Format: `projects/{project}/locations/{location}/apps/{app}`",
-"type": "string"
-}
-},
-"type": "object"
-},
-"OmnichannelIntegrationConfigChannelConfig": {
-"description": "ChannelConfig contains config for various of app integration.",
-"id": "OmnichannelIntegrationConfigChannelConfig",
-"properties": {
-"whatsappConfig": {
-"$ref": "OmnichannelIntegrationConfigWhatsappConfig",
-"description": "WhatsApp config."
-}
-},
-"type": "object"
-},
-"OmnichannelIntegrationConfigRoutingConfig": {
-"description": "Routing config specify how/who to route app events to a subscriber.",
-"id": "OmnichannelIntegrationConfigRoutingConfig",
-"properties": {
-"subscriberKey": {
-"description": "The key of the subscriber.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"OmnichannelIntegrationConfigSubscriberConfig": {
-"description": "Configs of subscribers.",
-"id": "OmnichannelIntegrationConfigSubscriberConfig",
-"properties": {
-"cesAppConfig": {
-"$ref": "OmnichannelIntegrationConfigCesAppConfig",
-"description": "Ces app config."
-}
-},
-"type": "object"
-},
-"OmnichannelIntegrationConfigWhatsappConfig": {
-"description": "How Omnichannel should receive/reply events from WhatsApp.",
-"id": "OmnichannelIntegrationConfigWhatsappConfig",
-"properties": {
-"metaBusinessPortfolioId": {
-"description": "The Meta Business Portfolio (MBP) ID. https://www.facebook.com/business/help/1710077379203657",
-"type": "string"
-},
-"phoneNumber": {
-"description": "The phone number used for sending/receiving messages.",
-"type": "string"
-},
-"phoneNumberId": {
-"description": "The Phone Number ID associated with the WhatsApp Business Account.",
-"type": "string"
-},
-"webhookVerifyToken": {
-"description": "The verify token configured in the Meta App Dashboard for webhook verification.",
-"type": "string"
-},
-"whatsappBusinessAccountId": {
-"description": "The customer's WhatsApp Business Account (WABA) ID.",
-"type": "string"
-},
-"whatsappBusinessToken": {
-"description": "The access token for authenticating API calls to the WhatsApp Cloud API. https://developers.facebook.com/docs/whatsapp/business-management-api/get-started/#business-integration-system-user-access-tokens",
-"type": "string"
-}
-},
-"type": "object"
-},
-"OmnichannelOperationMetadata": {
-"description": "Represents the metadata of the long-running operation.",
-"id": "OmnichannelOperationMetadata",
-"properties": {
-"createTime": {
-"description": "Output only. The time the operation was created.",
-"format": "google-datetime",
-"readOnly": true,
-"type": "string"
-},
-"endTime": {
-"description": "Output only. The time the operation finished running.",
-"format": "google-datetime",
-"readOnly": true,
-"type": "string"
-},
-"requestedCancellation": {
-"description": "Output only. Identifies whether the user has requested cancellation of the operation.",
-"readOnly": true,
-"type": "boolean"
-},
-"statusMessage": {
-"description": "Output only. Human-readable status of the operation, if any.",
-"readOnly": true,
-"type": "string"
-}
-},
-"type": "object"
-},
 "OpenApiTool": {
 "description": "A remote API tool defined by an OpenAPI schema.",
 "id": "OpenApiTool",
@@ -10196,6 +10858,10 @@
 "pythonCode": {
 "description": "Optional. The Python code to execute for the tool.",
 "type": "string"
+},
+"serviceDirectoryConfig": {
+"$ref": "ServiceDirectoryConfig",
+"description": "Optional. Service Directory configuration for the tool."
 }
 },
 "type": "object"
@@ -10285,6 +10951,25 @@
 },
 "type": "object"
 },
+"RemoteAgentTool": {
+"description": "Represents a tool that allows the agent to call another remote agent.",
+"id": "RemoteAgentTool",
+"properties": {
+"agentCard": {
+"$ref": "AgentCard",
+"description": "Required. The agent card of the remote agent that this tool invokes."
+},
+"description": {
+"description": "Required. The description of the tool.",
+"type": "string"
+},
+"name": {
+"description": "Required. The name of the tool.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "RestoreAppVersionRequest": {
 "description": "Request message for AgentService.RestoreAppVersion",
 "id": "RestoreAppVersionRequest",
@@ -10333,6 +11018,10 @@
 "description": "Request message for ToolService.RetrieveTools.",
 "id": "RetrieveToolsRequest",
 "properties": {
+"bypassPersistenceConfig": {
+"description": "Optional. If true, the returned tools will contain raw descriptions and schemas directly from the server, bypassing any stored persistence configurations (overrides/snapshots).",
+"type": "boolean"
+},
 "toolIds": {
 "description": "Optional. The identifiers of the tools to retrieve from the toolset. If empty, all tools in the toolset will be returned.",
 "items": {
@@ -11211,10 +11900,19 @@
 "$ref": "PythonFunction",
 "description": "Optional. The python function tool."
 },
+"remoteAgentTool": {
+"$ref": "RemoteAgentTool",
+"description": "Optional. The remote agent tool."
+},
 "systemTool": {
 "$ref": "SystemTool",
 "description": "Optional. The system tool."
 },
+"timeout": {
+"description": "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.",
+"format": "google-duration",
+"type": "string"
+},
 "toolFakeConfig": {
 "$ref": "ToolFakeConfig",
 "description": "Optional. Configuration for tool behavior in fake mode."
@@ -11584,6 +12282,20 @@
 },
 "type": "object"
 },
+"VpcScSettings": {
+"description": "VPC-SC settings for the app.",
+"id": "VpcScSettings",
+"properties": {
+"allowedOrigins": {
+"description": "Optional. The allowed HTTP(s) origins that OpenAPI tools in the App are able to directly call when VPC Service Controls are enabled. These strings must match the origin exactly, including the port if specified. For example, \"https://example.com\" or \"https://example.com:443\". This list does not yet apply to Python tools that may make direct HTTP calls.",
+"items": {
+"type": "string"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
 "WebSearchQuery": {
 "description": "Represents a single web search query and its associated search uri.",
 "id": "WebSearchQuery",