{
  "baseUrl": "https://ces.googleapis.com/",
  "protocol": "rest",
  "ownerDomain": "google.com",
  "version_module": true,
  "title": "Gemini Enterprise for Customer Experience API",
  "batchPath": "batch",
  "name": "ces",
  "schemas": {
    "ImportAppRequest": {
      "id": "ImportAppRequest",
      "type": "object",
      "description": "Request message for AgentService.ImportApp.",
      "properties": {
        "appContent": {
          "type": "string",
          "description": "Raw bytes representing the compressed zip file with the app folder structure.",
          "format": "byte"
        },
        "displayName": {
          "description": "Optional. The display name of the app to import. * If the app is created on import, and the display name is specified, the imported app will use this display name. If a conflict is detected with an existing app, a timestamp will be appended to the display name to make it unique. * If the app is a reimport, this field should not be set. Providing a display name during reimport will result in an INVALID_ARGUMENT error.",
          "type": "string"
        },
        "importOptions": {
          "$ref": "ImportAppRequestImportOptions",
          "description": "Optional. Options governing the import process for the app."
        },
        "ignoreAppLock": {
          "type": "boolean",
          "description": "Optional. Flag for overriding the app lock during import. If set to true, the import process will ignore the app lock."
        },
        "gcsUri": {
          "description": "The [Google Cloud Storage](https://cloud.google.com/storage/docs/) URI from which to import app. The format of this URI must be `gs:///`.",
          "type": "string"
        },
        "jsonPatchContent": {
          "description": "Optional. Patch content as a JSON string.",
          "type": "string"
        },
        "jsonPatchGcsUri": {
          "description": "Optional. A Cloud Storage URI pointing to a JSON file containing the patches.",
          "type": "string"
        },
        "appId": {
          "type": "string",
          "description": "Optional. The ID to use for the imported app. * If not specified, a unique ID will be automatically assigned for the app. * Otherwise, the imported app will use this ID as the final component of its resource name. If an app with the same ID already exists at the specified location in the project, the content of the existing app will be replaced."
        }
      }
    },
    "InputAudioConfig": {
      "type": "object",
      "properties": {
        "noiseSuppressionLevel": {
          "type": "string",
          "description": "Optional. Whether to enable noise suppression on the input audio. Available values are \"low\", \"moderate\", \"high\", \"very_high\"."
        },
        "sampleRateHertz": {
          "type": "integer",
          "description": "Required. The sample rate (in Hertz) of the input audio data.",
          "format": "int32"
        },
        "audioEncoding": {
          "enumDescriptions": [
            "Unspecified audio encoding.",
            "16-bit linear PCM audio encoding.",
            "8-bit samples that compand 14-bit audio samples using G.711 PCMU/mu-law.",
            "8-bit samples that compand 14-bit audio samples using G.711 PCMU/A-law."
          ],
          "type": "string",
          "enum": [
            "AUDIO_ENCODING_UNSPECIFIED",
            "LINEAR16",
            "MULAW",
            "ALAW"
          ],
          "description": "Required. The encoding of the input audio data."
        }
      },
      "id": "InputAudioConfig",
      "description": "InputAudioConfig configures how the CES agent should interpret the incoming audio data."
    },
    "AssistantMessage": {
      "type": "object",
      "id": "AssistantMessage",
      "description": "A message in an assistant session.",
      "properties": {
        "role": {
          "type": "string",
          "description": "Required. Role within the conversation \"user\" or \"model\"."
        },
        "attachedGcsUris": {
          "description": "Optional. Cloud Storage URIs for files uploaded by the user during this turn. This allows attachments to be persisted and rendered in the session history UI. Example: \"gs://cxas-transient-uploads/uuid/prd.pdf\"",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "chunks": {
          "items": {
            "$ref": "AssistantChunk"
          },
          "type": "array",
          "description": "Optional. Content of the message as chunks."
        },
        "eventTime": {
          "format": "google-datetime",
          "description": "Required. Timestamp when the message was sent or received.",
          "type": "string"
        }
      }
    },
    "CustomVoiceSample": {
      "id": "CustomVoiceSample",
      "type": "object",
      "description": "Configuration for a custom voice sample used for voice cloning.",
      "properties": {
        "previewAudioContent": {
          "description": "Output only. Synthesized preview audio for custom voice, formatted as canonical WAV (LINEAR16, 24kHz, 16-bit, mono).",
          "readOnly": true,
          "format": "byte",
          "type": "string"
        },
        "voiceInstruction": {
          "description": "Optional. Natural language instructions for voice style, tone, pacing, or pronunciation.",
          "type": "string"
        },
        "name": {
          "type": "string",
          "description": "Optional. The user-defined name for the custom voice sample."
        },
        "voiceInstructionMode": {
          "type": "string",
          "enum": [
            "VOICE_INSTRUCTION_MODE_UNSPECIFIED",
            "NO_INSTRUCTION",
            "GENERATE_INSTRUCTION",
            "CUSTOM_INSTRUCTION"
          ],
          "enumDescriptions": [
            "Unspecified instruction mode. Defaults to NO_INSTRUCTION.",
            "No voice instruction will be used.",
            "Voice instruction will be automatically generated by AI from the audio sample.",
            "Custom voice instruction provided by the user."
          ],
          "description": "Optional. Instruction mode for the voice sample. If unspecified, defaults to NO_INSTRUCTION."
        },
        "previewText": {
          "type": "string",
          "description": "Optional. Text for synthesizing preview audio for custom voice."
        },
        "voiceSampleGcsUri": {
          "description": "Optional. The Cloud Storage URI to the audio sample for voice cloning. The audio sample should be a mono-channel, 24kHz WAV file.",
          "type": "string"
        },
        "warnings": {
          "description": "Output only. Warning messages encountered during voice clone processing (e.g. low audio level).",
          "items": {
            "$ref": "CustomVoiceSampleWarning"
          },
          "readOnly": true,
          "type": "array"
        },
        "consentAudioGcsUri": {
          "type": "string",
          "description": "Optional. Consent audio for voice cloning."
        }
      }
    },
    "GenerateAppResourceResponseAppResources": {
      "properties": {
        "appSnapshot": {
          "description": "The app snapshot generated by the LLM assistant. This snapshot contains the app, agents & tools generated by the LLM assistant.",
          "$ref": "AppSnapshot"
        },
        "evaluations": {
          "items": {
            "$ref": "Evaluation"
          },
          "description": "The list of evaluations generated by the LLM assistant.",
          "type": "array"
        }
      },
      "id": "GenerateAppResourceResponseAppResources",
      "description": "The list of app resources generated by the LLM assistant.",
      "type": "object"
    },
    "PersonaRunConfig": {
      "properties": {
        "persona": {
          "description": "Optional. The persona to use for the evaluation. Format: `projects/{project}/locations/{location}/apps/{app}/evaluationPersonas/{evaluationPersona}`",
          "type": "string"
        },
        "taskCount": {
          "format": "int32",
          "type": "integer",
          "description": "Optional. The number of tasks to run for the persona."
        }
      },
      "description": "Configuration for running an evaluation for a specific persona.",
      "id": "PersonaRunConfig",
      "type": "object"
    },
    "EvaluationResultToolCallLatency": {
      "description": "The latency of a tool call execution.",
      "type": "object",
      "properties": {
        "executionLatency": {
          "format": "google-duration",
          "description": "Output only. The latency of the tool call execution.",
          "type": "string",
          "readOnly": true
        },
        "displayName": {
          "description": "Output only. The display name of the tool.",
          "type": "string",
          "readOnly": true
        },
        "tool": {
          "readOnly": true,
          "description": "Output only. The name of the tool that got executed. Format: `projects/{project}/locations/{location}/apps/{app}/tools/{tool}`.",
          "type": "string"
        },
        "startTime": {
          "readOnly": true,
          "format": "google-datetime",
          "type": "string",
          "description": "Output only. The start time of the tool call execution."
        },
        "endTime": {
          "readOnly": true,
          "type": "string",
          "format": "google-datetime",
          "description": "Output only. The end time of the tool call execution."
        }
      },
      "id": "EvaluationResultToolCallLatency"
    },
    "GenerateAppResourceRequestEvaluationPersonasGenerationConfig": {
      "type": "object",
      "description": "The configuration to be used to generate the evaluation personas.",
      "id": "GenerateAppResourceRequestEvaluationPersonasGenerationConfig",
      "properties": {}
    },
    "LfA2aV1SendMessageRequest": {
      "properties": {
        "configuration": {
          "$ref": "LfA2aV1SendMessageConfiguration",
          "description": "Configuration for the send request."
        },
        "metadata": {
          "additionalProperties": {
            "type": "any",
            "description": "Properties of the object."
          },
          "description": "A flexible key-value map for passing additional context or parameters.",
          "type": "object"
        },
        "message": {
          "description": "Required. The message to send to the agent.",
          "$ref": "LfA2aV1Message"
        }
      },
      "id": "LfA2aV1SendMessageRequest",
      "description": "Represents a request for the `SendMessage` method.",
      "type": "object"
    },
    "SessionConfigRemoteDialogflowQueryParameters": {
      "properties": {
        "webhookHeaders": {
          "additionalProperties": {
            "type": "string"
          },
          "description": "Optional. The HTTP headers to be sent as webhook_headers in [QueryParameters](https://cloud.google.com/dialogflow/cx/docs/reference/rpc/google.cloud.dialogflow.cx.v3#queryparameters).",
          "type": "object"
        },
        "endUserMetadata": {
          "additionalProperties": {
            "description": "Properties of the object.",
            "type": "any"
          },
          "description": "Optional. The end user metadata to be sent in [QueryParameters](https://cloud.google.com/dialogflow/cx/docs/reference/rpc/google.cloud.dialogflow.cx.v3#queryparameters).",
          "type": "object"
        },
        "payload": {
          "type": "object",
          "additionalProperties": {
            "type": "any",
            "description": "Properties of the object."
          },
          "description": "Optional. The payload to be sent in [QueryParameters](https://cloud.google.com/dialogflow/cx/docs/reference/rpc/google.cloud.dialogflow.cx.v3#queryparameters)."
        }
      },
      "id": "SessionConfigRemoteDialogflowQueryParameters",
      "description": "[QueryParameters](https://cloud.google.com/dialogflow/cx/docs/reference/rpc/google.cloud.dialogflow.cx.v3#queryparameters) to send to the remote [Dialogflow](https://cloud.google.com/dialogflow/cx/docs/concept/console-conversational-agents) agent when the session control is transferred to the remote agent.",
      "type": "object"
    },
    "LanguageSettings": {
      "properties": {
        "fallbackAction": {
          "description": "Optional. Deprecated: This feature is no longer supported. Use `enable_multilingual_support` instead to improve handling of multilingual input. The action to perform when an agent receives input in an unsupported language. This can be a predefined action or a custom tool call. Valid values are: - A tool's full resource name, which triggers a specific tool execution. - A predefined system action, such as \"escalate\" or \"exit\", which triggers an EndSession signal with corresponding metadata to terminate the conversation.",
          "type": "string",
          "deprecated": true
        },
        "supportedLanguageCodes": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Optional. List of languages codes supported by the app, in addition to the `default_language_code`."
        },
        "enableMultilingualSupport": {
          "description": "Optional. Enables multilingual support. If `true`, agents in the app will use pre-built instructions to improve handling of multilingual input.",
          "type": "boolean"
        },
        "defaultLanguageCode": {
          "type": "string",
          "description": "Optional. The default language code of the app."
        }
      },
      "id": "LanguageSettings",
      "type": "object",
      "description": "Language settings of the app."
    },
    "ListEvaluationExpectationsResponse": {
      "description": "Response message for EvaluationService.ListEvaluationExpectations.",
      "type": "object",
      "properties": {
        "nextPageToken": {
          "type": "string",
          "description": "A token that can be sent as ListEvaluationExpectationsRequest.page_token to retrieve the next page. Absence of this field indicates there are no subsequent pages."
        },
        "evaluationExpectations": {
          "type": "array",
          "description": "The list of evaluation expectations.",
          "items": {
            "$ref": "EvaluationExpectation"
          }
        }
      },
      "id": "ListEvaluationExpectationsResponse"
    },
    "QualityReportIssue": {
      "id": "QualityReportIssue",
      "properties": {
        "occurrenceCount": {
          "type": "integer",
          "description": "Optional. How many times this issue occurred.",
          "format": "int32"
        },
        "proposedSolution": {
          "type": "string",
          "description": "Optional. Proposed solution to fix the issue by modifying instructions or tools."
        },
        "description": {
          "description": "Optional. Description of the issue found.",
          "type": "string"
        }
      },
      "type": "object",
      "description": "The issue identified."
    },
    "LatencyReport": {
      "type": "object",
      "id": "LatencyReport",
      "description": "Latency report for the evaluation run.",
      "properties": {
        "toolLatencies": {
          "type": "array",
          "description": "Output only. Unordered list. Latency metrics for each tool.",
          "readOnly": true,
          "items": {
            "$ref": "LatencyReportToolLatency"
          }
        },
        "guardrailLatencies": {
          "readOnly": true,
          "description": "Output only. Unordered list. Latency metrics for each guardrail.",
          "items": {
            "$ref": "LatencyReportGuardrailLatency"
          },
          "type": "array"
        },
        "llmCallLatencies": {
          "items": {
            "$ref": "LatencyReportLlmCallLatency"
          },
          "description": "Output only. Unordered list. Latency metrics for each LLM call.",
          "type": "array",
          "readOnly": true
        },
        "callbackLatencies": {
          "readOnly": true,
          "type": "array",
          "items": {
            "$ref": "LatencyReportCallbackLatency"
          },
          "description": "Output only. Unordered list. Latency metrics for each callback."
        },
        "sessionCount": {
          "readOnly": true,
          "description": "Output only. The total number of sessions considered in the latency report.",
          "format": "int32",
          "type": "integer"
        }
      }
    },
    "EvaluationErrorInfo": {
      "id": "EvaluationErrorInfo",
      "type": "object",
      "description": "Information about an error encountered during an evaluation execution.",
      "properties": {
        "errorType": {
          "type": "string",
          "description": "Output only. The type of error.",
          "readOnly": true,
          "enum": [
            "ERROR_TYPE_UNSPECIFIED",
            "RUNTIME_FAILURE",
            "CONVERSATION_RETRIEVAL_FAILURE",
            "METRIC_CALCULATION_FAILURE",
            "EVALUATION_UPDATE_FAILURE",
            "QUOTA_EXHAUSTED",
            "USER_SIMULATION_FAILURE"
          ],
          "enumDescriptions": [
            "Unspecified error type.",
            "Failure during runtime execution.",
            "Failure to retrieve conversation from CES Runtime.",
            "Failure to calculate a metric / outcome.",
            "Failure to update the evaluation.",
            "Ran out of quota.",
            "Failure during user simulation."
          ]
        },
        "errorMessage": {
          "readOnly": true,
          "description": "Output only. The error message.",
          "type": "string"
        },
        "sessionId": {
          "description": "Output only. The session ID for the conversation that caused the error.",
          "type": "string",
          "readOnly": true
        },
        "userFacingErrorMessage": {
          "readOnly": true,
          "description": "Output only. The user facing error message.",
          "type": "string"
        }
      }
    },
    "DeployChannelResponse": {
      "properties": {
        "deployment": {
          "description": "The created deployment.",
          "$ref": "Deployment"
        }
      },
      "type": "object",
      "id": "DeployChannelResponse",
      "description": "Response message for AgentService.DeployChannel."
    },
    "ToolCall": {
      "type": "object",
      "description": "Request for the client or the agent to execute the specified tool.",
      "id": "ToolCall",
      "properties": {
        "displayName": {
          "type": "string",
          "description": "Output only. Display name of the tool.",
          "readOnly": true
        },
        "parentToolCallId": {
          "readOnly": true,
          "description": "Output only. The id of the tool call that caused this one, when it was issued by a sub-agent working on behalf of a parent call. Empty for top-level calls. Lets a client group a sub-agent's work under the call that started it instead of rendering every step as a sibling.",
          "type": "string"
        },
        "agentName": {
          "readOnly": true,
          "type": "string",
          "description": "Output only. Human-readable name of the agent that issued this call, e.g. \"Contract Architect\". Empty when the root agent issued it."
        },
        "targetApp": {
          "description": "Output only. The app this call targets, derived by the assistant from the call's resource arguments: an app resource name, `PROJECT` for location-scoped tools, or empty for session-local tools. Set only in project-scoped assistant sessions.",
          "readOnly": true,
          "type": "string"
        },
        "toolsetTool": {
          "$ref": "ToolsetTool",
          "description": "Optional. The toolset tool to execute."
        },
        "tool": {
          "description": "Optional. The name of the tool to execute. Format: `projects/{project}/locations/{location}/apps/{app}/tools/{tool}`",
          "type": "string"
        },
        "id": {
          "type": "string",
          "description": "Optional. The unique identifier of the tool call. If populated, the client should return the execution result with the matching ID in ToolResponse."
        },
        "args": {
          "description": "Optional. The input parameters and values for the tool in JSON object format.",
          "type": "object",
          "additionalProperties": {
            "type": "any",
            "description": "Properties of the object."
          }
        }
      }
    },
    "ChatAiAssistantResponse": {
      "id": "ChatAiAssistantResponse",
      "properties": {
        "statusMessage": {
          "description": "Simple status update",
          "type": "string"
        },
        "eventTime": {
          "description": "Timestamp when the event occurred.",
          "format": "google-datetime",
          "type": "string"
        },
        "eventId": {
          "description": "Unique identifier for the event.",
          "type": "string"
        },
        "uiEvent": {
          "$ref": "UiEvent",
          "description": "Optional. UI event payload."
        },
        "textChunk": {
          "type": "string",
          "description": "Text Token (for streaming Gemini responses word-by-word)"
        },
        "sessionCheckpoint": {
          "description": "Session checkpoint/compaction recap event containing user intent and rolling summary.",
          "$ref": "SessionCheckpoint"
        }
      },
      "description": "Response message for AssistantService.ChatAiAssistant.",
      "type": "object"
    },
    "VpcScSettings": {
      "properties": {
        "allowedOrigins": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "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."
        }
      },
      "id": "VpcScSettings",
      "description": "VPC-SC settings for the app.",
      "type": "object"
    },
    "Example": {
      "id": "Example",
      "description": "An example represents a sample conversation between the user and the agent(s).",
      "properties": {
        "invalid": {
          "readOnly": true,
          "description": "Output only. The example may become invalid if referencing resources are deleted. Invalid examples will not be used as few-shot examples.",
          "type": "boolean"
        },
        "name": {
          "description": "Identifier. The unique identifier of the example. Format: `projects/{project}/locations/{location}/apps/{app}/examples/{example}`",
          "type": "string"
        },
        "etag": {
          "description": "Etag used to ensure the object hasn't changed during a read-modify-write operation. If the etag is empty, the update will overwrite any concurrent changes.",
          "type": "string"
        },
        "description": {
          "type": "string",
          "description": "Optional. Human-readable description of the example."
        },
        "createTime": {
          "type": "string",
          "description": "Output only. Timestamp when the example was created.",
          "format": "google-datetime",
          "readOnly": true
        },
        "displayName": {
          "description": "Required. Display name of the example.",
          "type": "string"
        },
        "updateTime": {
          "type": "string",
          "description": "Output only. Timestamp when the example was last updated.",
          "format": "google-datetime",
          "readOnly": true
        },
        "messages": {
          "description": "Optional. The collection of messages that make up the conversation.",
          "items": {
            "$ref": "Message"
          },
          "type": "array"
        },
        "entryAgent": {
          "description": "Optional. The agent that initially handles the conversation. If not specified, the example represents a conversation that is handled by the root agent. Format: `projects/{project}/locations/{location}/apps/{app}/agents/{agent}`",
          "type": "string"
        }
      },
      "type": "object"
    },
    "CancelAssistantTurnRequest": {
      "description": "Request to cancel an assistant session's in-flight turn.",
      "properties": {
        "turnId": {
          "type": "string",
          "description": "Optional. The turn to cancel; empty cancels whichever turn is running. A cancel naming a turn that is no longer the running one is a no-op."
        }
      },
      "id": "CancelAssistantTurnRequest",
      "type": "object"
    },
    "OutputAudioConfig": {
      "type": "object",
      "description": "OutputAudioConfig configures how the CES agent should synthesize outgoing audio responses.",
      "id": "OutputAudioConfig",
      "properties": {
        "audioEncoding": {
          "enumDescriptions": [
            "Unspecified audio encoding.",
            "16-bit linear PCM audio encoding.",
            "8-bit samples that compand 14-bit audio samples using G.711 PCMU/mu-law.",
            "8-bit samples that compand 14-bit audio samples using G.711 PCMU/A-law."
          ],
          "type": "string",
          "enum": [
            "AUDIO_ENCODING_UNSPECIFIED",
            "LINEAR16",
            "MULAW",
            "ALAW"
          ],
          "description": "Required. The encoding of the output audio data."
        },
        "sampleRateHertz": {
          "type": "integer",
          "format": "int32",
          "description": "Required. The sample rate (in Hertz) of the output audio data."
        }
      }
    },
    "LatencyReportLatencyMetrics": {
      "type": "object",
      "id": "LatencyReportLatencyMetrics",
      "description": "Latency metrics for a component.",
      "properties": {
        "p90Latency": {
          "readOnly": true,
          "description": "Output only. The 90th percentile latency.",
          "type": "string",
          "format": "google-duration"
        },
        "p50Latency": {
          "readOnly": true,
          "type": "string",
          "format": "google-duration",
          "description": "Output only. The 50th percentile latency."
        },
        "callCount": {
          "description": "Output only. The number of times the resource was called.",
          "format": "int32",
          "type": "integer",
          "readOnly": true
        },
        "p99Latency": {
          "readOnly": true,
          "type": "string",
          "format": "google-duration",
          "description": "Output only. The 99th percentile latency."
        }
      }
    },
    "AudioProcessingConfig": {
      "description": "Configuration for how the input and output audio should be processed and delivered.",
      "properties": {
        "customVoiceSamples": {
          "items": {
            "$ref": "CustomVoiceSample"
          },
          "type": "array",
          "description": "Optional. Configures custom voice samples for voice cloning."
        },
        "inactivityTimeout": {
          "type": "string",
          "format": "google-duration",
          "description": "Optional. The duration of user inactivity (no speech or interaction) before the agent prompts the user for reengagement. If not set, the agent will not prompt the user for reengagement."
        },
        "ambientSoundConfig": {
          "description": "Optional. Configuration for the ambient sound to be played with the synthesized agent response, to enhance the naturalness of the conversation.",
          "$ref": "AmbientSoundConfig"
        },
        "bargeInConfig": {
          "description": "Optional. Configures the agent behavior for the user barge-in activities.",
          "$ref": "BargeInConfig"
        },
        "synthesizeSpeechConfigs": {
          "type": "object",
          "description": "Optional. Configuration of how the agent response should be synthesized, mapping from the language code to SynthesizeSpeechConfig. If the configuration for the specified language code is not found, the configuration for the root language code will be used. For example, if the map contains \"en-us\" and \"en\", and the specified language code is \"en-gb\", then \"en\" configuration will be used. Note: Language code is case-insensitive.",
          "additionalProperties": {
            "$ref": "SynthesizeSpeechConfig"
          }
        }
      },
      "type": "object",
      "id": "AudioProcessingConfig"
    },
    "ChannelProfileInstagramConfig": {
      "properties": {
        "displayName": {
          "type": "string",
          "description": "Output only. The fetched Meta business page name.",
          "readOnly": true
        },
        "description": {
          "readOnly": true,
          "description": "Output only. The description of the Meta business page or profile.",
          "type": "string"
        },
        "thumbnailUrl": {
          "readOnly": true,
          "description": "Output only. The fetched Meta business profile thumbnail URL.",
          "type": "string"
        },
        "instagramAccountId": {
          "description": "Required. The Instagram Account ID.",
          "type": "string"
        }
      },
      "description": "Configuration specific to Instagram deployments.",
      "id": "ChannelProfileInstagramConfig",
      "type": "object"
    },
    "DataStoreToolSummarizationConfig": {
      "properties": {
        "prompt": {
          "type": "string",
          "description": "Optional. The prompt definition. If not set, default prompt will be used."
        },
        "modelSettings": {
          "$ref": "ModelSettings",
          "description": "Optional. Configurations for the LLM model."
        },
        "disabled": {
          "description": "Optional. Whether summarization is disabled.",
          "type": "boolean"
        }
      },
      "id": "DataStoreToolSummarizationConfig",
      "type": "object",
      "description": "Summarization configuration."
    },
    "PythonFunction": {
      "id": "PythonFunction",
      "description": "A Python function tool.",
      "properties": {
        "pythonCode": {
          "description": "Optional. The Python code to execute for the tool.",
          "type": "string"
        },
        "description": {
          "description": "Output only. The description of the Python function, parsed from the python code's docstring.",
          "type": "string",
          "readOnly": true
        },
        "name": {
          "description": "Optional. The name of the Python function to execute. Must match a Python function name defined in the python code. Case sensitive. If the name is not provided, the first function defined in the python code will be used.",
          "type": "string"
        },
        "serviceDirectoryConfig": {
          "description": "Optional. Service Directory configuration for the tool.",
          "$ref": "ServiceDirectoryConfig"
        }
      },
      "type": "object"
    },
    "TurnHandoffEvent": {
      "description": "Emitted before this task stops serving the stream mid-turn (e.g. a server restart). The turn's state is persisted; a reconnect carrying resume_from_sequence_number continues it on another task.",
      "properties": {
        "turnId": {
          "description": "Identifies the turn to resume.",
          "type": "string"
        },
        "reason": {
          "enumDescriptions": [
            "Unspecified.",
            "The serving task is shutting down (release push or rescheduling)."
          ],
          "type": "string",
          "enum": [
            "REASON_UNSPECIFIED",
            "SERVER_RESTART"
          ],
          "description": "Why the stream is handing off."
        }
      },
      "type": "object",
      "id": "TurnHandoffEvent"
    },
    "AssistantConfirmationRequest": {
      "description": "A blocking question or confirmation the assistant needs answered before an agent action can proceed. The requesting agent is paused and resumes only when the answer arrives on a later StreamChatAiAssistantRequest.confirmation_response.",
      "type": "object",
      "properties": {
        "expireTime": {
          "description": "Time after which this confirmation can no longer be answered. An expired card renders as inactive, and the server declines the confirmation on the next turn so the paused agent does not wait indefinitely.",
          "type": "string",
          "format": "google-datetime"
        },
        "agentName": {
          "type": "string",
          "description": "Display label of the agent that raised the confirmation (e.g. `\"Contract Architect\"`), for the card header."
        },
        "context": {
          "type": "string",
          "description": "Context describing what is being confirmed (e.g. the action the agent wants to take, or the question it needs answered). Rendered as plain text, not Markdown."
        },
        "positiveLabel": {
          "description": "Label for the approving action of a binary confirmation (e.g. \"Publish\"). Unset when `questions` is populated.",
          "type": "string"
        },
        "tool": {
          "description": "Name of the tool call the agent paused on (e.g. \"update_app\"), for the card header. Unset for pure questions.",
          "type": "string"
        },
        "questions": {
          "items": {
            "$ref": "OptionQuestionsChunkQuestion"
          },
          "type": "array",
          "description": "Multi-choice form of the confirmation. When populated, the card renders a selectable option list and the chosen option's submit_text (or free-form user text) is returned as AssistantConfirmationResponse.answer_text."
        },
        "confirmationId": {
          "description": "Identifier correlating this request with its response. Opaque to clients; must be echoed verbatim on the answering request.",
          "type": "string"
        },
        "negativeLabel": {
          "description": "Label for the declining action of a binary confirmation (e.g. \"Not yet\"). Unset when `questions` is populated.",
          "type": "string"
        },
        "targets": {
          "description": "Everything the confirmed action will change, so the console can render \"Update 2 apps\" and one badge per app. Empty for legacy single-target cards.",
          "items": {
            "$ref": "AssistantConfirmationRequestTarget"
          },
          "type": "array"
        }
      },
      "id": "AssistantConfirmationRequest"
    },
    "EvaluationResultGoldenResultTurnReplayResult": {
      "type": "object",
      "properties": {
        "errorInfo": {
          "$ref": "EvaluationErrorInfo",
          "description": "Output only. Information about the error that occurred during this turn.",
          "readOnly": true
        },
        "turnLatency": {
          "format": "google-duration",
          "type": "string",
          "description": "Output only. Duration of the turn.",
          "readOnly": true
        },
        "expectationOutcome": {
          "description": "Output only. The outcome of each expectation.",
          "type": "array",
          "readOnly": true,
          "items": {
            "$ref": "EvaluationResultGoldenExpectationOutcome"
          }
        },
        "toolCallLatencies": {
          "description": "Output only. The latency of each tool call in the turn.",
          "items": {
            "$ref": "EvaluationResultToolCallLatency"
          },
          "readOnly": true,
          "type": "array"
        },
        "toolOrderedInvocationScore": {
          "readOnly": true,
          "description": "Output only. The overall tool ordered invocation score for this turn. This indicates the overall percent of tools from the expected turn that were actually invoked in the expected order.",
          "format": "float",
          "type": "number"
        },
        "overallToolInvocationResult": {
          "readOnly": true,
          "$ref": "EvaluationResultOverallToolInvocationResult",
          "description": "Output only. The result of the overall tool invocation check."
        },
        "spanLatencies": {
          "description": "Output only. The latency of spans in the turn.",
          "items": {
            "$ref": "EvaluationResultSpanLatency"
          },
          "readOnly": true,
          "type": "array"
        },
        "conversation": {
          "readOnly": true,
          "description": "Output only. The conversation that was generated for this turn.",
          "type": "string"
        },
        "semanticSimilarityResult": {
          "description": "Output only. The result of the semantic similarity check.",
          "readOnly": true,
          "$ref": "EvaluationResultSemanticSimilarityResult"
        },
        "hallucinationResult": {
          "readOnly": true,
          "description": "Output only. The result of the hallucination check.",
          "$ref": "EvaluationResultHallucinationResult"
        },
        "toolInvocationScore": {
          "readOnly": true,
          "type": "number",
          "format": "float",
          "description": "Output only. Deprecated. Use OverallToolInvocationResult instead.",
          "deprecated": true
        }
      },
      "description": "The result of running a single turn of the golden conversation.",
      "id": "EvaluationResultGoldenResultTurnReplayResult"
    },
    "ExperimentConfig": {
      "properties": {
        "versionRelease": {
          "$ref": "ExperimentConfigVersionRelease",
          "description": "Optional. Version release for the experiment."
        }
      },
      "description": "Experiment for the deployment.",
      "type": "object",
      "id": "ExperimentConfig"
    },
    "DataStore": {
      "properties": {
        "documentProcessingMode": {
          "enumDescriptions": [
            "Not specified.",
            "Documents are processed as documents.",
            "Documents are converted to chunks."
          ],
          "readOnly": true,
          "enum": [
            "DOCUMENT_PROCESSING_MODE_UNSPECIFIED",
            "DOCUMENTS",
            "CHUNKS"
          ],
          "type": "string",
          "description": "Output only. The document processing mode for the data store connection. Only set for PUBLIC_WEB and UNSTRUCTURED data stores."
        },
        "name": {
          "description": "Required. Full resource name of the DataStore. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}`",
          "type": "string"
        },
        "type": {
          "description": "Output only. The type of the data store. This field is readonly and populated by the server.",
          "readOnly": true,
          "enum": [
            "DATA_STORE_TYPE_UNSPECIFIED",
            "PUBLIC_WEB",
            "UNSTRUCTURED",
            "FAQ",
            "CONNECTOR"
          ],
          "type": "string",
          "enumDescriptions": [
            "Not specified. This value indicates that the data store type is not specified, so it will not be used during search.",
            "A data store that contains public web content.",
            "A data store that contains unstructured private data.",
            "A data store that contains structured data used as FAQ.",
            "A data store that is a connector to a first-party or a third-party service."
          ]
        },
        "displayName": {
          "description": "Output only. The display name of the data store.",
          "type": "string",
          "readOnly": true
        },
        "createTime": {
          "description": "Output only. Timestamp when the data store was created.",
          "readOnly": true,
          "format": "google-datetime",
          "type": "string"
        },
        "connectorConfig": {
          "readOnly": true,
          "$ref": "DataStoreConnectorConfig",
          "description": "Output only. The connector config for the data store connection."
        }
      },
      "id": "DataStore",
      "type": "object",
      "description": "A DataStore resource in Vertex AI Search."
    },
    "AssistantSuggestionLoadSession": {
      "id": "AssistantSuggestionLoadSession",
      "properties": {
        "assistantSessionId": {
          "description": "Identifier of the assistant session to open (the final segment of the AssistantSession resource name).",
          "type": "string"
        }
      },
      "description": "Parameters for the load_session action.",
      "type": "object"
    },
    "DataStoreSettingsEngine": {
      "type": "object",
      "description": "An engine to which the data stores are connected. See Vertex AI Search: https://cloud.google.com/generative-ai-app-builder/docs/enterprise-search-introduction.",
      "properties": {
        "type": {
          "description": "Output only. The type of the engine.",
          "enumDescriptions": [
            "Unspecified engine type.",
            "The SOLUTION_TYPE_SEARCH engine for the app. All connector data stores added to the app will be added to this engine.",
            "Chat engine type. The SOLUTION_TYPE_CHAT engine for the app. All connector data stores added to the app will be added to this engine."
          ],
          "type": "string",
          "enum": [
            "TYPE_UNSPECIFIED",
            "ENGINE_TYPE_SEARCH",
            "ENGINE_TYPE_CHAT"
          ],
          "readOnly": true
        },
        "name": {
          "type": "string",
          "description": "Output only. The resource name of the engine. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}`",
          "readOnly": true
        }
      },
      "id": "DataStoreSettingsEngine"
    },
    "AggregatedMetricsToolCallLatencyMetrics": {
      "properties": {
        "tool": {
          "type": "string",
          "readOnly": true,
          "description": "Output only. The name of the tool."
        },
        "averageLatency": {
          "type": "string",
          "description": "Output only. The average latency of the tool calls.",
          "format": "google-duration",
          "readOnly": true
        }
      },
      "description": "Metrics for tool call latency.",
      "type": "object",
      "id": "AggregatedMetricsToolCallLatencyMetrics"
    },
    "EvaluationResultHallucinationResult": {
      "type": "object",
      "description": "The result of the hallucination check for a single turn.",
      "properties": {
        "score": {
          "readOnly": true,
          "format": "int32",
          "type": "integer",
          "description": "Output only. The hallucination score. Can be -1, 0, 1."
        },
        "explanation": {
          "description": "Output only. The explanation for the hallucination score.",
          "type": "string",
          "readOnly": true
        },
        "label": {
          "description": "Output only. The label associated with each score. Score 1: Justified Score 0: Not Justified Score -1: No Claim To Assess",
          "readOnly": true,
          "type": "string"
        }
      },
      "id": "EvaluationResultHallucinationResult"
    },
    "EvaluationMetricsThresholds": {
      "properties": {
        "scenarioHallucinationMetricBehavior": {
          "type": "string",
          "enum": [
            "HALLUCINATION_METRIC_BEHAVIOR_UNSPECIFIED",
            "DISABLED",
            "ENABLED"
          ],
          "description": "Optional. The hallucination metric behavior for scenario evaluations.",
          "enumDescriptions": [
            "Unspecified hallucination metric behavior.",
            "Disable hallucination metric.",
            "Enable hallucination metric."
          ]
        },
        "goldenEvaluationMetricsThresholds": {
          "description": "Optional. The golden evaluation metrics thresholds.",
          "$ref": "EvaluationMetricsThresholdsGoldenEvaluationMetricsThresholds"
        },
        "goldenHallucinationMetricBehavior": {
          "description": "Optional. The hallucination metric behavior for golden evaluations.",
          "enumDescriptions": [
            "Unspecified hallucination metric behavior.",
            "Disable hallucination metric.",
            "Enable hallucination metric."
          ],
          "type": "string",
          "enum": [
            "HALLUCINATION_METRIC_BEHAVIOR_UNSPECIFIED",
            "DISABLED",
            "ENABLED"
          ]
        },
        "hallucinationMetricBehavior": {
          "description": "Optional. Deprecated: Use `golden_hallucination_metric_behavior` instead. The hallucination metric behavior is currently used for golden evaluations.",
          "type": "string",
          "enumDescriptions": [
            "Unspecified hallucination metric behavior.",
            "Disable hallucination metric.",
            "Enable hallucination metric."
          ],
          "deprecated": true,
          "enum": [
            "HALLUCINATION_METRIC_BEHAVIOR_UNSPECIFIED",
            "DISABLED",
            "ENABLED"
          ]
        }
      },
      "description": "Threshold settings for metrics in an Evaluation.",
      "id": "EvaluationMetricsThresholds",
      "type": "object"
    },
    "ListAppVersionsResponse": {
      "properties": {
        "nextPageToken": {
          "description": "A token that can be sent as ListAppVersionsRequest.page_token to retrieve the next page. Absence of this field indicates there are no subsequent pages.",
          "type": "string"
        },
        "appVersions": {
          "items": {
            "$ref": "AppVersion"
          },
          "description": "The list of app versions.",
          "type": "array"
        }
      },
      "description": "Response message for AgentService.ListAppVersions.",
      "type": "object",
      "id": "ListAppVersionsResponse"
    },
    "DataStoreToolBoostSpec": {
      "properties": {
        "conditionBoostSpecs": {
          "type": "array",
          "items": {
            "$ref": "DataStoreToolBoostSpecConditionBoostSpec"
          },
          "description": "Required. A list of boosting specifications."
        }
      },
      "type": "object",
      "description": "Boost specification to boost certain documents.",
      "id": "DataStoreToolBoostSpec"
    },
    "EvaluationMetricsConfigScenarioMetricsConfig": {
      "description": "Configuration for the scenario metrics for the evaluation.",
      "properties": {
        "expectationsMetMetricsConfig": {
          "$ref": "EvaluationMetricsConfigExpectationsMetMetricsConfig",
          "description": "Optional. Configuration for expectation level metrics."
        },
        "userGoalMetMetricsConfig": {
          "$ref": "EvaluationMetricsConfigUserGoalMetMetricsConfig",
          "description": "Optional. Configuration for user goal met metrics."
        }
      },
      "id": "EvaluationMetricsConfigScenarioMetricsConfig",
      "type": "object"
    },
    "ExperimentConfigVersionRelease": {
      "id": "ExperimentConfigVersionRelease",
      "type": "object",
      "properties": {
        "state": {
          "enumDescriptions": [
            "Unspecified state.",
            "Deprecated: This state is no longer used.",
            "Running state. Experiment is running and valid.",
            "Deprecated: This state is no longer used.",
            "Deprecated: This state is no longer used."
          ],
          "type": "string",
          "enum": [
            "STATE_UNSPECIFIED",
            "PENDING",
            "RUNNING",
            "DONE",
            "EXPIRED"
          ],
          "description": "Optional. State of the version release."
        },
        "trafficAllocations": {
          "description": "Optional. Traffic allocations for the version release. When non-empty, the `traffic_percentage` values across all allocations must sum to `100`, representing the split of remaining non-study traffic.",
          "items": {
            "$ref": "ExperimentConfigVersionReleaseTrafficAllocation"
          },
          "type": "array"
        }
      },
      "description": "Version release for the experiment."
    },
    "EvaluationMetricsThresholdsGoldenEvaluationMetricsThresholdsExpectationLevelMetricsThresholds": {
      "description": "Expectation level metrics thresholds.",
      "properties": {
        "toolInvocationParameterCorrectnessThreshold": {
          "type": "number",
          "description": "Optional. The success threshold for individual tool invocation parameter correctness. Must be a float between 0 and 1. Default is 1.0.",
          "format": "float"
        }
      },
      "id": "EvaluationMetricsThresholdsGoldenEvaluationMetricsThresholdsExpectationLevelMetricsThresholds",
      "type": "object"
    },
    "DataStoreTool": {
      "type": "object",
      "id": "DataStoreTool",
      "properties": {
        "dataStoreSource": {
          "$ref": "DataStoreToolDataStoreSource",
          "description": "Optional. Search within a single specific DataStore."
        },
        "name": {
          "description": "Required. The data store tool name.",
          "type": "string"
        },
        "description": {
          "type": "string",
          "description": "Optional. The tool description."
        },
        "modalityConfigs": {
          "items": {
            "$ref": "DataStoreToolModalityConfig"
          },
          "description": "Optional. The modality configs for the data store.",
          "type": "array"
        },
        "engineSource": {
          "description": "Optional. Search within an Engine (potentially across multiple DataStores).",
          "$ref": "DataStoreToolEngineSource"
        },
        "boostSpecs": {
          "type": "array",
          "items": {
            "$ref": "DataStoreToolBoostSpecs"
          },
          "description": "Optional. Boost specification to boost certain documents."
        },
        "filterParameterBehavior": {
          "description": "Optional. The filter parameter behavior.",
          "type": "string",
          "enum": [
            "FILTER_PARAMETER_BEHAVIOR_UNSPECIFIED",
            "ALWAYS_INCLUDE",
            "NEVER_INCLUDE"
          ],
          "enumDescriptions": [
            "Default filter behavior. Include filter parameter for connector datastores. For the rest of the datastore types, the filter input parameter is omitted.",
            "Always include filter parameter for all datastore types.",
            "The filter parameter is never included in the list of tool parameters, regardless of the datastore type."
          ]
        }
      },
      "description": "Tool to retrieve from Vertex AI Search datastore or engine for grounding. Accepts either a datastore or an engine, but not both. See Vertex AI Search: https://cloud.google.com/generative-ai-app-builder/docs/enterprise-search-introduction."
    },
    "LfA2aV1TaskStatus": {
      "type": "object",
      "description": "A container for the status of a task",
      "id": "LfA2aV1TaskStatus",
      "properties": {
        "message": {
          "$ref": "LfA2aV1Message",
          "description": "A message associated with the status."
        },
        "timestamp": {
          "type": "string",
          "format": "google-datetime",
          "description": "ISO 8601 Timestamp when the status was recorded. Example: \"2023-10-27T10:00:00Z\""
        },
        "state": {
          "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."
          ],
          "description": "Required. The current state of this task.",
          "type": "string",
          "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"
          ]
        }
      }
    },
    "AssistantSuggestion": {
      "description": "A single personalized onboarding suggestion chip for Arc's zero state.",
      "properties": {
        "label": {
          "description": "Chip label shown to the user (at most 60 characters).",
          "type": "string"
        },
        "suggestionId": {
          "description": "Stable identifier for this suggestion, round-tripped by clients in interaction logging.",
          "type": "string"
        },
        "rationale": {
          "type": "string",
          "description": "Optional short explanation of why this suggestion is shown (tooltip / rationale popover)."
        },
        "loadSession": {
          "description": "Open an existing assistant session.",
          "$ref": "AssistantSuggestionLoadSession"
        },
        "icon": {
          "type": "string",
          "enum": [
            "ICON_UNSPECIFIED",
            "RESUME",
            "BUILD",
            "EVALUATE",
            "DEPLOY",
            "EXPLORE",
            "FIX"
          ],
          "description": "Icon hint for the chip.",
          "enumDescriptions": [
            "Unspecified icon.",
            "Resume a previous session.",
            "Build something new.",
            "Evaluation-related suggestion.",
            "Deployment-related suggestion.",
            "Exploration / discovery suggestion.",
            "Fix an error or failing state."
          ]
        },
        "sendMessage": {
          "description": "Prefill the composer with this text and submit immediately. Only used for quick-reply chips inside an active onboarding conversation.",
          "type": "string"
        },
        "candidateType": {
          "description": "Rule-table candidate type in kebab-case (e.g. \"resume-pending-review\"), for metrics.",
          "type": "string"
        },
        "source": {
          "type": "string",
          "enum": [
            "SOURCE_UNSPECIFIED",
            "RULE",
            "LLM_RANKED"
          ],
          "enumDescriptions": [
            "Unspecified source.",
            "Deterministic rule-table candidate with template phrasing.",
            "Rule-table candidate re-ranked and phrased by the LLM phrasing step."
          ],
          "description": "How this suggestion was produced."
        },
        "seedPrompt": {
          "description": "Prefill the composer with this text; the user reviews and sends.",
          "type": "string"
        }
      },
      "type": "object",
      "id": "AssistantSuggestion"
    },
    "CustomVoiceSampleWarning": {
      "type": "object",
      "description": "A warning message encountered during voice sample processing.",
      "id": "CustomVoiceSampleWarning",
      "properties": {
        "message": {
          "type": "string",
          "description": "Output only. A human-readable description of the warning.",
          "readOnly": true
        },
        "type": {
          "enum": [
            "WARNING_TYPE_UNSPECIFIED",
            "LOW_AUDIO_LEVEL"
          ],
          "description": "Output only. The type of the warning.",
          "enumDescriptions": [
            "Unspecified warning type.",
            "The audio level of the voice sample is too low (e.g. low RMS amplitude)."
          ],
          "type": "string",
          "readOnly": true
        }
      }
    },
    "Guardrail": {
      "description": "Guardrail contains a list of checks and balances to keep the agents safe and secure.",
      "id": "Guardrail",
      "properties": {
        "description": {
          "description": "Optional. Description of the guardrail.",
          "type": "string"
        },
        "codeCallback": {
          "description": "Optional. Guardrail that potentially blocks the conversation based on the result of the callback execution.",
          "$ref": "GuardrailCodeCallback"
        },
        "supervisor": {
          "$ref": "GuardrailSupervisor",
          "description": "Optional. Guardrail that runs supervisor intervention."
        },
        "updateTime": {
          "format": "google-datetime",
          "readOnly": true,
          "description": "Output only. Timestamp when the guardrail was last updated.",
          "type": "string"
        },
        "etag": {
          "description": "Etag used to ensure the object hasn't changed during a read-modify-write operation. If the etag is empty, the update will overwrite any concurrent changes.",
          "type": "string"
        },
        "createTime": {
          "description": "Output only. Timestamp when the guardrail was created.",
          "readOnly": true,
          "format": "google-datetime",
          "type": "string"
        },
        "llmPolicy": {
          "description": "Optional. Guardrail that blocks the conversation if the LLM response is considered violating the policy based on the LLM classification.",
          "$ref": "GuardrailLlmPolicy"
        },
        "modelSafety": {
          "description": "Optional. Guardrail that blocks the conversation if the LLM response is considered unsafe based on the model safety settings.",
          "$ref": "GuardrailModelSafety"
        },
        "displayName": {
          "type": "string",
          "description": "Required. Display name of the guardrail."
        },
        "llmPromptSecurity": {
          "description": "Optional. Guardrail that blocks the conversation if the prompt is considered unsafe based on the LLM classification.",
          "$ref": "GuardrailLlmPromptSecurity"
        },
        "enabled": {
          "type": "boolean",
          "description": "Optional. Whether the guardrail is enabled."
        },
        "name": {
          "type": "string",
          "description": "Identifier. The unique identifier of the guardrail. Format: `projects/{project}/locations/{location}/apps/{app}/guardrails/{guardrail}`"
        },
        "contentFilter": {
          "$ref": "GuardrailContentFilter",
          "description": "Optional. Guardrail that bans certain content from being used in the conversation."
        },
        "action": {
          "$ref": "TriggerAction",
          "description": "Optional. Action to take when the guardrail is triggered."
        }
      },
      "type": "object"
    },
    "WebSearchQuery": {
      "id": "WebSearchQuery",
      "type": "object",
      "description": "Represents a single web search query and its associated search uri.",
      "properties": {
        "query": {
          "description": "The search query text.",
          "type": "string"
        },
        "uri": {
          "type": "string",
          "description": "The URI to the Google Search results page for the query."
        }
      }
    },
    "DataStoreToolModalityConfig": {
      "id": "DataStoreToolModalityConfig",
      "type": "object",
      "properties": {
        "modalityType": {
          "description": "Required. The modality type.",
          "type": "string",
          "enum": [
            "MODALITY_TYPE_UNSPECIFIED",
            "TEXT",
            "AUDIO"
          ],
          "enumDescriptions": [
            "Unspecified modality type.",
            "Text modality.",
            "Audio modality."
          ]
        },
        "snippetsConfig": {
          "description": "Optional. The snippets configuration.",
          "$ref": "DataStoreToolSnippetsConfig"
        },
        "rewriterConfig": {
          "description": "Optional. The rewriter config.",
          "$ref": "DataStoreToolRewriterConfig"
        },
        "groundingConfig": {
          "description": "Optional. The grounding configuration.",
          "$ref": "DataStoreToolGroundingConfig"
        },
        "summarizationConfig": {
          "description": "Optional. The summarization config.",
          "$ref": "DataStoreToolSummarizationConfig"
        }
      },
      "description": "If specified, will apply the given configuration for the specified modality."
    },
    "BatchDeleteConversationsResponse": {
      "type": "object",
      "properties": {
        "deletedConversations": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "The list of conversations that were successfully deleted."
        },
        "errorMessages": {
          "description": "Optional. A list of error messages associated with conversations that failed to be deleted.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "failedConversations": {
          "description": "The list of conversations that failed to be deleted.",
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "id": "BatchDeleteConversationsResponse",
      "description": "Response message for AgentService.BatchDeleteConversations."
    },
    "Changelog": {
      "type": "object",
      "properties": {
        "dependentResources": {
          "readOnly": true,
          "items": {
            "additionalProperties": {
              "type": "any",
              "description": "Properties of the object."
            },
            "type": "object"
          },
          "type": "array",
          "description": "Output only. The dependent resources that were changed."
        },
        "name": {
          "description": "Identifier. The unique identifier of the changelog. Format: `projects/{project}/locations/{location}/apps/{app}/changelogs/{changelog}`",
          "type": "string"
        },
        "action": {
          "description": "Output only. The action that was performed on the resource.",
          "type": "string",
          "readOnly": true
        },
        "createTime": {
          "format": "google-datetime",
          "type": "string",
          "description": "Output only. The time when the change was made.",
          "readOnly": true
        },
        "resource": {
          "type": "string",
          "readOnly": true,
          "description": "Output only. The resource that was changed."
        },
        "description": {
          "description": "Output only. Description of the change. which typically captures the changed fields in the resource.",
          "readOnly": true,
          "type": "string"
        },
        "resourceType": {
          "readOnly": true,
          "description": "Output only. The type of the resource that was changed.",
          "type": "string"
        },
        "originalResource": {
          "type": "object",
          "readOnly": true,
          "additionalProperties": {
            "type": "any",
            "description": "Properties of the object."
          },
          "description": "Output only. The original resource before the change."
        },
        "displayName": {
          "description": "Output only. Display name of the change. It typically should be the display name of the resource that was changed.",
          "readOnly": true,
          "type": "string"
        },
        "author": {
          "type": "string",
          "readOnly": true,
          "description": "Output only. Email address of the change author."
        },
        "sequenceNumber": {
          "readOnly": true,
          "description": "Output only. The monotonically increasing sequence number of the changelog.",
          "type": "string",
          "format": "int64"
        },
        "newResource": {
          "readOnly": true,
          "description": "Output only. The new resource after the change.",
          "type": "object",
          "additionalProperties": {
            "type": "any",
            "description": "Properties of the object."
          }
        }
      },
      "id": "Changelog",
      "description": "Changelogs represent a change made to the app or to an resource within the app."
    },
    "MetricAnalysisSettings": {
      "properties": {
        "llmMetricsOptedOut": {
          "type": "boolean",
          "description": "Optional. Whether to collect conversation data for llm analysis metrics. If true, conversation data will not be collected for llm analysis metrics; otherwise, conversation data will be collected."
        }
      },
      "id": "MetricAnalysisSettings",
      "type": "object",
      "description": "Settings to describe the conversation data collection behaviors for LLM analysis metrics pipeline."
    },
    "LfA2aV1AgentInterface": {
      "type": "object",
      "id": "LfA2aV1AgentInterface",
      "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.",
      "properties": {
        "tenant": {
          "description": "Optional. An opaque string used for routing requests to a specific agent or tenant when multiple agents are served behind a single A2A endpoint. When set, clients MUST include this value in the `tenant` field of all request messages sent to this interface. The server is responsible for interpreting the value and routing requests accordingly; the protocol does not define its format or semantics.",
          "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"
        },
        "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"
        },
        "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"
        }
      }
    },
    "GenerateAppResourceResponse": {
      "description": "Response message for AgentService.GenerateAppResource.",
      "id": "GenerateAppResourceResponse",
      "properties": {
        "tools": {
          "$ref": "GenerateAppResourceResponseTools",
          "description": "The list of tools generated by the LLM assistant."
        },
        "toolset": {
          "description": "Toolset generated by the LLM assistant. Supports Open API toolset schema generation.",
          "$ref": "Toolset"
        },
        "evaluations": {
          "$ref": "GenerateAppResourceResponseEvaluations",
          "description": "Evaluations generated by the LLM assistant."
        },
        "agent": {
          "description": "Agent generated by the LLM assistant.",
          "$ref": "Agent"
        },
        "appSnapshot": {
          "$ref": "AppSnapshot",
          "description": "App snapshot generated by the LLM assistant. This snapshot contains the app, agents & tools generated by the LLM assistant."
        },
        "generateResultInfo": {
          "$ref": "GenerateAppResourceResponseGenerateResultInfo",
          "description": "Additional information about the generated result."
        },
        "qualityReport": {
          "description": "The quality report generated by the LLM assistant.",
          "$ref": "QualityReport"
        },
        "appResources": {
          "description": "The app resources generated by the LLM assistant.",
          "$ref": "GenerateAppResourceResponseAppResources"
        }
      },
      "type": "object"
    },
    "LfA2aV1StreamResponse": {
      "description": "A wrapper object used in streaming operations to encapsulate different types of response data.",
      "type": "object",
      "properties": {
        "message": {
          "description": "A Message object containing a message from the agent.",
          "$ref": "LfA2aV1Message"
        },
        "task": {
          "description": "A Task object containing the current state of the task.",
          "$ref": "LfA2aV1Task"
        },
        "statusUpdate": {
          "$ref": "LfA2aV1TaskStatusUpdateEvent",
          "description": "An event indicating a task status update."
        },
        "artifactUpdate": {
          "$ref": "LfA2aV1TaskArtifactUpdateEvent",
          "description": "An event indicating a task artifact update."
        }
      },
      "id": "LfA2aV1StreamResponse"
    },
    "GenerateAppResourceRequestToolGenerationConfig": {
      "type": "object",
      "id": "GenerateAppResourceRequestToolGenerationConfig",
      "properties": {
        "openApiToolsetGenerationConfig": {
          "description": "Optional. The configuration to be used to generate an Open API schema.",
          "$ref": "GenerateAppResourceRequestToolGenerationConfigOpenApiToolsetGenerationConfig"
        },
        "context": {
          "type": "string",
          "description": "Optional. The context which describes the tool to be generated. This can be empty if the tool request & response are provided."
        },
        "fileContexts": {
          "description": "Optional. The files to be used as context.",
          "items": {
            "$ref": "FileContext"
          },
          "type": "array"
        }
      },
      "description": "The configuration to be used to generate a tool."
    },
    "RunSessionResponse": {
      "description": "Response message for SessionService.RunSession.",
      "type": "object",
      "properties": {
        "outputs": {
          "type": "array",
          "description": "Outputs for the session.",
          "items": {
            "$ref": "SessionOutput"
          }
        }
      },
      "id": "RunSessionResponse"
    },
    "Conversation": {
      "type": "object",
      "id": "Conversation",
      "description": "A conversation represents an interaction between an end user and the CES app.",
      "properties": {
        "deployment": {
          "description": "Output only. The deployment of the app used for processing the conversation. Format: `projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}`",
          "readOnly": true,
          "type": "string"
        },
        "channelType": {
          "deprecated": true,
          "enum": [
            "CHANNEL_TYPE_UNSPECIFIED",
            "TEXT",
            "AUDIO",
            "MULTIMODAL"
          ],
          "description": "DEPRECATED. Please use input_types instead.",
          "enumDescriptions": [
            "Unspecified channel type.",
            "The conversation only contains text messages between the end user and the agent.",
            "The conversation contains audio messages between the end user and the agent.",
            "The conversation multi-modal messages (e.g. image) between the end user and the agent."
          ],
          "type": "string"
        },
        "source": {
          "type": "string",
          "readOnly": true,
          "enumDescriptions": [
            "Unspecified source.",
            "The conversation is from the live end user.",
            "The conversation is from the simulator.",
            "The conversation is from the evaluation.",
            "The conversation is from an agent tool. Agent tool runs the agent in a separate session, which is persisted for testing and debugging purposes."
          ],
          "description": "Output only. Indicate the source of the conversation.",
          "enum": [
            "SOURCE_UNSPECIFIED",
            "LIVE",
            "SIMULATOR",
            "EVAL",
            "AGENT_TOOL"
          ]
        },
        "inputTypes": {
          "type": "array",
          "items": {
            "enumDescriptions": [
              "Unspecified input type.",
              "Text input.",
              "Event input.",
              "Audio input.",
              "Image input.",
              "Blob input.",
              "Client function tool response input.",
              "Variables input."
            ],
            "type": "string",
            "enum": [
              "INPUT_TYPE_UNSPECIFIED",
              "INPUT_TYPE_TEXT",
              "INPUT_TYPE_EVENT",
              "INPUT_TYPE_AUDIO",
              "INPUT_TYPE_IMAGE",
              "INPUT_TYPE_BLOB",
              "INPUT_TYPE_TOOL_RESPONSE",
              "INPUT_TYPE_VARIABLES"
            ]
          },
          "readOnly": true,
          "description": "Output only. The input types of the conversation."
        },
        "languageCode": {
          "type": "string",
          "readOnly": true,
          "description": "Output only. The language code of the conversation."
        },
        "entryAgent": {
          "readOnly": true,
          "type": "string",
          "description": "Output only. The agent that initially handles the conversation. If not specified, the conversation is handled by the root agent. Format: `projects/{project}/locations/{location}/apps/{app}/agents/{agent}`"
        },
        "endTime": {
          "readOnly": true,
          "format": "google-datetime",
          "description": "Output only. Timestamp when the conversation was completed.",
          "type": "string"
        },
        "turns": {
          "type": "array",
          "description": "Required. The turns in the conversation.",
          "items": {
            "$ref": "ConversationTurn"
          }
        },
        "name": {
          "description": "Identifier. The unique identifier of the conversation. Format: `projects/{project}/locations/{location}/apps/{app}/conversations/{conversation}`",
          "type": "string"
        },
        "messages": {
          "description": "Deprecated. Use turns instead.",
          "items": {
            "$ref": "Message"
          },
          "type": "array",
          "deprecated": true
        },
        "turnCount": {
          "description": "Output only. The number of turns in the conversation.",
          "format": "int32",
          "readOnly": true,
          "type": "integer"
        },
        "appVersion": {
          "readOnly": true,
          "description": "Output only. The version of the app used for processing the conversation. Format: `projects/{project}/locations/{location}/apps/{app}/versions/{version}`",
          "type": "string"
        },
        "startTime": {
          "type": "string",
          "readOnly": true,
          "format": "google-datetime",
          "description": "Output only. Timestamp when the conversation was created."
        }
      }
    },
    "GenerateAppResourceResponseGenerateResultInfo": {
      "type": "object",
      "description": "This provides additional information about the generated result.",
      "properties": {
        "explanation": {
          "description": "An explanation of the changes in the generated resource.",
          "type": "string"
        }
      },
      "id": "GenerateAppResourceResponseGenerateResultInfo"
    },
    "TurnResumeSnapshot": {
      "properties": {
        "turnId": {
          "description": "Identifies the turn being attached to.",
          "type": "string"
        },
        "orphanDeadlineTime": {
          "type": "string",
          "description": "When the turn will be wound down if no client remains attached.",
          "format": "google-datetime"
        },
        "resolvedSequenceNumber": {
          "description": "The position this snapshot represents. Live events follow with sequence_number strictly greater than this. When lower than the resume_from_sequence_number the client requested, flushed progress lags what the client already rendered: the client must discard its rendered content of this turn beyond this position before applying the snapshot.",
          "format": "int64",
          "type": "string"
        },
        "events": {
          "items": {
            "$ref": "StreamChatAiAssistantResponse"
          },
          "type": "array",
          "description": "Compacted events reconstructing the turn's visible output, in render order, using the same event shapes as live streaming."
        }
      },
      "description": "A compacted replay of an in-flight turn: everything needed to render the turn's visible output so far, plus the position live events continue from.",
      "type": "object",
      "id": "TurnResumeSnapshot"
    },
    "AgentCard": {
      "type": "object",
      "id": "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",
      "properties": {
        "skills": {
          "type": "array",
          "items": {
            "$ref": "AgentSkill"
          },
          "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."
        },
        "supportedInterfaces": {
          "description": "Required. Ordered list of supported interfaces. The first entry is preferred.",
          "type": "array",
          "items": {
            "$ref": "AgentInterface"
          }
        },
        "version": {
          "description": "Required. The version of the agent.",
          "type": "string"
        },
        "description": {
          "type": "string",
          "description": "Required. A description of the agent's domain of action/solution space."
        },
        "name": {
          "description": "Required. A human-readable name for the agent.",
          "type": "string"
        }
      }
    },
    "AgentLlmAgent": {
      "id": "AgentLlmAgent",
      "type": "object",
      "properties": {},
      "description": "Default agent type. The agent uses instructions and callbacks specified in the agent to perform the task using a large language model."
    },
    "GoogleSearchToolPromptConfig": {
      "properties": {
        "voicePrompt": {
          "description": "Optional. Defines the prompt used for the system instructions when interacting with the agent in voice conversations. If not set, default prompt will be used.",
          "type": "string"
        },
        "textPrompt": {
          "description": "Optional. Defines the prompt used for the system instructions when interacting with the agent in chat conversations. If not set, default prompt will be used.",
          "type": "string"
        }
      },
      "id": "GoogleSearchToolPromptConfig",
      "description": "Prompt settings used by the model when processing or summarizing the google search results.",
      "type": "object"
    },
    "AgentTransfer": {
      "id": "AgentTransfer",
      "type": "object",
      "description": "Represents an event indicating the transfer of a conversation to a different agent.",
      "properties": {
        "targetAgent": {
          "description": "Required. The agent to which the conversation is being transferred. The agent will handle the conversation from this point forward. Format: `projects/{project}/locations/{location}/apps/{app}/agents/{agent}`",
          "type": "string"
        },
        "displayName": {
          "description": "Output only. Display name of the agent.",
          "readOnly": true,
          "type": "string"
        }
      }
    },
    "DashboardSettings": {
      "id": "DashboardSettings",
      "properties": {
        "defaultDashboard": {
          "description": "Optional. The resource name of the default Contact Center Insights dashboard associated with the app. This is the dashboard that will be displayed when users navigate to the Monitoring view for the app. Format: `projects/{project}/locations/{location}/dashboards/{dashboard}`",
          "type": "string"
        }
      },
      "type": "object",
      "description": "Settings for dashboards associated with the app, that show up in the Monitoring view."
    },
    "AssistantOutput": {
      "id": "AssistantOutput",
      "description": "The output from the assistant agent.",
      "type": "object",
      "properties": {
        "userResponseSuggestions": {
          "$ref": "UserResponseSuggestions",
          "readOnly": true,
          "description": "Output only. Suggested user responses from the assistant agent."
        },
        "message": {
          "$ref": "AssistantMessage",
          "description": "Required. The response from the assistant agent."
        }
      }
    },
    "AssistantSessionArtifact": {
      "type": "object",
      "description": "A document artifact generated by the assistant within a session, stored as a file in the customer's Cloud Storage bucket.",
      "id": "AssistantSessionArtifact",
      "properties": {
        "id": {
          "description": "Output only. The unique identifier of the artifact within the session.",
          "readOnly": true,
          "type": "string"
        },
        "turnIndex": {
          "format": "int32",
          "type": "integer",
          "readOnly": true,
          "description": "Output only. Index of the message in [AssistantSession.messages] whose turn produced the artifact, for placing the artifact chip when history is restored."
        },
        "createTime": {
          "type": "string",
          "description": "Output only. When the artifact was persisted.",
          "format": "google-datetime",
          "readOnly": true
        },
        "mimeType": {
          "type": "string",
          "description": "Output only. The IANA media type of the artifact content, e.g. \"text/markdown\".",
          "readOnly": true
        },
        "gcsUri": {
          "type": "string",
          "description": "Output only. The Cloud Storage object holding the artifact content. Example: \"gs://{project}-agent-assist-artifacts/agent-assist-generated/1_tdd.md\"",
          "readOnly": true
        },
        "displayName": {
          "description": "Output only. The file name shown to the user, e.g. \"hotel_booking_tdd.md\".",
          "readOnly": true,
          "type": "string"
        }
      }
    },
    "Location": {
      "id": "Location",
      "properties": {
        "name": {
          "description": "Resource name for the location, which may vary between implementations. For example: `\"projects/example-project/locations/us-east1\"`",
          "type": "string"
        },
        "displayName": {
          "description": "The friendly name for this location, typically a nearby city name. For example, \"Tokyo\".",
          "type": "string"
        },
        "metadata": {
          "description": "Service-specific metadata. For example the available capacity at the given location.",
          "additionalProperties": {
            "description": "Properties of the object. Contains field @type with type URL.",
            "type": "any"
          },
          "type": "object"
        },
        "labels": {
          "additionalProperties": {
            "type": "string"
          },
          "description": "Cross-service attributes for the location. For example {\"cloud.googleapis.com/region\": \"us-east1\"}",
          "type": "object"
        },
        "locationId": {
          "description": "The canonical id for this location. For example: `\"us-east1\"`.",
          "type": "string"
        }
      },
      "type": "object",
      "description": "A resource that represents a Google Cloud location."
    },
    "ExportEvaluationResultsResponse": {
      "type": "object",
      "id": "ExportEvaluationResultsResponse",
      "properties": {
        "evaluationResultsContent": {
          "format": "byte",
          "type": "string",
          "description": "The content of the exported Evaluation Results. This will be populated if gcs_uri was not specified in the request."
        },
        "evaluationResultsUri": {
          "description": "The Google Cloud Storage URI folder where the exported Evaluation Results were written. This will be populated if gcs_uri was specified in the request.",
          "type": "string"
        }
      },
      "description": "Response message for EvaluationService.ExportEvaluationResults."
    },
    "DeleteEvaluationRunOperationMetadata": {
      "id": "DeleteEvaluationRunOperationMetadata",
      "description": "Operation metadata for EvaluationService.DeleteEvaluationRun.",
      "type": "object",
      "properties": {}
    },
    "Agent": {
      "type": "object",
      "id": "Agent",
      "properties": {
        "tools": {
          "description": "Optional. List of available tools for the agent. Format: `projects/{project}/locations/{location}/apps/{app}/tools/{tool}`",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "transferRules": {
          "items": {
            "$ref": "TransferRule"
          },
          "type": "array",
          "description": "Optional. Agent transfer rules. If multiple rules match, the first one in the list will be used."
        },
        "beforeAgentCallbacks": {
          "description": "Optional. The callbacks to execute before the agent is called. The provided callbacks are executed sequentially in the exact order they are given in the list. If a callback returns an overridden response, execution stops and any remaining callbacks are skipped.",
          "items": {
            "$ref": "Callback"
          },
          "type": "array"
        },
        "etag": {
          "type": "string",
          "description": "Etag used to ensure the object hasn't changed during a read-modify-write operation. If the etag is empty, the update will overwrite any concurrent changes."
        },
        "llmAgent": {
          "description": "Optional. The default agent type.",
          "$ref": "AgentLlmAgent"
        },
        "updateTime": {
          "format": "google-datetime",
          "readOnly": true,
          "description": "Output only. Timestamp when the agent was last updated.",
          "type": "string"
        },
        "afterModelCallbacks": {
          "description": "Optional. The callbacks to execute after the model is called. If there are multiple calls to the model, the callback will be executed multiple times. The provided callbacks are executed sequentially in the exact order they are given in the list. If a callback returns an overridden response, execution stops and any remaining callbacks are skipped.",
          "items": {
            "$ref": "Callback"
          },
          "type": "array"
        },
        "remoteDialogflowAgent": {
          "description": "Optional. The remote [Dialogflow](https://cloud.google.com/dialogflow/cx/docs/concept/console-conversational-agents) agent to be used for the agent execution. If this field is set, all other agent level properties will be ignored. Note: If the Dialogflow agent is in a different project from the app, you should grant `roles/dialogflow.client` to the CES service agent `service-@gcp-sa-ces.iam.gserviceaccount.com`.",
          "$ref": "AgentRemoteDialogflowAgent"
        },
        "description": {
          "type": "string",
          "description": "Optional. Human-readable description of the agent."
        },
        "instruction": {
          "description": "Optional. Instructions for the LLM model to guide the agent's behavior.",
          "type": "string"
        },
        "createTime": {
          "format": "google-datetime",
          "type": "string",
          "readOnly": true,
          "description": "Output only. Timestamp when the agent was created."
        },
        "remoteA2aAgent": {
          "$ref": "AgentRemoteA2aAgent",
          "description": "Optional. The remote [A2A](https://github.com/a2aproject/A2A) agent to be used for the agent execution."
        },
        "beforeModelCallbacks": {
          "type": "array",
          "items": {
            "$ref": "Callback"
          },
          "description": "Optional. The callbacks to execute before the model is called. If there are multiple calls to the model, the callback will be executed multiple times. The provided callbacks are executed sequentially in the exact order they are given in the list. If a callback returns an overridden response, execution stops and any remaining callbacks are skipped."
        },
        "name": {
          "description": "Identifier. The unique identifier of the agent. Format: `projects/{project}/locations/{location}/apps/{app}/agents/{agent}`",
          "type": "string"
        },
        "generatedSummary": {
          "readOnly": true,
          "type": "string",
          "description": "Output only. If the agent is generated by the LLM assistant, this field contains a descriptive summary of the generation."
        },
        "validationErrors": {
          "description": "Output only. Misconfigurations or errors in the agent that may affect agent quality.",
          "readOnly": true,
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "modelSettings": {
          "description": "Optional. Configurations for the LLM model.",
          "$ref": "ModelSettings"
        },
        "afterToolCallbacks": {
          "type": "array",
          "description": "Optional. The callbacks to execute after the tool is invoked. If there are multiple tool invocations, the callback will be executed multiple times. The provided callbacks are executed sequentially in the exact order they are given in the list. If a callback returns an overridden response, execution stops and any remaining callbacks are skipped.",
          "items": {
            "$ref": "Callback"
          }
        },
        "childAgents": {
          "items": {
            "type": "string"
          },
          "description": "Optional. List of child agents in the agent tree. Format: `projects/{project}/locations/{location}/apps/{app}/agents/{agent}`",
          "type": "array"
        },
        "beforeToolCallbacks": {
          "type": "array",
          "items": {
            "$ref": "Callback"
          },
          "description": "Optional. The callbacks to execute before the tool is invoked. If there are multiple tool invocations, the callback will be executed multiple times. The provided callbacks are executed sequentially in the exact order they are given in the list. If a callback returns an overridden response, execution stops and any remaining callbacks are skipped."
        },
        "afterAgentCallbacks": {
          "items": {
            "$ref": "Callback"
          },
          "description": "Optional. The callbacks to execute after the agent is called. The provided callbacks are executed sequentially in the exact order they are given in the list. If a callback returns an overridden response, execution stops and any remaining callbacks are skipped.",
          "type": "array"
        },
        "toolsets": {
          "type": "array",
          "description": "Optional. List of toolsets for the agent.",
          "items": {
            "$ref": "AgentAgentToolset"
          }
        },
        "displayName": {
          "type": "string",
          "description": "Required. Display name of the agent."
        },
        "guardrails": {
          "items": {
            "type": "string"
          },
          "description": "Optional. List of guardrails for the agent. Format: `projects/{project}/locations/{location}/apps/{app}/guardrails/{guardrail}`",
          "type": "array"
        }
      },
      "description": "An agent acts as the fundamental building block that provides instructions to the Large Language Model (LLM) for executing specific tasks."
    },
    "GenerateChatTokenRequest": {
      "description": "Request message for WidgetService.GenerateChatToken.",
      "id": "GenerateChatTokenRequest",
      "properties": {
        "liveHandoffEnabled": {
          "description": "Optional. Indicates if live handoff is enabled for the session.",
          "type": "boolean"
        },
        "recaptchaToken": {
          "type": "string",
          "description": "Optional. The reCAPTCHA token generated by the client-side chat widget."
        },
        "deployment": {
          "description": "Required. The deployment of the app to use for the session. Format: projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}",
          "type": "string"
        }
      },
      "type": "object"
    },
    "McpTool": {
      "description": "An MCP tool. See https://modelcontextprotocol.io/specification/2025-06-18/server/tools for more details.",
      "id": "McpTool",
      "type": "object",
      "properties": {
        "name": {
          "description": "Required. The name of the MCP tool.",
          "type": "string"
        },
        "serviceDirectoryConfig": {
          "description": "Optional. Service Directory configuration for VPC-SC, used to resolve service names within a perimeter.",
          "$ref": "ServiceDirectoryConfig"
        },
        "outputSchema": {
          "$ref": "Schema",
          "description": "Optional. The schema of the output arguments of the MCP tool."
        },
        "description": {
          "description": "Optional. The description of the MCP tool.",
          "type": "string"
        },
        "serverAddress": {
          "type": "string",
          "description": "Required. The server address of the MCP server, e.g., \"https://example.com/mcp/\". If the server is built with the MCP SDK, the url should be suffixed with \"/mcp/\". Only Streamable HTTP transport based servers are supported. This is the same as the server_address in the McpToolset. See https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http for more details."
        },
        "state": {
          "description": "Output only. The dynamic availability state of the tool on the external server.",
          "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."
          ],
          "enum": [
            "STATE_UNSPECIFIED",
            "ACTIVE",
            "INACTIVE",
            "STALE"
          ],
          "readOnly": true,
          "type": "string"
        },
        "tlsConfig": {
          "description": "Optional. The TLS configuration. Includes the custom server certificates that the client should trust.",
          "$ref": "TlsConfig"
        },
        "inputSchema": {
          "description": "Optional. The schema of the input arguments of the MCP tool.",
          "$ref": "Schema"
        },
        "customHeaders": {
          "type": "object",
          "description": "Optional. The custom headers to send in the request to the MCP server. The values must be in the format `$context.variables.` and can be set in the session variables. See https://docs.cloud.google.com/customer-engagement-ai/conversational-agents/ps/tool/open-api#openapi-injection for more details.",
          "additionalProperties": {
            "type": "string"
          }
        },
        "apiAuthentication": {
          "description": "Optional. Authentication information required to execute the tool against the MCP server. For bearer token authentication, the token applies only to tool execution, not to listing tools. This requires that tools can be listed without authentication.",
          "$ref": "ApiAuthentication"
        },
        "nameOverride": {
          "description": "Optional. The name override of the MCP tool. This is populated if the name was overridden by a Toolset override.",
          "type": "string"
        }
      }
    },
    "CancelAssistantTurnResponse": {
      "id": "CancelAssistantTurnResponse",
      "description": "Response for CancelAssistantTurn.",
      "type": "object",
      "properties": {
        "cancelled": {
          "description": "Whether an in-flight turn was found and asked to stop (directly on this task, or through an epoch preemption for a turn hosted elsewhere).",
          "type": "boolean"
        }
      }
    },
    "LoggingSettings": {
      "type": "object",
      "id": "LoggingSettings",
      "properties": {
        "conversationLoggingSettings": {
          "$ref": "ConversationLoggingSettings",
          "description": "Optional. Settings to describe the conversation logging behaviors for the app."
        },
        "cloudLoggingSettings": {
          "description": "Optional. Settings to describe the Cloud Logging behaviors for the app.",
          "$ref": "CloudLoggingSettings"
        },
        "bigqueryExportSettings": {
          "description": "Optional. Configures the BigQuery export behaviors for the app. The conversation data is subject to redaction as configured in RedactionConfig.",
          "$ref": "BigQueryExportSettings"
        },
        "unredactedBigqueryExportSettings": {
          "$ref": "BigQueryExportSettings",
          "description": "Optional. Configures the BigQuery export behaviors for the app. The unredacted conversation data will be exported to BigQuery tables if it is enabled."
        },
        "redactionConfig": {
          "$ref": "RedactionConfig",
          "description": "Optional. Configuration for how sensitive data should be redacted."
        },
        "unredactedAudioRecordingConfig": {
          "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.",
          "$ref": "AudioRecordingConfig"
        },
        "metricAnalysisSettings": {
          "description": "Optional. Settings to describe the conversation data collection behaviors for the LLM analysis pipeline for the app.",
          "$ref": "MetricAnalysisSettings"
        },
        "evaluationAudioRecordingConfig": {
          "$ref": "AudioRecordingConfig",
          "description": "Optional. Configuration for how audio interactions should be recorded for the evaluation. By default, audio recording is not enabled for evaluation sessions."
        },
        "audioRecordingConfig": {
          "description": "Optional. Configuration for how audio interactions should be recorded. The audio is subject to redaction as configured in RedactionConfig.",
          "$ref": "AudioRecordingConfig"
        },
        "requiredRecordingConsent": {
          "description": "Optional. Whether the app has to say what may be recorded before anything is kept. When true, a session starts with recording off and stays off until the client sends SessionInput.recording_control, which then decides every turn from that point on. This covers audio recording as well as conversation history, BigQuery export and Cloud Logging. When `false`, the default, the settings above decide on their own and the client does not have to send anything.",
          "type": "boolean"
        }
      },
      "description": "Settings to describe the logging behaviors for the app."
    },
    "ListEvaluationRunsResponse": {
      "properties": {
        "evaluationRuns": {
          "description": "The list of evaluation runs.",
          "items": {
            "$ref": "EvaluationRun"
          },
          "type": "array"
        },
        "nextPageToken": {
          "type": "string",
          "description": "A token that can be sent as ListEvaluationRunsRequest.page_token to retrieve the next page. Absence of this field indicates there are no subsequent pages."
        }
      },
      "id": "ListEvaluationRunsResponse",
      "type": "object",
      "description": "Response message for EvaluationService.ListEvaluationRuns."
    },
    "Chunk": {
      "properties": {
        "agentTransfer": {
          "$ref": "AgentTransfer",
          "description": "Optional. Agent transfer event."
        },
        "updatedVariables": {
          "description": "A struct represents variables that were updated in the conversation, keyed by variable names.",
          "type": "object",
          "additionalProperties": {
            "description": "Properties of the object.",
            "type": "any"
          }
        },
        "blob": {
          "description": "Optional. Blob data.",
          "$ref": "Blob"
        },
        "toolCall": {
          "description": "Optional. Tool execution request.",
          "$ref": "ToolCall"
        },
        "transcript": {
          "description": "Optional. Transcript associated with the audio.",
          "type": "string"
        },
        "text": {
          "description": "Optional. Text data.",
          "type": "string"
        },
        "payload": {
          "description": "Optional. Custom payload data.",
          "additionalProperties": {
            "description": "Properties of the object.",
            "type": "any"
          },
          "type": "object"
        },
        "toolResponse": {
          "$ref": "ToolResponse",
          "description": "Optional. Tool execution response."
        },
        "defaultVariables": {
          "type": "object",
          "additionalProperties": {
            "type": "any",
            "description": "Properties of the object."
          },
          "description": "A struct represents default variables at the start of the conversation, keyed by variable names."
        },
        "image": {
          "description": "Optional. Image data.",
          "$ref": "Image"
        }
      },
      "description": "A chunk of content within a message.",
      "type": "object",
      "id": "Chunk"
    },
    "McpToolDefinition": {
      "id": "McpToolDefinition",
      "type": "object",
      "description": "Container for a tool's core definition elements that are snapshot. Schemas in the snapshot are used as-is and cannot be overridden.",
      "properties": {
        "outputSchema": {
          "description": "Output only. The schema of the output arguments of the MCP tool.",
          "$ref": "Schema",
          "readOnly": true
        },
        "description": {
          "description": "Output only. The description of the MCP tool. This can be overridden by `description_override` in `McpToolOverride`.",
          "readOnly": true,
          "type": "string"
        },
        "inputSchema": {
          "description": "Output only. The schema of the input arguments of the MCP tool.",
          "readOnly": true,
          "$ref": "Schema"
        }
      }
    },
    "Schema": {
      "properties": {
        "items": {
          "description": "Optional. Schema of the elements of Type.ARRAY.",
          "$ref": "Schema"
        },
        "default": {
          "description": "Optional. Default value of the data.",
          "type": "any"
        },
        "prefixItems": {
          "type": "array",
          "description": "Optional. Schemas of initial elements of Type.ARRAY.",
          "items": {
            "$ref": "Schema"
          }
        },
        "ref": {
          "description": "Optional. Allows indirect references between schema nodes. The value should be a valid reference to a child of the root `defs`. For example, the following schema defines a reference to a schema node named \"Pet\": ``` type: object properties: pet: ref: #/defs/Pet defs: Pet: type: object properties: name: type: string ``` The value of the \"pet\" property is a reference to the schema node named \"Pet\". See details in https://json-schema.org/understanding-json-schema/structuring.",
          "type": "string"
        },
        "enum": {
          "items": {
            "type": "string"
          },
          "description": "Optional. Possible values of the element of primitive type with enum format. Examples: 1. We can define direction as : {type:STRING, format:enum, enum:[\"EAST\", NORTH\", \"SOUTH\", \"WEST\"]} 2. We can define apartment number as : {type:INTEGER, format:enum, enum:[\"101\", \"201\", \"301\"]}",
          "type": "array"
        },
        "defs": {
          "description": "Optional. A map of definitions for use by `ref`. Only allowed at the root of the schema.",
          "additionalProperties": {
            "$ref": "Schema"
          },
          "type": "object"
        },
        "minItems": {
          "description": "Optional. Minimum number of the elements for Type.ARRAY.",
          "format": "int64",
          "type": "string"
        },
        "description": {
          "type": "string",
          "description": "Optional. The description of the data."
        },
        "required": {
          "type": "array",
          "description": "Optional. Required properties of Type.OBJECT.",
          "items": {
            "type": "string"
          }
        },
        "anyOf": {
          "description": "Optional. The value should be validated against any (one or more) of the subschemas in the list.",
          "items": {
            "$ref": "Schema"
          },
          "type": "array"
        },
        "additionalProperties": {
          "$ref": "Schema",
          "description": "Optional. Can either be a boolean or an object, controls the presence of additional properties."
        },
        "type": {
          "enumDescriptions": [
            "Type unspecified.",
            "String type.",
            "Integer type.",
            "Number type.",
            "Boolean type.",
            "Object type.",
            "Array type."
          ],
          "type": "string",
          "enum": [
            "TYPE_UNSPECIFIED",
            "STRING",
            "INTEGER",
            "NUMBER",
            "BOOLEAN",
            "OBJECT",
            "ARRAY"
          ],
          "description": "Required. The type of the data."
        },
        "title": {
          "description": "Optional. The title of the schema.",
          "type": "string"
        },
        "maxItems": {
          "type": "string",
          "description": "Optional. Maximum number of the elements for Type.ARRAY.",
          "format": "int64"
        },
        "minimum": {
          "description": "Optional. Minimum value for Type.INTEGER and Type.NUMBER.",
          "type": "number",
          "format": "double"
        },
        "properties": {
          "description": "Optional. Properties of Type.OBJECT.",
          "additionalProperties": {
            "$ref": "Schema"
          },
          "type": "object"
        },
        "uniqueItems": {
          "description": "Optional. Indicate the items in the array must be unique. Only applies to TYPE.ARRAY.",
          "type": "boolean"
        },
        "nullable": {
          "description": "Optional. Indicates if the value may be null.",
          "type": "boolean"
        },
        "maximum": {
          "description": "Optional. Maximum value for Type.INTEGER and Type.NUMBER.",
          "format": "double",
          "type": "number"
        }
      },
      "description": "Represents a select subset of an OpenAPI 3.0 schema object.",
      "type": "object",
      "id": "Schema"
    },
    "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"
    },
    "AmbientSoundConfig": {
      "description": "Configuration for the ambient sound to be played with the synthesized agent response, to enhance the naturalness of the conversation.",
      "properties": {
        "volumeGainDb": {
          "description": "Optional. Volume gain (in dB) of the normal native volume supported by ambient noise, in the range [-96.0, 16.0]. If unset, or set to a value of 0.0 (dB), will play at normal native signal amplitude. A value of -6.0 (dB) will play at approximately half the amplitude of the normal native signal amplitude. A value of +6.0 (dB) will play at approximately twice the amplitude of the normal native signal amplitude. We strongly recommend not to exceed +10 (dB) as there's usually no effective increase in loudness for any value greater than that.",
          "format": "double",
          "type": "number"
        },
        "prebuiltAmbientNoise": {
          "enum": [
            "PREBUILT_AMBIENT_NOISE_UNSPECIFIED",
            "RETAIL_STORE",
            "CONVENTION_HALL",
            "OUTDOOR"
          ],
          "deprecated": true,
          "description": "Optional. Deprecated: `prebuilt_ambient_noise` is deprecated in favor of `prebuilt_ambient_sound`.",
          "enumDescriptions": [
            "Not specified.",
            "Ambient noise of a retail store.",
            "Ambient noise of a convention hall.",
            "Ambient noise of a street."
          ],
          "type": "string"
        },
        "gcsUri": {
          "type": "string",
          "description": "Optional. Ambient noise as a mono-channel, 16kHz WAV file stored in [Cloud Storage](https://cloud.google.com/storage). Note: Please make sure the CES service agent `service-@gcp-sa-ces.iam.gserviceaccount.com` has `storage.objects.get` permission to the Cloud Storage object."
        },
        "prebuiltAmbientSound": {
          "description": "Optional. Name of the prebuilt ambient sound. Valid values are: - \"coffee_shop\" - \"keyboard\" - \"keypad\" - \"hum\" - \"office_1\" - \"office_2\" - \"office_3\" - \"room_1\" - \"room_2\" - \"room_3\" - \"room_4\" - \"room_5\" - \"air_conditioner\"",
          "type": "string"
        }
      },
      "id": "AmbientSoundConfig",
      "type": "object"
    },
    "LfA2aV1SecurityRequirement": {
      "description": "Defines the security requirements for an agent.",
      "type": "object",
      "properties": {
        "schemes": {
          "additionalProperties": {
            "$ref": "LfA2aV1StringList"
          },
          "type": "object",
          "description": "A map of security schemes to the required scopes."
        }
      },
      "id": "LfA2aV1SecurityRequirement"
    },
    "Citations": {
      "type": "object",
      "properties": {
        "citedChunks": {
          "description": "List of cited pieces of information.",
          "type": "array",
          "items": {
            "$ref": "CitationsCitedChunk"
          }
        },
        "inlineCitations": {
          "items": {
            "$ref": "CitationsInlineCitation"
          },
          "description": "Optional. List of inline citations in the agent response.",
          "type": "array"
        }
      },
      "description": "Citations associated with the agent response.",
      "id": "Citations"
    },
    "EndUserAuthConfigOauth2AuthCodeConfig": {
      "type": "object",
      "id": "EndUserAuthConfigOauth2AuthCodeConfig",
      "properties": {
        "oauthToken": {
          "description": "Required. Oauth token parameter name to pass through. Must be in the format `$context.variables.`.",
          "type": "string"
        }
      },
      "description": "Oauth 2.0 Authorization Code authentication configuration."
    },
    "EvaluationConfig": {
      "type": "object",
      "id": "EvaluationConfig",
      "properties": {
        "outputAudioConfig": {
          "description": "Optional. Configuration for generating the output audio.",
          "$ref": "OutputAudioConfig"
        },
        "inputAudioConfig": {
          "description": "Optional. Configuration for processing the input audio.",
          "$ref": "InputAudioConfig"
        },
        "evaluationChannel": {
          "enumDescriptions": [
            "Unspecified evaluation channel.",
            "Text-only evaluation channel.",
            "Audio evaluation channel."
          ],
          "type": "string",
          "enum": [
            "EVALUATION_CHANNEL_UNSPECIFIED",
            "TEXT",
            "AUDIO"
          ],
          "description": "Optional. The channel to evaluate."
        },
        "toolCallBehaviour": {
          "type": "string",
          "enum": [
            "EVALUATION_TOOL_CALL_BEHAVIOUR_UNSPECIFIED",
            "REAL",
            "FAKE"
          ],
          "enumDescriptions": [
            "Unspecified tool call behavior. Will default to real tool calls.",
            "Use real tool calls.",
            "Use fake tool calls."
          ],
          "description": "Optional. Specifies whether the evaluation should use real tool calls or fake tools."
        }
      },
      "description": "EvaluationConfig configures settings for running the evaluation."
    },
    "ServiceAgentIdTokenAuthConfig": {
      "type": "object",
      "description": "Configurations for authentication with [ID token](https://cloud.google.com/docs/authentication/token-types#id) generated from service agent.",
      "id": "ServiceAgentIdTokenAuthConfig",
      "properties": {}
    },
    "EvaluationResultScenarioResult": {
      "description": "The outcome of a scenario evaluation.",
      "properties": {
        "hallucinationResult": {
          "description": "Output only. The result of the hallucination check. There will be one hallucination result for each turn in the conversation.",
          "readOnly": true,
          "type": "array",
          "items": {
            "$ref": "EvaluationResultHallucinationResult"
          }
        },
        "userFacts": {
          "type": "array",
          "items": {
            "$ref": "EvaluationScenarioUserFact"
          },
          "description": "Output only. The user facts that were used by the scenario for this result.",
          "readOnly": true
        },
        "expectationOutcomes": {
          "readOnly": true,
          "description": "Output only. The outcome of each expectation.",
          "items": {
            "$ref": "EvaluationResultScenarioExpectationOutcome"
          },
          "type": "array"
        },
        "toolCallLatencies": {
          "description": "Output only. The latency of each tool call execution in the conversation.",
          "type": "array",
          "readOnly": true,
          "items": {
            "$ref": "EvaluationResultToolCallLatency"
          }
        },
        "conversation": {
          "readOnly": true,
          "description": "Output only. The conversation that was generated in the scenario.",
          "type": "string"
        },
        "allExpectationsSatisfied": {
          "type": "boolean",
          "readOnly": true,
          "description": "Output only. Whether all expectations were satisfied for this turn."
        },
        "userGoalSatisfactionResult": {
          "readOnly": true,
          "description": "Output only. The result of the user goal satisfaction check.",
          "$ref": "EvaluationResultUserGoalSatisfactionResult"
        },
        "evaluationExpectationResults": {
          "items": {
            "$ref": "EvaluationResultEvaluationExpectationResult"
          },
          "readOnly": true,
          "type": "array",
          "description": "Output only. The results of the evaluation expectations."
        },
        "rubricOutcomes": {
          "description": "Output only. The outcome of the rubric.",
          "items": {
            "$ref": "EvaluationResultScenarioRubricOutcome"
          },
          "readOnly": true,
          "type": "array"
        },
        "task": {
          "type": "string",
          "readOnly": true,
          "description": "Output only. The task that was used when running the scenario for this result."
        },
        "milestoneResults": {
          "items": {
            "$ref": "EvaluationResultScenarioResultMilestoneResult"
          },
          "description": "Output only. The results of each milestone in the scenario.",
          "type": "array",
          "readOnly": true
        },
        "spanLatencies": {
          "items": {
            "$ref": "EvaluationResultSpanLatency"
          },
          "readOnly": true,
          "type": "array",
          "description": "Output only. The latency of spans in the conversation."
        },
        "taskCompletionResult": {
          "$ref": "EvaluationResultTaskCompletionResult",
          "deprecated": true,
          "readOnly": true,
          "description": "Output only. The result of the task completion check."
        },
        "taskCompleted": {
          "type": "boolean",
          "description": "Output only. Whether the task was completed for this turn. This is a composite of all expectations satisfied, no hallucinations, and user goal satisfaction.",
          "readOnly": true
        }
      },
      "id": "EvaluationResultScenarioResult",
      "type": "object"
    },
    "ExportEvaluationRunsResponse": {
      "properties": {
        "evaluationRunsContent": {
          "description": "The content of the exported Evaluation Runs. This will be populated if gcs_uri was not specified in the request.",
          "type": "string",
          "format": "byte"
        },
        "evaluationRunsUri": {
          "type": "string",
          "description": "The Google Cloud Storage URI folder where the exported Evaluation Runs were written. This will be populated if gcs_uri was specified in the request."
        }
      },
      "id": "ExportEvaluationRunsResponse",
      "description": "Response message for EvaluationService.ExportEvaluationRuns.",
      "type": "object"
    },
    "EvaluationResultOverallToolInvocationResult": {
      "properties": {
        "outcome": {
          "description": "Output only. The outcome of the tool invocation check. This is determined by comparing the tool_invocation_score to the overall_tool_invocation_correctness_threshold. If the score is equal to or above the threshold, the outcome will be PASS. Otherwise, the outcome will be FAIL.",
          "type": "string",
          "readOnly": true,
          "enumDescriptions": [
            "Evaluation outcome is not specified.",
            "Evaluation/Expectation passed. In the case of an evaluation, this means that all expectations were met.",
            "Evaluation/Expectation failed. In the case of an evaluation, this means that at least one expectation was not met.",
            "Evaluation/Expectation was skipped."
          ],
          "enum": [
            "OUTCOME_UNSPECIFIED",
            "PASS",
            "FAIL",
            "SKIPPED"
          ]
        },
        "toolInvocationScore": {
          "description": "The overall tool invocation score for this turn. This indicates the overall percent of tools from the expected turn that were actually invoked.",
          "type": "number",
          "format": "float"
        }
      },
      "description": "The result of the overall tool invocation check.",
      "type": "object",
      "id": "EvaluationResultOverallToolInvocationResult"
    },
    "GenerateChatTokenResponse": {
      "description": "Response message for WidgetService.GenerateChatToken.",
      "properties": {
        "chatToken": {
          "description": "The session scoped token for chat widget to authenticate with Session APIs.",
          "type": "string"
        },
        "expireTime": {
          "description": "The time at which the chat token expires.",
          "type": "string",
          "format": "google-datetime"
        }
      },
      "type": "object",
      "id": "GenerateChatTokenResponse"
    },
    "UiEvent": {
      "properties": {
        "mimeType": {
          "type": "string",
          "description": "The media type (MIME type) indicating the format of the UI event payload (e.g., \"application/json+a2ui\")."
        },
        "jsonPayload": {
          "description": "The JSON payload representing the A2UI surface.",
          "type": "string"
        }
      },
      "type": "object",
      "id": "UiEvent",
      "description": "Represents a UI event payload."
    },
    "AggregatedMetricsMetricsByTurn": {
      "description": "Metrics aggregated per turn.",
      "type": "object",
      "properties": {
        "toolCallLatencyMetrics": {
          "readOnly": true,
          "type": "array",
          "items": {
            "$ref": "AggregatedMetricsToolCallLatencyMetrics"
          },
          "description": "Output only. Metrics for tool call latency within this turn."
        },
        "turnLatencyMetrics": {
          "type": "array",
          "items": {
            "$ref": "AggregatedMetricsTurnLatencyMetrics"
          },
          "description": "Output only. Metrics for turn latency within this turn.",
          "readOnly": true
        },
        "semanticSimilarityMetrics": {
          "readOnly": true,
          "type": "array",
          "description": "Output only. Metrics for semantic similarity within this turn.",
          "items": {
            "$ref": "AggregatedMetricsSemanticSimilarityMetrics"
          }
        },
        "hallucinationMetrics": {
          "readOnly": true,
          "description": "Output only. Metrics for hallucination within this turn.",
          "items": {
            "$ref": "AggregatedMetricsHallucinationMetrics"
          },
          "type": "array"
        },
        "turnIndex": {
          "format": "int32",
          "description": "Output only. The turn index (0-based).",
          "readOnly": true,
          "type": "integer"
        },
        "toolMetrics": {
          "readOnly": true,
          "type": "array",
          "description": "Output only. Metrics for each tool within this turn.",
          "items": {
            "$ref": "AggregatedMetricsToolMetrics"
          }
        }
      },
      "id": "AggregatedMetricsMetricsByTurn"
    },
    "ListDeploymentsResponse": {
      "type": "object",
      "id": "ListDeploymentsResponse",
      "properties": {
        "deployments": {
          "items": {
            "$ref": "Deployment"
          },
          "type": "array",
          "description": "The list of deployments."
        },
        "nextPageToken": {
          "type": "string",
          "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages."
        }
      },
      "description": "Response message for AgentService.ListDeployments."
    },
    "GenerateEvaluationRequest": {
      "properties": {
        "evaluationType": {
          "enumDescriptions": [
            "Unspecified type. Defaults to GOLDEN.",
            "Golden evaluation.",
            "Scenario evaluation."
          ],
          "type": "string",
          "enum": [
            "EVALUATION_TYPE_UNSPECIFIED",
            "GOLDEN",
            "SCENARIO"
          ],
          "description": "Optional. The type of evaluation to generate. Defaults to GOLDEN if unspecified."
        },
        "source": {
          "enum": [
            "SOURCE_UNSPECIFIED",
            "LIVE",
            "SIMULATOR",
            "EVAL",
            "AGENT_TOOL"
          ],
          "enumDescriptions": [
            "Unspecified source.",
            "The conversation is from the live end user.",
            "The conversation is from the simulator.",
            "The conversation is from the evaluation.",
            "The conversation is from an agent tool. Agent tool runs the agent in a separate session, which is persisted for testing and debugging purposes."
          ],
          "description": "Optional. Indicate the source of the conversation. If not set, all sources will be searched.",
          "deprecated": true,
          "type": "string"
        }
      },
      "type": "object",
      "description": "Request message for EvaluationService.GenerateEvaluation.",
      "id": "GenerateEvaluationRequest"
    },
    "BatchDeleteConversationsRequest": {
      "type": "object",
      "id": "BatchDeleteConversationsRequest",
      "properties": {
        "conversations": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "description": "Required. The resource names of the conversations to delete."
        }
      },
      "description": "Request message for AgentService.BatchDeleteConversations."
    },
    "QualityReport": {
      "type": "object",
      "properties": {
        "issues": {
          "items": {
            "$ref": "QualityReportAgentIssues"
          },
          "type": "array",
          "description": "Optional. The issues grouped by agent."
        },
        "generalIssues": {
          "items": {
            "$ref": "QualityReportIssue"
          },
          "type": "array",
          "description": "Optional. General issues not specific to any agent."
        },
        "evaluationRuns": {
          "items": {
            "type": "string"
          },
          "description": "Optional. A list of evaluation runs used to generate the quality report. Format: `projects/{project}/locations/{location}/evaluationRuns/{evaluationRun}`.",
          "type": "array"
        }
      },
      "description": "The report describing any identified quality issues in the app.",
      "id": "QualityReport"
    },
    "ListAppsResponse": {
      "id": "ListAppsResponse",
      "type": "object",
      "description": "Response message for AgentService.ListApps.",
      "properties": {
        "apps": {
          "description": "The list of apps.",
          "items": {
            "$ref": "App"
          },
          "type": "array"
        },
        "unreachable": {
          "description": "Unordered list. Locations that could not be reached.",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "nextPageToken": {
          "type": "string",
          "description": "A token that can be sent as ListAppsRequest.page_token to retrieve the next page. Absence of this field indicates there are no subsequent pages."
        }
      }
    },
    "FileContext": {
      "type": "object",
      "id": "FileContext",
      "description": "Files to be used as context. Files can be provided as raw bytes.",
      "properties": {
        "fileBytes": {
          "description": "Optional. File provided as raw bytes.",
          "$ref": "FileContextFileBytes"
        }
      }
    },
    "ChannelProfileWebWidgetConfigSecuritySettings": {
      "id": "ChannelProfileWebWidgetConfigSecuritySettings",
      "type": "object",
      "properties": {
        "allowedOrigins": {
          "description": "Optional. The origins that are allowed to host the web widget. An origin is defined by RFC 6454. If empty, all origins are allowed. A maximum of 100 origins is allowed. Example: \"https://example.com\"",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "enableRecaptcha": {
          "type": "boolean",
          "description": "Optional. Indicates whether reCAPTCHA verification for the web widget is enabled."
        },
        "enablePublicAccess": {
          "type": "boolean",
          "description": "Optional. Indicates whether public access to the web widget is enabled. If `true`, the web widget will be publicly accessible. If `false`, the web widget must be integrated with your own authentication and authorization system to return valid credentials for accessing the CES agent."
        },
        "enableOriginCheck": {
          "type": "boolean",
          "description": "Optional. Indicates whether origin check for the web widget is enabled. If `true`, the web widget will check the origin of the website that loads the web widget and only allow it to be loaded in the same origin or any of the allowed origins."
        }
      },
      "description": "Security settings for the web widget."
    },
    "RunAssistantResponse": {
      "type": "object",
      "properties": {
        "output": {
          "description": "Required. The output from the assistant agent.",
          "$ref": "AssistantOutput"
        },
        "state": {
          "enum": [
            "ASSISTANT_SESSION_STATE_UNSPECIFIED",
            "PROCESSING",
            "IDLE",
            "PENDING_REVIEW"
          ],
          "enumDescriptions": [
            "The default value. This value is used if the status is not specified.",
            "The assistant agent is processing the request as a long running task.",
            "The assistant agent is idle and does not have any pending requests or response.",
            "The assistant agent is done processing a long running task and has a response ready for the user."
          ],
          "readOnly": true,
          "type": "string",
          "description": "Output only. The status of the assistant session."
        }
      },
      "description": "Response message for AssistantService.RunAssistant.",
      "id": "RunAssistantResponse"
    },
    "Action": {
      "id": "Action",
      "type": "object",
      "description": "Configuration of an Action for the tool to use. Note: This can be either an Action or an Operation. See https://cloud.google.com/integration-connectors/docs/entities-operation-action for details.",
      "properties": {
        "entityOperation": {
          "description": "Entity operation configuration for the tool to use.",
          "$ref": "ActionEntityOperation"
        },
        "outputFields": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Optional. Entity fields to return from the operation. If no fields are specified, all fields of the Entity will be returned."
        },
        "connectionActionId": {
          "type": "string",
          "description": "ID of a Connection action for the tool to use."
        },
        "inputFields": {
          "items": {
            "type": "string"
          },
          "description": "Optional. Entity fields to use as inputs for the operation. If no fields are specified, all fields of the Entity will be used.",
          "type": "array"
        }
      }
    },
    "LfA2aV1OAuth2SecurityScheme": {
      "description": "Defines a security scheme using OAuth 2.0.",
      "id": "LfA2aV1OAuth2SecurityScheme",
      "properties": {
        "oauth2MetadataUrl": {
          "description": "URL to the OAuth2 authorization server metadata [RFC 8414](https://datatracker.ietf.org/doc/html/rfc8414). TLS is required.",
          "type": "string"
        },
        "flows": {
          "$ref": "LfA2aV1OAuthFlows",
          "description": "Required. An object containing configuration information for the supported OAuth 2.0 flows."
        },
        "description": {
          "description": "An optional description for the security scheme.",
          "type": "string"
        }
      },
      "type": "object"
    },
    "EvaluationScenario": {
      "id": "EvaluationScenario",
      "description": "The config for a scenario",
      "properties": {
        "maxTurns": {
          "type": "integer",
          "description": "Optional. The maximum number of turns to simulate. The maximum allowed value is 100. The default value is 100.",
          "format": "int32"
        },
        "task": {
          "type": "string",
          "description": "Required. The task to be targeted by the scenario."
        },
        "scenarioExecutionMode": {
          "type": "string",
          "enum": [
            "SCENARIO_EXECUTION_MODE_UNSPECIFIED",
            "QUALITY_OPTIMIZED",
            "SPEED_OPTIMIZED"
          ],
          "description": "Optional. The execution mode for scenario evaluations.",
          "enumDescriptions": [
            "Unspecified execution mode. Defaults to QUALITY_OPTIMIZED.",
            "Quality optimized mode.",
            "Speed optimized mode."
          ]
        },
        "rubrics": {
          "description": "Required. The rubrics to score the scenario against.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "evaluationExpectations": {
          "description": "Optional. The evaluation expectations to evaluate the conversation produced by the simulation against. Format: `projects/{project}/locations/{location}/apps/{app}/evaluationExpectations/{evaluationExpectation}`",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "variableOverrides": {
          "description": "Optional. Variables / Session Parameters as context for the session, keyed by variable names. Members of this struct will override any default values set by the system. Note, these are different from user facts, which are facts known to the user. Variables are parameters known to the agent: i.e. MDN (phone number) passed by the telephony system.",
          "additionalProperties": {
            "type": "any",
            "description": "Properties of the object."
          },
          "type": "object"
        },
        "userFacts": {
          "type": "array",
          "items": {
            "$ref": "EvaluationScenarioUserFact"
          },
          "description": "Optional. The user facts to be used by the scenario."
        },
        "userGoalBehavior": {
          "description": "Optional. The expected behavior of the user goal.",
          "type": "string",
          "enum": [
            "USER_GOAL_BEHAVIOR_UNSPECIFIED",
            "USER_GOAL_SATISFIED",
            "USER_GOAL_REJECTED",
            "USER_GOAL_IGNORED"
          ],
          "enumDescriptions": [
            "Behavior unspecified. Will default to USER_GOAL_SATISFIED.",
            "The user goal should be completed successfully.",
            "The user goal should be rejected.",
            "Ignore the user goal status."
          ]
        },
        "scenarioExpectations": {
          "items": {
            "$ref": "EvaluationScenarioExpectation"
          },
          "type": "array",
          "description": "Required. The ScenarioExpectations to evaluate the conversation produced by the user simulation."
        },
        "milestones": {
          "description": "Optional. The milestones for this scenario.",
          "type": "array",
          "items": {
            "$ref": "EvaluationScenarioMilestone"
          }
        },
        "taskCompletionBehavior": {
          "deprecated": true,
          "type": "string",
          "description": "Optional. Deprecated. Use user_goal_behavior instead.",
          "enum": [
            "TASK_COMPLETION_BEHAVIOR_UNSPECIFIED",
            "TASK_SATISFIED",
            "TASK_REJECTED"
          ],
          "enumDescriptions": [
            "Behavior unspecified. Will default to TASK_SATISFIED.",
            "The user task should be completed successfully.",
            "The user task should be rejected."
          ]
        }
      },
      "type": "object"
    },
    "Image": {
      "type": "object",
      "id": "Image",
      "properties": {
        "data": {
          "type": "string",
          "format": "byte",
          "description": "Required. Raw bytes of the image."
        },
        "altText": {
          "description": "Optional. The alternative text for the image.",
          "type": "string"
        },
        "mimeType": {
          "type": "string",
          "description": "Required. The IANA standard MIME type of the source data. Supported image types includes: * image/png * image/jpeg * image/webp"
        }
      },
      "description": "Represents an image input or output in the conversation."
    },
    "LfA2aV1AgentCard": {
      "type": "object",
      "id": "LfA2aV1AgentCard",
      "description": "A self-describing manifest for an agent. It provides essential metadata including the agent's identity, capabilities, skills, supported communication methods, and security requirements. Next ID: 20",
      "properties": {
        "supportedInterfaces": {
          "description": "Required. Ordered list of supported interfaces. The first entry is preferred.",
          "type": "array",
          "items": {
            "$ref": "LfA2aV1AgentInterface"
          }
        },
        "description": {
          "description": "Required. A human-readable description of the agent, assisting users and other agents in understanding its purpose. Example: \"Agent that helps users with recipes and cooking.\"",
          "type": "string"
        },
        "name": {
          "type": "string",
          "description": "Required. A human readable name for the agent. Example: \"Recipe Agent\""
        },
        "iconUrl": {
          "description": "Optional. A URL to an icon for the agent.",
          "type": "string"
        },
        "version": {
          "description": "Required. The version of the agent. Example: \"1.0.0\"",
          "type": "string"
        },
        "skills": {
          "type": "array",
          "description": "Required. Skills represent the abilities of an agent. It is largely a descriptive concept but represents a more focused set of behaviors that the agent is likely to succeed at.",
          "items": {
            "$ref": "LfA2aV1AgentSkill"
          }
        },
        "defaultInputModes": {
          "type": "array",
          "description": "Required. protolint:enable REPEATED_FIELD_NAMES_PLURALIZED The set of interaction modes that the agent supports across all skills. This can be overridden per skill. Defined as media types.",
          "items": {
            "type": "string"
          }
        },
        "securityRequirements": {
          "type": "array",
          "description": "Security requirements for contacting the agent.",
          "items": {
            "$ref": "LfA2aV1SecurityRequirement"
          }
        },
        "signatures": {
          "items": {
            "$ref": "LfA2aV1AgentCardSignature"
          },
          "type": "array",
          "description": "JSON Web Signatures computed for this `AgentCard`."
        },
        "capabilities": {
          "description": "Required. A2A Capability set supported by the agent.",
          "$ref": "LfA2aV1AgentCapabilities"
        },
        "defaultOutputModes": {
          "description": "Required. The media types supported as outputs from this agent.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "documentationUrl": {
          "description": "A URL providing additional documentation about the agent.",
          "type": "string"
        },
        "securitySchemes": {
          "description": "The security scheme details used for authenticating with this agent.",
          "type": "object",
          "additionalProperties": {
            "$ref": "LfA2aV1SecurityScheme"
          }
        },
        "provider": {
          "$ref": "LfA2aV1AgentProvider",
          "description": "The service provider of the agent."
        }
      }
    },
    "GuardrailModelSafetySafetySetting": {
      "description": "Safety setting.",
      "properties": {
        "threshold": {
          "description": "Required. The harm block threshold.",
          "type": "string",
          "enum": [
            "HARM_BLOCK_THRESHOLD_UNSPECIFIED",
            "BLOCK_LOW_AND_ABOVE",
            "BLOCK_MEDIUM_AND_ABOVE",
            "BLOCK_ONLY_HIGH",
            "BLOCK_NONE",
            "OFF"
          ],
          "enumDescriptions": [
            "Unspecified harm block threshold.",
            "Block low threshold and above (i.e. block more).",
            "Block medium threshold and above.",
            "Block only high threshold (i.e. block less).",
            "Block none.",
            "Turn off the safety filter."
          ]
        },
        "category": {
          "enumDescriptions": [
            "The harm category is unspecified.",
            "The harm category is hate speech.",
            "The harm category is dangerous content.",
            "The harm category is harassment.",
            "The harm category is sexually explicit content.",
            "The harm category is profanity.",
            "The harm category is toxic."
          ],
          "type": "string",
          "enum": [
            "HARM_CATEGORY_UNSPECIFIED",
            "HARM_CATEGORY_HATE_SPEECH",
            "HARM_CATEGORY_DANGEROUS_CONTENT",
            "HARM_CATEGORY_HARASSMENT",
            "HARM_CATEGORY_SEXUALLY_EXPLICIT",
            "HARM_CATEGORY_PROFANITY",
            "HARM_CATEGORY_TOXIC"
          ],
          "description": "Required. The harm category."
        }
      },
      "type": "object",
      "id": "GuardrailModelSafetySafetySetting"
    },
    "StreamChatAiAssistantRequest": {
      "description": "Request message for SessionService.StreamChatAiAssistant.",
      "properties": {
        "operationCompletedEvent": {
          "description": "Optional. Resumes an assistant session paused waiting for a client-managed long-running operation to complete.",
          "$ref": "OperationCompletedEvent"
        },
        "attachOnly": {
          "type": "boolean",
          "description": "Optional. Optional flag to attach to an existing in-flight turn without submitting a new message."
        },
        "attachedGcsUris": {
          "description": "Optional. Cloud Storage URIs for files uploaded by the user during this turn. Example: \"gs://cxas-transient-uploads/uuid/prd.pdf\"",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "clientCapabilities": {
          "type": "array",
          "description": "Optional. Response features this client can render. The server only emits events that need a capability (e.g. `confirmation_request`) when the capability is declared, so older clients never receive events they would silently drop.",
          "items": {
            "type": "string",
            "enum": [
              "CLIENT_CAPABILITY_UNSPECIFIED",
              "CONFIRMATION_CARDS",
              "CLIENT_MANAGED_LRO",
              "PROJECT_SCOPE"
            ],
            "enumDescriptions": [
              "Unspecified capability; ignored.",
              "The client renders AssistantConfirmationRequest cards and answers them via `confirmation_response`.",
              "The client manages long-running operations out-of-band by polling the operation and sending `operation_completed_event` to resume the turn. If not declared, the server manages LRO polling and completes the turn inline.",
              "The client renders project-scope events: `typed_payload` cards, `target_app` on tool calls and responses, `targets` on confirmation requests and `touched_apps` on turn completion."
            ]
          }
        },
        "resumeFromSequenceNumber": {
          "format": "int64",
          "type": "string",
          "description": "Optional. Optional cursor to resume and replay events from an in-flight or completed turn."
        },
        "contextToken": {
          "type": "string",
          "description": "Optional. Opaque onboarding context token returned by SessionService.GenerateOnboardingSuggestions. When set and still fresh, the server reuses the onboarding snapshot computed for the zero state instead of recomputing it for the first conversation turn."
        },
        "message": {
          "description": "Optional. The message to send to the assistant agent. May be empty when `confirmation_response` is set (answering a pending confirmation without adding a new message); at least one of the two must be provided.",
          "type": "string"
        },
        "confirmationResponse": {
          "$ref": "AssistantConfirmationResponse",
          "description": "Optional. The user's answer to a pending AssistantConfirmationRequest. When set, the server resumes the paused agent with this answer instead of (or in addition to) starting a new prompt turn."
        }
      },
      "type": "object",
      "id": "StreamChatAiAssistantRequest"
    },
    "EvaluationMetricsConfigUserGoalMetMetricsConfig": {
      "type": "object",
      "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.",
      "properties": {
        "enableUserGoalMetMetrics": {
          "description": "Optional. Whether to calculate the user goal met metrics for the evaluation.",
          "type": "boolean"
        }
      },
      "id": "EvaluationMetricsConfigUserGoalMetMetricsConfig"
    },
    "ListChangelogsResponse": {
      "description": "Response message for AgentService.ListChangelogs.",
      "type": "object",
      "properties": {
        "changelogs": {
          "description": "The list of changelogs.",
          "type": "array",
          "items": {
            "$ref": "Changelog"
          }
        },
        "nextPageToken": {
          "description": "A token that can be sent as ListChangelogsRequest.page_token to retrieve the next page. Absence of this field indicates there are no subsequent pages.",
          "type": "string"
        }
      },
      "id": "ListChangelogsResponse"
    },
    "ChatAiAssistantRequest": {
      "description": "Request message for AssistantService.ChatAiAssistant.",
      "type": "object",
      "id": "ChatAiAssistantRequest",
      "properties": {
        "attachedGcsUris": {
          "description": "Optional. Cloud Storage URIs for files uploaded by the user during this turn. Example: \"gs://cxas-transient-uploads/uuid/prd.pdf\"",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "assistantSession": {
          "type": "string",
          "description": "Required. The assistant session to be used to run the assistant. Format: `projects/{project}/locations/{location}/apps/{app}/assistantSessions/{assistant_session}`"
        },
        "message": {
          "type": "string",
          "description": "Required. The message to send to the assistant agent."
        },
        "contextToken": {
          "description": "Optional. Opaque onboarding context token returned by SessionService.GenerateOnboardingSuggestions. When set and still fresh, the server reuses the onboarding snapshot computed for the zero state instead of recomputing it for the first conversation turn.",
          "type": "string"
        }
      }
    },
    "TriggerAction": {
      "properties": {
        "respondImmediately": {
          "$ref": "TriggerActionRespondImmediately",
          "description": "Optional. Immediately respond with a preconfigured response."
        },
        "transferAgent": {
          "description": "Optional. Transfer the conversation to a different agent.",
          "$ref": "TriggerActionTransferAgent"
        },
        "generativeAnswer": {
          "$ref": "TriggerActionGenerativeAnswer",
          "description": "Optional. Respond with a generative answer."
        }
      },
      "type": "object",
      "id": "TriggerAction",
      "description": "Action that is taken when a certain precondition is met."
    },
    "DataStoreToolRewriterConfig": {
      "id": "DataStoreToolRewriterConfig",
      "properties": {
        "modelSettings": {
          "$ref": "ModelSettings",
          "description": "Required. Configurations for the LLM model."
        },
        "prompt": {
          "type": "string",
          "description": "Optional. The prompt definition. If not set, default prompt will be used."
        },
        "disabled": {
          "type": "boolean",
          "description": "Optional. Whether the rewriter is disabled."
        }
      },
      "type": "object",
      "description": "Rewriter configuration."
    },
    "ImportAppRequestImportOptions": {
      "id": "ImportAppRequestImportOptions",
      "properties": {
        "validateOnly": {
          "description": "Optional. Flag for dry-running the import process. If set to true, the import process will only perform validations and will not make any changes to the existing app or create a new one.",
          "type": "boolean"
        },
        "conflictResolutionStrategy": {
          "description": "Optional. The strategy to use when resolving conflicts during import.",
          "type": "string",
          "enum": [
            "CONFLICT_RESOLUTION_STRATEGY_UNSPECIFIED",
            "REPLACE",
            "OVERWRITE"
          ],
          "enumDescriptions": [
            "The conflict resolution strategy is unspecified.",
            "Replace existing data with imported data. If an app with the same `app_id` already exists, its content will be updated based on the imported app. - Resources (App, Agents, Tools, Examples, Guardrails, Toolsets) in the imported app that have the same display name as existing resources will overwrite the existing ones. - Imported resources with new display names will be created. - Existing resources that do not have a matching display name in the imported app will remain untouched.",
            "Overwrite existing data with imported data. If an app with the same `app_id` already exists, its content will be overwritten with the imported app. - Existing resources (Agents, Tools, Examples, Guardrails, Toolsets) in the app will be deleted. - Imported resources will be created as new resources."
          ]
        }
      },
      "description": "Configuration options for the app import process. These options control how the import behaves, particularly when conflicts arise with existing app data.",
      "type": "object"
    },
    "McpToolset": {
      "type": "object",
      "properties": {
        "toolOverrides": {
          "type": "array",
          "items": {
            "$ref": "McpToolOverride"
          },
          "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."
        },
        "serviceDirectoryConfig": {
          "description": "Optional. Service Directory configuration for VPC-SC, used to resolve service names within a perimeter.",
          "$ref": "ServiceDirectoryConfig"
        },
        "tlsConfig": {
          "$ref": "TlsConfig",
          "description": "Optional. The TLS configuration. Includes the custom server certificates that the client should trust."
        },
        "apiAuthentication": {
          "$ref": "ApiAuthentication",
          "description": "Optional. Authentication information required to access tools and execute a tool against the MCP server. For bearer token authentication, the token applies only to tool execution, not to listing tools. This requires that tools can be listed without authentication."
        },
        "serverAddress": {
          "description": "Required. The address of the MCP server, for example, \"https://example.com/mcp/\". If the server is built with the MCP SDK, the url should be suffixed with \"/mcp/\". Only Streamable HTTP transport based servers are supported. See https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http for more details.",
          "type": "string"
        },
        "customHeaders": {
          "additionalProperties": {
            "type": "string"
          },
          "type": "object",
          "description": "Optional. The custom headers to send in the request to the MCP server. The values must be in the format `$context.variables.` and can be set in the session variables. See https://docs.cloud.google.com/customer-engagement-ai/conversational-agents/ps/tool/open-api#openapi-injection for more details."
        }
      },
      "description": "A toolset that contains a list of tools that are offered by the MCP server.",
      "id": "McpToolset"
    },
    "GuardrailCodeCallback": {
      "id": "GuardrailCodeCallback",
      "type": "object",
      "properties": {
        "afterModelCallback": {
          "$ref": "Callback",
          "description": "Optional. The callback to execute after the model is called. If there are multiple calls to the model, the callback will be executed multiple times. Each callback function is expected to return a structure (e.g., a dict or object) containing at least: - 'decision': Either 'OK' or 'TRIGGER'. - 'reason': A string explaining the decision. A 'TRIGGER' decision may halt further processing."
        },
        "afterAgentCallback": {
          "$ref": "Callback",
          "description": "Optional. The callback to execute after the agent is called. Each callback function is expected to return a structure (e.g., a dict or object) containing at least: - 'decision': Either 'OK' or 'TRIGGER'. - 'reason': A string explaining the decision. A 'TRIGGER' decision may halt further processing."
        },
        "beforeAgentCallback": {
          "$ref": "Callback",
          "description": "Optional. The callback to execute before the agent is called. Each callback function is expected to return a structure (e.g., a dict or object) containing at least: - 'decision': Either 'OK' or 'TRIGGER'. - 'reason': A string explaining the decision. A 'TRIGGER' decision may halt further processing."
        },
        "beforeModelCallback": {
          "description": "Optional. The callback to execute before the model is called. If there are multiple calls to the model, the callback will be executed multiple times. Each callback function is expected to return a structure (e.g., a dict or object) containing at least: - 'decision': Either 'OK' or 'TRIGGER'. - 'reason': A string explaining the decision. A 'TRIGGER' decision may halt further processing.",
          "$ref": "Callback"
        }
      },
      "description": "Guardrail that blocks the conversation based on the code callbacks provided."
    },
    "ListConversationsResponse": {
      "type": "object",
      "id": "ListConversationsResponse",
      "description": "Response message for AgentService.ListConversations.",
      "properties": {
        "conversations": {
          "description": "The list of conversations.",
          "items": {
            "$ref": "Conversation"
          },
          "type": "array"
        },
        "nextPageToken": {
          "type": "string",
          "description": "A token that can be sent as ListConversationsRequest.page_token to retrieve the next page. Absence of this field indicates there are no subsequent pages."
        }
      }
    },
    "LfA2aV1TaskPushNotificationConfig": {
      "properties": {
        "tenant": {
          "type": "string",
          "description": "Optional. Opaque routing identifier. Must match the `tenant` value from the selected `AgentInterface` in the Agent Card when that field is set."
        },
        "id": {
          "description": "The push notification configuration details. A unique identifier (e.g. UUID) for this push notification configuration.",
          "type": "string"
        },
        "taskId": {
          "type": "string",
          "description": "The ID of the task this configuration is associated with."
        },
        "token": {
          "description": "A token unique for this task or session.",
          "type": "string"
        },
        "authentication": {
          "description": "Authentication information required to send the notification.",
          "$ref": "LfA2aV1AuthenticationInfo"
        },
        "url": {
          "description": "Required. The URL where the notification should be sent.",
          "type": "string"
        }
      },
      "type": "object",
      "description": "A container associating a push notification configuration with a specific task.",
      "id": "LfA2aV1TaskPushNotificationConfig"
    },
    "TransferRuleDeterministicTransfer": {
      "type": "object",
      "id": "TransferRuleDeterministicTransfer",
      "properties": {
        "pythonCodeCondition": {
          "$ref": "PythonCodeCondition",
          "description": "Optional. A rule that uses Python code block to evaluate the conditions. If the condition evaluates to true, the transfer occurs."
        },
        "expressionCondition": {
          "description": "Optional. A rule that evaluates a session state condition. If the condition evaluates to true, the transfer occurs.",
          "$ref": "ExpressionCondition"
        }
      },
      "description": "Deterministic transfer rule. When the condition evaluates to true, the transfer occurs."
    },
    "LfA2aV1AgentExtension": {
      "description": "A declaration of a protocol extension supported by an Agent.",
      "id": "LfA2aV1AgentExtension",
      "type": "object",
      "properties": {
        "description": {
          "description": "A human-readable description of how this agent uses the extension.",
          "type": "string"
        },
        "uri": {
          "type": "string",
          "description": "The unique URI identifying the extension."
        },
        "required": {
          "description": "If true, the client must understand and comply with the extension's requirements.",
          "type": "boolean"
        },
        "params": {
          "additionalProperties": {
            "type": "any",
            "description": "Properties of the object."
          },
          "description": "Optional. Extension-specific configuration parameters.",
          "type": "object"
        }
      }
    },
    "TriggerActionTransferAgent": {
      "properties": {
        "agent": {
          "description": "Required. The name of the agent to transfer the conversation to. The agent must be in the same app as the current agent. Format: `projects/{project}/locations/{location}/apps/{app}/agents/{agent}`",
          "type": "string"
        }
      },
      "id": "TriggerActionTransferAgent",
      "description": "The agent will transfer the conversation to a different agent.",
      "type": "object"
    },
    "LfA2aV1AgentProvider": {
      "type": "object",
      "description": "Represents the service provider of an agent.",
      "properties": {
        "url": {
          "description": "Required. A URL for the agent provider's website or relevant documentation. Example: \"https://ai.google.dev\"",
          "type": "string"
        },
        "organization": {
          "description": "Required. The name of the agent provider's organization. Example: \"Google\"",
          "type": "string"
        }
      },
      "id": "LfA2aV1AgentProvider"
    },
    "ExecuteToolResponse": {
      "id": "ExecuteToolResponse",
      "type": "object",
      "properties": {
        "toolsetTool": {
          "description": "The toolset tool that got executed.",
          "$ref": "ToolsetTool"
        },
        "googleSearchSuggestions": {
          "description": "The suggestions returned from Google Search as a result of invoking the Google Search Tool during the tool execution.",
          "$ref": "GoogleSearchSuggestions"
        },
        "response": {
          "description": "The tool execution result in JSON object format. Use \"output\" key to specify tool response and \"error\" key to specify error details (if any). If \"output\" and \"error\" keys are not specified, then whole \"response\" is treated as tool execution result.",
          "additionalProperties": {
            "type": "any",
            "description": "Properties of the object."
          },
          "type": "object"
        },
        "citations": {
          "$ref": "Citations",
          "description": "Citations that provide the source information for the tool's execution."
        },
        "tool": {
          "type": "string",
          "description": "The name of the tool that got executed. Format: `projects/{project}/locations/{location}/apps/{app}/tools/{tool}`"
        },
        "variables": {
          "description": "The variable values at the end of the tool execution.",
          "additionalProperties": {
            "description": "Properties of the object.",
            "type": "any"
          },
          "type": "object"
        }
      },
      "description": "Response message for ToolService.ExecuteTool."
    },
    "ExportAppRequest": {
      "id": "ExportAppRequest",
      "description": "Request message for AgentService.ExportApp.",
      "properties": {
        "gcsUri": {
          "description": "Optional. The [Google Cloud Storage](https://cloud.google.com/storage/docs/) URI to which to export the app. The format of this URI must be `gs:///`. The exported app archive will be written directly to the specified Cloud Storage object.",
          "type": "string"
        },
        "appVersion": {
          "type": "string",
          "description": "Optional. The resource name of the app version to export. Format: `projects/{project}/locations/{location}/apps/{app}/versions/{version}`."
        },
        "exportFormat": {
          "description": "Required. The format to export the app in.",
          "type": "string",
          "enum": [
            "EXPORT_FORMAT_UNSPECIFIED",
            "JSON",
            "YAML"
          ],
          "enumDescriptions": [
            "The export format is unspecified.",
            "The export format is JSON.",
            "The export format is YAML."
          ]
        }
      },
      "type": "object"
    },
    "DataStoreToolBoostSpecs": {
      "id": "DataStoreToolBoostSpecs",
      "type": "object",
      "description": "Boost specifications to boost certain documents. For more information, please refer to https://cloud.google.com/generative-ai-app-builder/docs/boosting.",
      "properties": {
        "spec": {
          "description": "Required. A list of boosting specifications.",
          "type": "array",
          "items": {
            "$ref": "DataStoreToolBoostSpec"
          }
        },
        "dataStores": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "description": "Required. The Data Store where the boosting configuration is applied. Full resource name of DataStore, such as projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}."
        }
      }
    },
    "LfA2aV1AuthenticationInfo": {
      "id": "LfA2aV1AuthenticationInfo",
      "type": "object",
      "properties": {
        "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"
        },
        "credentials": {
          "type": "string",
          "description": "Push Notification credentials. Format depends on the scheme (e.g., token for Bearer)."
        }
      },
      "description": "Defines authentication details, used for push notifications."
    },
    "EvaluationRunEvaluationRunSummary": {
      "id": "EvaluationRunEvaluationRunSummary",
      "properties": {
        "errorCount": {
          "readOnly": true,
          "format": "int32",
          "description": "Output only. Number of error results for the associated Evaluation in this run.",
          "type": "integer"
        },
        "passedCount": {
          "description": "Output only. Number of passed results for the associated Evaluation in this run.",
          "format": "int32",
          "type": "integer",
          "readOnly": true
        },
        "failedCount": {
          "type": "integer",
          "description": "Output only. Number of failed results for the associated Evaluation in this run.",
          "readOnly": true,
          "format": "int32"
        }
      },
      "type": "object",
      "description": "Contains the summary of passed and failed result counts for a specific evaluation in an evaluation run."
    },
    "AgentInterface": {
      "type": "object",
      "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": {
          "type": "string",
          "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\""
        },
        "tenant": {
          "type": "string",
          "description": "Tenant ID to be used in the request when calling the agent."
        },
        "url": {
          "type": "string",
          "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\""
        }
      },
      "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."
    },
    "ToolFakeConfig": {
      "properties": {
        "codeBlock": {
          "$ref": "CodeBlock",
          "description": "Optional. Code block which will be executed instead of a real tool call."
        },
        "enableFakeMode": {
          "type": "boolean",
          "description": "Optional. Whether the tool is using fake mode."
        }
      },
      "type": "object",
      "id": "ToolFakeConfig",
      "description": "Configuration for tool behavior in fake mode."
    },
    "ConversationLoggingSettings": {
      "properties": {
        "disableConversationLogging": {
          "type": "boolean",
          "description": "Optional. Whether to disable conversation logging for the sessions."
        },
        "retentionWindow": {
          "format": "google-duration",
          "type": "string",
          "description": "Optional. Controls the retention window for the conversation. If not set, the conversation will be retained for 365 days."
        }
      },
      "description": "Settings to describe the conversation logging behaviors for the app.",
      "type": "object",
      "id": "ConversationLoggingSettings"
    },
    "ExportEvaluationsResponse": {
      "properties": {
        "evaluationsUri": {
          "type": "string",
          "description": "The Google Cloud Storage URI folder where the exported evaluations were written. This will be populated if gcs_uri was specified in the request."
        },
        "failedEvaluations": {
          "additionalProperties": {
            "type": "string"
          },
          "readOnly": true,
          "type": "object",
          "description": "Output only. A map of evaluation resource names that could not be exported, to the reason why they failed."
        },
        "evaluationsContent": {
          "type": "string",
          "format": "byte",
          "description": "The content of the exported Evaluations. This will be populated if gcs_uri was not specified in the request."
        }
      },
      "description": "Response message for EvaluationService.ExportEvaluations.",
      "id": "ExportEvaluationsResponse",
      "type": "object"
    },
    "Event": {
      "type": "object",
      "properties": {
        "variables": {
          "description": "Optional. Additional variables associated with the event.",
          "type": "object",
          "additionalProperties": {
            "type": "any",
            "description": "Properties of the object."
          }
        },
        "event": {
          "description": "Required. The name of the event.",
          "type": "string"
        }
      },
      "description": "Event input.",
      "id": "Event"
    },
    "OpenApiTool": {
      "properties": {
        "openApiSchema": {
          "description": "Required. The OpenAPI schema in JSON or YAML format.",
          "type": "string"
        },
        "ignoreUnknownFields": {
          "description": "Optional. If true, the agent will ignore unknown fields in the API response.",
          "type": "boolean"
        },
        "url": {
          "description": "Optional. The server URL of the Open API schema. This field is only set in tools in the environment dependencies during the export process if the schema contains a server url. During the import process, if this url is present in the environment dependencies and the schema has the $env_var placeholder, it will replace the placeholder in the schema.",
          "type": "string"
        },
        "serviceDirectoryConfig": {
          "description": "Optional. Service Directory configuration.",
          "$ref": "ServiceDirectoryConfig"
        },
        "description": {
          "type": "string",
          "description": "Optional. The description of the tool. If not provided, the description of the tool will be derived from the OpenAPI schema, from `operation.description` or `operation.summary`."
        },
        "tlsConfig": {
          "$ref": "TlsConfig",
          "description": "Optional. The TLS configuration. Includes the custom server certificates that the client will trust."
        },
        "apiAuthentication": {
          "description": "Optional. Authentication information required by the API.",
          "$ref": "ApiAuthentication"
        },
        "name": {
          "description": "Optional. The name of the tool. If not provided, the name of the tool will be derived from the OpenAPI schema, from `operation.operationId`.",
          "type": "string"
        }
      },
      "id": "OpenApiTool",
      "description": "A remote API tool defined by an OpenAPI schema.",
      "type": "object"
    },
    "EvaluationMetricsThresholdsGoldenEvaluationMetricsThresholds": {
      "properties": {
        "toolMatchingSettings": {
          "description": "Optional. The tool matching settings. An extra tool call is a tool call that is present in the execution but does not match any tool call in the golden expectation.",
          "$ref": "EvaluationMetricsThresholdsToolMatchingSettings"
        },
        "turnLevelMetricsThresholds": {
          "description": "Optional. The turn level metrics thresholds.",
          "$ref": "EvaluationMetricsThresholdsGoldenEvaluationMetricsThresholdsTurnLevelMetricsThresholds"
        },
        "expectationLevelMetricsThresholds": {
          "description": "Optional. The expectation level metrics thresholds.",
          "$ref": "EvaluationMetricsThresholdsGoldenEvaluationMetricsThresholdsExpectationLevelMetricsThresholds"
        }
      },
      "id": "EvaluationMetricsThresholdsGoldenEvaluationMetricsThresholds",
      "description": "Settings for golden evaluations.",
      "type": "object"
    },
    "ErrorHandlingSettings": {
      "description": "Settings to describe how errors should be handled in the app.",
      "id": "ErrorHandlingSettings",
      "properties": {
        "endSessionConfig": {
          "$ref": "ErrorHandlingSettingsEndSessionConfig",
          "description": "Optional. Configuration for ending the session in case of system errors (e.g. LLM errors)."
        },
        "fallbackResponseConfig": {
          "description": "Optional. Configuration for handling fallback responses.",
          "$ref": "ErrorHandlingSettingsFallbackResponseConfig"
        },
        "errorHandlingStrategy": {
          "type": "string",
          "enum": [
            "ERROR_HANDLING_STRATEGY_UNSPECIFIED",
            "NONE",
            "FALLBACK_RESPONSE",
            "END_SESSION"
          ],
          "description": "Optional. The strategy to use for error handling.",
          "enumDescriptions": [
            "Unspecified error handling strategy.",
            "No specific handling is enabled.",
            "A fallback message will be returned to the user in case of system errors (e.g. LLM errors).",
            "An EndSession signal will be emitted in case of system errors (e.g. LLM errors)."
          ]
        }
      },
      "type": "object"
    },
    "LfA2aV1ImplicitOAuthFlow": {
      "properties": {
        "authorizationUrl": {
          "description": "The authorization URL to be used for this flow. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS",
          "type": "string"
        },
        "refreshUrl": {
          "description": "The URL to be used for obtaining refresh tokens. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS.",
          "type": "string"
        },
        "scopes": {
          "description": "The available scopes for the OAuth2 security scheme. A map between the scope name and a short description for it. The map MAY be empty.",
          "type": "object",
          "additionalProperties": {
            "type": "string"
          }
        }
      },
      "type": "object",
      "description": "Deprecated: Use Authorization Code + PKCE instead.",
      "id": "LfA2aV1ImplicitOAuthFlow"
    },
    "TransferRuleDisablePlannerTransfer": {
      "properties": {
        "expressionCondition": {
          "$ref": "ExpressionCondition",
          "description": "Required. If the condition evaluates to true, planner will not be allowed to transfer to the target agent."
        }
      },
      "type": "object",
      "description": "A rule that prevents the planner from transferring to the target agent.",
      "id": "TransferRuleDisablePlannerTransfer"
    },
    "GuardrailLlmPromptSecurityDefaultSecuritySettings": {
      "description": "Configuration for default system security settings.",
      "properties": {
        "defaultPromptTemplate": {
          "type": "string",
          "description": "Output only. The default prompt template used by the system. This field is for display purposes to show the user what prompt the system uses by default. It is OUTPUT_ONLY.",
          "readOnly": true
        }
      },
      "id": "GuardrailLlmPromptSecurityDefaultSecuritySettings",
      "type": "object"
    },
    "SessionInput": {
      "id": "SessionInput",
      "description": "Input for the session.",
      "type": "object",
      "properties": {
        "variables": {
          "description": "Optional. Contextual variables for the session, keyed by name. Only variables declared in the app will be used by the CES agent. Unrecognized variables will still be sent to the Dialogflow agent as additional session parameters.",
          "additionalProperties": {
            "description": "Properties of the object.",
            "type": "any"
          },
          "type": "object"
        },
        "recordingControl": {
          "description": "Optional. Whether the conversation may be recorded and logged from here on. Use this when the app, rather than the agent, decides what may be kept: for example when the end user has to consent to being recorded before anything about the call can be stored. The value stays in effect until the client sends a different one, so it only needs to be sent when the answer changes. Whatever is in effect when a turn completes decides that turn, both whether its audio reaches the recording bucket and whether its transcript reaches conversation history, BigQuery and Cloud Logging. It covers the agent's side of the turn as well as the end user's. Turns that complete before the client first sends this are recorded according to the app's logging settings, as though the field did not exist. If more than one input in the same request sets it, the last one wins.",
          "enumDescriptions": [
            "The app is not controlling recording. The app's logging settings decide, as they do for every session that never sets this field.",
            "The conversation may be recorded and logged from here on.",
            "The conversation may not be recorded or logged from here on."
          ],
          "type": "string",
          "enum": [
            "RECORDING_CONTROL_UNSPECIFIED",
            "RECORDING_ENABLED",
            "RECORDING_DISABLED"
          ]
        },
        "dtmf": {
          "type": "string",
          "description": "Optional. DTMF digits from the end user."
        },
        "text": {
          "type": "string",
          "description": "Optional. Text data from the end user."
        },
        "willContinue": {
          "description": "Optional. A flag to indicate if the current message is a fragment of a larger input in the bidi streaming session. When set to `true`, the agent defers processing until it receives a subsequent message where `will_continue` is `false`, or until the system detects an endpoint in the audio input. NOTE: This field does not apply to audio and DTMF inputs, as they are always processed automatically based on the endpointing signal.",
          "type": "boolean"
        },
        "toolResponses": {
          "description": "Optional. Execution results for the tool calls from the client.",
          "$ref": "ToolResponses"
        },
        "audio": {
          "format": "byte",
          "description": "Optional. Audio data from the end user.",
          "type": "string"
        },
        "image": {
          "$ref": "Image",
          "description": "Optional. Image data from the end user."
        },
        "blob": {
          "description": "Optional. Blob data from the end user.",
          "$ref": "Blob"
        },
        "event": {
          "description": "Optional. Event input.",
          "$ref": "Event"
        }
      }
    },
    "QualityReportAgentIssues": {
      "type": "object",
      "description": "Issues identified for a single agent.",
      "properties": {
        "agent": {
          "type": "string",
          "description": "Optional. The name of the agent to which the issues are related. Format: `projects/{project}/locations/{location}/apps/{app}/agents/{agent}`"
        },
        "issues": {
          "type": "array",
          "description": "Optional. List of issues found for this agent.",
          "items": {
            "$ref": "QualityReportIssue"
          }
        }
      },
      "id": "QualityReportAgentIssues"
    },
    "EvaluationSettings": {
      "type": "object",
      "properties": {
        "scenarioExecutionMode": {
          "type": "string",
          "enum": [
            "SCENARIO_EXECUTION_MODE_UNSPECIFIED",
            "QUALITY_OPTIMIZED",
            "SPEED_OPTIMIZED"
          ],
          "enumDescriptions": [
            "Unspecified execution mode. Defaults to QUALITY_OPTIMIZED.",
            "Quality optimized mode.",
            "Speed optimized mode."
          ],
          "description": "Optional. The execution mode for scenario evaluations. If not provided, will default to QUALITY_OPTIMIZED."
        },
        "metricsConfig": {
          "$ref": "EvaluationMetricsConfig",
          "description": "Optional. Configures the default metrics for evaluations."
        },
        "scenarioEvaluationToolCallBehaviour": {
          "description": "Optional. Configures the default tool call behaviour for scenario evaluations.",
          "type": "string",
          "enum": [
            "EVALUATION_TOOL_CALL_BEHAVIOUR_UNSPECIFIED",
            "REAL",
            "FAKE"
          ],
          "enumDescriptions": [
            "Unspecified tool call behavior. Will default to real tool calls.",
            "Use real tool calls.",
            "Use fake tool calls."
          ]
        },
        "evaluationRunCachingSettings": {
          "description": "Optional. The caching settings to use for the evaluation run.",
          "$ref": "EvaluationRunCachingSettings"
        },
        "goldenEvaluationToolCallBehaviour": {
          "description": "Optional. Configures the default tool call behaviour for golden evaluations.",
          "type": "string",
          "enum": [
            "EVALUATION_TOOL_CALL_BEHAVIOUR_UNSPECIFIED",
            "REAL",
            "FAKE"
          ],
          "enumDescriptions": [
            "Unspecified tool call behavior. Will default to real tool calls.",
            "Use real tool calls.",
            "Use fake tool calls."
          ]
        },
        "scenarioConversationInitiator": {
          "enumDescriptions": [
            "Unspecified. Defaults to USER.",
            "The user starts the conversation.",
            "The agent starts the conversation."
          ],
          "description": "Optional. Who starts the conversation in a scenario evaluation.",
          "type": "string",
          "enum": [
            "SCENARIO_CONVERSATION_INITIATOR_UNSPECIFIED",
            "USER",
            "AGENT"
          ]
        },
        "goldenRunMethod": {
          "type": "string",
          "enum": [
            "GOLDEN_RUN_METHOD_UNSPECIFIED",
            "STABLE",
            "NAIVE"
          ],
          "description": "Optional. The default method used to run golden evaluations. This will be used if no golden_run_method is specified in the RunEvaluationRequest.",
          "enumDescriptions": [
            "Run method is not specified.",
            "Run the evaluation as stable replay, where each turn is a unique session with the previous expected turns injected as context.",
            "Run the evaluation as naive replay, where the run is a single session with no context injected."
          ]
        }
      },
      "description": "Settings for evaluation.",
      "id": "EvaluationSettings"
    },
    "WidgetToolDataMapping": {
      "description": "Configuration for mapping data from a source tool to the widget's input parameters.",
      "properties": {
        "fieldMappings": {
          "description": "Optional. A map of widget input parameter fields to the corresponding output fields of the source tool.",
          "additionalProperties": {
            "type": "string"
          },
          "type": "object"
        },
        "pythonFunction": {
          "description": "Optional. Configuration for a Python function used to transform the source tool's output into the widget's input format.",
          "$ref": "PythonFunction"
        },
        "mode": {
          "enumDescriptions": [
            "Unspecified mode.",
            "Use the `field_mappings` map for data transformation.",
            "Use the `python_script` for data transformation."
          ],
          "type": "string",
          "enum": [
            "MODE_UNSPECIFIED",
            "FIELD_MAPPING",
            "PYTHON_SCRIPT"
          ],
          "description": "Optional. The mode of the data mapping."
        },
        "pythonScript": {
          "type": "string",
          "deprecated": true,
          "description": "Deprecated: Use `python_function` instead."
        },
        "sourceToolName": {
          "description": "Optional. The resource name of the tool that provides the data for the widget (e.g., a search tool or a custom function). Format: `projects/{project}/locations/{location}/agents/{agent}/tools/{tool}`",
          "type": "string"
        }
      },
      "id": "WidgetToolDataMapping",
      "type": "object"
    },
    "ImportEvaluationsRequest": {
      "description": "Request message for EvaluationService.ImportEvaluations.",
      "properties": {
        "gcsUri": {
          "type": "string",
          "description": "The [Google Cloud Storage](https://cloud.google.com/storage/docs/) URI from which to import evaluations. The format of this URI must be `gs:///`."
        },
        "conversationList": {
          "$ref": "ImportEvaluationsRequestConversationList",
          "description": "The conversations to import the evaluations from."
        },
        "importOptions": {
          "description": "Optional. Options governing the import process for the evaluations.",
          "$ref": "ImportEvaluationsRequestImportOptions"
        },
        "csvContent": {
          "format": "byte",
          "description": "Raw bytes representing the csv file with the evaluations structure.",
          "type": "string"
        }
      },
      "id": "ImportEvaluationsRequest",
      "type": "object"
    },
    "GoogleSearchSuggestions": {
      "description": "Search suggestions from Google Search Tool.",
      "properties": {
        "htmls": {
          "items": {
            "type": "string"
          },
          "description": "Compliant HTML and CSS styling for search suggestions. The provided HTML and CSS automatically adapts to your device settings, displaying in either light or dark mode indicated by `@media(prefers-color-scheme)`.",
          "type": "array"
        },
        "webSearchQueries": {
          "items": {
            "$ref": "WebSearchQuery"
          },
          "type": "array",
          "description": "List of queries used to perform the google search along with the search result URIs forming the search suggestions."
        }
      },
      "type": "object",
      "id": "GoogleSearchSuggestions"
    },
    "GenerateAppResourceRequestAppGenerationConfig": {
      "id": "GenerateAppResourceRequestAppGenerationConfig",
      "properties": {
        "context": {
          "type": "string",
          "description": "Optional. The context which describes the requirements of the agents & tools to be generated."
        },
        "datasetId": {
          "description": "Optional. The insights dataset to be used to fetch conversation data for generating the agents & tools. Format: `projects/{project}/locations/{location}/datasets/{dataset}`.",
          "type": "string"
        },
        "generateEvaluations": {
          "description": "Optional. Whether to generate the evaluations for the app. If true, the provided context will be used to generate the evaluations data.",
          "type": "boolean"
        },
        "gcsLocation": {
          "type": "string",
          "description": "Optional. The Cloud Storage location to store the generated question answer data to be used by the Datastore tool. This data is generated only when using conversation data as an input source. The location must be in the same project as the app. Format: `gs://...`."
        },
        "fileContexts": {
          "items": {
            "$ref": "FileContext"
          },
          "type": "array",
          "description": "Optional. The files to be used as context."
        }
      },
      "description": "The configuration to be used to generate the app.",
      "type": "object"
    },
    "EvaluationMetricsThresholdsGoldenEvaluationMetricsThresholdsTurnLevelMetricsThresholds": {
      "type": "object",
      "description": "Turn level metrics thresholds.",
      "id": "EvaluationMetricsThresholdsGoldenEvaluationMetricsThresholdsTurnLevelMetricsThresholds",
      "properties": {
        "overallToolInvocationCorrectnessThreshold": {
          "format": "float",
          "type": "number",
          "description": "Optional. The success threshold for overall tool invocation correctness. Must be a float between 0 and 1. Default is 1.0."
        },
        "semanticSimilaritySuccessThreshold": {
          "type": "integer",
          "description": "Optional. The success threshold for semantic similarity. Must be an integer between 0 and 4. Default is \u003e= 3.",
          "format": "int32"
        },
        "semanticSimilarityChannel": {
          "description": "Optional. The semantic similarity channel to use for evaluation.",
          "type": "string",
          "enum": [
            "SEMANTIC_SIMILARITY_CHANNEL_UNSPECIFIED",
            "TEXT",
            "AUDIO"
          ],
          "enumDescriptions": [
            "Metric unspecified. Defaults to TEXT.",
            "Use text semantic similarity.",
            "Use audio semantic similarity."
          ]
        }
      }
    },
    "EvaluationResultUserGoalSatisfactionResult": {
      "description": "The result of a user goal satisfaction check for a conversation.",
      "properties": {
        "label": {
          "readOnly": true,
          "description": "Output only. The label associated with each score. Score 2: Graceful Handoff Score 1: User Task Satisfied Score 0: User Task Not Satisfied Score -1: User Task Unspecified",
          "type": "string"
        },
        "score": {
          "format": "int32",
          "type": "integer",
          "description": "Output only. The user task satisfaction score. Can be -1, 0, 1, 2.",
          "readOnly": true
        },
        "explanation": {
          "description": "Output only. The explanation for the user task satisfaction score.",
          "type": "string",
          "readOnly": true
        }
      },
      "type": "object",
      "id": "EvaluationResultUserGoalSatisfactionResult"
    },
    "GenerateAppResourceRequestHillClimbingFixConfig": {
      "type": "object",
      "properties": {
        "qualityReport": {
          "description": "Required. The quality report used to inform the instruction following fix.",
          "$ref": "QualityReport"
        }
      },
      "description": "The configuration to be used for hill climbing fixes.",
      "id": "GenerateAppResourceRequestHillClimbingFixConfig"
    },
    "ConnectorTool": {
      "id": "ConnectorTool",
      "properties": {
        "description": {
          "type": "string",
          "description": "Optional. The description of the tool that can be used by the Agent to decide whether to call this ConnectorTool."
        },
        "action": {
          "description": "Required. Action for the tool to use.",
          "$ref": "Action"
        },
        "connection": {
          "type": "string",
          "description": "Required. The full resource name of the referenced Integration Connectors Connection. Format: `projects/{project}/locations/{location}/connections/{connection}`"
        },
        "name": {
          "description": "Optional. The name of the tool that can be used by the Agent to decide whether to call this ConnectorTool.",
          "type": "string"
        },
        "authConfig": {
          "$ref": "EndUserAuthConfig",
          "description": "Optional. Configures how authentication is handled in Integration Connectors. By default, an admin authentication is passed in the Integration Connectors API requests. You can override it with a different end-user authentication config. **Note**: The Connection must have authentication override enabled in order to specify an EUC configuration here - otherwise, the ConnectorTool creation will fail. See https://cloud.google.com/application-integration/docs/configure-connectors-task#configure-authentication-override for details."
        }
      },
      "type": "object",
      "description": "A ConnectorTool allows connections to different integrations. See: https://cloud.google.com/integration-connectors/docs/overview."
    },
    "EvaluationScenarioUserFact": {
      "properties": {
        "name": {
          "description": "Required. The name of the user fact.",
          "type": "string"
        },
        "value": {
          "type": "string",
          "description": "Required. The value of the user fact."
        }
      },
      "description": "Facts about the user as a key value pair.",
      "type": "object",
      "id": "EvaluationScenarioUserFact"
    },
    "AgentAgentToolset": {
      "id": "AgentAgentToolset",
      "properties": {
        "toolset": {
          "type": "string",
          "description": "Required. The resource name of the toolset. Format: `projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset}`"
        },
        "toolIds": {
          "items": {
            "type": "string"
          },
          "description": "Optional. The tools IDs to filter the toolset.",
          "type": "array"
        }
      },
      "type": "object",
      "description": "A toolset with a selection of its tools."
    },
    "ApiKeyConfig": {
      "type": "object",
      "description": "Configurations for authentication with API key.",
      "id": "ApiKeyConfig",
      "properties": {
        "keyName": {
          "description": "Required. The parameter name or the header name of the API key. E.g., If the API request is \"https://example.com/act?X-Api-Key=\", \"X-Api-Key\" would be the parameter name.",
          "type": "string"
        },
        "requestLocation": {
          "description": "Required. Key location in the request.",
          "enumDescriptions": [
            "Unspecified. This value should not be used.",
            "Represents the key in http header.",
            "Represents the key in query string."
          ],
          "type": "string",
          "enum": [
            "REQUEST_LOCATION_UNSPECIFIED",
            "HEADER",
            "QUERY_STRING"
          ]
        },
        "apiKeySecretVersion": {
          "type": "string",
          "description": "Required. The name of the SecretManager secret version resource storing the API key. Format: `projects/{project}/secrets/{secret}/versions/{version}` Note: You should grant `roles/secretmanager.secretAccessor` role to the CES service agent `service-@gcp-sa-ces.iam.gserviceaccount.com`."
        }
      }
    },
    "EvaluationResultGoldenExpectationOutcomeToolInvocationResult": {
      "type": "object",
      "id": "EvaluationResultGoldenExpectationOutcomeToolInvocationResult",
      "description": "The result of the tool invocation check.",
      "properties": {
        "explanation": {
          "description": "Output only. A free text explanation for the tool invocation result.",
          "type": "string",
          "readOnly": true
        },
        "parameterCorrectnessScore": {
          "readOnly": true,
          "format": "float",
          "description": "Output only. The tool invocation parameter correctness score. This indicates the percent of parameters from the expected tool call that were also present in the actual tool call.",
          "type": "number"
        },
        "outcome": {
          "description": "Output only. The outcome of the tool invocation check. This is determined by comparing the parameter_correctness_score to the threshold. If the score is equal to or above the threshold, the outcome will be PASS. Otherwise, the outcome will be FAIL.",
          "readOnly": true,
          "enum": [
            "OUTCOME_UNSPECIFIED",
            "PASS",
            "FAIL",
            "SKIPPED"
          ],
          "enumDescriptions": [
            "Evaluation outcome is not specified.",
            "Evaluation/Expectation passed. In the case of an evaluation, this means that all expectations were met.",
            "Evaluation/Expectation failed. In the case of an evaluation, this means that at least one expectation was not met.",
            "Evaluation/Expectation was skipped."
          ],
          "type": "string"
        }
      }
    },
    "SynthesizeSpeechConfig": {
      "id": "SynthesizeSpeechConfig",
      "type": "object",
      "properties": {
        "model": {
          "description": "Optional. The model used to synthesize audio. Currently supported values: - \"gemini-3.1-flash-tts-preview\" If empty, Chirp3-HD is used.",
          "type": "string"
        },
        "speakingRate": {
          "description": "Optional. The speaking rate/speed in the range [0.25, 2.0]. 1.0 is the normal native speed supported by the specific voice. 2.0 is twice as fast, and 0.5 is half as fast. Values outside of the range [0.25, 2.0] will return an error.",
          "format": "double",
          "type": "number"
        },
        "voice": {
          "type": "string",
          "description": "Optional. The name of the voice. If not set, the service will choose a voice based on the other parameters such as language_code. For the list of available voices, please refer to [Supported voices and languages](https://cloud.google.com/text-to-speech/docs/voices) from Cloud Text-to-Speech."
        },
        "instruction": {
          "description": "Optional. The instruction used to synthesize speech when using a generative model.",
          "type": "string"
        }
      },
      "description": "Configuration for how the agent response should be synthesized."
    },
    "UserResponseSuggestions": {
      "id": "UserResponseSuggestions",
      "type": "object",
      "properties": {
        "suggestions": {
          "items": {
            "type": "string"
          },
          "description": "Required. The assistant suggested user responses. These are suggestions for the user on how to interact with the assistant.",
          "type": "array"
        }
      },
      "description": "Suggested user responses from the assistant agent."
    },
    "LfA2aV1TaskArtifactUpdateEvent": {
      "description": "A task delta where an artifact has been generated.",
      "properties": {
        "metadata": {
          "type": "object",
          "additionalProperties": {
            "description": "Properties of the object.",
            "type": "any"
          },
          "description": "Optional. Metadata associated with the artifact update."
        },
        "lastChunk": {
          "description": "If true, this is the final chunk of the artifact.",
          "type": "boolean"
        },
        "contextId": {
          "type": "string",
          "description": "Required. The ID of the context that this task belongs to."
        },
        "artifact": {
          "description": "Required. The artifact that was generated or updated.",
          "$ref": "LfA2aV1Artifact"
        },
        "append": {
          "type": "boolean",
          "description": "If true, the content of this artifact should be appended to a previously sent artifact with the same ID."
        },
        "taskId": {
          "description": "Required. The ID of the task for this artifact.",
          "type": "string"
        }
      },
      "id": "LfA2aV1TaskArtifactUpdateEvent",
      "type": "object"
    },
    "RestoreAppVersionRequest": {
      "properties": {},
      "type": "object",
      "id": "RestoreAppVersionRequest",
      "description": "Request message for AgentService.RestoreAppVersion"
    },
    "OptimizationConfig": {
      "description": "Configuration for running the optimization step after the evaluation run.",
      "properties": {
        "errorMessage": {
          "type": "string",
          "description": "Output only. The error message if the optimization run failed.",
          "readOnly": true
        },
        "status": {
          "enum": [
            "OPTIMIZATION_STATUS_UNSPECIFIED",
            "RUNNING",
            "COMPLETED",
            "ERROR"
          ],
          "readOnly": true,
          "type": "string",
          "enumDescriptions": [
            "Optimization status is not specified.",
            "Optimization is running.",
            "Optimization has completed.",
            "Optimization failed due to an internal error."
          ],
          "description": "Output only. The status of the optimization run."
        },
        "generateLossReport": {
          "description": "Optional. Whether to generate a loss report.",
          "type": "boolean"
        },
        "assistantSession": {
          "type": "string",
          "readOnly": true,
          "description": "Output only. The assistant session to use for the optimization based on this evaluation run. Format: `projects/{project}/locations/{location}/apps/{app}/assistantSessions/{assistantSession}`"
        },
        "lossReport": {
          "type": "object",
          "description": "Output only. The generated loss report.",
          "additionalProperties": {
            "type": "any",
            "description": "Properties of the object."
          },
          "readOnly": true
        },
        "shouldSuggestFix": {
          "description": "Output only. Whether to suggest a fix for the losses.",
          "readOnly": true,
          "type": "boolean"
        },
        "reportSummary": {
          "description": "Output only. The summary of the loss report.",
          "type": "string",
          "readOnly": true
        }
      },
      "id": "OptimizationConfig",
      "type": "object"
    },
    "ClientCertificateSettings": {
      "id": "ClientCertificateSettings",
      "description": "Settings for custom client certificates.",
      "type": "object",
      "properties": {
        "passphrase": {
          "type": "string",
          "description": "Optional. The name of the SecretManager secret version resource storing the passphrase to decrypt the private key. Should be left unset if the private key is not encrypted. Format: `projects/{project}/secrets/{secret}/versions/{version}`"
        },
        "privateKey": {
          "description": "Required. The name of the SecretManager secret version resource storing the private key encoded in PEM format. Format: `projects/{project}/secrets/{secret}/versions/{version}`",
          "type": "string"
        },
        "tlsCertificate": {
          "description": "Required. The TLS certificate encoded in PEM format. This string must include the begin header and end footer lines.",
          "type": "string"
        }
      }
    },
    "EvaluationMetricsConfigGoldenMetricsConfig": {
      "properties": {
        "stepToolCorrectnessMetricsConfig": {
          "$ref": "EvaluationMetricsConfigToolCorrectnessMetricsConfig",
          "description": "Optional. Configuration for step level tool correctness metrics."
        },
        "semanticSimilarityMetricsConfig": {
          "$ref": "EvaluationMetricsConfigSemanticSimilarityMetricsConfig",
          "description": "Optional. Global configuration for semantic similarity metrics."
        },
        "toolCorrectnessMetricsConfig": {
          "$ref": "EvaluationMetricsConfigToolCorrectnessMetricsConfig",
          "description": "Optional. Configuration for turn level tool correctness metrics."
        }
      },
      "description": "Configuration for the golden metrics for the evaluation.",
      "id": "EvaluationMetricsConfigGoldenMetricsConfig",
      "type": "object"
    },
    "DataStoreToolGroundingConfig": {
      "id": "DataStoreToolGroundingConfig",
      "properties": {
        "disabled": {
          "description": "Optional. Whether grounding is disabled.",
          "type": "boolean"
        },
        "groundingLevel": {
          "description": "Optional. The groundedness threshold of the answer based on the retrieved sources. The value has a configurable range of [1, 5]. The level is used to threshold the groundedness of the answer, meaning that all responses with a groundedness score below the threshold will fall back to returning relevant snippets only. For example, a level of 3 means that the groundedness score must be 3 or higher for the response to be returned.",
          "format": "float",
          "type": "number"
        }
      },
      "type": "object",
      "description": "Grounding configuration."
    },
    "ListExamplesResponse": {
      "description": "Response message for AgentService.ListExamples.",
      "id": "ListExamplesResponse",
      "properties": {
        "nextPageToken": {
          "description": "A token that can be sent as ListExamplesRequest.page_token to retrieve the next page. Absence of this field indicates there are no subsequent pages.",
          "type": "string"
        },
        "examples": {
          "items": {
            "$ref": "Example"
          },
          "description": "The list of examples.",
          "type": "array"
        }
      },
      "type": "object"
    },
    "GuardrailSupervisor": {
      "properties": {
        "detectionMode": {
          "description": "Optional. The detection mode of the supervisor.",
          "enumDescriptions": [
            "Detection mode is unspecified. Default to NON_BLOCKING.",
            "Non blocking detection mode. Response is not blocked when the supervisor detection is ongoing.",
            "Blocking detection mode. Response is blocked when the supervisor detection is ongoing."
          ],
          "type": "string",
          "enum": [
            "DETECTION_MODE_UNSPECIFIED",
            "NON_BLOCKING",
            "BLOCKING"
          ]
        },
        "type": {
          "description": "Optional. The type of the supervisor.",
          "type": "string",
          "enum": [
            "TYPE_UNSPECIFIED",
            "INVALID_TEXT",
            "LANGUAGE_SHIFT",
            "SPEAKER_SHIFT",
            "AUDIO_MISMATCH",
            "MISSING_TOOL_CALL",
            "CUSTOM",
            "CHOPPY_AUDIO",
            "PROFANITY"
          ],
          "enumDescriptions": [
            "Type is unspecified.",
            "Invalid text issue type.",
            "Language shift issue type.",
            "Speaker shift issue type.",
            "Audio mismatch issue type.",
            "Missing tool call issue type.",
            "Custom issue type.",
            "Choppy audio issue type.",
            "Agent profanity issue type."
          ]
        }
      },
      "type": "object",
      "id": "GuardrailSupervisor",
      "description": "Guardrail that runs supervisor intervention."
    },
    "LfA2aV1HTTPAuthSecurityScheme": {
      "id": "LfA2aV1HTTPAuthSecurityScheme",
      "properties": {
        "bearerFormat": {
          "description": "A hint to the client to identify how the bearer token is formatted (e.g., \"JWT\"). Primarily for documentation purposes.",
          "type": "string"
        },
        "description": {
          "type": "string",
          "description": "An optional description for the security scheme."
        },
        "scheme": {
          "type": "string",
          "description": "Required. The name of the HTTP Authentication scheme to be used in the Authorization header, as defined in RFC7235 (e.g., \"Bearer\"). This value should be registered in the IANA Authentication Scheme registry."
        }
      },
      "description": "Defines a security scheme using HTTP authentication.",
      "type": "object"
    },
    "ActionEntityOperation": {
      "type": "object",
      "properties": {
        "operation": {
          "enumDescriptions": [
            "Operation type unspecified. Invalid, ConnectorTool create/update will fail.",
            "List operation.",
            "Get operation.",
            "Create operation.",
            "Update operation.",
            "Delete operation."
          ],
          "type": "string",
          "enum": [
            "OPERATION_TYPE_UNSPECIFIED",
            "LIST",
            "GET",
            "CREATE",
            "UPDATE",
            "DELETE"
          ],
          "description": "Required. Operation to perform on the entity."
        },
        "entityId": {
          "type": "string",
          "description": "Required. ID of the entity."
        }
      },
      "description": "Entity CRUD operation specification.",
      "id": "ActionEntityOperation"
    },
    "OperationMetadata": {
      "description": "Represents the metadata of the long-running operation.",
      "properties": {
        "requestedCancellation": {
          "description": "Output only. Identifies whether the user has requested cancellation of the operation. Operations that have been cancelled successfully have google.longrunning.Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.",
          "readOnly": true,
          "type": "boolean"
        },
        "createTime": {
          "format": "google-datetime",
          "type": "string",
          "readOnly": true,
          "description": "Output only. The time the operation was created."
        },
        "statusMessage": {
          "description": "Output only. Human-readable status of the operation, if any.",
          "readOnly": true,
          "type": "string"
        },
        "endTime": {
          "readOnly": true,
          "type": "string",
          "description": "Output only. The time the operation finished running.",
          "format": "google-datetime"
        }
      },
      "id": "OperationMetadata",
      "type": "object"
    },
    "CitationsInlineCitation": {
      "type": "object",
      "id": "CitationsInlineCitation",
      "properties": {
        "endIndex": {
          "type": "integer",
          "format": "int32",
          "description": "The ending index (in bytes) of the text segment in the agent response."
        },
        "citedChunkIndices": {
          "items": {
            "format": "int32",
            "type": "integer"
          },
          "type": "array",
          "description": "The indices of the cited chunks that back this text segment. Indices refer to the elements in `cited_chunks`."
        },
        "startIndex": {
          "description": "The starting index (in bytes) of the text segment in the agent response.",
          "format": "int32",
          "type": "integer"
        }
      },
      "description": "An inline citation in the response text."
    },
    "OptionQuestionsChunkQuestion": {
      "description": "One question with its options.",
      "properties": {
        "question": {
          "description": "The question header text.",
          "type": "string"
        },
        "options": {
          "items": {
            "$ref": "OptionQuestionsChunkOption"
          },
          "type": "array",
          "description": "The selectable options, in presentation order."
        }
      },
      "id": "OptionQuestionsChunkQuestion",
      "type": "object"
    },
    "EvaluationResultEvaluationExpectationResult": {
      "properties": {
        "prompt": {
          "description": "Output only. The prompt that was used for the evaluation.",
          "readOnly": true,
          "type": "string"
        },
        "evaluationExpectation": {
          "type": "string",
          "readOnly": true,
          "description": "Output only. The evaluation expectation. Format: `projects/{project}/locations/{location}/apps/{app}/evaluationExpectations/{evaluation_expectation}`"
        },
        "outcome": {
          "description": "Output only. The outcome of the evaluation expectation.",
          "readOnly": true,
          "type": "string",
          "enumDescriptions": [
            "Evaluation outcome is not specified.",
            "Evaluation/Expectation passed. In the case of an evaluation, this means that all expectations were met.",
            "Evaluation/Expectation failed. In the case of an evaluation, this means that at least one expectation was not met.",
            "Evaluation/Expectation was skipped."
          ],
          "enum": [
            "OUTCOME_UNSPECIFIED",
            "PASS",
            "FAIL",
            "SKIPPED"
          ]
        },
        "explanation": {
          "description": "Output only. The explanation for the result.",
          "type": "string",
          "readOnly": true
        }
      },
      "type": "object",
      "id": "EvaluationResultEvaluationExpectationResult",
      "description": "The result of a single evaluation expectation."
    },
    "Message": {
      "type": "object",
      "properties": {
        "chunks": {
          "items": {
            "$ref": "Chunk"
          },
          "type": "array",
          "description": "Optional. Content of the message as a series of chunks."
        },
        "eventTime": {
          "description": "Optional. Timestamp when the message was sent or received. Should not be used if the message is part of an example.",
          "format": "google-datetime",
          "type": "string"
        },
        "role": {
          "type": "string",
          "description": "Optional. The role within the conversation, e.g., user, agent."
        }
      },
      "description": "A message within a conversation.",
      "id": "Message"
    },
    "ExportAppResponse": {
      "properties": {
        "appUri": {
          "type": "string",
          "description": "The [Google Cloud Storage](https://cloud.google.com/storage/docs/) URI to which the app was exported."
        },
        "appContent": {
          "format": "byte",
          "description": "App folder compressed as a zip file.",
          "type": "string"
        }
      },
      "id": "ExportAppResponse",
      "description": "Response message for AgentService.ExportApp.",
      "type": "object"
    },
    "EvaluationMetricsConfigExpectationsMetMetricsConfig": {
      "id": "EvaluationMetricsConfigExpectationsMetMetricsConfig",
      "type": "object",
      "properties": {
        "enableExpectationsMetMetrics": {
          "type": "boolean",
          "description": "Optional. Whether to calculate the expectation level metrics for the evaluation."
        }
      },
      "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."
    },
    "EvaluationMetricsConfigToolCorrectnessMetricsConfig": {
      "properties": {
        "enableToolCorrectnessMetrics": {
          "type": "boolean",
          "description": "Optional. Whether to calculate tool correctness metrics for the evaluation."
        }
      },
      "type": "object",
      "id": "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."
    },
    "AggregatedMetricsMetricsByAppVersion": {
      "type": "object",
      "description": "Metrics aggregated per app version.",
      "properties": {
        "toolCallLatencyMetrics": {
          "readOnly": true,
          "description": "Output only. Metrics for tool call latency within this app version.",
          "type": "array",
          "items": {
            "$ref": "AggregatedMetricsToolCallLatencyMetrics"
          }
        },
        "failCount": {
          "type": "integer",
          "description": "Output only. The number of times the evaluation failed.",
          "readOnly": true,
          "format": "int32"
        },
        "turnLatencyMetrics": {
          "description": "Output only. Metrics for turn latency within this app version.",
          "readOnly": true,
          "items": {
            "$ref": "AggregatedMetricsTurnLatencyMetrics"
          },
          "type": "array"
        },
        "appVersionId": {
          "type": "string",
          "description": "Output only. The app version ID.",
          "readOnly": true
        },
        "semanticSimilarityMetrics": {
          "items": {
            "$ref": "AggregatedMetricsSemanticSimilarityMetrics"
          },
          "type": "array",
          "description": "Output only. Metrics for semantic similarity within this app version.",
          "readOnly": true
        },
        "toolMetrics": {
          "items": {
            "$ref": "AggregatedMetricsToolMetrics"
          },
          "description": "Output only. Metrics for each tool within this app version.",
          "type": "array",
          "readOnly": true
        },
        "passCount": {
          "type": "integer",
          "format": "int32",
          "description": "Output only. The number of times the evaluation passed.",
          "readOnly": true
        },
        "hallucinationMetrics": {
          "type": "array",
          "readOnly": true,
          "description": "Output only. Metrics for hallucination within this app version.",
          "items": {
            "$ref": "AggregatedMetricsHallucinationMetrics"
          }
        },
        "metricsByTurn": {
          "readOnly": true,
          "type": "array",
          "items": {
            "$ref": "AggregatedMetricsMetricsByTurn"
          },
          "description": "Output only. Metrics aggregated per turn within this app version."
        }
      },
      "id": "AggregatedMetricsMetricsByAppVersion"
    },
    "AggregatedMetricsTurnLatencyMetrics": {
      "type": "object",
      "id": "AggregatedMetricsTurnLatencyMetrics",
      "description": "Metrics for turn latency.",
      "properties": {
        "averageLatency": {
          "format": "google-duration",
          "description": "Output only. The average latency of the turns.",
          "type": "string",
          "readOnly": true
        }
      }
    },
    "TurnMetadata": {
      "type": "object",
      "description": "Turn-level metadata and intent categorization.",
      "id": "TurnMetadata",
      "properties": {
        "contractDraftComplete": {
          "description": "Set on the terminal event of a contract draft whose every placeholder is resolved (contract_progress is 100%), whether or not the draft was published. Clients complete and dismiss the contract progress display on it; publication is reported separately by contract_finalized.",
          "type": "boolean"
        },
        "contractStreamingPhase": {
          "description": "Set only on in-flight progress estimates emitted while a contract artifact fence is streaming, and on the revision-turn-start event. Unset on authoritative payloads.",
          "enumDescriptions": [
            "The payload is authoritative (computed from a complete contract document, a persisted snapshot, or the pre-draft state). Clients must replace any previously received progress with it.",
            "An initial contract draft is streaming. contract_progress is an in-flight estimate: non-decreasing within one artifact fence, capped below the authoritative range, with pillar_breakdowns carrying total_item_count == 0 to mark estimated pillar states.",
            "A revision of an existing contract is streaming (for example after an annotation submission). Same estimate semantics as DRAFTING."
          ],
          "type": "string",
          "enum": [
            "CONTRACT_STREAMING_PHASE_UNSPECIFIED",
            "DRAFTING",
            "REVISING"
          ]
        },
        "contractFinalized": {
          "description": "Set on the final artifact event of a turn whose contract draft was published (a revision was activated). Terminal for the clarification flow of this draft: contract_progress is authoritative and complete.",
          "type": "boolean"
        },
        "contractRelated": {
          "type": "boolean",
          "description": "Indicates whether this assistant turn was contract-related (e.g. contract drafting, alignment, extraction, or revision)."
        }
      }
    },
    "ImportEvaluationsRequestImportOptions": {
      "description": "Configuration options for the evaluation import process. These options control how the import behaves, particularly when conflicts arise with existing evaluations data.",
      "properties": {
        "conflictResolutionStrategy": {
          "enumDescriptions": [
            "The conflict resolution strategy is unspecified.",
            "Overwrite the existing evaluation with the new one.",
            "Keep the existing evaluation and skip the new one.",
            "Keep the existing evaluation and duplicate the new one as a new evaluation."
          ],
          "type": "string",
          "enum": [
            "CONFLICT_RESOLUTION_STRATEGY_UNSPECIFIED",
            "OVERWRITE",
            "SKIP",
            "DUPLICATE"
          ],
          "description": "Optional. The strategy to use when resolving conflicts during import."
        }
      },
      "id": "ImportEvaluationsRequestImportOptions",
      "type": "object"
    },
    "RetrieveToolSchemaRequest": {
      "description": "Request message for ToolService.RetrieveToolSchema.",
      "type": "object",
      "properties": {
        "toolsetTool": {
          "description": "Optional. The toolset tool to retrieve the schema for. Only one tool should match the predicate from the toolset. Otherwise, an error will be returned.",
          "$ref": "ToolsetTool"
        },
        "tool": {
          "description": "Optional. The name of the tool to retrieve the schema for. Format: projects/{project}/locations/{location}/apps/{app}/tools/{tool}",
          "type": "string"
        }
      },
      "id": "RetrieveToolSchemaRequest"
    },
    "ImportEvaluationsOperationMetadata": {
      "type": "object",
      "description": "Represents the metadata of the long-running operation for EvaluationService.ImportEvaluations.",
      "properties": {
        "endTime": {
          "readOnly": true,
          "type": "string",
          "description": "Output only. The time the operation finished running.",
          "format": "google-datetime"
        },
        "statusMessage": {
          "description": "Output only. Human-readable status of the operation, if any.",
          "readOnly": true,
          "type": "string"
        },
        "createTime": {
          "type": "string",
          "description": "Output only. The time the operation was created.",
          "format": "google-datetime",
          "readOnly": true
        }
      },
      "id": "ImportEvaluationsOperationMetadata"
    },
    "GenerateAppResourceRequestQualityReportGenerationConfig": {
      "properties": {
        "algorithm": {
          "type": "string",
          "enum": [
            "LOSS_ATTRIBUTION_ALGORITHM_UNSPECIFIED",
            "APP_CENTRIC",
            "AGENT_CENTRIC"
          ],
          "enumDescriptions": [
            "Unspecified.",
            "App-centric loss attribution. Treats the app as a single unit.",
            "Agent-centric loss attribution. Attributes loss to individual agents."
          ],
          "description": "Optional. The loss attribution algorithm to use."
        },
        "evaluationRun": {
          "description": "Required. The evaluation run used to inform quality report analysis.",
          "type": "string"
        }
      },
      "id": "GenerateAppResourceRequestQualityReportGenerationConfig",
      "type": "object",
      "description": "The configuration to be used for quality report generation."
    },
    "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).",
      "properties": {
        "raw": {
          "format": "byte",
          "description": "The `raw` byte content of a file. In JSON serialization, this is encoded as a base64 string.",
          "type": "string"
        },
        "text": {
          "type": "string",
          "description": "The string content of the `text` part."
        },
        "metadata": {
          "description": "Optional. metadata associated with this part.",
          "additionalProperties": {
            "type": "any",
            "description": "Properties of the object."
          },
          "type": "object"
        },
        "filename": {
          "type": "string",
          "description": "An optional `filename` for the file (e.g., \"document.pdf\")."
        },
        "data": {
          "description": "Arbitrary structured `data` as a JSON value (object, array, string, number, boolean, or null).",
          "type": "any"
        },
        "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"
        },
        "url": {
          "description": "A `url` pointing to the file's content.",
          "type": "string"
        }
      },
      "type": "object",
      "id": "LfA2aV1Part"
    },
    "DataStoreToolBoostSpecConditionBoostSpecBoostControlSpecControlPoint": {
      "id": "DataStoreToolBoostSpecConditionBoostSpecBoostControlSpecControlPoint",
      "description": "The control points used to define the curve. The curve defined through these control points can only be monotonically increasing or decreasing(constant values are acceptable).",
      "properties": {
        "attributeValue": {
          "type": "string",
          "description": "Optional. Can be one of: 1. The numerical field value. 2. The duration spec for freshness: The value must be formatted as an XSD `dayTimeDuration` value (a restricted subset of an ISO 8601 duration value). The pattern for this is: `nDnM]`."
        },
        "boostAmount": {
          "type": "number",
          "description": "Optional. The value between -1 to 1 by which to boost the score if the attribute_value evaluates to the value specified above.",
          "format": "float"
        }
      },
      "type": "object"
    },
    "WidgetToolTextResponseConfig": {
      "properties": {
        "textResponseInstruction": {
          "type": "string",
          "description": "Optional. Instruction for the LLM on how to generate the text response. Used as the description for the text response parameter if type is LLM_GENERATED."
        },
        "type": {
          "description": "Optional. The strategy for providing the text response.",
          "enumDescriptions": [
            "Unspecified type.",
            "The LLM dynamically decides whether to generate a text response alongside the widget based on the conversation context.",
            "The LLM is explicitly required to generate a text response.",
            "A pre-defined static text response is always used."
          ],
          "type": "string",
          "enum": [
            "TYPE_UNSPECIFIED",
            "NONE",
            "LLM_GENERATED",
            "STATIC"
          ]
        },
        "staticText": {
          "description": "Optional. The static text response to return when type is STATIC.",
          "type": "string"
        }
      },
      "description": "Configuration for the text response returned with the widget.",
      "id": "WidgetToolTextResponseConfig",
      "type": "object"
    },
    "Blob": {
      "description": "Represents a blob input or output in the conversation.",
      "properties": {
        "data": {
          "type": "string",
          "format": "byte",
          "description": "Required. Raw bytes of the blob."
        },
        "mimeType": {
          "type": "string",
          "description": "Required. The IANA standard MIME type of the source data."
        }
      },
      "id": "Blob",
      "type": "object"
    },
    "OperationCompletedEvent": {
      "properties": {
        "deduplicationToken": {
          "description": "Optional deduplication token (e.g. UUID) to prevent duplicate turn execution from concurrent browser tabs.",
          "type": "string"
        },
        "metadata": {
          "additionalProperties": {
            "description": "Properties of the object.",
            "type": "any"
          },
          "type": "object",
          "description": "Optional structured result metadata (e.g. pass_rate, total_examples, export_uri)."
        },
        "error": {
          "$ref": "Status",
          "description": "Optional canonical error status if the operation failed."
        },
        "operationName": {
          "description": "The operation resource name (e.g. `operations/{op}`).",
          "type": "string"
        },
        "targetResourceName": {
          "description": "The primary resource targeted or produced by the operation (e.g. evaluation run ID, app ID, dataset ID).",
          "type": "string"
        },
        "status": {
          "description": "Status of the operation run (e.g. \"SUCCEEDED\", \"FAILED\", \"CANCELLED\").",
          "type": "string"
        },
        "operationType": {
          "description": "The operation type or tool name (e.g. \"run_evaluation\", \"copy_app\", \"export_app\").",
          "type": "string"
        }
      },
      "description": "Event sent by the client or background worker to resume an assistant session after an asynchronous Long-Running Operation (LRO) completes.",
      "type": "object",
      "id": "OperationCompletedEvent"
    },
    "Deployment": {
      "id": "Deployment",
      "description": "A deployment represents an immutable, queryable version of the app. It is used to deploy an app version with a specific channel profile.",
      "properties": {
        "modelSettings": {
          "$ref": "ModelSettings",
          "description": "Optional. Model settings for the deployment. Overrides model settings configured at the app/agent levels. Note: Deployment-level model settings override is gated behind an allowlist. Contact the CXAS team to enable this field."
        },
        "etag": {
          "description": "Output only. Etag used to ensure the object hasn't changed during a read-modify-write operation. If the etag is empty, the update will overwrite any concurrent changes.",
          "readOnly": true,
          "type": "string"
        },
        "displayName": {
          "type": "string",
          "description": "Required. Display name of the deployment."
        },
        "instagramCredentials": {
          "description": "Optional. Input only. Ephemeral Instagram credentials required when configuring a Instagram channel profile.",
          "$ref": "InstagramCredentials"
        },
        "modality": {
          "enumDescriptions": [
            "Unknown modality.",
            "Text modality.",
            "Voice modality.",
            "Video modality."
          ],
          "type": "string",
          "enum": [
            "MODALITY_UNSPECIFIED",
            "MODALITY_TEXT",
            "MODALITY_VOICE",
            "MODALITY_VIDEO"
          ],
          "description": "Optional. The modality of the deployment. Note: Deployment-level modality override is gated behind an allowlist. Contact the CXAS team to enable this field."
        },
        "experimentConfig": {
          "$ref": "ExperimentConfig",
          "description": "Optional. Experiment configuration for the deployment."
        },
        "agentRegistryDeployment": {
          "$ref": "AgentRegistryDeployment",
          "description": "Optional. Configuration for deploying this deployment to Agent Registry. If present, this deployment will be published to Agent Registry."
        },
        "createTime": {
          "type": "string",
          "readOnly": true,
          "description": "Output only. Timestamp when this deployment was created.",
          "format": "google-datetime"
        },
        "appVersion": {
          "description": "Optional. The resource name of the app version to deploy. Format: `projects/{project}/locations/{location}/apps/{app}/versions/{version}` Use `projects/{project}/locations/{location}/apps/{app}/versions/-` to use the draft app.",
          "type": "string"
        },
        "name": {
          "type": "string",
          "description": "Identifier. The resource name of the deployment. Format: `projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}`"
        },
        "updateTime": {
          "readOnly": true,
          "description": "Output only. Timestamp when this deployment was last updated.",
          "type": "string",
          "format": "google-datetime"
        },
        "whatsappCredentials": {
          "description": "Optional. Input only. Ephemeral WhatsApp credentials required when configuring a WhatsApp channel profile.",
          "$ref": "WhatsAppCredentials"
        },
        "channelProfile": {
          "$ref": "ChannelProfile",
          "description": "Required. The channel profile used in the deployment."
        }
      },
      "type": "object"
    },
    "EvaluationResultSpanLatency": {
      "properties": {
        "callback": {
          "type": "string",
          "description": "Output only. The name of the user callback span.",
          "readOnly": true
        },
        "executionLatency": {
          "format": "google-duration",
          "type": "string",
          "description": "Output only. The latency of span.",
          "readOnly": true
        },
        "type": {
          "description": "Output only. The type of span.",
          "type": "string",
          "readOnly": true,
          "enumDescriptions": [
            "Default value. This value is unused.",
            "Tool call span.",
            "User callback span.",
            "Guardrail span.",
            "LLM span."
          ],
          "enum": [
            "TYPE_UNSPECIFIED",
            "TOOL",
            "USER_CALLBACK",
            "GUARDRAIL",
            "LLM"
          ]
        },
        "model": {
          "type": "string",
          "description": "Output only. The name of the LLM span.",
          "readOnly": true
        },
        "toolset": {
          "$ref": "ToolsetTool",
          "readOnly": true,
          "description": "Output only. The toolset tool identifier."
        },
        "startTime": {
          "readOnly": true,
          "type": "string",
          "format": "google-datetime",
          "description": "Output only. The start time of span."
        },
        "displayName": {
          "type": "string",
          "readOnly": true,
          "description": "Output only. The display name of the span. Applicable to tool and guardrail spans."
        },
        "endTime": {
          "readOnly": true,
          "description": "Output only. The end time of span.",
          "type": "string",
          "format": "google-datetime"
        },
        "resource": {
          "readOnly": true,
          "description": "Output only. The resource name of the guardrail or tool spans.",
          "type": "string"
        }
      },
      "type": "object",
      "description": "The latency of a span execution.",
      "id": "EvaluationResultSpanLatency"
    },
    "LfA2aV1TaskStatusUpdateEvent": {
      "properties": {
        "taskId": {
          "type": "string",
          "description": "Required. The ID of the task that has changed."
        },
        "contextId": {
          "description": "Required. The ID of the context that the task belongs to.",
          "type": "string"
        },
        "status": {
          "description": "Required. The new status of the task.",
          "$ref": "LfA2aV1TaskStatus"
        },
        "metadata": {
          "type": "object",
          "additionalProperties": {
            "type": "any",
            "description": "Properties of the object."
          },
          "description": "Optional. Metadata associated with the task update."
        }
      },
      "description": "An event sent by the agent to notify the client of a change in a task's status.",
      "type": "object",
      "id": "LfA2aV1TaskStatusUpdateEvent"
    },
    "App": {
      "description": "An app serves as a top-level container for a group of agents, including the root agent and its sub-agents, along with their associated configurations. These agents work together to achieve specific goals within the app's context.",
      "properties": {
        "audioProcessingConfig": {
          "$ref": "AudioProcessingConfig",
          "description": "Optional. Audio processing configuration of the app."
        },
        "loggingSettings": {
          "$ref": "LoggingSettings",
          "description": "Optional. Logging settings of the app."
        },
        "metadata": {
          "description": "Optional. Metadata about the app. This field can be used to store additional information relevant to the app's details or intended usages.",
          "type": "object",
          "additionalProperties": {
            "type": "string"
          }
        },
        "dashboardSettings": {
          "$ref": "DashboardSettings",
          "description": "Optional. App-specific dashboard settings for linking and configuring Contact Center Insights dashboards."
        },
        "errorHandlingSettings": {
          "$ref": "ErrorHandlingSettings",
          "description": "Optional. Error handling settings of the app."
        },
        "languageSettings": {
          "description": "Optional. Language settings of the app.",
          "$ref": "LanguageSettings"
        },
        "dataStoreSettings": {
          "$ref": "DataStoreSettings",
          "description": "Optional. The data store settings for the app."
        },
        "rootAgent": {
          "description": "Optional. The root agent is the entry point of the app. Format: `projects/{project}/locations/{location}/apps/{app}/agents/{agent}`",
          "type": "string"
        },
        "updateTime": {
          "readOnly": true,
          "format": "google-datetime",
          "type": "string",
          "description": "Output only. Timestamp when the app was last updated."
        },
        "modelSettings": {
          "description": "Optional. The default LLM model settings for the app. Individual resources (e.g. agents, guardrails) can override these configurations as needed.",
          "$ref": "ModelSettings"
        },
        "timeZoneSettings": {
          "$ref": "TimeZoneSettings",
          "description": "Optional. TimeZone settings of the app."
        },
        "displayName": {
          "type": "string",
          "description": "Required. Display name of the app."
        },
        "evaluationPersonas": {
          "items": {
            "$ref": "EvaluationPersona"
          },
          "description": "Optional. The evaluation personas for the app. This field is used to define the personas that can be used for evaluation. Maximum of 30 personas can be defined.",
          "type": "array"
        },
        "locked": {
          "description": "Optional. Indicates whether the app is locked for changes. If the app is locked, modifications to the app resources will be rejected.",
          "type": "boolean"
        },
        "globalInstruction": {
          "type": "string",
          "description": "Optional. Instructions for all the agents in the app. You can use this instruction to set up a stable identity or personality across all the agents."
        },
        "defaultChannelProfile": {
          "description": "Optional. The default channel profile used by the app.",
          "$ref": "ChannelProfile"
        },
        "validationErrors": {
          "description": "Output only. Misconfigurations or warnings in the app.",
          "readOnly": true,
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "clientCertificateSettings": {
          "description": "Optional. The default client certificate settings for the app.",
          "$ref": "ClientCertificateSettings"
        },
        "evaluationMetricsThresholds": {
          "description": "Optional. The evaluation thresholds for the app.",
          "$ref": "EvaluationMetricsThresholds"
        },
        "guardrails": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Optional. List of guardrails for the app. Format: `projects/{project}/locations/{location}/apps/{app}/guardrails/{guardrail}`"
        },
        "toolExecutionMode": {
          "type": "string",
          "enum": [
            "TOOL_EXECUTION_MODE_UNSPECIFIED",
            "PARALLEL",
            "SEQUENTIAL"
          ],
          "description": "Optional. The tool execution mode for the app. If not provided, will default to PARALLEL.",
          "enumDescriptions": [
            "Unspecified tool execution mode. Default to PARALLEL.",
            "If there are multiple tools being selected, they will be executed in parallel, with the same [ToolContext](https://google.github.io/adk-docs/context/#the-different-types-of-context).",
            "If there are multiple tools being selected, they will be executed sequentially. The next tool will only be executed after the previous tool completes and it can see updated [ToolContext](https://google.github.io/adk-docs/context/#the-different-types-of-context) from the previous tool."
          ]
        },
        "deploymentCount": {
          "format": "int32",
          "type": "integer",
          "description": "Output only. Number of deployments in the app.",
          "readOnly": true
        },
        "description": {
          "type": "string",
          "description": "Optional. Human-readable description of the app."
        },
        "name": {
          "type": "string",
          "description": "Identifier. The unique identifier of the app. Format: `projects/{project}/locations/{location}/apps/{app}`"
        },
        "vpcScSettings": {
          "description": "Optional. VPC-SC settings for the app.",
          "$ref": "VpcScSettings"
        },
        "createTime": {
          "type": "string",
          "readOnly": true,
          "description": "Output only. Timestamp when the app was created.",
          "format": "google-datetime"
        },
        "predefinedVariableDeclarations": {
          "readOnly": true,
          "items": {
            "$ref": "AppVariableDeclaration"
          },
          "description": "Output only. The declarations of predefined variables for the app.",
          "type": "array"
        },
        "etag": {
          "type": "string",
          "readOnly": true,
          "description": "Output only. Etag used to ensure the object hasn't changed during a read-modify-write operation. If the etag is empty, the update will overwrite any concurrent changes."
        },
        "pinned": {
          "description": "Optional. Whether the app is pinned in the app list.",
          "type": "boolean"
        },
        "evaluationSettings": {
          "$ref": "EvaluationSettings",
          "description": "Optional. The evaluation settings for the app."
        },
        "variableDeclarations": {
          "description": "Optional. The declarations of the variables.",
          "type": "array",
          "items": {
            "$ref": "AppVariableDeclaration"
          }
        }
      },
      "type": "object",
      "id": "App"
    },
    "DataStoreConnectorConfig": {
      "type": "object",
      "description": "The connector config for the data store connection.",
      "id": "DataStoreConnectorConfig",
      "properties": {
        "collectionDisplayName": {
          "type": "string",
          "description": "Display name of the collection the data store belongs to."
        },
        "collection": {
          "description": "Resource name of the collection the data store belongs to.",
          "type": "string"
        },
        "dataSource": {
          "type": "string",
          "description": "The name of the data source. Example: `salesforce`, `jira`, `confluence`, `bigquery`."
        }
      }
    },
    "ListEvaluationResultsResponse": {
      "type": "object",
      "properties": {
        "evaluationResults": {
          "items": {
            "$ref": "EvaluationResult"
          },
          "description": "The list of evaluation results.",
          "type": "array"
        },
        "nextPageToken": {
          "type": "string",
          "description": "A token that can be sent as ListEvaluationResultsRequest.page_token to retrieve the next page. Absence of this field indicates there are no subsequent pages."
        }
      },
      "description": "Response message for EvaluationService.ListEvaluationResults.",
      "id": "ListEvaluationResultsResponse"
    },
    "EvaluationRunProgress": {
      "type": "object",
      "description": "The progress of the evaluation run.",
      "properties": {
        "totalCount": {
          "readOnly": true,
          "description": "Output only. Total number of evaluation results in this run.",
          "format": "int32",
          "type": "integer"
        },
        "completedCount": {
          "description": "Output only. Number of evaluation results that finished successfully. (EvaluationResult.execution_state is COMPLETED).",
          "type": "integer",
          "format": "int32",
          "readOnly": true
        },
        "cancelledCount": {
          "type": "integer",
          "description": "Output only. Number of evaluation results that were cancelled. (EvaluationResult.execution_state is CANCELLED).",
          "format": "int32",
          "readOnly": true
        },
        "errorCount": {
          "description": "Output only. Number of evaluation results that failed to execute. (EvaluationResult.execution_state is ERROR).",
          "format": "int32",
          "type": "integer",
          "readOnly": true
        },
        "failedCount": {
          "format": "int32",
          "description": "Output only. Number of completed evaluation results with an outcome of FAIL. (EvaluationResult.execution_state is COMPLETED and EvaluationResult.evaluation_status is FAIL).",
          "type": "integer",
          "readOnly": true
        },
        "passedCount": {
          "format": "int32",
          "description": "Output only. Number of completed evaluation results with an outcome of PASS. (EvaluationResult.execution_state is COMPLETED and EvaluationResult.evaluation_status is PASS).",
          "readOnly": true,
          "type": "integer"
        }
      },
      "id": "EvaluationRunProgress"
    },
    "WidgetTool": {
      "description": "Represents a widget tool that the agent can invoke. When the tool is chosen by the agent, agent will return the widget to the client. The client is responsible for processing the widget and generating the next user query to continue the interaction with the agent.",
      "properties": {
        "description": {
          "description": "Optional. The description of the widget tool.",
          "type": "string"
        },
        "dataMapping": {
          "description": "Optional. The mapping that defines how data from a source tool is mapped to the widget's input parameters.",
          "$ref": "WidgetToolDataMapping"
        },
        "textResponseConfig": {
          "description": "Optional. Configuration for always-included text responses.",
          "$ref": "WidgetToolTextResponseConfig"
        },
        "name": {
          "description": "Required. The display name of the widget tool.",
          "type": "string"
        },
        "uiConfig": {
          "additionalProperties": {
            "type": "any",
            "description": "Properties of the object."
          },
          "type": "object",
          "description": "Optional. Configuration for rendering the widget."
        },
        "widgetType": {
          "enumDescriptions": [
            "Unspecified widget type.",
            "Custom widget type.",
            "Product carousel widget.",
            "Product details widget.",
            "Quick actions widget.",
            "Product comparison widget.",
            "Advanced product details widget.",
            "Short form widget.",
            "Overall satisfaction widget.",
            "Order summary widget.",
            "Appointment details widget.",
            "Appointment scheduler widget.",
            "Contact form widget."
          ],
          "type": "string",
          "enum": [
            "WIDGET_TYPE_UNSPECIFIED",
            "CUSTOM",
            "PRODUCT_CAROUSEL",
            "PRODUCT_DETAILS",
            "QUICK_ACTIONS",
            "PRODUCT_COMPARISON",
            "ADVANCED_PRODUCT_DETAILS",
            "SHORT_FORM",
            "OVERALL_SATISFACTION",
            "ORDER_SUMMARY",
            "APPOINTMENT_DETAILS",
            "APPOINTMENT_SCHEDULER",
            "CONTACT_FORM"
          ],
          "description": "Optional. The type of the widget tool. If not specified, the default type will be CUSTOMIZED."
        },
        "parameters": {
          "$ref": "Schema",
          "description": "Optional. The input parameters of the widget tool."
        }
      },
      "type": "object",
      "id": "WidgetTool"
    },
    "ConnectorToolset": {
      "type": "object",
      "properties": {
        "connection": {
          "description": "Required. The full resource name of the referenced Integration Connectors Connection. Format: `projects/{project}/locations/{location}/connections/{connection}`",
          "type": "string"
        },
        "connectorActions": {
          "type": "array",
          "items": {
            "$ref": "Action"
          },
          "description": "Required. The list of connector actions/entity operations to generate tools for."
        },
        "authConfig": {
          "$ref": "EndUserAuthConfig",
          "description": "Optional. Configures how authentication is handled in Integration Connectors. By default, an admin authentication is passed in the Integration Connectors API requests. You can override it with a different end-user authentication config. **Note**: The Connection must have authentication override enabled in order to specify an EUC configuration here - otherwise, the Toolset creation will fail. See: https://cloud.google.com/application-integration/docs/configure-connectors-task#configure-authentication-override"
        }
      },
      "id": "ConnectorToolset",
      "description": "A toolset that generates tools from an Integration Connectors Connection."
    },
    "ScheduledEvaluationRunSchedulingConfig": {
      "type": "object",
      "properties": {
        "startTime": {
          "description": "Required. Timestamp when the eval should start.",
          "format": "google-datetime",
          "type": "string"
        },
        "daysOfWeek": {
          "description": "Optional. The days of the week to run the eval. Applicable only for Weekly and Biweekly frequencies. 1 is Monday, 2 is Tuesday, ..., 7 is Sunday.",
          "type": "array",
          "items": {
            "format": "int32",
            "type": "integer"
          }
        },
        "frequency": {
          "enumDescriptions": [
            "The frequency is unspecified.",
            "Indicates a one-time scheduled run that should not repeat",
            "Run the evaluation daily.",
            "Run the evaluation weekly.",
            "Run the evaluation biweekly."
          ],
          "description": "Required. The frequency with which to run the eval",
          "type": "string",
          "enum": [
            "FREQUENCY_UNSPECIFIED",
            "NONE",
            "DAILY",
            "WEEKLY",
            "BIWEEKLY"
          ]
        }
      },
      "id": "ScheduledEvaluationRunSchedulingConfig",
      "description": "Eval scheduling configuration details"
    },
    "LfA2aV1AgentSkill": {
      "description": "Represents a distinct capability or function that an agent can perform.",
      "id": "LfA2aV1AgentSkill",
      "properties": {
        "id": {
          "type": "string",
          "description": "Required. A unique identifier for the agent's skill."
        },
        "securityRequirements": {
          "type": "array",
          "description": "Security schemes necessary for this skill.",
          "items": {
            "$ref": "LfA2aV1SecurityRequirement"
          }
        },
        "description": {
          "type": "string",
          "description": "Required. A detailed description of the skill."
        },
        "name": {
          "description": "Required. A human-readable name for the skill.",
          "type": "string"
        },
        "examples": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Example prompts or scenarios that this skill can handle."
        },
        "tags": {
          "description": "Required. A set of keywords describing the skill's capabilities.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "outputModes": {
          "description": "The set of supported output media types for this skill, overriding the agent's defaults.",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "inputModes": {
          "description": "The set of supported input media types for this skill, overriding the agent's defaults.",
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "type": "object"
    },
    "EvaluationPersonaSpeechConfig": {
      "id": "EvaluationPersonaSpeechConfig",
      "description": "Configuration for Text-to-Speech generation.",
      "type": "object",
      "properties": {
        "environment": {
          "enumDescriptions": [
            "Background environment unspecified.",
            "Call center environment.",
            "Traffic noise environment.",
            "Kids noise environment.",
            "Cafe environment."
          ],
          "type": "string",
          "enum": [
            "BACKGROUND_ENVIRONMENT_UNSPECIFIED",
            "CALL_CENTER",
            "TRAFFIC",
            "KIDS_NOISE",
            "CAFE"
          ],
          "description": "Optional. The simulated audio environment."
        },
        "voiceId": {
          "description": "Optional. The specific voice identifier/accent to use. Example: \"en-US-Wavenet-D\" or \"en-GB-Standard-A\"",
          "type": "string"
        },
        "speakingRate": {
          "format": "double",
          "type": "number",
          "description": "Optional. The speaking rate. 1.0 is normal. Lower is slower (e.g., 0.8), higher is faster (e.g., 1.5). Useful for testing how the agent handles fast talkers."
        }
      }
    },
    "StreamChatAiAssistantResponse": {
      "type": "object",
      "id": "StreamChatAiAssistantResponse",
      "description": "Response message for SessionService.StreamChatAiAssistant.",
      "properties": {
        "eventTime": {
          "format": "google-datetime",
          "type": "string",
          "description": "Timestamp when the event occurred."
        },
        "handoff": {
          "$ref": "TurnHandoffEvent",
          "description": "Tells the client to silently reconnect with resume_from_sequence_number: the task serving this stream is going away and the turn will continue elsewhere. Not an error; the stream completes normally after this event."
        },
        "status": {
          "$ref": "Status",
          "description": "Simple status update."
        },
        "optionQuestionsChunk": {
          "$ref": "OptionQuestionsChunk",
          "description": "Structured clarification options parsed out of the model turn. The console renders these as a selectable option list instead of raw text."
        },
        "turnCompleted": {
          "$ref": "TurnCompletedEvent",
          "description": "The turn has ended. Sent as the last event of every turn, on the original stream and on every attached or resumed stream, so clients can end the turn on an explicit signal instead of inferring it from stream closure."
        },
        "toolCall": {
          "description": "Tool call execution event.",
          "$ref": "ToolCall"
        },
        "sequenceNumber": {
          "type": "string",
          "description": "Optional. Monotonically increasing sequence number for this session turn.",
          "format": "int64"
        },
        "toolResponse": {
          "$ref": "ToolResponse",
          "description": "Tool call response event."
        },
        "sessionCheckpoint": {
          "$ref": "SessionCheckpoint",
          "description": "Session checkpoint/compaction recap event containing user intent and rolling summary."
        },
        "turnMetadata": {
          "description": "Optional. Turn-level metadata and intent categorization.",
          "$ref": "TurnMetadata"
        },
        "thoughtChunk": {
          "description": "Thought text chunk (agent's reasoning before generating response).",
          "type": "string"
        },
        "confirmationRequest": {
          "description": "A blocking confirmation the agent paused on. The agent resumes when the answer arrives on a later request's `confirmation_response`. Only sent to clients that declared the CONFIRMATION_CARDS capability on the request.",
          "$ref": "AssistantConfirmationRequest"
        },
        "uiEvent": {
          "description": "Optional. UI event payload.",
          "$ref": "UiEvent"
        },
        "artifactChunk": {
          "$ref": "ArtifactChunk",
          "description": "Generated-document artifact event (live preview deltas + final Cloud Storage pointer)."
        },
        "turnInProgress": {
          "description": "Optional. Indicates whether the turn is still actively running in the background.",
          "type": "boolean"
        },
        "resumeSnapshot": {
          "description": "A compacted replay of an in-flight turn, sent as the first event of every attach or resume before any live event. The client replaces any locally rendered state for this turn with the snapshot's contents.",
          "$ref": "TurnResumeSnapshot"
        },
        "textChunk": {
          "type": "string",
          "description": "Text Token (for streaming Gemini responses word-by-word)."
        },
        "eventId": {
          "type": "string",
          "description": "Unique identifier for the event."
        }
      }
    },
    "EvaluationScenarioExpectationToolExpectation": {
      "properties": {
        "expectedToolCall": {
          "$ref": "ToolCall",
          "description": "Required. The expected tool call, with the parameters of interest specified. Any parameters not specified will be hallucinated by the LLM."
        },
        "mockToolResponse": {
          "$ref": "ToolResponse",
          "description": "Required. The tool response to mock, with the parameters of interest specified. Any parameters not specified will be hallucinated by the LLM."
        }
      },
      "id": "EvaluationScenarioExpectationToolExpectation",
      "type": "object",
      "description": "The tool call and response pair to be evaluated."
    },
    "EvaluationMetricsConfigHallucinationMetricsConfig": {
      "id": "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.",
      "type": "object",
      "properties": {
        "enableHallucinationMetrics": {
          "description": "Optional. Whether to calculate hallucination metrics for the evaluation.",
          "type": "boolean"
        }
      }
    },
    "Empty": {
      "type": "object",
      "properties": {},
      "id": "Empty",
      "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }"
    },
    "TriggerActionRespondImmediately": {
      "id": "TriggerActionRespondImmediately",
      "properties": {
        "responses": {
          "description": "Required. The canned responses for the agent to choose from. The response is chosen randomly.",
          "type": "array",
          "items": {
            "$ref": "TriggerActionResponse"
          }
        }
      },
      "type": "object",
      "description": "The agent will immediately respond with a preconfigured response."
    },
    "ErrorHandlingSettingsFallbackResponseConfig": {
      "id": "ErrorHandlingSettingsFallbackResponseConfig",
      "properties": {
        "maxFallbackAttempts": {
          "description": "Optional. The maximum number of fallback attempts to make before the agent emitting EndSession Signal.",
          "format": "int32",
          "type": "integer"
        },
        "customFallbackMessages": {
          "additionalProperties": {
            "type": "string"
          },
          "type": "object",
          "description": "Optional. The fallback messages in case of system errors (e.g. LLM errors), mapped by [supported language code](https://docs.cloud.google.com/customer-engagement-ai/conversational-agents/ps/reference/language)."
        }
      },
      "type": "object",
      "description": "Configuration for handling fallback responses."
    },
    "FileContextFileBytes": {
      "description": "File provided as raw bytes.",
      "properties": {
        "fileName": {
          "type": "string",
          "description": "Required. The name of the file provided as raw bytes."
        },
        "mimeType": {
          "description": "Required. The IANA standard MIME type of the source data.",
          "type": "string"
        },
        "data": {
          "format": "byte",
          "type": "string",
          "description": "Required. Raw bytes of the file."
        }
      },
      "type": "object",
      "id": "FileContextFileBytes"
    },
    "TransferRule": {
      "description": "Rule for transferring to a specific agent.",
      "id": "TransferRule",
      "properties": {
        "deterministicTransfer": {
          "description": "Optional. A rule that immediately transfers to the target agent when the condition is met.",
          "$ref": "TransferRuleDeterministicTransfer"
        },
        "disablePlannerTransfer": {
          "$ref": "TransferRuleDisablePlannerTransfer",
          "description": "Optional. Rule that prevents the planner from transferring to the target agent."
        },
        "direction": {
          "enumDescriptions": [
            "Unspecified direction.",
            "Transfer from the parent agent to the child agent.",
            "Transfer from the child agent to the parent agent."
          ],
          "type": "string",
          "enum": [
            "DIRECTION_UNSPECIFIED",
            "PARENT_TO_CHILD",
            "CHILD_TO_PARENT"
          ],
          "description": "Required. The direction of the transfer."
        },
        "childAgent": {
          "type": "string",
          "description": "Required. The resource name of the child agent the rule applies to. Format: `projects/{project}/locations/{location}/apps/{app}/agents/{agent}`"
        }
      },
      "type": "object"
    },
    "EvaluationResultTaskCompletionResult": {
      "type": "object",
      "properties": {
        "explanation": {
          "description": "Output only. The explanation for the task completion score.",
          "type": "string",
          "readOnly": true
        },
        "label": {
          "description": "Output only. The label associated with each score. Score 1: Task Completed Score 0: Task Not Completed Score -1: User Goal Undefined",
          "type": "string",
          "readOnly": true
        },
        "score": {
          "format": "int32",
          "type": "integer",
          "readOnly": true,
          "description": "Output only. The task completion score. Can be -1, 0, 1"
        }
      },
      "id": "EvaluationResultTaskCompletionResult",
      "description": "The result of the task completion check for the conversation."
    },
    "EvaluationExpectationLlmCriteria": {
      "properties": {
        "prompt": {
          "type": "string",
          "description": "Required. The prompt/instructions provided to the LLM judge."
        }
      },
      "type": "object",
      "id": "EvaluationExpectationLlmCriteria",
      "description": "Configuration for LLM-based evaluation criteria."
    },
    "ListAssistantSessionsResponse": {
      "type": "object",
      "id": "ListAssistantSessionsResponse",
      "properties": {
        "nextPageToken": {
          "type": "string",
          "description": "Optional. A token that can be sent as ListAssistantSessionsRequest.page_token to retrieve the next page. Absence of this field indicates there are no subsequent pages."
        },
        "assistantSessions": {
          "description": "The list of assistant sessions.",
          "type": "array",
          "items": {
            "$ref": "AssistantSession"
          }
        }
      },
      "description": "Response message for AssistantService.ListAssistantSessions."
    },
    "AgentTool": {
      "properties": {
        "name": {
          "type": "string",
          "description": "Required. The name of the agent tool."
        },
        "description": {
          "description": "Optional. Description of the tool's purpose.",
          "type": "string"
        },
        "agent": {
          "type": "string",
          "description": "Optional. The resource name of the agent that is the entry point of the tool. Format: `projects/{project}/locations/{location}/agents/{agent}`"
        }
      },
      "id": "AgentTool",
      "type": "object",
      "description": "Represents a tool that allows the agent to call another agent."
    },
    "AppVariableDeclaration": {
      "properties": {
        "name": {
          "description": "Required. The name of the variable. The name must start with a letter or underscore and contain only letters, numbers, or underscores.",
          "type": "string"
        },
        "description": {
          "type": "string",
          "description": "Required. The description of the variable."
        },
        "schema": {
          "$ref": "Schema",
          "description": "Required. The schema of the variable."
        }
      },
      "id": "AppVariableDeclaration",
      "type": "object",
      "description": "Defines the structure and metadata for a variable."
    },
    "AgentSkill": {
      "properties": {
        "inputModes": {
          "description": "The set of supported input media types for this skill, overriding the agent's defaults.",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "examples": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Example prompts or scenarios that this skill can handle."
        },
        "description": {
          "description": "Required. A detailed description of the skill.",
          "type": "string"
        },
        "name": {
          "description": "Required. A human-readable name for the skill.",
          "type": "string"
        },
        "outputModes": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "description": "The set of supported output media types for this skill, overriding the agent's defaults."
        },
        "tags": {
          "description": "Required. A set of keywords describing the skill's capabilities.",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "id": {
          "type": "string",
          "description": "Required. A unique identifier for the agent's skill."
        }
      },
      "description": "Represents a distinct capability or function that an agent can perform.",
      "id": "AgentSkill",
      "type": "object"
    },
    "EvaluationResultScenarioExpectationOutcomeObservedToolCall": {
      "type": "object",
      "id": "EvaluationResultScenarioExpectationOutcomeObservedToolCall",
      "properties": {
        "toolResponse": {
          "description": "Output only. The observed tool response.",
          "$ref": "ToolResponse",
          "readOnly": true
        },
        "toolCall": {
          "description": "Output only. The observed tool call.",
          "readOnly": true,
          "$ref": "ToolCall"
        }
      },
      "description": "The observed tool call and response."
    },
    "BearerTokenConfig": {
      "properties": {
        "token": {
          "type": "string",
          "description": "Required. The bearer token. Must be in the format `$context.variables.`."
        }
      },
      "description": "Configurations for authentication with a bearer token.",
      "type": "object",
      "id": "BearerTokenConfig"
    },
    "UploadEvaluationAudioResponse": {
      "id": "UploadEvaluationAudioResponse",
      "description": "Response message for EvaluationService.UploadEvaluationAudio.",
      "type": "object",
      "properties": {
        "audioGcsUri": {
          "type": "string",
          "description": "The Google Cloud Storage URI where the uploaded audio file is stored. Format: `gs:///`"
        },
        "duration": {
          "format": "google-duration",
          "description": "The duration of the audio.",
          "type": "string"
        },
        "transcript": {
          "description": "The transcript of the audio, generated by Cloud Speech-to-Text.",
          "type": "string"
        }
      }
    },
    "RunAssistantRequest": {
      "type": "object",
      "properties": {
        "interactionType": {
          "type": "string",
          "enum": [
            "INTERACTION_TYPE_UNSPECIFIED",
            "NEW_MESSAGE",
            "POLL",
            "DISMISS"
          ],
          "description": "Optional. Different interaction types for the assistant message.",
          "enumDescriptions": [
            "The default value. This value is used if the type is not specified.",
            "The message is a user input. User input is provided in the chunk list.",
            "The message is for polling the state of the assistant session.",
            "The message is to dismiss the assistant session pending review. This will change the state of the assistant session to idle."
          ]
        },
        "assistantSession": {
          "description": "Required. The assistant session to be used to run the assistant. Format: `projects/{project}/locations/{location}/apps/{app}/assistantSessions/{assistant_session}`",
          "type": "string"
        },
        "message": {
          "$ref": "AssistantMessage",
          "description": "Required. The message to send to the assistant agent."
        }
      },
      "id": "RunAssistantRequest",
      "description": "Request message for AssistantService.RunAssistant."
    },
    "RetrieveToolsRequest": {
      "properties": {
        "toolIds": {
          "items": {
            "type": "string"
          },
          "description": "Optional. The identifiers of the tools to retrieve from the toolset. If empty, all tools in the toolset will be returned.",
          "type": "array"
        },
        "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"
        }
      },
      "description": "Request message for ToolService.RetrieveTools.",
      "id": "RetrieveToolsRequest",
      "type": "object"
    },
    "LatencyReportCallbackLatency": {
      "description": "Latency metrics for a single callback.",
      "id": "LatencyReportCallbackLatency",
      "properties": {
        "latencyMetrics": {
          "readOnly": true,
          "description": "Output only. The latency metrics for the callback.",
          "$ref": "LatencyReportLatencyMetrics"
        },
        "stage": {
          "description": "Output only. The stage of the callback.",
          "readOnly": true,
          "type": "string"
        }
      },
      "type": "object"
    },
    "ListToolsResponse": {
      "id": "ListToolsResponse",
      "description": "Response message for AgentService.ListTools.",
      "type": "object",
      "properties": {
        "nextPageToken": {
          "type": "string",
          "description": "A token that can be sent as ListToolsRequest.page_token to retrieve the next page. Absence of this field indicates there are no subsequent pages."
        },
        "tools": {
          "type": "array",
          "items": {
            "$ref": "Tool"
          },
          "description": "The list of tools."
        }
      }
    },
    "EvaluationGolden": {
      "type": "object",
      "id": "EvaluationGolden",
      "description": "The steps required to replay a golden conversation.",
      "properties": {
        "turns": {
          "type": "array",
          "description": "Required. The golden turns required to replay a golden conversation. The maximum number of allowed turns is 100.",
          "items": {
            "$ref": "EvaluationGoldenTurn"
          }
        },
        "evaluationExpectations": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Optional. The evaluation expectations to evaluate the replayed conversation against. Format: `projects/{project}/locations/{location}/apps/{app}/evaluationExpectations/{evaluationExpectation}`"
        }
      }
    },
    "EvaluationResultGoldenExpectationOutcome": {
      "id": "EvaluationResultGoldenExpectationOutcome",
      "properties": {
        "observedToolResponse": {
          "readOnly": true,
          "$ref": "ToolResponse",
          "description": "Output only. The result of the tool response expectation."
        },
        "expectation": {
          "description": "Output only. The expectation that was evaluated.",
          "readOnly": true,
          "$ref": "EvaluationGoldenExpectation"
        },
        "toolInvocationResult": {
          "readOnly": true,
          "description": "Output only. The result of the tool invocation check.",
          "$ref": "EvaluationResultGoldenExpectationOutcomeToolInvocationResult"
        },
        "observedPayload": {
          "additionalProperties": {
            "type": "any",
            "description": "Properties of the object."
          },
          "readOnly": true,
          "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.",
          "type": "object"
        },
        "observedToolCall": {
          "$ref": "ToolCall",
          "readOnly": true,
          "description": "Output only. The result of the tool call expectation."
        },
        "observedAgentResponse": {
          "$ref": "Message",
          "readOnly": true,
          "description": "Output only. The result of the agent response expectation."
        },
        "semanticSimilarityResult": {
          "deprecated": true,
          "readOnly": true,
          "$ref": "EvaluationResultSemanticSimilarityResult",
          "description": "Output only. The result of the semantic similarity check."
        },
        "outcome": {
          "enum": [
            "OUTCOME_UNSPECIFIED",
            "PASS",
            "FAIL",
            "SKIPPED"
          ],
          "description": "Output only. The outcome of the expectation.",
          "readOnly": true,
          "type": "string",
          "enumDescriptions": [
            "Evaluation outcome is not specified.",
            "Evaluation/Expectation passed. In the case of an evaluation, this means that all expectations were met.",
            "Evaluation/Expectation failed. In the case of an evaluation, this means that at least one expectation was not met.",
            "Evaluation/Expectation was skipped."
          ]
        },
        "observedAgentTransfer": {
          "description": "Output only. The result of the agent transfer expectation.",
          "readOnly": true,
          "$ref": "AgentTransfer"
        }
      },
      "description": "Specifies the expectation and the result of that expectation.",
      "type": "object"
    },
    "AggregatedMetrics": {
      "description": "Aggregated metrics for an evaluation or evaluation dataset.",
      "properties": {
        "metricsByAppVersion": {
          "items": {
            "$ref": "AggregatedMetricsMetricsByAppVersion"
          },
          "description": "Output only. Aggregated metrics, grouped by app version ID.",
          "readOnly": true,
          "type": "array"
        }
      },
      "type": "object",
      "id": "AggregatedMetrics"
    },
    "ServiceDirectoryConfig": {
      "id": "ServiceDirectoryConfig",
      "type": "object",
      "description": "Configuration for tools using Service Directory.",
      "properties": {
        "service": {
          "description": "Required. The name of [Service Directory](https://cloud.google.com/service-directory) service. Format: `projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}`. Location of the service directory must be the same as the location of the app.",
          "type": "string"
        }
      }
    },
    "RetrieveToolSchemaResponse": {
      "id": "RetrieveToolSchemaResponse",
      "type": "object",
      "description": "Response message for ToolService.RetrieveToolSchema.",
      "properties": {
        "toolsetTool": {
          "description": "The toolset tool that the schema is for.",
          "$ref": "ToolsetTool"
        },
        "inputSchema": {
          "description": "The schema of the tool input parameters.",
          "$ref": "Schema"
        },
        "outputSchema": {
          "$ref": "Schema",
          "description": "The schema of the tool output parameters."
        },
        "tool": {
          "description": "The name of the tool that the schema is for. Format: `projects/{project}/locations/{location}/apps/{app}/tools/{tool}`",
          "type": "string"
        }
      }
    },
    "SystemTool": {
      "description": "Pre-defined system tool.",
      "properties": {
        "description": {
          "description": "Output only. The description of the system tool.",
          "type": "string",
          "readOnly": true
        },
        "name": {
          "type": "string",
          "description": "Required. The name of the system tool."
        }
      },
      "id": "SystemTool",
      "type": "object"
    },
    "ExportEvaluationsRequest": {
      "properties": {
        "names": {
          "description": "Required. The resource names of the evaluations to export.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "exportOptions": {
          "$ref": "ExportOptions",
          "description": "Optional. The export options for the evaluations."
        },
        "includeEvaluationResults": {
          "type": "boolean",
          "description": "Optional. Includes evaluation results in the export. At least one of include_evaluation_results or include_evaluations must be set."
        },
        "includeEvaluations": {
          "description": "Optional. Includes evaluations in the export. At least one of include_evaluation_results or include_evaluations must be set.",
          "type": "boolean"
        }
      },
      "description": "Request message for EvaluationService.ExportEvaluations.",
      "id": "ExportEvaluationsRequest",
      "type": "object"
    },
    "TimeZoneSettings": {
      "id": "TimeZoneSettings",
      "description": "TimeZone settings of the app.",
      "type": "object",
      "properties": {
        "timeZone": {
          "description": "Optional. The time zone of the app from the [time zone database](https://www.iana.org/time-zones), e.g., America/Los_Angeles, Europe/Paris.",
          "type": "string"
        }
      }
    },
    "OAuthConfig": {
      "description": "Configurations for authentication with OAuth.",
      "type": "object",
      "properties": {
        "oauthGrantType": {
          "type": "string",
          "enum": [
            "OAUTH_GRANT_TYPE_UNSPECIFIED",
            "CLIENT_CREDENTIAL"
          ],
          "description": "Required. OAuth grant types.",
          "enumDescriptions": [
            "Unspecified. Defaults to CLIENT_CREDENTIAL.",
            "Represents the [client credential flow](https://oauth.net/2/grant-types/client-credentials)."
          ]
        },
        "clientSecretVersion": {
          "type": "string",
          "description": "Required. The name of the SecretManager secret version resource storing the client secret. Format: `projects/{project}/secrets/{secret}/versions/{version}` Note: You should grant `roles/secretmanager.secretAccessor` role to the CES service agent `service-@gcp-sa-ces.iam.gserviceaccount.com`."
        },
        "clientId": {
          "description": "Required. The client ID from the OAuth provider.",
          "type": "string"
        },
        "scopes": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Optional. The OAuth scopes to grant."
        },
        "tokenEndpoint": {
          "type": "string",
          "description": "Required. The token endpoint in the OAuth provider to exchange for an access token."
        }
      },
      "id": "OAuthConfig"
    },
    "ExecuteToolRequest": {
      "type": "object",
      "properties": {
        "variables": {
          "type": "object",
          "description": "Optional. The variables that are available for the tool execution.",
          "additionalProperties": {
            "type": "any",
            "description": "Properties of the object."
          }
        },
        "toolsetTool": {
          "description": "Optional. The toolset tool to execute. Only one tool should match the predicate from the toolset. Otherwise, an error will be returned.",
          "$ref": "ToolsetTool"
        },
        "mockConfig": {
          "$ref": "MockConfig",
          "description": "Optional. Mock configuration for the tool execution. If this field is set, tools that call other tools will be mocked based on the provided patterns and responses."
        },
        "args": {
          "description": "Optional. The input parameters and values for the tool in JSON object format.",
          "additionalProperties": {
            "type": "any",
            "description": "Properties of the object."
          },
          "type": "object"
        },
        "context": {
          "additionalProperties": {
            "description": "Properties of the object.",
            "type": "any"
          },
          "description": "Optional. The [ToolCallContext](https://docs.cloud.google.com/customer-engagement-ai/conversational-agents/ps/tool/python#environment for details) to be passed to the Python tool.",
          "type": "object"
        },
        "tool": {
          "type": "string",
          "description": "Optional. The name of the tool to execute. Format: projects/{project}/locations/{location}/apps/{app}/tools/{tool}"
        }
      },
      "description": "Request message for ToolService.ExecuteTool.",
      "id": "ExecuteToolRequest"
    },
    "ImportEvaluationsRequestConversationList": {
      "type": "object",
      "properties": {
        "conversations": {
          "items": {
            "type": "string"
          },
          "description": "Optional. Conversation resource names.",
          "type": "array"
        }
      },
      "description": "A list of conversation resource names.",
      "id": "ImportEvaluationsRequestConversationList"
    },
    "RunEvaluationRequest": {
      "id": "RunEvaluationRequest",
      "type": "object",
      "properties": {
        "scheduledEvaluationRun": {
          "description": "Optional. The resource name of the `ScheduledEvaluationRun` that is triggering this evaluation run. If this field is set, the `scheduled_evaluation_run` field on the created `EvaluationRun` resource will be populated from this value. Format: `projects/{project}/locations/{location}/apps/{app}/scheduledEvaluationRuns/{scheduled_evaluation_run}`",
          "type": "string"
        },
        "appVersion": {
          "type": "string",
          "description": "Optional. The app version to evaluate. At most one of `app_version` or `deployment` can be set. Format: `projects/{project}/locations/{location}/apps/{app}/versions/{version}`"
        },
        "personaRunConfigs": {
          "type": "array",
          "description": "Optional. The configuration to use for the run per persona.",
          "items": {
            "$ref": "PersonaRunConfig"
          }
        },
        "app": {
          "description": "Required. The app to evaluate. Format: `projects/{project}/locations/{location}/apps/{app}`",
          "type": "string"
        },
        "evaluationDataset": {
          "description": "Optional. An evaluation dataset to run. Format: `projects/{project}/locations/{location}/apps/{app}/evaluationDatasets/{evaluationDataset}`",
          "type": "string"
        },
        "goldenRunMethod": {
          "enumDescriptions": [
            "Run method is not specified.",
            "Run the evaluation as stable replay, where each turn is a unique session with the previous expected turns injected as context.",
            "Run the evaluation as naive replay, where the run is a single session with no context injected."
          ],
          "type": "string",
          "enum": [
            "GOLDEN_RUN_METHOD_UNSPECIFIED",
            "STABLE",
            "NAIVE"
          ],
          "description": "Optional. The method to run the evaluation if it is a golden evaluation. If not set, default to STABLE."
        },
        "evaluationRunCachingSettings": {
          "$ref": "EvaluationRunCachingSettings",
          "description": "Optional. The caching settings to use for the evaluation run."
        },
        "evaluations": {
          "description": "Optional. List of evaluations to run. Format: `projects/{project}/locations/{location}/apps/{app}/evaluations/{evaluation}`",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "generateLatencyReport": {
          "type": "boolean",
          "description": "Optional. Whether to generate a latency report for the evaluation run."
        },
        "runCount": {
          "format": "int32",
          "type": "integer",
          "description": "Optional. The number of times to run the evaluation. If not set, the default value is 1 per golden, and 5 per scenario."
        },
        "config": {
          "description": "Optional. The configuration to use for the run.",
          "$ref": "EvaluationConfig"
        },
        "optimizationConfig": {
          "description": "Optional. Configuration for running the optimization step after the evaluation run. If not set, the optimization step will not be run.",
          "$ref": "OptimizationConfig"
        },
        "displayName": {
          "type": "string",
          "description": "Optional. The display name of the evaluation run."
        }
      },
      "description": "Request message for EvaluationService.RunEvaluation."
    },
    "BargeInConfig": {
      "type": "object",
      "properties": {
        "disableBargeIn": {
          "description": "Optional. Deprecated: `disable_barge_in` is deprecated in favor of `disable_barge_in_control` in ChannelProfile. Disables user barge-in while the agent is speaking. If true, user input during agent response playback will be ignored.",
          "deprecated": true,
          "type": "boolean"
        },
        "bargeInAwareness": {
          "description": "Optional. If enabled, the agent will adapt its next response based on the assumption that the user hasn't heard the full preceding agent message. This should not be used in scenarios where agent responses are displayed visually.",
          "type": "boolean"
        }
      },
      "id": "BargeInConfig",
      "description": "Configuration for how the user barge-in activities should be handled."
    },
    "MockedToolCall": {
      "type": "object",
      "description": "A mocked tool call. Expresses the target tool + a pattern to match against that tool's args / inputs. If the pattern matches, then the mock response will be returned.",
      "id": "MockedToolCall",
      "properties": {
        "tool": {
          "description": "Optional. Deprecated. Use tool_identifier instead.",
          "deprecated": true,
          "type": "string"
        },
        "toolId": {
          "type": "string",
          "description": "Optional. The name of the tool to mock. Format: `projects/{project}/locations/{location}/apps/{app}/tools/{tool}`"
        },
        "expectedArgsPattern": {
          "description": "Required. A pattern to match against the args / inputs of all dispatched tool calls. If the tool call inputs match this pattern, then mock output will be returned.",
          "additionalProperties": {
            "description": "Properties of the object.",
            "type": "any"
          },
          "type": "object"
        },
        "mockResponse": {
          "description": "Optional. The mock response / output to return if the tool call args / inputs match the pattern.",
          "additionalProperties": {
            "type": "any",
            "description": "Properties of the object."
          },
          "type": "object"
        },
        "toolset": {
          "description": "Optional. The toolset to mock.",
          "$ref": "ToolsetTool"
        }
      }
    },
    "EvaluationGoldenTurn": {
      "description": "A golden turn defines a single turn in a golden conversation.",
      "id": "EvaluationGoldenTurn",
      "type": "object",
      "properties": {
        "rootSpan": {
          "$ref": "Span",
          "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."
        },
        "hallucinationMetricBehaviorOverride": {
          "description": "Optional. Override for turn-level hallucination metric behavior.",
          "enumDescriptions": [
            "Unspecified hallucination metric behavior.",
            "Disable hallucination metric.",
            "Enable hallucination metric."
          ],
          "type": "string",
          "enum": [
            "HALLUCINATION_METRIC_BEHAVIOR_UNSPECIFIED",
            "DISABLED",
            "ENABLED"
          ]
        },
        "steps": {
          "description": "Required. The steps required to replay a golden conversation.",
          "type": "array",
          "items": {
            "$ref": "EvaluationStep"
          }
        },
        "turnLevelMetricsThresholdsOverride": {
          "description": "Optional. Overrides for turn-level metric thresholds.",
          "$ref": "EvaluationMetricsThresholdsGoldenEvaluationMetricsThresholdsTurnLevelMetricsThresholds"
        }
      }
    },
    "DataStoreToolBoostSpecConditionBoostSpec": {
      "properties": {
        "boost": {
          "description": "Optional. Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0. Setting to 1.0 gives the suggestions a big promotion. However, it does not necessarily mean that the top result will be a boosted suggestion. Setting to -1.0 gives the suggestions a big demotion. However, other suggestions that are relevant might still be shown. Setting to 0.0 means no boost applied. The boosting condition is ignored.",
          "type": "number",
          "format": "float"
        },
        "condition": {
          "description": "Required. An expression which specifies a boost condition. The syntax is the same as filter expression syntax. Currently, the only supported condition is a list of BCP-47 lang codes. Example: To boost suggestions in languages en or fr: (lang_code: ANY(\"en\", \"fr\"))",
          "type": "string"
        },
        "boostControlSpec": {
          "description": "Optional. Complex specification for custom ranking based on customer defined attribute value.",
          "$ref": "DataStoreToolBoostSpecConditionBoostSpecBoostControlSpec"
        }
      },
      "type": "object",
      "id": "DataStoreToolBoostSpecConditionBoostSpec",
      "description": "Boost specification for a condition."
    },
    "CancelOperationRequest": {
      "properties": {},
      "type": "object",
      "id": "CancelOperationRequest",
      "description": "The request message for Operations.CancelOperation."
    },
    "LfA2aV1Artifact": {
      "id": "LfA2aV1Artifact",
      "properties": {
        "name": {
          "type": "string",
          "description": "A human readable name for the artifact."
        },
        "artifactId": {
          "description": "Required. Unique identifier (e.g. UUID) for the artifact. It must be unique within a task.",
          "type": "string"
        },
        "parts": {
          "items": {
            "$ref": "LfA2aV1Part"
          },
          "description": "Required. The content of the artifact. Must contain at least one part.",
          "type": "array"
        },
        "extensions": {
          "type": "array",
          "description": "The URIs of extensions that are present or contributed to this Artifact.",
          "items": {
            "type": "string"
          }
        },
        "metadata": {
          "description": "Optional. Metadata included with the artifact.",
          "type": "object",
          "additionalProperties": {
            "type": "any",
            "description": "Properties of the object."
          }
        },
        "description": {
          "type": "string",
          "description": "Optional. A human readable description of the artifact."
        }
      },
      "type": "object",
      "description": "Artifacts represent task outputs."
    },
    "AssistantSession": {
      "type": "object",
      "id": "AssistantSession",
      "description": "An assistant session represents a conversation between a user and the assistant agent.",
      "properties": {
        "updateTime": {
          "format": "google-datetime",
          "readOnly": true,
          "description": "Output only. The time the assistant session was last updated.",
          "type": "string"
        },
        "activeTurn": {
          "readOnly": true,
          "$ref": "ActiveTurnInfo",
          "description": "Output only. Attachment info for this session's currently running turn. Unset when no turn is running."
        },
        "artifacts": {
          "type": "array",
          "description": "Output only. Document artifacts (e.g. generated TDDs in markdown) produced by the assistant in this session. Pointers only; the file content lives in the customer's Cloud Storage bucket.",
          "readOnly": true,
          "items": {
            "$ref": "AssistantSessionArtifact"
          }
        },
        "requestor": {
          "type": "string",
          "readOnly": true,
          "description": "Output only. The user who initiated the session."
        },
        "createTime": {
          "format": "google-datetime",
          "readOnly": true,
          "description": "Output only. The time the assistant session was created.",
          "type": "string"
        },
        "messages": {
          "items": {
            "$ref": "AssistantMessage"
          },
          "type": "array",
          "description": "Optional. History of messages in the session."
        },
        "touchedApps": {
          "readOnly": true,
          "description": "Output only. Apps this session has targeted or changed (project-scoped sessions only), for history tags. Format: `projects/{project}/locations/{location}/apps/{app}`",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "sessionCheckpoint": {
          "description": "Output only. Session checkpoint containing user intent and rolling history summary.",
          "readOnly": true,
          "$ref": "SessionCheckpoint"
        },
        "userResponseSuggestions": {
          "description": "Output only. Suggested user responses from the assistant agent.",
          "$ref": "UserResponseSuggestions",
          "readOnly": true
        },
        "name": {
          "type": "string",
          "description": "Required. Identifier. The unique identifier of the session. Format: `projects/{project}/locations/{location}/apps/{app}/assistantSessions/{session}`"
        },
        "displayName": {
          "type": "string",
          "description": "Optional. The display name of the assistant session."
        },
        "state": {
          "enumDescriptions": [
            "The default value. This value is used if the status is not specified.",
            "The assistant agent is processing the request as a long running task.",
            "The assistant agent is idle and does not have any pending requests or response.",
            "The assistant agent is done processing a long running task and has a response ready for the user."
          ],
          "description": "Output only. The status of the assistant session.",
          "enum": [
            "ASSISTANT_SESSION_STATE_UNSPECIFIED",
            "PROCESSING",
            "IDLE",
            "PENDING_REVIEW"
          ],
          "readOnly": true,
          "type": "string"
        }
      }
    },
    "RunEvaluationResultMetricsRequest": {
      "id": "RunEvaluationResultMetricsRequest",
      "properties": {},
      "description": "Request message for EvaluationService.RunEvaluationResultMetrics.",
      "type": "object"
    },
    "LfA2aV1StringList": {
      "id": "LfA2aV1StringList",
      "description": "protolint:disable REPEATED_FIELD_NAMES_PLURALIZED A list of strings.",
      "type": "object",
      "properties": {
        "list": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "The individual string values."
        }
      }
    },
    "GuardrailContentFilter": {
      "type": "object",
      "properties": {
        "sensitiveWordsExemptions": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Optional. Entries of the sensitive words list that this guardrail allows. Only valid when match_type is SENSITIVE_WORDS. Each value must equal a list entry (case-insensitive, surrounding whitespace ignored); other values have no effect. Applies to this guardrail only. At most 1000 entries of up to 256 characters each."
        },
        "disregardDiacritics": {
          "description": "Optional. If true, diacritics are ignored during matching.",
          "type": "boolean"
        },
        "bannedContentsInUserInput": {
          "description": "Optional. List of banned phrases. Applies only to user inputs.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "bannedContents": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "description": "Optional. List of banned phrases. Applies to both user inputs and agent responses."
        },
        "matchType": {
          "enumDescriptions": [
            "Match type is not specified.",
            "Content is matched for substrings character by character.",
            "Content only matches if the pattern found in the text is surrounded by word delimiters. Banned phrases can also contain word delimiters.",
            "Content is matched using regular expression syntax.",
            "Content is matched against a system-managed list of sensitive words and phrases. Attaching a guardrail with this match type to an app or agent replaces the default sensitive words filter for the affected agents; disable the guardrail to opt out of the default filter."
          ],
          "type": "string",
          "enum": [
            "MATCH_TYPE_UNSPECIFIED",
            "SIMPLE_STRING_MATCH",
            "WORD_BOUNDARY_STRING_MATCH",
            "REGEXP_MATCH",
            "SENSITIVE_WORDS"
          ],
          "description": "Required. Match type for the content filter."
        },
        "bannedContentsInAgentResponse": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "description": "Optional. List of banned phrases. Applies only to agent responses."
        }
      },
      "id": "GuardrailContentFilter",
      "description": "Guardrail that bans certain content from being used in the conversation."
    },
    "AssistantConfirmationRequestTarget": {
      "type": "object",
      "description": "One resource the confirmed action will change.",
      "properties": {
        "displayName": {
          "description": "Display name of the resource or app, for the card.",
          "type": "string"
        },
        "action": {
          "description": "The action, e.g. `CREATE`, `UPDATE`, `DELETE`, `COPY`, `LINK`.",
          "type": "string"
        },
        "targetApp": {
          "description": "The app the resource belongs to, or empty for a location-scoped action such as creating an app. Format: `projects/{project}/locations/{location}/apps/{app}`",
          "type": "string"
        },
        "resource": {
          "type": "string",
          "description": "The resource that will change, as a full resource name."
        }
      },
      "id": "AssistantConfirmationRequestTarget"
    },
    "EvaluationStep": {
      "type": "object",
      "properties": {
        "expectation": {
          "description": "Optional. Executes an expectation on the current turn.",
          "$ref": "EvaluationGoldenExpectation"
        },
        "userInput": {
          "$ref": "SessionInput",
          "description": "Optional. User input for the conversation."
        },
        "agentTransfer": {
          "description": "Optional. Transfer the conversation to a different agent.",
          "$ref": "AgentTransfer"
        }
      },
      "id": "EvaluationStep",
      "description": "A step defines a singular action to happen during the evaluation."
    },
    "RedactionConfig": {
      "type": "object",
      "id": "RedactionConfig",
      "properties": {
        "enableRedaction": {
          "type": "boolean",
          "description": "Optional. If `true`, redaction will be applied in various logging scenarios, including conversation history, Cloud Logging and audio recording."
        },
        "deidentifyTemplate": {
          "type": "string",
          "description": "Optional. [DLP](https://cloud.google.com/dlp/docs) deidentify template name to instruct on how to de-identify content. Format: `projects/{project}/locations/{location}/deidentifyTemplates/{deidentify_template}`"
        },
        "inspectTemplate": {
          "type": "string",
          "description": "Optional. [DLP](https://cloud.google.com/dlp/docs) inspect template name to configure detection of sensitive data types. Format: `projects/{project}/locations/{location}/inspectTemplates/{inspect_template}`"
        }
      },
      "description": "Configuration to instruct how sensitive data should be handled."
    },
    "LfA2aV1SendMessageResponse": {
      "description": "Represents the response for the `SendMessage` method.",
      "type": "object",
      "id": "LfA2aV1SendMessageResponse",
      "properties": {
        "task": {
          "$ref": "LfA2aV1Task",
          "description": "The task created or updated by the message."
        },
        "message": {
          "description": "A message from the agent.",
          "$ref": "LfA2aV1Message"
        }
      }
    },
    "ExportEvaluationResultsRequest": {
      "properties": {
        "exportOptions": {
          "description": "Optional. The export options for the evaluation results.",
          "$ref": "ExportOptions"
        },
        "names": {
          "description": "Required. The resource names of the evaluation results to export.",
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "id": "ExportEvaluationResultsRequest",
      "description": "Request message for EvaluationService.ExportEvaluationResults.",
      "type": "object"
    },
    "ChannelProfile": {
      "id": "ChannelProfile",
      "type": "object",
      "description": "A ChannelProfile configures the agent's behavior for a specific communication channel, such as web UI or telephony.",
      "properties": {
        "instagramConfig": {
          "$ref": "ChannelProfileInstagramConfig",
          "description": "Optional. Configuration specific to Instagram deployments."
        },
        "channelType": {
          "type": "string",
          "enum": [
            "UNKNOWN",
            "WEB_UI",
            "API",
            "TWILIO",
            "GOOGLE_TELEPHONY_PLATFORM",
            "CONTACT_CENTER_AS_A_SERVICE",
            "CONTACT_CENTER_AS_A_SERVICE_CHAT",
            "FIVE9",
            "CONTACT_CENTER_INTEGRATION",
            "WHATSAPP",
            "INSTAGRAM"
          ],
          "enumDescriptions": [
            "Unknown channel type.",
            "Web UI channel.",
            "API channel.",
            "Twilio channel.",
            "Google Telephony Platform channel.",
            "Contact Center as a Service (CCaaS) channel.",
            "Contact Center as a Service (CCaaS Chat) channel.",
            "Five9 channel.",
            "Third party contact center integration channel.",
            "WhatsApp channel.",
            "Instagram channel."
          ],
          "description": "Optional. The type of the channel profile."
        },
        "disableBargeInControl": {
          "description": "Optional. Whether to disable user barge-in control in the conversation. - **true**: User interruptions are disabled while the agent is speaking. - **false**: The agent retains automatic control over when the user can interrupt.",
          "type": "boolean"
        },
        "noiseSuppressionLevel": {
          "description": "Optional. The noise suppression level of the channel profile. Available values are \"low\", \"moderate\", \"high\", \"very_high\".",
          "type": "string"
        },
        "whatsappConfig": {
          "$ref": "ChannelProfileWhatsAppConfig",
          "description": "Optional. Configuration specific to WhatsApp deployments."
        },
        "disableDtmf": {
          "description": "Optional. Whether to disable DTMF (dual-tone multi-frequency).",
          "type": "boolean"
        },
        "webWidgetConfig": {
          "$ref": "ChannelProfileWebWidgetConfig",
          "description": "Optional. The configuration for the web widget."
        },
        "profileId": {
          "description": "Optional. The unique identifier of the channel profile.",
          "type": "string"
        },
        "personaProperty": {
          "description": "Optional. The persona property of the channel profile.",
          "$ref": "ChannelProfilePersonaProperty"
        }
      }
    },
    "ListToolsetsResponse": {
      "type": "object",
      "description": "Response message for AgentService.ListToolsets.",
      "properties": {
        "toolsets": {
          "description": "The list of toolsets.",
          "type": "array",
          "items": {
            "$ref": "Toolset"
          }
        },
        "nextPageToken": {
          "description": "A token that can be sent as ListToolsetsRequest.page_token to retrieve the next page. Absence of this field indicates there are no subsequent pages.",
          "type": "string"
        }
      },
      "id": "ListToolsetsResponse"
    },
    "ExpressionCondition": {
      "id": "ExpressionCondition",
      "type": "object",
      "properties": {
        "expression": {
          "type": "string",
          "description": "Required. The string representation of cloud.api.Expression condition."
        }
      },
      "description": "Expression condition based on session state."
    },
    "LfA2aV1PasswordOAuthFlow": {
      "description": "Deprecated: Use Authorization Code + PKCE or Device Code.",
      "type": "object",
      "properties": {
        "refreshUrl": {
          "description": "The URL to be used for obtaining refresh tokens. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS.",
          "type": "string"
        },
        "tokenUrl": {
          "description": "The token URL to be used for this flow. This MUST be in the form of a URL. The OAuth2 standard requires the use of TLS.",
          "type": "string"
        },
        "scopes": {
          "additionalProperties": {
            "type": "string"
          },
          "type": "object",
          "description": "The available scopes for the OAuth2 security scheme. A map between the scope name and a short description for it. The map MAY be empty."
        }
      },
      "id": "LfA2aV1PasswordOAuthFlow"
    },
    "EvaluationResultScenarioRubricOutcome": {
      "type": "object",
      "id": "EvaluationResultScenarioRubricOutcome",
      "properties": {
        "rubric": {
          "readOnly": true,
          "description": "Output only. The rubric that was used to evaluate the conversation.",
          "type": "string"
        },
        "score": {
          "readOnly": true,
          "type": "number",
          "format": "float",
          "description": "Output only. The score of the conversation against the rubric."
        },
        "scoreExplanation": {
          "type": "string",
          "description": "Output only. The rater's response to the rubric.",
          "readOnly": true
        }
      },
      "description": "The outcome of the evaluation against the rubric."
    },
    "EvaluationGoldenExpectation": {
      "properties": {
        "expectationLevelMetricsThresholdsOverride": {
          "description": "Optional. Overrides metrics at the step level.",
          "$ref": "EvaluationMetricsThresholdsGoldenEvaluationMetricsThresholdsExpectationLevelMetricsThresholds"
        },
        "toolResponse": {
          "$ref": "ToolResponse",
          "description": "Optional. Check that a specific tool had the expected response."
        },
        "mockToolResponse": {
          "description": "Optional. The tool response to mock, with the parameters of interest specified. Any parameters not specified will be hallucinated by the LLM.",
          "$ref": "ToolResponse"
        },
        "note": {
          "description": "Optional. A note for this requirement, useful in reporting when specific checks fail. E.g., \"Check_Payment_Tool_Called\".",
          "type": "string"
        },
        "toolCall": {
          "$ref": "ToolCall",
          "description": "Optional. Check that a specific tool was called with the parameters."
        },
        "noToolCalls": {
          "type": "boolean",
          "description": "Optional. Check that no tools were called during this turn."
        },
        "agentResponse": {
          "description": "Optional. Check that the agent responded with the correct response. The role \"agent\" is implied.",
          "$ref": "Message"
        },
        "skipEvaluation": {
          "type": "boolean",
          "description": "Optional. If set to true, this specific expectation will not be evaluated."
        },
        "comparisonType": {
          "description": "Optional. The comparison type to use for the expectation check.",
          "type": "string",
          "enum": [
            "COMPARISON_TYPE_UNSPECIFIED",
            "EQUALS",
            "CONTAINS",
            "SEMANTIC_SIMILARITY"
          ],
          "enumDescriptions": [
            "Unspecified comparison type. Behavior defaults to SEMANTIC_SIMILARITY for agent responses and tool calls.",
            "Exact string match.",
            "Substring match (checks if the expected string is contained in the actual response).",
            "Semantic similarity match (evaluates meaning similarity using an LLM)."
          ]
        },
        "agentResponseHallucinationMetricsConfigOverride": {
          "description": "Optional. Overrides for agent_response hallucination metrics.",
          "$ref": "EvaluationMetricsConfigHallucinationMetricsConfig"
        },
        "agentResponseSemanticSimilarityMetricsConfigOverride": {
          "$ref": "EvaluationMetricsConfigSemanticSimilarityMetricsConfig",
          "description": "Optional. Overrides for agent_response semantic similarity metrics."
        },
        "updatedVariables": {
          "description": "Optional. Check that the agent updated the session variables to the expected values. Used to also capture agent variable updates for golden evals.",
          "additionalProperties": {
            "type": "any",
            "description": "Properties of the object."
          },
          "type": "object"
        },
        "agentTransfer": {
          "description": "Optional. Check that the agent transferred the conversation to a different agent.",
          "$ref": "AgentTransfer"
        }
      },
      "id": "EvaluationGoldenExpectation",
      "type": "object",
      "description": "Represents a single, checkable requirement."
    },
    "Operation": {
      "type": "object",
      "id": "Operation",
      "properties": {
        "done": {
          "description": "If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.",
          "type": "boolean"
        },
        "response": {
          "description": "The normal, successful response of the operation. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.",
          "additionalProperties": {
            "description": "Properties of the object. Contains field @type with type URL.",
            "type": "any"
          },
          "type": "object"
        },
        "error": {
          "$ref": "Status",
          "description": "The error result of the operation in case of failure or cancellation."
        },
        "name": {
          "description": "The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.",
          "type": "string"
        },
        "metadata": {
          "description": "Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.",
          "additionalProperties": {
            "description": "Properties of the object. Contains field @type with type URL.",
            "type": "any"
          },
          "type": "object"
        }
      },
      "description": "This resource represents a long-running operation that is the result of a network API call."
    },
    "Toolset": {
      "description": "A toolset represents a group of dynamically managed tools that can be used by the agent.",
      "properties": {
        "toolFakeConfig": {
          "description": "Optional. Configuration for tools behavior in fake mode.",
          "$ref": "ToolFakeConfig"
        },
        "mcpToolset": {
          "$ref": "McpToolset",
          "description": "Optional. A toolset that contains a list of tools that are offered by the MCP server."
        },
        "name": {
          "type": "string",
          "description": "Identifier. The unique identifier of the toolset. Format: `projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset}`"
        },
        "etag": {
          "type": "string",
          "description": "ETag used to ensure the object hasn't changed during a read-modify-write operation. If the etag is empty, the update will overwrite any concurrent changes."
        },
        "openApiToolset": {
          "description": "Optional. A toolset that contains a list of tools that are defined by an OpenAPI schema.",
          "$ref": "OpenApiToolset"
        },
        "displayName": {
          "description": "Optional. The display name of the toolset. Must be unique within the same app.",
          "type": "string"
        },
        "createTime": {
          "format": "google-datetime",
          "description": "Output only. Timestamp when the toolset was created.",
          "type": "string",
          "readOnly": true
        },
        "timeout": {
          "type": "string",
          "description": "Optional. The timeout for the toolset execution. If not set, the default timeout is 30 seconds for `SYNCHRONOUS` toolsets and 60 seconds for `ASYNCHRONOUS` toolsets.",
          "format": "google-duration"
        },
        "updateTime": {
          "readOnly": true,
          "format": "google-datetime",
          "type": "string",
          "description": "Output only. Timestamp when the toolset was last updated."
        },
        "executionType": {
          "type": "string",
          "enum": [
            "EXECUTION_TYPE_UNSPECIFIED",
            "SYNCHRONOUS",
            "ASYNCHRONOUS"
          ],
          "enumDescriptions": [
            "The execution type is unspecified. Defaults to `SYNCHRONOUS` if unspecified.",
            "The tool is executed synchronously. The session is blocked until the tool returns.",
            "The tool is executed asynchronously. The session will continue while the tool is executing."
          ],
          "description": "Optional. The execution type of the tools in the toolset."
        },
        "description": {
          "type": "string",
          "description": "Optional. The description of the toolset."
        },
        "connectorToolset": {
          "description": "Optional. A toolset that generates tools from an Integration Connectors Connection.",
          "$ref": "ConnectorToolset"
        }
      },
      "type": "object",
      "id": "Toolset"
    },
    "ImportEvaluationsResponse": {
      "description": "Response message for EvaluationService.ImportEvaluations.",
      "properties": {
        "evaluationResults": {
          "description": "The list of evaluation results that were imported into the app.",
          "items": {
            "$ref": "EvaluationResult"
          },
          "type": "array"
        },
        "evaluationRuns": {
          "description": "The list of evaluation runs that were imported into the app.",
          "type": "array",
          "items": {
            "$ref": "EvaluationRun"
          }
        },
        "evaluations": {
          "type": "array",
          "items": {
            "$ref": "Evaluation"
          },
          "description": "The list of evaluations that were imported into the app."
        },
        "evaluationResultImportFailureCount": {
          "format": "int32",
          "type": "integer",
          "description": "The number of evaluation results that either failed to import entirely or completed import with one or more errors."
        },
        "errorMessages": {
          "items": {
            "type": "string"
          },
          "description": "Optional. A list of error messages associated with evaluations that failed to be imported.",
          "type": "array"
        },
        "evaluationRunImportFailureCount": {
          "type": "integer",
          "description": "The number of evaluation runs that either failed to import entirely or completed import with one or more errors.",
          "format": "int32"
        },
        "importFailureCount": {
          "description": "The number of evaluations that either failed to import entirely or completed import with one or more errors.",
          "format": "int32",
          "type": "integer"
        }
      },
      "id": "ImportEvaluationsResponse",
      "type": "object"
    },
    "TriggerActionGenerativeAnswer": {
      "id": "TriggerActionGenerativeAnswer",
      "description": "The agent will immediately respond with a generative answer.",
      "properties": {
        "prompt": {
          "type": "string",
          "description": "Required. The prompt to use for the generative answer."
        }
      },
      "type": "object"
    },
    "ActiveTurnInfo": {
      "type": "object",
      "properties": {
        "turnId": {
          "description": "Identifies the turn; echoed by resume snapshots on the streaming API.",
          "type": "string"
        },
        "status": {
          "type": "string",
          "enum": [
            "STATUS_UNSPECIFIED",
            "RUNNING",
            "DISCONNECTED",
            "RESUMING",
            "ABANDONED"
          ],
          "enumDescriptions": [
            "Unspecified.",
            "The turn is executing with at least one client attached.",
            "The turn is executing with no client attached.",
            "The turn is parked for pickup: the next attach continues it.",
            "The turn's server lease has lapsed and no task is driving it; the next read seals it to a committed partial. Not attachable."
          ],
          "description": "Current attachment status."
        },
        "startTime": {
          "format": "google-datetime",
          "readOnly": true,
          "type": "string",
          "description": "Output only. When the turn started."
        },
        "orphanDeadlineTime": {
          "readOnly": true,
          "type": "string",
          "format": "google-datetime",
          "description": "Output only. When the turn will be wound down if no client attaches."
        },
        "lastProgressTime": {
          "format": "google-datetime",
          "readOnly": true,
          "description": "Output only. When the turn last persisted progress.",
          "type": "string"
        }
      },
      "id": "ActiveTurnInfo",
      "description": "Live-attachment info for a session turn that is currently running, disconnected from its client, or parked for pickup by another server task."
    },
    "ExportEvaluationRunsRequest": {
      "properties": {
        "exportOptions": {
          "$ref": "ExportOptions",
          "description": "Optional. The export options for the evaluation runs."
        },
        "names": {
          "description": "Required. The resource names of the evaluation runs to export.",
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "type": "object",
      "description": "Request message for EvaluationService.ExportEvaluationRuns.",
      "id": "ExportEvaluationRunsRequest"
    },
    "EvaluationResultScenarioExpectationOutcome": {
      "description": "The outcome of a scenario expectation.",
      "type": "object",
      "properties": {
        "observedAgentResponse": {
          "$ref": "Message",
          "description": "Output only. The observed agent response.",
          "readOnly": true
        },
        "outcome": {
          "enum": [
            "OUTCOME_UNSPECIFIED",
            "PASS",
            "FAIL",
            "SKIPPED"
          ],
          "description": "Output only. The outcome of the ScenarioExpectation.",
          "enumDescriptions": [
            "Evaluation outcome is not specified.",
            "Evaluation/Expectation passed. In the case of an evaluation, this means that all expectations were met.",
            "Evaluation/Expectation failed. In the case of an evaluation, this means that at least one expectation was not met.",
            "Evaluation/Expectation was skipped."
          ],
          "type": "string",
          "readOnly": true
        },
        "expectation": {
          "description": "Output only. The expectation that was evaluated.",
          "$ref": "EvaluationScenarioExpectation",
          "readOnly": true
        },
        "observedToolCall": {
          "description": "Output only. The observed tool call.",
          "readOnly": true,
          "$ref": "EvaluationResultScenarioExpectationOutcomeObservedToolCall"
        }
      },
      "id": "EvaluationResultScenarioExpectationOutcome"
    },
    "GuardrailModelSafety": {
      "type": "object",
      "id": "GuardrailModelSafety",
      "properties": {
        "safetySettings": {
          "items": {
            "$ref": "GuardrailModelSafetySafetySetting"
          },
          "type": "array",
          "description": "Required. List of safety settings."
        }
      },
      "description": "Model safety settings overrides. When this is set, it will override the default settings and trigger the guardrail if the response is considered unsafe."
    },
    "RunSessionRequest": {
      "description": "Request message for SessionService.RunSession.",
      "properties": {
        "config": {
          "$ref": "SessionConfig",
          "description": "Required. The configuration for the session."
        },
        "inputs": {
          "description": "Required. Inputs for the session.",
          "items": {
            "$ref": "SessionInput"
          },
          "type": "array"
        }
      },
      "type": "object",
      "id": "RunSessionRequest"
    },
    "LfA2aV1MutualTlsSecurityScheme": {
      "type": "object",
      "id": "LfA2aV1MutualTlsSecurityScheme",
      "properties": {
        "description": {
          "description": "An optional description for the security scheme.",
          "type": "string"
        }
      },
      "description": "Defines a security scheme using mTLS authentication."
    },
    "LfA2aV1SecurityScheme": {
      "properties": {
        "oauth2SecurityScheme": {
          "$ref": "LfA2aV1OAuth2SecurityScheme",
          "description": "OAuth 2.0 authentication."
        },
        "openIdConnectSecurityScheme": {
          "description": "OpenID Connect authentication.",
          "$ref": "LfA2aV1OpenIdConnectSecurityScheme"
        },
        "mtlsSecurityScheme": {
          "$ref": "LfA2aV1MutualTlsSecurityScheme",
          "description": "Mutual TLS authentication."
        },
        "httpAuthSecurityScheme": {
          "$ref": "LfA2aV1HTTPAuthSecurityScheme",
          "description": "HTTP authentication (Basic, Bearer, etc.)."
        },
        "apiKeySecurityScheme": {
          "description": "API key-based authentication.",
          "$ref": "LfA2aV1APIKeySecurityScheme"
        }
      },
      "id": "LfA2aV1SecurityScheme",
      "description": "Defines a security scheme that can be used to secure an agent's endpoints. This is a discriminated union type based on the OpenAPI 3.2 Security Scheme Object. See: https://spec.openapis.org/oas/v3.2.0.html#security-scheme-object",
      "type": "object"
    },
    "ArtifactChunk": {
      "id": "ArtifactChunk",
      "type": "object",
      "properties": {
        "targetApp": {
          "type": "string",
          "description": "Output only. The app this artifact was produced for, when it was produced for one. Format: `projects/{project}/locations/{location}/apps/{app}`",
          "readOnly": true
        },
        "gcsUri": {
          "description": "The Cloud Storage object the artifact was persisted to. Set on FINALIZED chunks.",
          "type": "string"
        },
        "displayName": {
          "description": "The file name shown to the user, e.g. \"hotel_booking_tdd.md\". Set on STARTED (and repeated on FINALIZED).",
          "type": "string"
        },
        "mimeType": {
          "type": "string",
          "description": "The IANA media type of the artifact content, e.g. \"text/markdown\"."
        },
        "artifactId": {
          "type": "string",
          "description": "Identifier of the artifact, stable across all chunks of one artifact within the stream."
        },
        "contentDelta": {
          "description": "Incremental artifact content. Set on DELTA chunks.",
          "type": "string"
        },
        "state": {
          "description": "Lifecycle position of this chunk.",
          "type": "string",
          "enum": [
            "STATE_UNSPECIFIED",
            "STARTED",
            "DELTA",
            "FINALIZED",
            "FAILED",
            "CLOSED"
          ],
          "enumDescriptions": [
            "Unused default.",
            "The assistant started generating the artifact.",
            "A content increment; content_delta is set.",
            "The artifact was persisted; gcs_uri is set.",
            "Generation or persistence failed; the artifact was not saved.",
            "The document finished streaming: its content was fully delivered via content_delta chunks. Persistence may still follow; a FINALIZED chunk with a gcs_uri is sent if and when the artifact is saved."
          ]
        }
      },
      "description": "A streamed fragment of a document artifact (e.g. a markdown TDD) that the assistant is generating. Content deltas stream while the document is being written so clients can render a live preview; the FINALIZED chunk carries the Cloud Storage URI once the file has been persisted."
    },
    "GenerateAppResourceRequestRefineInstructions": {
      "type": "object",
      "properties": {
        "instructions": {
          "type": "string",
          "description": "Required. The instructions to refine the resource."
        },
        "fieldMask": {
          "description": "Required. The field of the resource being refined. Only one field is allowed per RefineInstructions. If refining agent instructions, the field mask should be \"instructions\".",
          "type": "string",
          "format": "google-fieldmask"
        },
        "endIndex": {
          "format": "int64",
          "type": "string",
          "description": "Required. The last character (inclusive) of the text to refine."
        },
        "startIndex": {
          "description": "Required. The first character (inclusive) of the text to refine.",
          "type": "string",
          "format": "int64"
        }
      },
      "description": "The instructions to be used to refine a part of the resource. The part of the resource can be specified with a start index, end index and a field mask. For example, if you want to refine a part of the agent instructions you can specify the index of the first character of the instructions, the index of the last character of the instructions and the field mask as \"instructions\".",
      "id": "GenerateAppResourceRequestRefineInstructions"
    },
    "GuardrailLlmPolicy": {
      "id": "GuardrailLlmPolicy",
      "type": "object",
      "properties": {
        "maxConversationMessages": {
          "format": "int32",
          "description": "Optional. When checking this policy, consider the last 'n' messages in the conversation. When not set a default value of 10 will be used.",
          "type": "integer"
        },
        "allowShortUtterance": {
          "description": "Optional. By default, the LLM policy check is bypassed for short utterances. Enabling this setting applies the policy check to all utterances, including those that would normally be skipped.",
          "type": "boolean"
        },
        "modelSettings": {
          "description": "Optional. Model settings.",
          "$ref": "ModelSettings"
        },
        "prompt": {
          "type": "string",
          "description": "Required. Policy prompt. Supports session variable placeholders (`{var}`) as well as `{agent_system_instruction}` to inject the agent's resolved system instructions."
        },
        "failOpen": {
          "type": "boolean",
          "description": "Optional. If an error occurs during the policy check, fail open and do not trigger the guardrail."
        },
        "policyScope": {
          "description": "Required. Defines when to apply the policy check during the conversation. If set to `POLICY_SCOPE_UNSPECIFIED`, the policy will be applied to the user input. When applying the policy to the agent response, additional latency will be introduced before the agent can respond.",
          "enumDescriptions": [
            "Policy scope is not specified.",
            "Policy check is triggered on user input.",
            "Policy check is triggered on agent response. Applying this policy scope will introduce additional latency before the agent can respond.",
            "Policy check is triggered on both user input and agent response. Applying this policy scope will introduce additional latency before the agent can respond."
          ],
          "type": "string",
          "enum": [
            "POLICY_SCOPE_UNSPECIFIED",
            "USER_QUERY",
            "AGENT_RESPONSE",
            "USER_QUERY_AND_AGENT_RESPONSE"
          ]
        }
      },
      "description": "Guardrail that blocks the conversation if the LLM response is considered violating the policy based on the LLM classification."
    },
    "SecuritySettings": {
      "description": "Project/Location level security settings for CES.",
      "type": "object",
      "id": "SecuritySettings",
      "properties": {
        "name": {
          "description": "Identifier. The unique identifier of the security settings. Format: `projects/{project}/locations/{location}/securitySettings`",
          "type": "string"
        },
        "etag": {
          "description": "Output only. Etag of the security settings.",
          "type": "string",
          "readOnly": true
        },
        "createTime": {
          "type": "string",
          "readOnly": true,
          "format": "google-datetime",
          "description": "Output only. Create time of the security settings."
        },
        "endpointControlPolicy": {
          "description": "Optional. Endpoint control related settings.",
          "$ref": "EndpointControlPolicy"
        },
        "updateTime": {
          "readOnly": true,
          "type": "string",
          "description": "Output only. Last update time of the security settings.",
          "format": "google-datetime"
        }
      }
    },
    "DataStoreSettings": {
      "description": "Data store related settings for the app.",
      "id": "DataStoreSettings",
      "properties": {
        "engines": {
          "items": {
            "$ref": "DataStoreSettingsEngine"
          },
          "type": "array",
          "readOnly": true,
          "description": "Output only. The engines for the app."
        }
      },
      "type": "object"
    },
    "SessionOutputDiagnosticInfo": {
      "id": "SessionOutputDiagnosticInfo",
      "type": "object",
      "properties": {
        "rootSpan": {
          "$ref": "Span",
          "description": "A trace of the entire request processing, represented as a root span. This span can contain nested child spans for specific operations."
        },
        "messages": {
          "description": "List of the messages that happened during the processing.",
          "items": {
            "$ref": "Message"
          },
          "type": "array"
        }
      },
      "description": "Contains execution details during the processing."
    },
    "LfA2aV1DeviceCodeOAuthFlow": {
      "properties": {
        "deviceAuthorizationUrl": {
          "type": "string",
          "description": "Required. The device authorization endpoint URL."
        },
        "scopes": {
          "type": "object",
          "description": "Required. The available scopes for the OAuth2 security scheme.",
          "additionalProperties": {
            "type": "string"
          }
        },
        "tokenUrl": {
          "description": "Required. The token URL to be used for this flow.",
          "type": "string"
        },
        "refreshUrl": {
          "description": "The URL to be used for obtaining refresh tokens.",
          "type": "string"
        }
      },
      "type": "object",
      "description": "Defines configuration details for the OAuth 2.0 Device Code flow (RFC 8628). This flow is designed for input-constrained devices such as IoT devices, and CLI tools where the user authenticates on a separate device.",
      "id": "LfA2aV1DeviceCodeOAuthFlow"
    },
    "InstagramCredentials": {
      "id": "InstagramCredentials",
      "description": "Ephemeral Meta credentials for Instagram native integration.",
      "properties": {
        "conversationProfileId": {
          "type": "string",
          "description": "Optional. The Conversation Profile ID to use for the deployment."
        },
        "authCode": {
          "description": "Required. The Meta auth code provided by the embedded signup flow.",
          "type": "string"
        }
      },
      "type": "object"
    },
    "RunEvaluationResultMetricsResponse": {
      "id": "RunEvaluationResultMetricsResponse",
      "type": "object",
      "properties": {
        "status": {
          "readOnly": true,
          "type": "string",
          "enum": [
            "OUTCOME_UNSPECIFIED",
            "PASS",
            "FAIL",
            "SKIPPED"
          ],
          "description": "Output only. The status of the evaluation result metrics calculation.",
          "enumDescriptions": [
            "Evaluation outcome is not specified.",
            "Evaluation/Expectation passed. In the case of an evaluation, this means that all expectations were met.",
            "Evaluation/Expectation failed. In the case of an evaluation, this means that at least one expectation was not met.",
            "Evaluation/Expectation was skipped."
          ]
        }
      },
      "description": "Response message for EvaluationService.RunEvaluationResultMetrics."
    },
    "AggregatedMetricsToolMetrics": {
      "type": "object",
      "description": "Metrics for a single tool.",
      "properties": {
        "tool": {
          "readOnly": true,
          "description": "Output only. The name of the tool.",
          "type": "string"
        },
        "passCount": {
          "format": "int32",
          "description": "Output only. The number of times the tool passed.",
          "type": "integer",
          "readOnly": true
        },
        "failCount": {
          "readOnly": true,
          "format": "int32",
          "type": "integer",
          "description": "Output only. The number of times the tool failed."
        }
      },
      "id": "AggregatedMetricsToolMetrics"
    },
    "EvaluationScenarioExpectation": {
      "id": "EvaluationScenarioExpectation",
      "type": "object",
      "description": "The expectation to evaluate the conversation produced by the simulation.",
      "properties": {
        "agentResponse": {
          "description": "Optional. The agent response to be evaluated.",
          "$ref": "Message"
        },
        "toolExpectation": {
          "description": "Optional. The tool call and response pair to be evaluated.",
          "$ref": "EvaluationScenarioExpectationToolExpectation"
        }
      }
    },
    "TestPersonaVoiceRequest": {
      "properties": {
        "personaId": {
          "type": "string",
          "description": "Required. The persona ID to test the voice for. Also accepts \"default\"."
        },
        "text": {
          "description": "Required. The text to test the voice for.",
          "type": "string"
        }
      },
      "id": "TestPersonaVoiceRequest",
      "type": "object",
      "description": "Request message for EvaluationService.TestPersonaVoice."
    },
    "SessionCheckpoint": {
      "description": "Session checkpoint containing inferred user intent for session title and UI.",
      "id": "SessionCheckpoint",
      "type": "object",
      "properties": {
        "userIntent": {
          "type": "string",
          "description": "Inferred user goal or topic for the session (e.g. \"Building E-Commerce Support Agent\")."
        }
      }
    },
    "EvaluationDataset": {
      "type": "object",
      "properties": {
        "updateTime": {
          "type": "string",
          "description": "Output only. Timestamp when the evaluation dataset was last updated.",
          "readOnly": true,
          "format": "google-datetime"
        },
        "displayName": {
          "type": "string",
          "description": "Required. User-defined display name of the evaluation dataset. Unique within an App."
        },
        "createTime": {
          "format": "google-datetime",
          "description": "Output only. Timestamp when the evaluation dataset was created.",
          "type": "string",
          "readOnly": true
        },
        "name": {
          "description": "Identifier. The unique identifier of this evaluation dataset. Format: `projects/{project}/locations/{location}/apps/{app}/evaluationDatasets/{evaluationDataset}`",
          "type": "string"
        },
        "etag": {
          "description": "Output only. Etag used to ensure the object hasn't changed during a read-modify-write operation. If the etag is empty, the update will overwrite any concurrent changes.",
          "type": "string",
          "readOnly": true
        },
        "lastUpdatedBy": {
          "description": "Output only. The user who last updated the evaluation dataset.",
          "type": "string",
          "readOnly": true
        },
        "aggregatedMetrics": {
          "$ref": "AggregatedMetrics",
          "description": "Output only. The aggregated metrics for this evaluation dataset across all runs.",
          "readOnly": true
        },
        "createdBy": {
          "readOnly": true,
          "type": "string",
          "description": "Output only. The user who created the evaluation dataset."
        },
        "evaluations": {
          "description": "Optional. Evaluations that are included in this dataset.",
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "description": "An evaluation dataset represents a set of evaluations that are grouped together basaed on shared tags.",
      "id": "EvaluationDataset"
    },
    "AgentRemoteA2aAgent": {
      "description": "The agent which will transfer execution to a remote [A2A](https://github.com/a2aproject/A2A) agent.",
      "id": "AgentRemoteA2aAgent",
      "type": "object",
      "properties": {
        "a2aConfig": {
          "$ref": "RemoteA2aConfig",
          "description": "Required. The A2A connection configuration."
        }
      }
    },
    "LfA2aV1Message": {
      "type": "object",
      "id": "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.",
      "properties": {
        "taskId": {
          "description": "Optional. The task id of the message. If set, the message will be associated with the given task.",
          "type": "string"
        },
        "metadata": {
          "additionalProperties": {
            "description": "Properties of the object.",
            "type": "any"
          },
          "type": "object",
          "description": "Optional. Any metadata to provide along with the message."
        },
        "contextId": {
          "description": "Optional. The context id of the message. If set, the message will be associated with the given context.",
          "type": "string"
        },
        "referenceTaskIds": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "description": "A list of task IDs that this message references for additional context."
        },
        "role": {
          "description": "Required. Identifies the sender of the message.",
          "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",
          "enum": [
            "ROLE_UNSPECIFIED",
            "ROLE_USER",
            "ROLE_AGENT"
          ]
        },
        "parts": {
          "type": "array",
          "description": "Required. Parts is the container of the message content.",
          "items": {
            "$ref": "LfA2aV1Part"
          }
        },
        "messageId": {
          "type": "string",
          "description": "Required. The unique identifier (e.g. UUID) of the message. This is created by the message creator."
        },
        "extensions": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "description": "The URIs of extensions that are present or contributed to this Message."
        }
      }
    },
    "EvaluationPersona": {
      "properties": {
        "name": {
          "type": "string",
          "description": "Required. The unique identifier of the persona. Format: `projects/{project}/locations/{location}/apps/{app}/evaluationPersonas/{evaluationPersona}`"
        },
        "speechConfig": {
          "$ref": "EvaluationPersonaSpeechConfig",
          "description": "Optional. Configuration for how the persona sounds (TTS settings)."
        },
        "displayName": {
          "description": "Required. The display name of the persona. Unique within an app.",
          "type": "string"
        },
        "personality": {
          "description": "Required. An instruction for the agent on how to behave in the evaluation.",
          "type": "string"
        },
        "description": {
          "description": "Optional. The description of the persona.",
          "type": "string"
        }
      },
      "type": "object",
      "description": "A persona represents an end user in an evaluation.",
      "id": "EvaluationPersona"
    },
    "PythonCodeCondition": {
      "description": "Python code block to evaluate the condition.",
      "type": "object",
      "properties": {
        "pythonCode": {
          "description": "Required. The python code to execute.",
          "type": "string"
        }
      },
      "id": "PythonCodeCondition"
    },
    "GenerateAppResourceRequestEvaluationGenerationConfig": {
      "properties": {
        "datasetId": {
          "type": "string",
          "description": "Optional. The insights dataset to be used to fetch conversation data for generating the evaluations. Format: `projects/{project}/locations/{location}/datasets/{dataset}`."
        }
      },
      "type": "object",
      "description": "The configuration to be used to generate the evaluations.",
      "id": "GenerateAppResourceRequestEvaluationGenerationConfig"
    },
    "TlsConfig": {
      "description": "The TLS configuration.",
      "id": "TlsConfig",
      "type": "object",
      "properties": {
        "caCerts": {
          "type": "array",
          "description": "Required. Specifies a list of allowed custom CA certificates for HTTPS verification.",
          "items": {
            "$ref": "TlsConfigCaCert"
          }
        }
      }
    },
    "EvaluationMetricsThresholdsToolMatchingSettings": {
      "description": "Settings for matching tool calls.",
      "id": "EvaluationMetricsThresholdsToolMatchingSettings",
      "properties": {
        "extraToolCallBehavior": {
          "enumDescriptions": [
            "Unspecified behavior. Defaults to FAIL.",
            "Fail the evaluation if an extra tool call is encountered.",
            "Allow the extra tool call."
          ],
          "type": "string",
          "enum": [
            "EXTRA_TOOL_CALL_BEHAVIOR_UNSPECIFIED",
            "FAIL",
            "ALLOW"
          ],
          "description": "Optional. Behavior for extra tool calls. Defaults to FAIL."
        }
      },
      "type": "object"
    },
    "LfA2aV1AgentCardSignature": {
      "description": "AgentCardSignature represents a JWS signature of an AgentCard. This follows the JSON format of an RFC 7515 JSON Web Signature (JWS).",
      "properties": {
        "signature": {
          "type": "string",
          "description": "Required. The computed signature, base64url-encoded."
        },
        "header": {
          "type": "object",
          "description": "The unprotected JWS header values.",
          "additionalProperties": {
            "description": "Properties of the object.",
            "type": "any"
          }
        },
        "protected": {
          "type": "string",
          "description": "Required. Required. The protected JWS header for the signature. This is always a base64url-encoded JSON object."
        }
      },
      "type": "object",
      "id": "LfA2aV1AgentCardSignature"
    },
    "ToolsetTool": {
      "description": "A tool that is created from a toolset.",
      "properties": {
        "toolset": {
          "type": "string",
          "description": "Required. The resource name of the Toolset from which this tool is derived. Format: `projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset}`"
        },
        "toolId": {
          "description": "Optional. The tool ID to filter the tools to retrieve the schema for.",
          "type": "string"
        }
      },
      "type": "object",
      "id": "ToolsetTool"
    },
    "MockConfig": {
      "description": "Mock tool calls configuration for the session.",
      "properties": {
        "mockedToolCalls": {
          "items": {
            "$ref": "MockedToolCall"
          },
          "description": "Optional. All tool calls to mock for the duration of the session.",
          "type": "array"
        },
        "unmatchedToolCallBehavior": {
          "description": "Required. Beavhior for tool calls that don't match any args patterns in mocked_tool_calls.",
          "type": "string",
          "enum": [
            "UNMATCHED_TOOL_CALL_BEHAVIOR_UNSPECIFIED",
            "FAIL",
            "PASS_THROUGH"
          ],
          "enumDescriptions": [
            "Default value. This value is unused.",
            "Throw an error for any tool calls that don't match a mock expected input pattern.",
            "For unmatched tool calls, pass the tool call through to real tool."
          ]
        }
      },
      "id": "MockConfig",
      "type": "object"
    },
    "CitationsCitedChunk": {
      "description": "Piece of cited information.",
      "type": "object",
      "properties": {
        "uri": {
          "description": "URI used for citation.",
          "type": "string"
        },
        "text": {
          "type": "string",
          "description": "Text used for citation."
        },
        "requiresAttribution": {
          "description": "Whether this citation requires attribution to be shown to the end users.",
          "type": "boolean"
        },
        "title": {
          "description": "Title of the cited document.",
          "type": "string"
        }
      },
      "id": "CitationsCitedChunk"
    },
    "ConversationTurn": {
      "type": "object",
      "properties": {
        "messages": {
          "description": "Optional. List of messages in the conversation turn, including user input, agent responses and intermediate events during the processing.",
          "type": "array",
          "items": {
            "$ref": "Message"
          }
        },
        "rootSpan": {
          "$ref": "Span",
          "description": "Optional. The root span of the action processing."
        },
        "userIntendedText": {
          "description": "Optional. The intended ground-truth text from the Simulated Caller (Polysynth). Only populated when word error rate metrics are enabled.",
          "type": "string"
        }
      },
      "id": "ConversationTurn",
      "description": "All information about a single turn in the conversation."
    },
    "OptionQuestionsChunkOption": {
      "properties": {
        "details": {
          "description": "Optional trade-off details shown as secondary text.",
          "type": "string"
        },
        "title": {
          "description": "Short plain-text option title (no markdown, no numbering).",
          "type": "string"
        },
        "submitText": {
          "description": "Optional message text to send when the option is chosen; defaults to `title` when empty.",
          "type": "string"
        }
      },
      "id": "OptionQuestionsChunkOption",
      "type": "object",
      "description": "A single selectable option."
    },
    "BigQueryExportSettings": {
      "type": "object",
      "properties": {
        "project": {
          "description": "Optional. The **project ID** of the BigQuery dataset to export the data to. Note: If the BigQuery dataset is in a different project from the app, you should grant `roles/bigquery.admin` role to the CES service agent `service-@gcp-sa-ces.iam.gserviceaccount.com`.",
          "type": "string"
        },
        "enabled": {
          "type": "boolean",
          "description": "Optional. Indicates whether the BigQuery export is enabled."
        },
        "dataset": {
          "type": "string",
          "description": "Optional. The BigQuery **dataset ID** to export the data to."
        }
      },
      "id": "BigQueryExportSettings",
      "description": "Settings to describe the BigQuery export behaviors for the app."
    },
    "Callback": {
      "description": "A callback defines the custom logic to be executed at various stages of agent interaction.",
      "properties": {
        "proactiveExecutionEnabled": {
          "description": "Optional. If enabled, the callback will also be executed on intermediate model outputs. This setting only affects after model callback. **ENABLE WITH CAUTION**. Typically after model callback only needs to be executed after receiving all model responses. Enabling proactive execution may have negative implication on the execution cost and latency, and should only be enabled in rare situations.",
          "type": "boolean"
        },
        "pythonCode": {
          "description": "Required. The python code to execute for the callback.",
          "type": "string"
        },
        "disabled": {
          "description": "Optional. Whether the callback is disabled. Disabled callbacks are ignored by the agent.",
          "type": "boolean"
        },
        "description": {
          "type": "string",
          "description": "Optional. Human-readable description of the callback."
        }
      },
      "type": "object",
      "id": "Callback"
    },
    "ListOperationsResponse": {
      "id": "ListOperationsResponse",
      "description": "The response message for Operations.ListOperations.",
      "properties": {
        "nextPageToken": {
          "type": "string",
          "description": "The standard List next-page token."
        },
        "operations": {
          "type": "array",
          "items": {
            "$ref": "Operation"
          },
          "description": "A list of operations that matches the specified filter in the request."
        },
        "unreachable": {
          "type": "array",
          "description": "Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections. For example, when attempting to list all resources across all supported locations.",
          "items": {
            "type": "string"
          }
        }
      },
      "type": "object"
    },
    "TestPersonaVoiceResponse": {
      "properties": {
        "audio": {
          "description": "The audio data bytes of the synthesized voice.",
          "type": "string",
          "format": "byte"
        }
      },
      "id": "TestPersonaVoiceResponse",
      "type": "object",
      "description": "Response message for EvaluationService.TestPersonaVoice."
    },
    "Tool": {
      "id": "Tool",
      "type": "object",
      "properties": {
        "clientFunction": {
          "description": "Optional. The client function.",
          "$ref": "ClientFunction"
        },
        "displayName": {
          "readOnly": true,
          "type": "string",
          "description": "Output only. The display name of the tool, derived based on the tool's type. For example, display name of a ClientFunction is derived from its `name` property."
        },
        "openApiTool": {
          "description": "Optional. The open API tool.",
          "$ref": "OpenApiTool"
        },
        "toolFakeConfig": {
          "description": "Optional. Configuration for tool behavior in fake mode.",
          "$ref": "ToolFakeConfig"
        },
        "systemTool": {
          "$ref": "SystemTool",
          "description": "Optional. The system tool."
        },
        "readOnly": {
          "description": "Output only. Indicates whether the tool is read-only. If true, the tool cannot be modified by the user.",
          "readOnly": true,
          "type": "boolean"
        },
        "name": {
          "description": "Identifier. The resource name of the tool. Format: * `projects/{project}/locations/{location}/apps/{app}/tools/{tool}` for standalone tools. * `projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset}/tools/{tool}` for tools retrieved from a toolset. These tools are dynamic and output-only; they cannot be referenced directly where a tool is expected.",
          "type": "string"
        },
        "createTime": {
          "readOnly": true,
          "format": "google-datetime",
          "type": "string",
          "description": "Output only. Timestamp when the tool was created."
        },
        "pythonFunction": {
          "$ref": "PythonFunction",
          "description": "Optional. The python function tool."
        },
        "remoteAgentTool": {
          "description": "Optional. The remote agent tool.",
          "$ref": "RemoteAgentTool"
        },
        "widgetTool": {
          "description": "Optional. The widget tool.",
          "$ref": "WidgetTool"
        },
        "executionType": {
          "enumDescriptions": [
            "The execution type is unspecified. Defaults to `SYNCHRONOUS` if unspecified.",
            "The tool is executed synchronously. The session is blocked until the tool returns.",
            "The tool is executed asynchronously. The session will continue while the tool is executing."
          ],
          "type": "string",
          "enum": [
            "EXECUTION_TYPE_UNSPECIFIED",
            "SYNCHRONOUS",
            "ASYNCHRONOUS"
          ],
          "description": "Optional. The execution type of the tool."
        },
        "updateTime": {
          "readOnly": true,
          "description": "Output only. Timestamp when the tool was last updated.",
          "type": "string",
          "format": "google-datetime"
        },
        "dataStoreTool": {
          "$ref": "DataStoreTool",
          "description": "Optional. The data store tool."
        },
        "generatedSummary": {
          "type": "string",
          "description": "Output only. If the tool is generated by the LLM assistant, this field contains a descriptive summary of the generation.",
          "readOnly": true
        },
        "mcpTool": {
          "description": "Optional. The MCP tool. An MCP tool cannot be created or updated directly and is managed by the MCP toolset.",
          "$ref": "McpTool"
        },
        "agentTool": {
          "$ref": "AgentTool",
          "description": "Optional. The agent tool."
        },
        "fileSearchTool": {
          "description": "Optional. The file search tool.",
          "$ref": "FileSearchTool"
        },
        "googleSearchTool": {
          "$ref": "GoogleSearchTool",
          "description": "Optional. The google search tool."
        },
        "etag": {
          "description": "Etag used to ensure the object hasn't changed during a read-modify-write operation. If the etag is empty, the update will overwrite any concurrent changes.",
          "type": "string"
        },
        "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.",
          "type": "string",
          "format": "google-duration"
        },
        "connectorTool": {
          "description": "Optional. The Integration Connector tool.",
          "$ref": "ConnectorTool"
        }
      },
      "description": "A tool represents an action that the CES agent can take to achieve certain goals."
    },
    "LfA2aV1AgentCapabilities": {
      "type": "object",
      "description": "Defines optional capabilities supported by an agent.",
      "id": "LfA2aV1AgentCapabilities",
      "properties": {
        "extensions": {
          "description": "A list of protocol extensions supported by the agent.",
          "items": {
            "$ref": "LfA2aV1AgentExtension"
          },
          "type": "array"
        },
        "streaming": {
          "type": "boolean",
          "description": "Indicates if the agent supports streaming responses."
        },
        "pushNotifications": {
          "description": "Indicates if the agent supports sending push notifications for asynchronous task updates.",
          "type": "boolean"
        },
        "extendedAgentCard": {
          "type": "boolean",
          "description": "Indicates if the agent supports providing an extended agent card when authenticated."
        }
      }
    },
    "ChannelProfilePersonaProperty": {
      "type": "object",
      "properties": {
        "persona": {
          "type": "string",
          "enum": [
            "UNKNOWN",
            "CONCISE",
            "CHATTY"
          ],
          "enumDescriptions": [
            "UNKNOWN persona.",
            "The agent keeps the responses concise and to the point",
            "The agent provides additional context, explanations, and details"
          ],
          "description": "Optional. The persona of the channel."
        }
      },
      "id": "ChannelProfilePersonaProperty",
      "description": "Represents the persona property of a channel."
    },
    "EvaluationScenarioMilestone": {
      "properties": {
        "staticUtterance": {
          "description": "Optional. A static utterance that the simulator will send exactly, instead of dynamically generating user input.",
          "type": "string"
        },
        "protocol": {
          "type": "string",
          "description": "Optional. The guidelines the agent should follow during the conversation."
        },
        "maxTurnCount": {
          "format": "int32",
          "description": "Optional. The maximum number of turns for this milestone.",
          "type": "integer"
        },
        "successCriteria": {
          "description": "Optional. The success criteria of the milestone.",
          "type": "string"
        },
        "goal": {
          "description": "Required. The goal of the milestone.",
          "type": "string"
        },
        "event": {
          "description": "Optional. An event input to send instead of dynamic generation.",
          "$ref": "Event"
        }
      },
      "type": "object",
      "description": "Represents a single milestone in the scenario. Used to guide the behaviour of the user simulator to follow a protocol. The user simulator executes the milestone sequentially and only proceeds to the next one if the success_criteria of that milestone is achieved.",
      "id": "EvaluationScenarioMilestone"
    },
    "EvaluationExpectation": {
      "description": "An evaluation expectation represents a specific criteria to evaluate against.",
      "id": "EvaluationExpectation",
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Identifier. The unique identifier of this evaluation expectation. Format: `projects/{project}/locations/{location}/apps/{app}/evaluationExpectations/{evaluation_expectation}`"
        },
        "etag": {
          "description": "Output only. Etag used to ensure the object hasn't changed during a read-modify-write operation. If the etag is empty, the update will overwrite any concurrent changes.",
          "readOnly": true,
          "type": "string"
        },
        "displayName": {
          "type": "string",
          "description": "Required. User-defined display name. Must be unique within the app."
        },
        "updateTime": {
          "type": "string",
          "readOnly": true,
          "format": "google-datetime",
          "description": "Output only. Timestamp when the evaluation expectation was last updated."
        },
        "tags": {
          "type": "array",
          "description": "Optional. User-defined tags for expectations. Can be used to filter expectations.",
          "items": {
            "type": "string"
          }
        },
        "createTime": {
          "readOnly": true,
          "format": "google-datetime",
          "type": "string",
          "description": "Output only. Timestamp when the evaluation expectation was created."
        },
        "llmCriteria": {
          "description": "Optional. Evaluation criteria based on an LLM prompt.",
          "$ref": "EvaluationExpectationLlmCriteria"
        }
      }
    },
    "LfA2aV1OAuthFlows": {
      "type": "object",
      "id": "LfA2aV1OAuthFlows",
      "properties": {
        "clientCredentials": {
          "$ref": "LfA2aV1ClientCredentialsOAuthFlow",
          "description": "Configuration for the OAuth Client Credentials flow."
        },
        "implicit": {
          "deprecated": true,
          "$ref": "LfA2aV1ImplicitOAuthFlow",
          "description": "Deprecated: Use Authorization Code + PKCE instead."
        },
        "deviceCode": {
          "description": "Configuration for the OAuth Device Code flow.",
          "$ref": "LfA2aV1DeviceCodeOAuthFlow"
        },
        "authorizationCode": {
          "$ref": "LfA2aV1AuthorizationCodeOAuthFlow",
          "description": "Configuration for the OAuth Authorization Code flow."
        },
        "password": {
          "deprecated": true,
          "$ref": "LfA2aV1PasswordOAuthFlow",
          "description": "Deprecated: Use Authorization Code + PKCE or Device Code."
        }
      },
      "description": "Defines the configuration for the supported OAuth 2.0 flows."
    },
    "GenerateAppResourceRequestAppVersionContext": {
      "id": "GenerateAppResourceRequestAppVersionContext",
      "properties": {
        "appVersion": {
          "description": "The resource name of the app version to be used by the LLM assistant. Format: `projects/{project}/locations/{location}/apps/{app}/versions/{version}`",
          "type": "string"
        },
        "agentResourceName": {
          "description": "The resource name of the target agent to be used by the LLM assistant. Format: `projects/{project}/locations/{location}/apps/{app}/agents/{agent}`",
          "type": "string"
        }
      },
      "type": "object",
      "description": "The app version context specifying the base snapshot and target agent."
    },
    "CloudLoggingSettings": {
      "description": "Settings to describe the Cloud Logging behaviors for the app.",
      "id": "CloudLoggingSettings",
      "type": "object",
      "properties": {
        "enableCloudLogging": {
          "description": "Optional. Whether to enable Cloud Logging for the sessions.",
          "type": "boolean"
        }
      }
    },
    "LatencyReportGuardrailLatency": {
      "properties": {
        "guardrailDisplayName": {
          "description": "Output only. The display name of the guardrail.",
          "type": "string",
          "readOnly": true
        },
        "guardrail": {
          "readOnly": true,
          "type": "string",
          "description": "Output only. The name of the guardrail. Format: `projects/{project}/locations/{location}/apps/{app}/guardrails/{guardrail}`."
        },
        "latencyMetrics": {
          "$ref": "LatencyReportLatencyMetrics",
          "readOnly": true,
          "description": "Output only. The latency metrics for the guardrail."
        }
      },
      "description": "Latency metrics for a single guardrail.",
      "type": "object",
      "id": "LatencyReportGuardrailLatency"
    },
    "CodeBlock": {
      "description": "A code block to be executed instead of a real tool call.",
      "type": "object",
      "id": "CodeBlock",
      "properties": {
        "pythonCode": {
          "description": "Required. Python code which will be invoked in tool fake mode. Expected Python function signature - To catch all tool calls: def fake_tool_call(tool: Tool, input: dict[str, Any], callback_context: CallbackContext) -\u003e Optional[dict[str, Any]]: To catch a specific tool call: def fake_{tool_id}(tool: Tool, input: dict[str, Any], callback_context: CallbackContext) -\u003e Optional[dict[str, Any]]: If the function returns None, the real tool will be invoked instead.",
          "type": "string"
        }
      }
    },
    "ListScheduledEvaluationRunsResponse": {
      "type": "object",
      "properties": {
        "nextPageToken": {
          "type": "string",
          "description": "A token that can be sent as ListScheduledEvaluationRunsRequest.page_token to retrieve the next page. Absence of this field indicates there are no subsequent pages."
        },
        "scheduledEvaluationRuns": {
          "description": "The list of scheduled evaluation runs.",
          "items": {
            "$ref": "ScheduledEvaluationRun"
          },
          "type": "array"
        }
      },
      "id": "ListScheduledEvaluationRunsResponse",
      "description": "Response message for EvaluationService.ListScheduledEvaluationRuns."
    },
    "ApiAuthentication": {
      "properties": {
        "apiKeyConfig": {
          "$ref": "ApiKeyConfig",
          "description": "Optional. Config for API key auth."
        },
        "serviceAccountAuthConfig": {
          "$ref": "ServiceAccountAuthConfig",
          "description": "Optional. Config for service account authentication."
        },
        "serviceAgentIdTokenAuthConfig": {
          "$ref": "ServiceAgentIdTokenAuthConfig",
          "description": "Optional. Config for ID token auth generated from CES service agent."
        },
        "oauthConfig": {
          "$ref": "OAuthConfig",
          "description": "Optional. Config for OAuth."
        },
        "bearerTokenConfig": {
          "$ref": "BearerTokenConfig",
          "description": "Optional. Config for bearer token auth."
        }
      },
      "id": "ApiAuthentication",
      "type": "object",
      "description": "Authentication information required for API calls."
    },
    "ScheduledEvaluationRun": {
      "id": "ScheduledEvaluationRun",
      "type": "object",
      "description": "Represents a scheduled evaluation run configuration.",
      "properties": {
        "displayName": {
          "type": "string",
          "description": "Required. User-defined display name of the scheduled evaluation run config."
        },
        "etag": {
          "type": "string",
          "readOnly": true,
          "description": "Output only. Etag used to ensure the object hasn't changed during a read-modify-write operation. If the etag is empty, the update will overwrite any concurrent changes."
        },
        "request": {
          "$ref": "RunEvaluationRequest",
          "description": "Required. The RunEvaluationRequest to schedule"
        },
        "totalExecutions": {
          "format": "int32",
          "type": "integer",
          "readOnly": true,
          "description": "Output only. The total number of times this run has been executed"
        },
        "nextScheduledExecutionTime": {
          "format": "google-datetime",
          "type": "string",
          "readOnly": true,
          "description": "Output only. The next time this is scheduled to execute"
        },
        "lastCompletedRun": {
          "type": "string",
          "description": "Output only. The last successful EvaluationRun of this scheduled execution. Format: `projects/{project}/locations/{location}/apps/{app}/evaluationRuns/{evaluationRun}`",
          "readOnly": true
        },
        "createTime": {
          "format": "google-datetime",
          "type": "string",
          "description": "Output only. Timestamp when the scheduled evaluation run was created.",
          "readOnly": true
        },
        "schedulingConfig": {
          "$ref": "ScheduledEvaluationRunSchedulingConfig",
          "description": "Required. Configuration for the timing and frequency with which to execute the evaluations."
        },
        "description": {
          "type": "string",
          "description": "Optional. User-defined description of the scheduled evaluation run."
        },
        "name": {
          "description": "Identifier. The unique identifier of the scheduled evaluation run config. Format: projects/{projectId}/locations/{locationId}/apps/{appId}/scheduledEvaluationRuns/{scheduledEvaluationRunId}",
          "type": "string"
        },
        "updateTime": {
          "type": "string",
          "readOnly": true,
          "format": "google-datetime",
          "description": "Output only. Timestamp when the evaluation was last updated."
        },
        "createdBy": {
          "type": "string",
          "description": "Output only. The user who created the scheduled evaluation run.",
          "readOnly": true
        },
        "active": {
          "type": "boolean",
          "description": "Optional. Whether this config is active"
        },
        "lastUpdatedBy": {
          "type": "string",
          "description": "Output only. The user who last updated the evaluation.",
          "readOnly": true
        }
      }
    },
    "GenerateAppResourceRequestToolGenerationConfigOpenApiToolsetGenerationConfigOperationGenerationConfig": {
      "properties": {
        "path": {
          "description": "Required. The path of the tool to be appended to the base uri. This should include query and path parameters if any.",
          "type": "string"
        },
        "method": {
          "description": "Required. The uri of the tool. This should include query and path parameters if any.",
          "type": "string"
        },
        "requestJson": {
          "description": "Required. A sample request to the tool in JSON format. Skip if the tool does not support request body.",
          "type": "string"
        },
        "responseJson": {
          "description": "Required. A sample response from the tool in JSON format.",
          "type": "string"
        }
      },
      "description": "The configuration to be used to generate an operation in the Open API schema.",
      "type": "object",
      "id": "GenerateAppResourceRequestToolGenerationConfigOpenApiToolsetGenerationConfigOperationGenerationConfig"
    },
    "EvaluationResult": {
      "id": "EvaluationResult",
      "description": "An evaluation result represents the output of running an Evaluation.",
      "type": "object",
      "properties": {
        "goldenRunMethod": {
          "readOnly": true,
          "enumDescriptions": [
            "Run method is not specified.",
            "Run the evaluation as stable replay, where each turn is a unique session with the previous expected turns injected as context.",
            "Run the evaluation as naive replay, where the run is a single session with no context injected."
          ],
          "description": "Output only. The method used to run the golden evaluation.",
          "type": "string",
          "enum": [
            "GOLDEN_RUN_METHOD_UNSPECIFIED",
            "STABLE",
            "NAIVE"
          ]
        },
        "errorInfo": {
          "description": "Output only. Error information for the evaluation result.",
          "$ref": "EvaluationErrorInfo",
          "readOnly": true
        },
        "evaluationMetricsThresholds": {
          "$ref": "EvaluationMetricsThresholds",
          "readOnly": true,
          "description": "Output only. The evaluation thresholds for the result."
        },
        "initiatedBy": {
          "readOnly": true,
          "description": "Output only. The user who initiated the evaluation run that resulted in this result.",
          "type": "string"
        },
        "changelog": {
          "description": "Output only. The changelog of the app version that the evaluation ran against. This is populated if user runs evaluation on latest/draft.",
          "readOnly": true,
          "type": "string"
        },
        "displayName": {
          "description": "Required. Display name of the Evaluation Result. Unique within an Evaluation. By default, it has the following format: \" result - \".",
          "type": "string"
        },
        "error": {
          "$ref": "Status",
          "deprecated": true,
          "readOnly": true,
          "description": "Output only. Deprecated: Use `error_info` instead. Errors encountered during execution."
        },
        "evaluationStatus": {
          "enumDescriptions": [
            "Evaluation outcome is not specified.",
            "Evaluation/Expectation passed. In the case of an evaluation, this means that all expectations were met.",
            "Evaluation/Expectation failed. In the case of an evaluation, this means that at least one expectation was not met.",
            "Evaluation/Expectation was skipped."
          ],
          "enum": [
            "OUTCOME_UNSPECIFIED",
            "PASS",
            "FAIL",
            "SKIPPED"
          ],
          "description": "Output only. The outcome of the evaluation. Only populated if execution_state is COMPLETE.",
          "readOnly": true,
          "type": "string"
        },
        "scenarioResult": {
          "$ref": "EvaluationResultScenarioResult",
          "readOnly": true,
          "description": "Output only. The outcome of a scenario evaluation."
        },
        "executionState": {
          "description": "Output only. The state of the evaluation result execution.",
          "enum": [
            "EXECUTION_STATE_UNSPECIFIED",
            "QUEUED",
            "RUNNING",
            "COMPLETED",
            "ERROR",
            "CANCELLED"
          ],
          "enumDescriptions": [
            "Evaluation result execution state is not specified.",
            "Evaluation result execution is queued.",
            "Evaluation result execution is running.",
            "Evaluation result execution has completed.",
            "Evaluation result execution failed due to an internal error.",
            "Evaluation result execution was cancelled."
          ],
          "type": "string",
          "readOnly": true
        },
        "appVersionDisplayName": {
          "readOnly": true,
          "type": "string",
          "description": "Output only. The display name of the `app_version` that the evaluation ran against."
        },
        "config": {
          "readOnly": true,
          "description": "Output only. The configuration used in the evaluation run that resulted in this result.",
          "$ref": "EvaluationConfig"
        },
        "outcomeMetadata": {
          "enum": [
            "OUTCOME_METADATA_UNSPECIFIED",
            "GRACEFUL_HANDOFF"
          ],
          "description": "Output only. The outcome metadata of the evaluation. Only populated if execution_state is COMPLETE.",
          "readOnly": true,
          "type": "string",
          "enumDescriptions": [
            "Unspecified outcome metadata.",
            "The evaluation resulted in a graceful handoff to a human representative."
          ]
        },
        "name": {
          "type": "string",
          "description": "Identifier. The unique identifier of the evaluation result. Format: `projects/{project}/locations/{location}/apps/{app}/evaluations/{evaluation}/results/{result}`"
        },
        "createTime": {
          "format": "google-datetime",
          "description": "Output only. Timestamp when the evaluation result was created.",
          "type": "string",
          "readOnly": true
        },
        "changelogCreateTime": {
          "type": "string",
          "format": "google-datetime",
          "description": "Output only. The create time of the changelog of the app version that the evaluation ran against. This is populated if user runs evaluation on latest/draft.",
          "readOnly": true
        },
        "goldenResult": {
          "description": "Output only. The outcome of a golden evaluation.",
          "readOnly": true,
          "$ref": "EvaluationResultGoldenResult"
        },
        "evaluationRun": {
          "readOnly": true,
          "description": "Output only. The evaluation run that produced this result. Format: `projects/{project}/locations/{location}/apps/{app}/evaluationRuns/{evaluationRun}`",
          "type": "string"
        },
        "persona": {
          "$ref": "EvaluationPersona",
          "readOnly": true,
          "description": "Output only. The persona used to generate the conversation for the evaluation result."
        },
        "rootSpan": {
          "readOnly": true,
          "$ref": "Span",
          "description": "Output only. The root span of the evaluation execution, which includes information about each step of the evaluation."
        },
        "appVersion": {
          "description": "Output only. The app version used to generate the conversation that resulted in this result. Format: `projects/{project}/locations/{location}/apps/{app}/versions/{version}`",
          "readOnly": true,
          "type": "string"
        }
      }
    },
    "GenerateOnboardingSuggestionsResponse": {
      "type": "object",
      "id": "GenerateOnboardingSuggestionsResponse",
      "description": "Response message for SessionService.GenerateOnboardingSuggestions.",
      "properties": {
        "suggestions": {
          "description": "Personalized suggestions, ranked most relevant first.",
          "type": "array",
          "items": {
            "$ref": "AssistantSuggestion"
          }
        },
        "contextToken": {
          "description": "Opaque token capturing the onboarding snapshot used to generate these suggestions. Clients echo it on the first StreamChatAiAssistantRequest so the server can reuse the snapshot.",
          "type": "string"
        },
        "userProfile": {
          "enumDescriptions": [
            "Unspecified profile.",
            "No assistant sessions containing messages.",
            "One or two assistant sessions containing messages.",
            "More than two assistant sessions containing messages."
          ],
          "type": "string",
          "enum": [
            "USER_PROFILE_UNSPECIFIED",
            "NEW",
            "EXPLORING",
            "RETURNING"
          ],
          "description": "Classification of the requesting user's history."
        }
      }
    },
    "EvaluationRun": {
      "type": "object",
      "id": "EvaluationRun",
      "description": "An evaluation run represents an all the evaluation results from an evaluation execution.",
      "properties": {
        "error": {
          "readOnly": true,
          "$ref": "Status",
          "description": "Output only. Deprecated: Use error_info instead. Errors encountered during execution.",
          "deprecated": true
        },
        "errorInfo": {
          "readOnly": true,
          "description": "Output only. Error information for the evaluation run.",
          "$ref": "EvaluationErrorInfo"
        },
        "changelog": {
          "type": "string",
          "description": "Output only. The changelog of the app version that the evaluation ran against. This is populated if user runs evaluation on latest/draft.",
          "readOnly": true
        },
        "displayName": {
          "description": "Optional. User-defined display name of the evaluation run. default: \" run - \".",
          "type": "string"
        },
        "evaluationDataset": {
          "type": "string",
          "readOnly": true,
          "description": "Output only. The evaluation dataset that this run is associated with. This field is mutually exclusive with `evaluations`. Format: `projects/{project}/locations/{location}/apps/{app}/evaluationDatasets/{evaluationDataset}`"
        },
        "appVersion": {
          "description": "Output only. The app version to evaluate. Format: `projects/{project}/locations/{location}/apps/{app}/versions/{version}`",
          "type": "string",
          "readOnly": true
        },
        "personaRunConfigs": {
          "items": {
            "$ref": "PersonaRunConfig"
          },
          "readOnly": true,
          "type": "array",
          "description": "Output only. The configuration to use for the run per persona."
        },
        "evaluationType": {
          "description": "Output only. The type of the evaluations in this run.",
          "readOnly": true,
          "enumDescriptions": [
            "Evaluation type is not specified.",
            "Golden evaluation.",
            "Scenario evaluation.",
            "Indicates the run includes a mix of golden and scenario evaluations."
          ],
          "type": "string",
          "enum": [
            "EVALUATION_TYPE_UNSPECIFIED",
            "GOLDEN",
            "SCENARIO",
            "MIXED"
          ]
        },
        "evaluationResults": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "description": "Output only. The evaluation results that are part of this run. Format: `projects/{project}/locations/{location}/apps/{app}/evaluations/{evaluation}/results/{result}`",
          "readOnly": true
        },
        "createTime": {
          "type": "string",
          "description": "Output only. Timestamp when the evaluation run was created.",
          "format": "google-datetime",
          "readOnly": true
        },
        "appVersionDisplayName": {
          "readOnly": true,
          "description": "Output only. The display name of the `app_version` that the evaluation ran against.",
          "type": "string"
        },
        "changelogCreateTime": {
          "readOnly": true,
          "description": "Output only. The create time of the changelog of the app version that the evaluation ran against. This is populated if user runs evaluation on latest/draft.",
          "format": "google-datetime",
          "type": "string"
        },
        "latencyReport": {
          "readOnly": true,
          "description": "Output only. Latency report for the evaluation run.",
          "$ref": "LatencyReport"
        },
        "progress": {
          "readOnly": true,
          "$ref": "EvaluationRunProgress",
          "description": "Output only. The progress of the evaluation run."
        },
        "goldenRunMethod": {
          "enumDescriptions": [
            "Run method is not specified.",
            "Run the evaluation as stable replay, where each turn is a unique session with the previous expected turns injected as context.",
            "Run the evaluation as naive replay, where the run is a single session with no context injected."
          ],
          "readOnly": true,
          "enum": [
            "GOLDEN_RUN_METHOD_UNSPECIFIED",
            "STABLE",
            "NAIVE"
          ],
          "description": "Output only. The method used to run the evaluation.",
          "type": "string"
        },
        "initiatedBy": {
          "readOnly": true,
          "type": "string",
          "description": "Output only. The user who initiated the evaluation run."
        },
        "optimizationConfig": {
          "description": "Optional. Configuration for running the optimization step after the evaluation run. If not set, the optimization step will not be run.",
          "$ref": "OptimizationConfig"
        },
        "name": {
          "type": "string",
          "description": "Identifier. The unique identifier of the evaluation run. Format: `projects/{project}/locations/{location}/apps/{app}/evaluationRuns/{evaluationRun}`"
        },
        "config": {
          "description": "Output only. The configuration used in the run.",
          "readOnly": true,
          "$ref": "EvaluationConfig"
        },
        "evaluationRunSummaries": {
          "description": "Output only. Map of evaluation name to EvaluationRunSummary.",
          "additionalProperties": {
            "$ref": "EvaluationRunEvaluationRunSummary"
          },
          "type": "object",
          "readOnly": true
        },
        "scheduledEvaluationRun": {
          "readOnly": true,
          "type": "string",
          "description": "Output only. The scheduled evaluation run resource name that created this evaluation run. This field is only set if the evaluation run was created by a scheduled evaluation run. Format: `projects/{project}/locations/{location}/apps/{app}/scheduledEvaluationRuns/{scheduled_evaluation_run}`"
        },
        "evaluations": {
          "description": "Output only. The evaluations that are part of this run. The list may contain evaluations of either type. This field is mutually exclusive with `evaluation_dataset`. Format: `projects/{project}/locations/{location}/apps/{app}/evaluations/{evaluation}`",
          "items": {
            "type": "string"
          },
          "type": "array",
          "readOnly": true
        },
        "state": {
          "readOnly": true,
          "description": "Output only. The state of the evaluation run.",
          "enumDescriptions": [
            "Evaluation run state is not specified.",
            "Indicates the evaluation run is queued.",
            "Evaluation run is running.",
            "Evaluation run has completed.",
            "The evaluation run has an error.",
            "Evaluation run was cancelled."
          ],
          "type": "string",
          "enum": [
            "EVALUATION_RUN_STATE_UNSPECIFIED",
            "QUEUED",
            "RUNNING",
            "COMPLETED",
            "ERROR",
            "CANCELLED"
          ]
        },
        "runCount": {
          "readOnly": true,
          "format": "int32",
          "description": "Output only. The number of times the evaluations inside the run were run.",
          "type": "integer"
        },
        "operation": {
          "description": "Output only. The operation that created this evaluation run. Format: `projects/{project}/locations/{location}/operations/{operation}`",
          "type": "string",
          "readOnly": true
        }
      }
    },
    "LfA2aV1SendMessageConfiguration": {
      "id": "LfA2aV1SendMessageConfiguration",
      "description": "Configuration of a send message request.",
      "type": "object",
      "properties": {
        "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"
        },
        "historyLength": {
          "type": "integer",
          "format": "int32",
          "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."
        },
        "taskPushNotificationConfig": {
          "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.",
          "$ref": "LfA2aV1TaskPushNotificationConfig"
        },
        "acceptedOutputModes": {
          "description": "A list of media types the client is prepared to accept for response parts. Agents SHOULD use this to tailor their output.",
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      }
    },
    "LfA2aV1APIKeySecurityScheme": {
      "properties": {
        "location": {
          "type": "string",
          "description": "Required. The location of the API key. Valid values are \"query\", \"header\", or \"cookie\"."
        },
        "description": {
          "type": "string",
          "description": "An optional description for the security scheme."
        },
        "name": {
          "type": "string",
          "description": "Required. The name of the header, query, or cookie parameter to be used."
        }
      },
      "description": "Defines a security scheme using an API key.",
      "type": "object",
      "id": "LfA2aV1APIKeySecurityScheme"
    },
    "ClientFunction": {
      "type": "object",
      "id": "ClientFunction",
      "description": "Represents a client-side function that the agent can invoke. When the tool is chosen by the agent, control is handed off to the client. The client is responsible for executing the function and returning the result as a ToolResponse to continue the interaction with the agent.",
      "properties": {
        "description": {
          "description": "Optional. The function description.",
          "type": "string"
        },
        "response": {
          "description": "Optional. The schema of the function response.",
          "$ref": "Schema"
        },
        "parameters": {
          "description": "Optional. The schema of the function parameters.",
          "$ref": "Schema"
        },
        "name": {
          "type": "string",
          "description": "Required. The function name."
        }
      }
    },
    "AgentRegistryDeployment": {
      "type": "object",
      "description": "Configuration and status for Agent Registry deployment.",
      "properties": {
        "agentRegistryServiceName": {
          "type": "string",
          "description": "Optional. Output only. The resource name of the deployed Agent Registry service. Format: `projects/{project}/locations/{location}/services/{service}`",
          "readOnly": true
        }
      },
      "id": "AgentRegistryDeployment"
    },
    "SessionConfig": {
      "type": "object",
      "id": "SessionConfig",
      "properties": {
        "outputAudioConfig": {
          "description": "Optional. Configuration for generating the output audio.",
          "$ref": "OutputAudioConfig"
        },
        "remoteDialogflowQueryParameters": {
          "description": "Optional. [QueryParameters](https://cloud.google.com/dialogflow/cx/docs/reference/rpc/google.cloud.dialogflow.cx.v3#queryparameters) to send to the remote [Dialogflow](https://cloud.google.com/dialogflow/cx/docs/concept/console-conversational-agents) agent when the session control is transferred to the remote agent.",
          "$ref": "SessionConfigRemoteDialogflowQueryParameters"
        },
        "enableTextStreaming": {
          "type": "boolean",
          "description": "Optional. Whether to stream text output from the model to the client incrementally as it is generated. Defaults to `false`. * When disabled, the model's text output is buffered, and each text output sent to the client is a complete sentence. Clients can render each text output on a new line. * When enabled, each text output may contain only part of a sentence. Clients should concatenate consecutive text outputs to render the complete response. NOTE: This is only supported for text (non-voice) sessions using StreamRunSession or BidiRunSession."
        },
        "historicalContexts": {
          "items": {
            "$ref": "Message"
          },
          "type": "array",
          "description": "Optional. The historical context of the session, including user inputs, agent responses, and other messages. Typically, CES agent would manage session automatically so client doesn't need to explicitly populate this field. However, client can optionally override the historical contexts to force the session start from certain state."
        },
        "deployment": {
          "description": "Optional. The deployment of the app to use for the session. Format: `projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}`",
          "type": "string"
        },
        "timeZone": {
          "description": "Optional. The time zone of the user. If provided, the agent will use the time zone for date and time related variables. Otherwise, the agent will use the time zone specified in the App.time_zone_settings. The format is the IANA Time Zone Database time zone, e.g. \"America/Los_Angeles\".",
          "type": "string"
        },
        "includeProgressUpdate": {
          "description": "Optional. Whether to include intermediate processing update to the client. If enabled, the update will be sent back in SessionOutput.progress.",
          "type": "boolean"
        },
        "inputAudioConfig": {
          "description": "Optional. Configuration for processing the input audio.",
          "$ref": "InputAudioConfig"
        },
        "includeLlmThoughtSummary": {
          "type": "boolean",
          "description": "Optional. Whether to include LLM thought summaries in the session outputs."
        },
        "excludeDiagnosticInfo": {
          "description": "Optional. Whether to exclude diagnostic info from the session output.",
          "type": "boolean"
        },
        "entryAgent": {
          "description": "Optional. The entry agent to handle the session. If not specified, the session will be handled by the root agent of the app. Format: `projects/{project}/locations/{location}/apps/{app}/agents/{agent}`",
          "type": "string"
        },
        "useToolFakes": {
          "type": "boolean",
          "description": "Optional. Whether to use tool fakes for the session. If this field is set, the agent will attempt use tool fakes instead of calling the real tools."
        }
      },
      "description": "The configuration for the session."
    },
    "ListEvaluationsResponse": {
      "description": "Response message for EvaluationService.ListEvaluations.",
      "properties": {
        "evaluations": {
          "description": "The list of evaluations.",
          "items": {
            "$ref": "Evaluation"
          },
          "type": "array"
        },
        "nextPageToken": {
          "type": "string",
          "description": "A token that can be sent as ListEvaluationsRequest.page_token to retrieve the next page. Absence of this field indicates there are no subsequent pages."
        }
      },
      "type": "object",
      "id": "ListEvaluationsResponse"
    },
    "LfA2aV1AuthorizationCodeOAuthFlow": {
      "type": "object",
      "properties": {
        "pkceRequired": {
          "description": "Indicates if PKCE (RFC 7636) is required for this flow. PKCE should always be used for public clients and is recommended for all clients.",
          "type": "boolean"
        },
        "scopes": {
          "additionalProperties": {
            "type": "string"
          },
          "type": "object",
          "description": "Required. The available scopes for the OAuth2 security scheme."
        },
        "authorizationUrl": {
          "type": "string",
          "description": "Required. The authorization URL to be used for this flow."
        },
        "tokenUrl": {
          "description": "Required. The token URL to be used for this flow.",
          "type": "string"
        },
        "refreshUrl": {
          "type": "string",
          "description": "The URL to be used for obtaining refresh tokens."
        }
      },
      "id": "LfA2aV1AuthorizationCodeOAuthFlow",
      "description": "Defines configuration details for the OAuth 2.0 Authorization Code flow."
    },
    "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.",
      "type": "object",
      "id": "LfA2aV1Task",
      "properties": {
        "history": {
          "type": "array",
          "items": {
            "$ref": "LfA2aV1Message"
          },
          "description": "protolint:disable REPEATED_FIELD_NAMES_PLURALIZED The history of interactions from a `Task`."
        },
        "metadata": {
          "type": "object",
          "additionalProperties": {
            "type": "any",
            "description": "Properties of the object."
          },
          "description": "protolint:enable REPEATED_FIELD_NAMES_PLURALIZED A key/value object to store custom metadata about a task."
        },
        "artifacts": {
          "type": "array",
          "description": "A set of output artifacts for a `Task`.",
          "items": {
            "$ref": "LfA2aV1Artifact"
          }
        },
        "contextId": {
          "description": "Unique identifier (e.g. UUID) for the contextual collection of interactions (tasks and messages).",
          "type": "string"
        },
        "status": {
          "$ref": "LfA2aV1TaskStatus",
          "description": "Required. The current status of a `Task`, including `state` and a `message`."
        },
        "id": {
          "type": "string",
          "description": "Required. Unique identifier (e.g. UUID) for the task, generated by the server for a new task."
        }
      }
    },
    "ListEvaluationDatasetsResponse": {
      "description": "Response message for EvaluationService.ListEvaluationDatasets.",
      "properties": {
        "evaluationDatasets": {
          "items": {
            "$ref": "EvaluationDataset"
          },
          "type": "array",
          "description": "The list of evaluation datasets."
        },
        "nextPageToken": {
          "description": "A token that can be sent as ListEvaluationDatasetsRequest.page_token to retrieve the next page. Absence of this field indicates there are no subsequent pages.",
          "type": "string"
        }
      },
      "type": "object",
      "id": "ListEvaluationDatasetsResponse"
    },
    "LatencyReportToolLatency": {
      "description": "Latency metrics for a single tool.",
      "id": "LatencyReportToolLatency",
      "type": "object",
      "properties": {
        "toolDisplayName": {
          "readOnly": true,
          "type": "string",
          "description": "Output only. The display name of the tool."
        },
        "latencyMetrics": {
          "readOnly": true,
          "$ref": "LatencyReportLatencyMetrics",
          "description": "Output only. The latency metrics for the tool."
        },
        "toolsetTool": {
          "$ref": "ToolsetTool",
          "readOnly": true,
          "description": "Output only. The toolset tool identifier."
        },
        "tool": {
          "description": "Output only. Format: `projects/{project}/locations/{location}/apps/{app}/tools/{tool}`.",
          "type": "string",
          "readOnly": true
        }
      }
    },
    "ModelSettings": {
      "description": "Model settings contains various configurations for the LLM model.",
      "id": "ModelSettings",
      "properties": {
        "temperature": {
          "type": "number",
          "description": "Optional. If set, this temperature will be used for the LLM model. Temperature controls the randomness of the model's responses. Lower temperatures produce responses that are more predictable. Higher temperatures produce responses that are more creative.",
          "format": "double"
        },
        "model": {
          "description": "Optional. The LLM model that the agent should use. If not set, the agent will inherit the model from its parent agent.",
          "type": "string"
        },
        "thinkingLevel": {
          "description": "Optional. The thinking level of the model.",
          "enumDescriptions": [
            "Thinking level is unspecified.",
            "Default thinking level.",
            "Low thinking level.",
            "Medium thinking level.",
            "High thinking level."
          ],
          "type": "string",
          "enum": [
            "THINKING_LEVEL_UNSPECIFIED",
            "DEFAULT",
            "LOW",
            "MEDIUM",
            "HIGH"
          ]
        }
      },
      "type": "object"
    },
    "ImportAppResponse": {
      "description": "Response message for AgentService.ImportApp.",
      "properties": {
        "name": {
          "type": "string",
          "description": "The resource name of the app that was imported."
        },
        "warnings": {
          "description": "Warning messages generated during the import process. If errors occur for specific resources, they will not be included in the imported app and the error will be mentioned here.",
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "type": "object",
      "id": "ImportAppResponse"
    },
    "ToolCalls": {
      "description": "Request for the client to execute the tools and return the execution results before continuing the session.",
      "type": "object",
      "id": "ToolCalls",
      "properties": {
        "toolCalls": {
          "description": "Optional. The list of tool calls to execute.",
          "type": "array",
          "items": {
            "$ref": "ToolCall"
          }
        }
      }
    },
    "UploadEvaluationAudioRequest": {
      "description": "Request message for EvaluationService.UploadEvaluationAudio.",
      "id": "UploadEvaluationAudioRequest",
      "properties": {
        "audioContent": {
          "description": "Required. The raw audio bytes. The format of the audio must be single-channel LINEAR16 with a sample rate of 16kHz (default InputAudioConfig).",
          "format": "byte",
          "type": "string"
        },
        "previousAudioGcsUri": {
          "type": "string",
          "description": "Optional. The Google Cloud Storage URI of the previously uploaded audio file to be deleted. Format: `gs:///`"
        }
      },
      "type": "object"
    },
    "EvaluationMetricsConfig": {
      "type": "object",
      "description": "Configures the metrics for an evaluation.",
      "properties": {
        "goldenMetricsConfig": {
          "description": "Optional. Configuration for the golden metrics for the evaluation.",
          "$ref": "EvaluationMetricsConfigGoldenMetricsConfig"
        },
        "scenarioMetricsConfig": {
          "description": "Optional. Configuration for the scenario metrics for the evaluation.",
          "$ref": "EvaluationMetricsConfigScenarioMetricsConfig"
        }
      },
      "id": "EvaluationMetricsConfig"
    },
    "GenerateAppResourceResponseEvaluations": {
      "id": "GenerateAppResourceResponseEvaluations",
      "properties": {
        "evaluations": {
          "items": {
            "$ref": "Evaluation"
          },
          "type": "array",
          "description": "The list of generated evaluations."
        }
      },
      "type": "object",
      "description": "The list of evaluations generated by the LLM assistant."
    },
    "ErrorHandlingSettingsEndSessionConfig": {
      "id": "ErrorHandlingSettingsEndSessionConfig",
      "description": "Configuration for ending the session in case of system errors (e.g. LLM errors).",
      "type": "object",
      "properties": {
        "escalateSession": {
          "description": "Optional. Whether to escalate the session in EndSession. If session is escalated, metadata in EndSession will contain `session_escalated = true`. See https://docs.cloud.google.com/customer-engagement-ai/conversational-agents/ps/deploy/google-telephony-platform#transfer_a_call_to_a_human_agent for details.",
          "type": "boolean"
        }
      }
    },
    "GenerateAppResourceRequest": {
      "type": "object",
      "properties": {
        "toolGenerationConfig": {
          "$ref": "GenerateAppResourceRequestToolGenerationConfig",
          "description": "Optional. The configuration to be used to generate the tool."
        },
        "qualityReportGenerationConfig": {
          "description": "Optional. The configuration to be used for quality report generation.",
          "$ref": "GenerateAppResourceRequestQualityReportGenerationConfig"
        },
        "evaluationGenerationConfig": {
          "$ref": "GenerateAppResourceRequestEvaluationGenerationConfig",
          "description": "Optional. The configuration to be used to generate the evaluations."
        },
        "evaluationPersonasGenerationConfig": {
          "description": "Optional. The configuration to be used to generate the evaluation personas.",
          "$ref": "GenerateAppResourceRequestEvaluationPersonasGenerationConfig"
        },
        "refineInstructions": {
          "items": {
            "$ref": "GenerateAppResourceRequestRefineInstructions"
          },
          "type": "array",
          "description": "Optional. List of refine instructions to be used to refine the resource."
        },
        "appVersionContext": {
          "description": "The app version context specifying the base snapshot and target agent.",
          "$ref": "GenerateAppResourceRequestAppVersionContext"
        },
        "tool": {
          "description": "The tool resource to be used by the LLM assistant, can be empty for generating a new tool.",
          "$ref": "Tool"
        },
        "hillClimbingFixConfig": {
          "$ref": "GenerateAppResourceRequestHillClimbingFixConfig",
          "description": "Optional. The configuration to be used for hill climbing fixes."
        },
        "toolset": {
          "$ref": "Toolset",
          "description": "The toolset resource to be used by the LLM assistant, can be empty for generating a new toolset."
        },
        "agent": {
          "description": "The agent resource to be used by the LLM assistant, can be empty for generating a new agent.",
          "$ref": "Agent"
        },
        "appGenerationConfig": {
          "$ref": "GenerateAppResourceRequestAppGenerationConfig",
          "description": "Optional. The configuration to be used to generate the agents and tools."
        }
      },
      "id": "GenerateAppResourceRequest",
      "description": "Request message for AgentService.GenerateAppResource."
    },
    "TurnCompletedEvent": {
      "id": "TurnCompletedEvent",
      "description": "Terminal event of a turn (see StreamChatAiAssistantResponse.turn_completed).",
      "type": "object",
      "properties": {
        "turnId": {
          "description": "Identifier of the turn that ended; matches TurnResumeSnapshot.turn_id and ActiveTurnInfo.turn_id.",
          "type": "string"
        },
        "reason": {
          "enumDescriptions": [
            "Unspecified.",
            "The turn ran to completion; the session holds its committed output.",
            "No task was driving the turn any more; it was sealed to a committed partial and cannot be continued.",
            "This server does not serve attach or resume for the session, so nothing was tailed; the client should reload the session instead."
          ],
          "type": "string",
          "enum": [
            "REASON_UNSPECIFIED",
            "COMPLETED",
            "ABANDONED",
            "RESUME_UNAVAILABLE"
          ],
          "description": "Why the turn ended."
        },
        "touchedApps": {
          "type": "array",
          "description": "Apps this turn targeted or changed, so the console can refresh exactly those apps' stores. Project-scoped sessions only. Format: `projects/{project}/locations/{location}/apps/{app}`",
          "items": {
            "type": "string"
          }
        },
        "finalSequenceNumber": {
          "format": "int64",
          "description": "Sequence number of the last event the turn produced. A client whose cursor is lower missed content and should reload the session to see it.",
          "type": "string"
        }
      }
    },
    "GenerateAppResourceRequestToolGenerationConfigOpenApiToolsetGenerationConfig": {
      "type": "object",
      "id": "GenerateAppResourceRequestToolGenerationConfigOpenApiToolsetGenerationConfig",
      "description": "The configuration to be used to generate an Open API schema.",
      "properties": {
        "uri": {
          "description": "Required. The base uri of the tool.",
          "type": "string"
        },
        "operationGenerationConfigs": {
          "type": "array",
          "description": "Required. The list of operations to be added to the Open API schema.",
          "items": {
            "$ref": "GenerateAppResourceRequestToolGenerationConfigOpenApiToolsetGenerationConfigOperationGenerationConfig"
          }
        }
      }
    },
    "CreateAssistantSessionRequest": {
      "id": "CreateAssistantSessionRequest",
      "description": "Request message for AssistantService.CreateAssistantSession.",
      "properties": {
        "assistantSessionMessages": {
          "type": "array",
          "items": {
            "$ref": "AssistantMessage"
          },
          "description": "Optional. The messages to seed the assistant session with."
        },
        "assistantSessionId": {
          "type": "string",
          "description": "Optional. The ID to use for the assistant session, which will become the final component of the assistant session's resource name. If not provided, a unique ID will be automatically assigned for the assistant session."
        }
      },
      "type": "object"
    },
    "GenerateEvaluationOperationMetadata": {
      "id": "GenerateEvaluationOperationMetadata",
      "type": "object",
      "properties": {},
      "description": "Operation metadata for EvaluationService.GenerateEvaluation."
    },
    "TypedPayload": {
      "id": "TypedPayload",
      "type": "object",
      "description": "Payload with a type. Used by the assistant history (`AssistantChunk`) and by the streaming `typed_payload` event; lives here because both assistant_service.proto and session_service.proto need it.",
      "properties": {
        "metadata": {
          "description": "Optional. The metadata of the payload.",
          "additionalProperties": {
            "type": "any",
            "description": "Properties of the object."
          },
          "type": "object"
        },
        "type": {
          "description": "Required. The type of the payload.",
          "type": "string"
        },
        "value": {
          "additionalProperties": {
            "type": "any",
            "description": "Properties of the object."
          },
          "type": "object",
          "description": "Required. The value of the payload."
        },
        "displayName": {
          "description": "Required. The display name of the payload.",
          "type": "string"
        }
      }
    },
    "OpenApiToolset": {
      "properties": {
        "ignoreUnknownFields": {
          "type": "boolean",
          "description": "Optional. If true, the agent will ignore unknown fields in the API response for all operations defined in the OpenAPI schema."
        },
        "apiAuthentication": {
          "$ref": "ApiAuthentication",
          "description": "Optional. Authentication information required by the API."
        },
        "openApiSchema": {
          "type": "string",
          "description": "Required. The OpenAPI schema of the toolset."
        },
        "url": {
          "description": "Optional. The server URL of the Open API schema. This field is only set in toolsets in the environment dependencies during the export process if the schema contains a server url. During the import process, if this url is present in the environment dependencies and the schema has the $env_var placeholder, it will replace the placeholder in the schema.",
          "type": "string"
        },
        "serviceDirectoryConfig": {
          "description": "Optional. Service Directory configuration.",
          "$ref": "ServiceDirectoryConfig"
        },
        "tlsConfig": {
          "description": "Optional. The TLS configuration. Includes the custom server certificates",
          "$ref": "TlsConfig"
        }
      },
      "type": "object",
      "description": "A toolset that contains a list of tools that are defined by an OpenAPI schema.",
      "id": "OpenApiToolset"
    },
    "ChannelProfileWebWidgetConfig": {
      "description": "Message for configuration for the web widget.",
      "properties": {
        "theme": {
          "enumDescriptions": [
            "Unknown theme.",
            "Light theme.",
            "Dark theme."
          ],
          "type": "string",
          "enum": [
            "THEME_UNSPECIFIED",
            "LIGHT",
            "DARK"
          ],
          "description": "Optional. The theme of the web widget."
        },
        "modality": {
          "description": "Optional. The modality of the web widget.",
          "type": "string",
          "enum": [
            "MODALITY_UNSPECIFIED",
            "CHAT_AND_VOICE",
            "VOICE_ONLY",
            "CHAT_ONLY",
            "CHAT_VOICE_AND_VIDEO"
          ],
          "enumDescriptions": [
            "Unknown modality.",
            "Widget supports both chat and voice input.",
            "Widget supports only voice input.",
            "Widget supports only chat input.",
            "Widget supports chat, voice, and video input."
          ]
        },
        "webWidgetTitle": {
          "description": "Optional. The title of the web widget.",
          "type": "string"
        },
        "securitySettings": {
          "description": "Optional. The security settings of the web widget.",
          "$ref": "ChannelProfileWebWidgetConfigSecuritySettings"
        }
      },
      "type": "object",
      "id": "ChannelProfileWebWidgetConfig"
    },
    "LfA2aV1ClientCredentialsOAuthFlow": {
      "description": "Defines configuration details for the OAuth 2.0 Client Credentials flow.",
      "type": "object",
      "id": "LfA2aV1ClientCredentialsOAuthFlow",
      "properties": {
        "refreshUrl": {
          "description": "The URL to be used for obtaining refresh tokens.",
          "type": "string"
        },
        "scopes": {
          "description": "Required. The available scopes for the OAuth2 security scheme.",
          "type": "object",
          "additionalProperties": {
            "type": "string"
          }
        },
        "tokenUrl": {
          "description": "Required. The token URL to be used for this flow.",
          "type": "string"
        }
      }
    },
    "LfA2aV1OpenIdConnectSecurityScheme": {
      "id": "LfA2aV1OpenIdConnectSecurityScheme",
      "type": "object",
      "properties": {
        "description": {
          "type": "string",
          "description": "An optional description for the security scheme."
        },
        "openIdConnectUrl": {
          "description": "Required. The [OpenID Connect Discovery URL](https://openid.net/specs/openid-connect-discovery-1_0.html) for the OIDC provider's metadata.",
          "type": "string"
        }
      },
      "description": "Defines a security scheme using OpenID Connect."
    },
    "AssistantChunk": {
      "description": "A chunk of data in an assistant message.",
      "id": "AssistantChunk",
      "properties": {
        "thought": {
          "type": "string",
          "description": "Optional. Thought generated by the model."
        },
        "typedPayload": {
          "description": "Optional. Typed payload which contains structured responses.",
          "$ref": "TypedPayload"
        },
        "createTime": {
          "description": "Optional. Timestamp when the chunk was created or emitted.",
          "type": "string",
          "format": "google-datetime"
        },
        "payload": {
          "type": "object",
          "additionalProperties": {
            "description": "Properties of the object.",
            "type": "any"
          },
          "description": "Optional. Payload which contains structured responses like the quality report, agent version name, suggested responses etc."
        },
        "text": {
          "type": "string",
          "description": "Optional. Text data."
        }
      },
      "type": "object"
    },
    "Evaluation": {
      "id": "Evaluation",
      "description": "An evaluation represents all of the information needed to simulate and evaluate an agent.",
      "type": "object",
      "properties": {
        "golden": {
          "$ref": "EvaluationGolden",
          "description": "Optional. The golden steps to be evaluated."
        },
        "lastTenResults": {
          "items": {
            "$ref": "EvaluationResult"
          },
          "type": "array",
          "readOnly": true,
          "description": "Output only. The last 10 evaluation results for this evaluation. This is only populated if include_last_ten_results is set to true in the ListEvaluationsRequest or GetEvaluationRequest."
        },
        "displayName": {
          "description": "Required. User-defined display name of the evaluation. Unique within an App.",
          "type": "string"
        },
        "lastCompletedResult": {
          "description": "Output only. The latest evaluation result for this evaluation.",
          "$ref": "EvaluationResult",
          "readOnly": true
        },
        "createdBy": {
          "type": "string",
          "readOnly": true,
          "description": "Output only. The user who created the evaluation."
        },
        "evaluationRuns": {
          "description": "Output only. The EvaluationRuns that this Evaluation is associated with.",
          "readOnly": true,
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "etag": {
          "type": "string",
          "description": "Output only. Etag used to ensure the object hasn't changed during a read-modify-write operation. If the etag is empty, the update will overwrite any concurrent changes.",
          "readOnly": true
        },
        "tags": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "description": "Optional. User defined tags to categorize the evaluation."
        },
        "scenario": {
          "description": "Optional. The config for a scenario.",
          "$ref": "EvaluationScenario"
        },
        "invalid": {
          "readOnly": true,
          "type": "boolean",
          "description": "Output only. Whether the evaluation is invalid. This can happen if an evaluation is referencing a tool, toolset, or agent that has since been deleted."
        },
        "evaluationMetricsConfigOverride": {
          "$ref": "EvaluationMetricsConfig",
          "description": "Optional. Overrides metrics config for this specific evaluation."
        },
        "aggregatedMetrics": {
          "description": "Output only. The aggregated metrics for this evaluation across all runs.",
          "readOnly": true,
          "$ref": "AggregatedMetrics"
        },
        "evaluationMetricsThresholdOverride": {
          "description": "Optional. Overrides metrics thresholds for this specific evaluation.",
          "$ref": "EvaluationMetricsThresholds"
        },
        "updateTime": {
          "readOnly": true,
          "type": "string",
          "description": "Output only. Timestamp when the evaluation was last updated.",
          "format": "google-datetime"
        },
        "name": {
          "description": "Identifier. The unique identifier of this evaluation. Format: `projects/{project}/locations/{location}/apps/{app}/evaluations/{evaluation}`",
          "type": "string"
        },
        "lastUpdatedBy": {
          "type": "string",
          "description": "Output only. The user who last updated the evaluation.",
          "readOnly": true
        },
        "description": {
          "description": "Optional. User-defined description of the evaluation.",
          "type": "string"
        },
        "createTime": {
          "description": "Output only. Timestamp when the evaluation was created.",
          "type": "string",
          "readOnly": true,
          "format": "google-datetime"
        },
        "evaluationDatasets": {
          "type": "array",
          "description": "Output only. List of evaluation datasets the evaluation belongs to. Format: `projects/{project}/locations/{location}/apps/{app}/evaluationDatasets/{evaluationDataset}`",
          "items": {
            "type": "string"
          },
          "readOnly": true
        }
      }
    },
    "TlsConfigCaCert": {
      "id": "TlsConfigCaCert",
      "properties": {
        "cert": {
          "description": "Required. The allowed custom CA certificates (in DER format) for HTTPS verification. This overrides the default SSL trust store. If this is empty or unspecified, CES will use Google's default trust store to verify certificates. N.B. Make sure the HTTPS server certificates are signed with \"subject alt name\". For instance a certificate can be self-signed using the following command: ``` openssl x509 -req -days 200 -in example.com.csr \\ -signkey example.com.key \\ -out example.com.crt \\ -extfile \u003c(printf \"\\nsubjectAltName='DNS:www.example.com'\") ```",
          "format": "byte",
          "type": "string"
        },
        "displayName": {
          "description": "Required. The name of the allowed custom CA certificates. This can be used to disambiguate the custom CA certificates.",
          "type": "string"
        }
      },
      "description": "The CA certificate.",
      "type": "object"
    },
    "DataStoreToolDataStoreSource": {
      "properties": {
        "filter": {
          "description": "Optional. Filter specification for the DataStore. See: https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata",
          "type": "string"
        },
        "dataStore": {
          "$ref": "DataStore",
          "description": "Optional. The data store."
        }
      },
      "description": "Configuration for searching within a specific DataStore.",
      "id": "DataStoreToolDataStoreSource",
      "type": "object"
    },
    "Span": {
      "id": "Span",
      "properties": {
        "name": {
          "description": "Output only. The name of the span.",
          "readOnly": true,
          "type": "string"
        },
        "attributes": {
          "additionalProperties": {
            "description": "Properties of the object.",
            "type": "any"
          },
          "description": "Output only. Key-value attributes associated with the span.",
          "readOnly": true,
          "type": "object"
        },
        "childSpans": {
          "items": {
            "$ref": "Span"
          },
          "readOnly": true,
          "type": "array",
          "description": "Output only. The child spans that are nested under this span."
        },
        "startTime": {
          "readOnly": true,
          "type": "string",
          "format": "google-datetime",
          "description": "Output only. The start time of the span."
        },
        "endTime": {
          "format": "google-datetime",
          "readOnly": true,
          "description": "Output only. The end time of the span.",
          "type": "string"
        },
        "duration": {
          "format": "google-duration",
          "type": "string",
          "readOnly": true,
          "description": "Output only. The duration of the span."
        }
      },
      "type": "object",
      "description": "A span is a unit of work or a single operation during the request processing."
    },
    "ListGuardrailsResponse": {
      "description": "Response message for AgentService.ListGuardrails.",
      "type": "object",
      "id": "ListGuardrailsResponse",
      "properties": {
        "guardrails": {
          "type": "array",
          "description": "The list of guardrails.",
          "items": {
            "$ref": "Guardrail"
          }
        },
        "nextPageToken": {
          "type": "string",
          "description": "A token that can be sent as ListGuardrailsRequest.page_token to retrieve the next page. Absence of this field indicates there are no subsequent pages."
        }
      }
    },
    "DataStoreToolSnippetsConfig": {
      "properties": {
        "enableSnippets": {
          "description": "Optional. Whether snippets are enabled.",
          "type": "boolean"
        },
        "maxSnippets": {
          "type": "integer",
          "format": "int32",
          "description": "Optional. Number of snippets to return per query. If unset, returns all snippets from the service by default."
        }
      },
      "id": "DataStoreToolSnippetsConfig",
      "type": "object",
      "description": "Snippets configuration."
    },
    "TriggerActionResponse": {
      "description": "Represents a response from the agent.",
      "properties": {
        "text": {
          "description": "Required. Text for the agent to respond with.",
          "type": "string"
        },
        "disabled": {
          "type": "boolean",
          "description": "Optional. Whether the response is disabled. Disabled responses are not used by the agent."
        }
      },
      "id": "TriggerActionResponse",
      "type": "object"
    },
    "EndUserAuthConfigOauth2JwtBearerConfig": {
      "type": "object",
      "id": "EndUserAuthConfigOauth2JwtBearerConfig",
      "properties": {
        "subject": {
          "type": "string",
          "description": "Required. Subject parameter name to pass through. Must be in the format `$context.variables.`."
        },
        "issuer": {
          "type": "string",
          "description": "Required. Issuer parameter name to pass through. Must be in the format `$context.variables.`."
        },
        "clientKey": {
          "type": "string",
          "description": "Required. Client parameter name to pass through. Must be in the format `$context.variables.`."
        }
      },
      "description": "JWT Profile Oauth 2.0 Authorization Grant authentication configuration."
    },
    "ExportOptions": {
      "type": "object",
      "description": "Options for exporting CES evaluation resources.",
      "id": "ExportOptions",
      "properties": {
        "exportFormat": {
          "description": "Optional. The format to export the evaluation results in. Defaults to JSON if not specified.",
          "type": "string",
          "enum": [
            "EXPORT_FORMAT_UNSPECIFIED",
            "JSON",
            "YAML"
          ],
          "enumDescriptions": [
            "Unspecified format.",
            "JSON format.",
            "YAML format."
          ]
        },
        "gcsUri": {
          "description": "Optional. The Google Cloud Storage URI to write the exported Evaluation Results to.",
          "type": "string"
        }
      }
    },
    "EvaluationResultSemanticSimilarityResult": {
      "description": "The result of the semantic similarity check.",
      "type": "object",
      "id": "EvaluationResultSemanticSimilarityResult",
      "properties": {
        "score": {
          "readOnly": true,
          "description": "Output only. The semantic similarity score. Can be 0, 1, 2, 3, or 4.",
          "type": "integer",
          "format": "int32"
        },
        "label": {
          "description": "Output only. The label associated with each score. Score 4: Fully Consistent Score 3: Mostly Consistent Score 2: Partially Consistent (Minor Omissions) Score 1: Largely Inconsistent (Major Omissions) Score 0: Completely Inconsistent / Contradictory",
          "readOnly": true,
          "type": "string"
        },
        "explanation": {
          "description": "Output only. The explanation for the semantic similarity score.",
          "type": "string",
          "readOnly": true
        },
        "outcome": {
          "enumDescriptions": [
            "Evaluation outcome is not specified.",
            "Evaluation/Expectation passed. In the case of an evaluation, this means that all expectations were met.",
            "Evaluation/Expectation failed. In the case of an evaluation, this means that at least one expectation was not met.",
            "Evaluation/Expectation was skipped."
          ],
          "readOnly": true,
          "enum": [
            "OUTCOME_UNSPECIFIED",
            "PASS",
            "FAIL",
            "SKIPPED"
          ],
          "description": "Output only. The outcome of the semantic similarity check. This is determined by comparing the score to the semantic_similarity_success_threshold. If the score is equal to or above the threshold, the outcome will be PASS. Otherwise, the outcome will be FAIL.",
          "type": "string"
        }
      }
    },
    "AssistantConfirmationResponse": {
      "description": "The user's answer to an AssistantConfirmationRequest, sent on the next SessionService.StreamChatAiAssistant call to resume the paused agent.",
      "id": "AssistantConfirmationResponse",
      "properties": {
        "answerText": {
          "description": "The chosen option's submit_text, or free-form user text. The paused action is cancelled and the text is handed to the agent to act on.",
          "type": "string"
        },
        "confirmationId": {
          "type": "string",
          "description": "The AssistantConfirmationRequest.confirmation_id being answered."
        },
        "confirmed": {
          "description": "Binary answer: true approves the paused action, false declines it.",
          "type": "boolean"
        }
      },
      "type": "object"
    },
    "EndUserAuthConfig": {
      "description": "End-user authentication configuration used for Connection calls. The field values must be the names of context variables in the format `$context.variables.`.",
      "properties": {
        "oauth2AuthCodeConfig": {
          "description": "Oauth 2.0 Authorization Code authentication.",
          "$ref": "EndUserAuthConfigOauth2AuthCodeConfig"
        },
        "oauth2JwtBearerConfig": {
          "$ref": "EndUserAuthConfigOauth2JwtBearerConfig",
          "description": "JWT Profile Oauth 2.0 Authorization Grant authentication."
        }
      },
      "id": "EndUserAuthConfig",
      "type": "object"
    },
    "ChannelProfileWhatsAppConfig": {
      "properties": {
        "wabaId": {
          "description": "Required. The WhatsApp Business Account ID.",
          "type": "string"
        },
        "description": {
          "type": "string",
          "description": "Output only. The description of the Meta business page or profile.",
          "readOnly": true
        },
        "thumbnailUrl": {
          "description": "Output only. The fetched Meta business profile thumbnail URL.",
          "type": "string",
          "readOnly": true
        },
        "phoneNumber": {
          "type": "string",
          "description": "Optional. The phone number in E.164 format."
        },
        "displayName": {
          "type": "string",
          "readOnly": true,
          "description": "Output only. The fetched Meta business page name."
        },
        "phoneNumberId": {
          "description": "Required. The Meta phone number ID.",
          "type": "string"
        }
      },
      "id": "ChannelProfileWhatsAppConfig",
      "description": "Configuration specific to WhatsApp deployments.",
      "type": "object"
    },
    "GenerateAppResourceResponseTools": {
      "id": "GenerateAppResourceResponseTools",
      "type": "object",
      "description": "The list of tools generated by the LLM assistant.",
      "properties": {
        "tools": {
          "description": "The list of tools generated by the LLM assistant.",
          "items": {
            "$ref": "Tool"
          },
          "type": "array"
        }
      }
    },
    "LatencyReportLlmCallLatency": {
      "id": "LatencyReportLlmCallLatency",
      "description": "Latency metrics for a single LLM call.",
      "properties": {
        "latencyMetrics": {
          "description": "Output only. The latency metrics for the LLM call.",
          "readOnly": true,
          "$ref": "LatencyReportLatencyMetrics"
        },
        "model": {
          "description": "Output only. The name of the model.",
          "type": "string",
          "readOnly": true
        }
      },
      "type": "object"
    },
    "AppVersion": {
      "description": "In Customer Engagement Suite (CES), an app version is a snapshot of the app at a specific point in time. It is immutable and cannot be modified once created.",
      "id": "AppVersion",
      "properties": {
        "creator": {
          "description": "Output only. Email of the user who created the app version.",
          "readOnly": true,
          "type": "string"
        },
        "updateTime": {
          "format": "google-datetime",
          "type": "string",
          "readOnly": true,
          "description": "Output only. Timestamp when the app version was last updated."
        },
        "name": {
          "description": "Identifier. The unique identifier of the app version. Format: `projects/{project}/locations/{location}/apps/{app}/versions/{version}`",
          "type": "string"
        },
        "etag": {
          "type": "string",
          "description": "Output only. Etag used to ensure the object hasn't changed during a read-modify-write operation. If the etag is empty, the update will overwrite any concurrent changes.",
          "readOnly": true
        },
        "description": {
          "type": "string",
          "description": "Optional. The description of the app version."
        },
        "snapshot": {
          "$ref": "AppSnapshot",
          "readOnly": true,
          "description": "Output only. The snapshot of the app when the version is created."
        },
        "displayName": {
          "description": "Optional. The display name of the app version.",
          "type": "string"
        },
        "createTime": {
          "type": "string",
          "format": "google-datetime",
          "readOnly": true,
          "description": "Output only. Timestamp when the app version was created."
        }
      },
      "type": "object"
    },
    "EvaluationRunCachingSettings": {
      "properties": {
        "runCachingMode": {
          "description": "Optional. The caching mode to use for the evaluation run. If not set, default to FORCE_RUN.",
          "enumDescriptions": [
            "The run caching mode is unspecified.",
            "Always execute a full live simulation regardless of whether changelogs exist.",
            "Skip execution and copy previous verified results if no dependencies have mutated, the evaluation channel/run method are the same."
          ],
          "type": "string",
          "enum": [
            "EVALUATION_RUN_CACHING_MODE_UNSPECIFIED",
            "FORCE_RUN",
            "SKIP_IF_UNCHANGED"
          ]
        }
      },
      "type": "object",
      "description": "Settings for evaluation run caching.",
      "id": "EvaluationRunCachingSettings"
    },
    "FileSearchTool": {
      "type": "object",
      "properties": {
        "description": {
          "description": "Optional. The tool description.",
          "type": "string"
        },
        "corpusType": {
          "description": "Optional. The type of the corpus. Default is FULLY_MANAGED.",
          "type": "string",
          "enum": [
            "CORPUS_TYPE_UNSPECIFIED",
            "USER_OWNED",
            "FULLY_MANAGED"
          ],
          "enumDescriptions": [
            "Unspecified corpus type.",
            "The corpus is created and owned by the user.",
            "The corpus is created by the agent."
          ]
        },
        "fileCorpus": {
          "type": "string",
          "description": "Optional. The corpus where files are stored. Format: projects/{project}/locations/{location}/ragCorpora/{rag_corpus}"
        },
        "name": {
          "description": "Required. The tool name.",
          "type": "string"
        }
      },
      "id": "FileSearchTool",
      "description": "The file search tool allows the agent to search across the files uploaded by the app/agent developer. It has presets to give relatively good quality search over the uploaded files and summarization of the retrieved results."
    },
    "RetrieveToolsResponse": {
      "type": "object",
      "description": "Response message for ToolService.RetrieveTools.",
      "properties": {
        "tools": {
          "description": "The list of tools that are included in the specified toolset.",
          "type": "array",
          "items": {
            "$ref": "Tool"
          }
        }
      },
      "id": "RetrieveToolsResponse"
    },
    "ListAgentsResponse": {
      "description": "Response message for AgentService.ListAgents.",
      "type": "object",
      "id": "ListAgentsResponse",
      "properties": {
        "agents": {
          "type": "array",
          "description": "The list of agents.",
          "items": {
            "$ref": "Agent"
          }
        },
        "nextPageToken": {
          "description": "A token that can be sent as ListAgentsRequest.page_token to retrieve the next page. Absence of this field indicates there are no subsequent pages.",
          "type": "string"
        }
      }
    },
    "GuardrailLlmPromptSecurity": {
      "description": "Guardrail that blocks the conversation if the input is considered unsafe based on the LLM classification.",
      "properties": {
        "failOpen": {
          "description": "Optional. Determines the behavior when the guardrail encounters an LLM error. - If true: the guardrail is bypassed. - If false (default): the guardrail triggers/blocks. Note: If a custom policy is provided, this field is ignored in favor of the policy's 'fail_open' configuration.",
          "type": "boolean"
        },
        "defaultSettings": {
          "$ref": "GuardrailLlmPromptSecurityDefaultSecuritySettings",
          "description": "Optional. Use the system's predefined default security settings. To select this mode, include an empty 'default_settings' message in the request. The 'default_prompt_template' field within will be populated by the server in the response."
        },
        "customPolicy": {
          "$ref": "GuardrailLlmPolicy",
          "description": "Optional. Use a user-defined LlmPolicy to configure the security guardrail."
        }
      },
      "type": "object",
      "id": "GuardrailLlmPromptSecurity"
    },
    "Status": {
      "id": "Status",
      "properties": {
        "message": {
          "description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.",
          "type": "string"
        },
        "details": {
          "items": {
            "type": "object",
            "additionalProperties": {
              "type": "any",
              "description": "Properties of the object. Contains field @type with type URL."
            }
          },
          "type": "array",
          "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use."
        },
        "code": {
          "type": "integer",
          "format": "int32",
          "description": "The status code, which should be an enum value of google.rpc.Code."
        }
      },
      "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).",
      "type": "object"
    },
    "AggregatedMetricsSemanticSimilarityMetrics": {
      "id": "AggregatedMetricsSemanticSimilarityMetrics",
      "properties": {
        "score": {
          "description": "Output only. The average semantic similarity score (0-4).",
          "format": "float",
          "type": "number",
          "readOnly": true
        }
      },
      "description": "Metrics for semantic similarity results.",
      "type": "object"
    },
    "SessionOutput": {
      "properties": {
        "turnIndex": {
          "format": "int32",
          "description": "Indicates the sequential order of conversation turn to which this output belongs to, starting from 1.",
          "type": "integer"
        },
        "progress": {
          "description": "Intermediate progress update from the CES agent.",
          "type": "string"
        },
        "googleSearchSuggestions": {
          "$ref": "GoogleSearchSuggestions",
          "description": "The suggestions returned from Google Search as a result of invoking the GoogleSearchTool."
        },
        "payload": {
          "description": "Custom payload with structured output from the CES agent.",
          "additionalProperties": {
            "description": "Properties of the object.",
            "type": "any"
          },
          "type": "object"
        },
        "endSession": {
          "description": "Indicates the session has ended.",
          "$ref": "EndSession"
        },
        "diagnosticInfo": {
          "$ref": "SessionOutputDiagnosticInfo",
          "description": "Optional. Diagnostic information contains execution details during the processing of the input. Only populated in the last SessionOutput (with `turn_completed=true`) for each turn."
        },
        "toolCalls": {
          "$ref": "ToolCalls",
          "description": "Request for the client to execute the tools."
        },
        "citations": {
          "description": "Citations that provide the source information for the agent's generated text.",
          "$ref": "Citations"
        },
        "text": {
          "description": "Output text from the CES agent.",
          "type": "string"
        },
        "audio": {
          "description": "Output audio from the CES agent.",
          "type": "string",
          "format": "byte"
        },
        "image": {
          "description": "Output image from the CES agent.",
          "$ref": "Image"
        },
        "turnCompleted": {
          "type": "boolean",
          "description": "If true, the CES agent has detected the end of the current conversation turn and will provide no further output for this turn."
        }
      },
      "id": "SessionOutput",
      "type": "object",
      "description": "Output for the session."
    },
    "ExperimentConfigVersionReleaseTrafficAllocation": {
      "properties": {
        "trafficPercentage": {
          "format": "int32",
          "description": "Optional. Traffic percentage of the traffic allocation, relative to the remaining non-study traffic. Must be between `0` and `100`.",
          "type": "integer"
        },
        "appVersion": {
          "type": "string",
          "description": "Optional. App version of the traffic allocation. Format: `projects/{project}/locations/{location}/apps/{app}/versions/{version}`"
        },
        "id": {
          "type": "string",
          "description": "Optional. Id of the traffic allocation. Free format string, up to 128 characters."
        }
      },
      "id": "ExperimentConfigVersionReleaseTrafficAllocation",
      "description": "Traffic allocation for the version release.",
      "type": "object"
    },
    "EndSession": {
      "type": "object",
      "properties": {
        "metadata": {
          "type": "object",
          "additionalProperties": {
            "type": "any",
            "description": "Properties of the object."
          },
          "description": "Optional. Provides additional information about the end session signal, such as the reason for ending the session."
        }
      },
      "id": "EndSession",
      "description": "Indicates the session has terminated, due to either successful completion (e.g. user says \"Good bye!\" ) or an agent escalation. The agent will not process any further inputs after session is terminated and the client should half-close and disconnect after receiving all remaining responses from the agent."
    },
    "GenerateOnboardingSuggestionsRequest": {
      "properties": {
        "maxSuggestions": {
          "format": "int32",
          "type": "integer",
          "description": "Optional. Maximum number of suggestions to return. Defaults to 4 when unset."
        }
      },
      "description": "Request message for SessionService.GenerateOnboardingSuggestions.",
      "id": "GenerateOnboardingSuggestionsRequest",
      "type": "object"
    },
    "AggregatedMetricsHallucinationMetrics": {
      "description": "Metrics for hallucination results.",
      "type": "object",
      "id": "AggregatedMetricsHallucinationMetrics",
      "properties": {
        "score": {
          "description": "Output only. The average hallucination score (0 to 1).",
          "type": "number",
          "format": "float",
          "readOnly": true
        }
      }
    },
    "EvaluationResultScenarioResultMilestoneResult": {
      "properties": {
        "milestone": {
          "$ref": "EvaluationScenarioMilestone",
          "readOnly": true,
          "description": "Output only. The milestone being tracked."
        },
        "status": {
          "type": "string",
          "enumDescriptions": [
            "Unspecified status.",
            "The milestone has not started yet.",
            "The milestone is currently in progress.",
            "The milestone has been successfully completed."
          ],
          "enum": [
            "MILESTONE_STATUS_UNSPECIFIED",
            "NOT_STARTED",
            "IN_PROGRESS",
            "COMPLETED"
          ],
          "readOnly": true,
          "description": "Output only. The current status of the milestone."
        },
        "justification": {
          "readOnly": true,
          "description": "Output only. The justification for the current status.",
          "type": "string"
        }
      },
      "description": "Represents the result of a milestone execution.",
      "id": "EvaluationResultScenarioResultMilestoneResult",
      "type": "object"
    },
    "ToolResponses": {
      "id": "ToolResponses",
      "properties": {
        "toolResponses": {
          "description": "Optional. The list of tool execution results.",
          "type": "array",
          "items": {
            "$ref": "ToolResponse"
          }
        }
      },
      "description": "Execution results for the requested tool calls from the client.",
      "type": "object"
    },
    "WhatsAppCredentials": {
      "description": "Ephemeral Meta credentials for WhatsApp native integration.",
      "properties": {
        "conversationProfileId": {
          "description": "Optional. The Conversation Profile ID to use for the deployment.",
          "type": "string"
        },
        "authCode": {
          "description": "Required. The Meta auth code provided by the embedded signup flow.",
          "type": "string"
        },
        "wabaId": {
          "type": "string",
          "description": "Required. The WhatsApp Business Account ID."
        },
        "phoneNumber": {
          "description": "Required. The phone number to register with WhatsApp.",
          "type": "string"
        },
        "pin": {
          "type": "string",
          "description": "Required. The 6-digit PIN created by the user for two-step verification."
        },
        "businessAccountId": {
          "type": "string",
          "description": "Required. The Business Account ID to use for the phone number."
        }
      },
      "id": "WhatsAppCredentials",
      "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": {
        "tool": {
          "description": "Required. The original name of the tool as it is emitted by the MCP 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": {
          "readOnly": true,
          "$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."
        },
        "descriptionOverride": {
          "type": "string",
          "description": "Optional. If present, this tool uses this description instead of the original description from the server."
        }
      },
      "type": "object"
    },
    "GoogleSearchTool": {
      "properties": {
        "name": {
          "type": "string",
          "description": "Required. The name of the tool."
        },
        "description": {
          "description": "Optional. Description of the tool's purpose.",
          "type": "string"
        },
        "preferredDomains": {
          "description": "Optional. Specifies domains to restrict search results to. Example: \"example.com\", \"another.site\". A maximum of 20 domains can be specified.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "contextUrls": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "description": "Optional. Content will be fetched directly from these URLs for context and grounding. Example: \"https://example.com/path.html\". A maximum of 20 URLs are allowed."
        },
        "excludeDomains": {
          "description": "Optional. List of domains to be excluded from the search results. Example: \"example.com\". A maximum of 2000 domains can be excluded.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "promptConfig": {
          "description": "Optional. Prompt instructions passed to planner on how the search results should be processed for text and voice.",
          "$ref": "GoogleSearchToolPromptConfig"
        }
      },
      "description": "Represents a tool to perform Google web searches for grounding. See https://cloud.google.com/customer-engagement-ai/conversational-agents/ps/tool#google-search.",
      "id": "GoogleSearchTool",
      "type": "object"
    },
    "ToolResponse": {
      "properties": {
        "toolsetTool": {
          "$ref": "ToolsetTool",
          "description": "Optional. The toolset tool that got executed."
        },
        "displayName": {
          "readOnly": true,
          "description": "Output only. Display name of the tool.",
          "type": "string"
        },
        "parentToolCallId": {
          "type": "string",
          "readOnly": true,
          "description": "Output only. The id of the tool call that caused this one, when it was issued by a sub-agent working on behalf of a parent call. Empty for top-level calls. Lets a client group a sub-agent's work under the call that started it instead of rendering every step as a sibling."
        },
        "id": {
          "description": "Optional. The matching ID of the tool call the response is for.",
          "type": "string"
        },
        "response": {
          "additionalProperties": {
            "type": "any",
            "description": "Properties of the object."
          },
          "type": "object",
          "description": "Required. The tool execution result in JSON object format. Use \"output\" key to specify tool response and \"error\" key to specify error details (if any). If \"output\" and \"error\" keys are not specified, then whole \"response\" is treated as tool execution result."
        },
        "tool": {
          "description": "Optional. The name of the tool to execute. Format: `projects/{project}/locations/{location}/apps/{app}/tools/{tool}`",
          "type": "string"
        },
        "agentName": {
          "description": "Output only. Human-readable name of the agent that issued this call, e.g. \"Contract Architect\". Empty when the root agent issued it.",
          "readOnly": true,
          "type": "string"
        },
        "targetApp": {
          "type": "string",
          "readOnly": true,
          "description": "Output only. The app the executed tool targeted; mirrors ToolCall.target_app."
        }
      },
      "description": "The execution result of a specific tool from the client or the agent.",
      "type": "object",
      "id": "ToolResponse"
    },
    "RemoteA2aConfig": {
      "type": "object",
      "description": "Shared configuration for connecting to a remote [A2A](https://github.com/a2aproject/A2A) agent.",
      "id": "RemoteA2aConfig",
      "properties": {
        "contextId": {
          "type": "string",
          "description": "Optional. If not empty, interactions with the remote A2A agent will use this context ID. This context_id field can refer to a session variable like `$context.variables.order_agent_session_id`."
        },
        "outputVariableMapping": {
          "additionalProperties": {
            "type": "string"
          },
          "type": "object",
          "description": "Optional. Mapping of output variable names of remote agent to GECX variable names."
        },
        "agentRegistry": {
          "type": "string",
          "description": "Optional. Reference to the agent in the Agent Registry. Format: `projects/{project}/locations/{location}/agents/{agent}`"
        },
        "agentCard": {
          "description": "Optional. The full agent card defined inline.",
          "$ref": "AgentCard"
        },
        "inputVariableMapping": {
          "type": "object",
          "additionalProperties": {
            "type": "string"
          },
          "description": "Optional. Mapping of input variable names of remote agent to GECX variable names."
        },
        "apiAuthentication": {
          "description": "Optional. Authentication configuration for calling the remote agent. Optional if the registry reference already handles authentication.",
          "$ref": "ApiAuthentication"
        },
        "streamingEnabled": {
          "type": "boolean",
          "description": "Optional. Whether streaming is enabled for the remote agent."
        }
      }
    },
    "OptionQuestionsChunk": {
      "description": "Structured clarification options the assistant asks the user to choose among, transduced server-side out of the model's turn (the option block is stripped from the streamed and persisted text). The console renders a keyboard-navigable option list docked above the composer.",
      "type": "object",
      "properties": {
        "questions": {
          "type": "array",
          "description": "The questions asked this turn. More than one entry drives the console's \"1 of N\" pager.",
          "items": {
            "$ref": "OptionQuestionsChunkQuestion"
          }
        }
      },
      "id": "OptionQuestionsChunk"
    },
    "AgentRemoteDialogflowAgent": {
      "properties": {
        "agent": {
          "type": "string",
          "description": "Required. The [Dialogflow](https://docs.cloud.google.com/dialogflow/cx/docs/concept/agent) agent resource name. Format: `projects/{project}/locations/{location}/agents/{agent}`"
        },
        "inputVariableMapping": {
          "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",
          "additionalProperties": {
            "type": "string"
          }
        },
        "languageCodeVariable": {
          "type": "string",
          "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."
        },
        "environmentId": {
          "type": "string",
          "description": "Optional. The environment ID of the Dialogflow agent to be used for the agent execution. If not specified, the draft environment will be used."
        },
        "outputVariableMapping": {
          "type": "object",
          "additionalProperties": {
            "type": "string"
          },
          "description": "Optional. The mapping of the Dialogflow session parameters names to the app variables names to be sent back to the CES agent after the Dialogflow agent execution ends."
        },
        "flowId": {
          "type": "string",
          "description": "Optional. The flow ID of the flow in the Dialogflow agent."
        },
        "respectResponseInterruptionSettings": {
          "type": "boolean",
          "description": "Optional. Indicates whether to respect the message-level interruption settings configured in the Dialogflow agent. * If false: all response messages from the Dialogflow agent follow the app-level barge-in settings. * If true: only response messages with [`allow_playback_interruption`](https://docs.cloud.google.com/dialogflow/cx/docs/reference/rpc/google.cloud.dialogflow.cx.v3#text) set to true will be interruptable, all other messages follow the app-level barge-in settings."
        }
      },
      "id": "AgentRemoteDialogflowAgent",
      "description": "The agent which will transfer execution to a remote [Dialogflow CX](https://docs.cloud.google.com/dialogflow/cx/docs/concept/agent) agent. The Dialogflow agent will process subsequent user queries until the session ends or flow ends, and the control is transferred back to the parent CES agent.",
      "type": "object"
    },
    "AppSnapshot": {
      "properties": {
        "agents": {
          "items": {
            "$ref": "Agent"
          },
          "type": "array",
          "description": "Optional. List of agents in the app."
        },
        "examples": {
          "description": "Optional. List of examples in the app.",
          "items": {
            "$ref": "Example"
          },
          "type": "array"
        },
        "tools": {
          "type": "array",
          "items": {
            "$ref": "Tool"
          },
          "description": "Optional. List of tools in the app."
        },
        "guardrails": {
          "type": "array",
          "description": "Optional. List of guardrails in the app.",
          "items": {
            "$ref": "Guardrail"
          }
        },
        "toolsets": {
          "items": {
            "$ref": "Toolset"
          },
          "type": "array",
          "description": "Optional. List of toolsets in the app."
        },
        "app": {
          "description": "Optional. The basic settings for the app.",
          "$ref": "App"
        }
      },
      "description": "A snapshot of the app.",
      "id": "AppSnapshot",
      "type": "object"
    },
    "RemoteAgentTool": {
      "properties": {
        "apiAuthentication": {
          "$ref": "ApiAuthentication",
          "description": "Optional. Authentication configuration for calling the remote agent."
        },
        "name": {
          "type": "string",
          "description": "Required. The name of the tool."
        },
        "description": {
          "type": "string",
          "description": "Required. The description of the tool."
        },
        "agentCard": {
          "description": "Required. The agent card of the remote agent that this tool invokes.",
          "$ref": "AgentCard"
        },
        "inputVariableMapping": {
          "additionalProperties": {
            "type": "string"
          },
          "type": "object",
          "description": "Optional. Mapping of input variable names of remote agent to GECX variable names."
        },
        "statefulAgent": {
          "type": "boolean",
          "description": "Optional. When enabled, the interaction between the CXAS app and the remote agent will share the same context. If the remote agent returns a context_id, it will be persisted for the entirety of the session for this remote agent tool."
        },
        "outputVariableMapping": {
          "description": "Optional. Mapping of output variable names of remote agent to GECX variable names.",
          "additionalProperties": {
            "type": "string"
          },
          "type": "object"
        }
      },
      "description": "Represents a tool that allows the agent to call another remote agent.",
      "id": "RemoteAgentTool",
      "type": "object"
    },
    "EvaluationResultGoldenResult": {
      "id": "EvaluationResultGoldenResult",
      "description": "The result of a golden evaluation.",
      "type": "object",
      "properties": {
        "evaluationExpectationResults": {
          "readOnly": true,
          "type": "array",
          "description": "Output only. The results of the evaluation expectations.",
          "items": {
            "$ref": "EvaluationResultEvaluationExpectationResult"
          }
        },
        "turnReplayResults": {
          "description": "Output only. The result of running each turn of the golden conversation.",
          "readOnly": true,
          "type": "array",
          "items": {
            "$ref": "EvaluationResultGoldenResultTurnReplayResult"
          }
        }
      }
    },
    "AudioRecordingConfig": {
      "type": "object",
      "description": "Configuration for how the audio interactions should be recorded.",
      "properties": {
        "gcsPathPrefix": {
          "description": "Optional. The Cloud Storage path prefix for audio recordings. This prefix can include the following placeholders, which will be dynamically substituted at serving time: - $project: project ID - $location: app location - $app: app ID - $date: session date in YYYY-MM-DD format - $session: session ID If the path prefix is not specified, the default prefix `$project/$location/$app/$date/$session/` will be used.",
          "type": "string"
        },
        "gcsBucket": {
          "description": "Optional. The [Cloud Storage](https://cloud.google.com/storage) bucket to store the session audio recordings. The URI must start with \"gs://\". Please choose a bucket location that meets your data residency requirements. Note: If the Cloud Storage bucket is in a different project from the app, you should grant `storage.objects.create` permission to the CES service agent `service-@gcp-sa-ces.iam.gserviceaccount.com`.",
          "type": "string"
        }
      },
      "id": "AudioRecordingConfig"
    },
    "ServiceAccountAuthConfig": {
      "properties": {
        "scopes": {
          "type": "array",
          "description": "Optional. The OAuth scopes to grant. If not specified, the default scope `https://www.googleapis.com/auth/cloud-platform` is used.",
          "items": {
            "type": "string"
          }
        },
        "serviceAccount": {
          "type": "string",
          "description": "Required. The email address of the service account used for authentication. CES uses this service account to exchange an access token and the access token is then sent in the `Authorization` header of the request. The service account must have the `roles/iam.serviceAccountTokenCreator` role granted to the CES service agent `service-@gcp-sa-ces.iam.gserviceaccount.com`."
        }
      },
      "type": "object",
      "description": "Configurations for authentication using a custom service account.",
      "id": "ServiceAccountAuthConfig"
    },
    "DataStoreToolBoostSpecConditionBoostSpecBoostControlSpec": {
      "id": "DataStoreToolBoostSpecConditionBoostSpecBoostControlSpec",
      "properties": {
        "attributeType": {
          "description": "Optional. The attribute type to be used to determine the boost amount. The attribute value can be derived from the field value of the specified field_name. In the case of numerical it is straightforward i.e. attribute_value = numerical_field_value. In the case of freshness however, attribute_value = (time.now() - datetime_field_value).",
          "type": "string",
          "enum": [
            "ATTRIBUTE_TYPE_UNSPECIFIED",
            "NUMERICAL",
            "FRESHNESS"
          ],
          "enumDescriptions": [
            "Unspecified AttributeType.",
            "The value of the numerical field will be used to dynamically update the boost amount. In this case, the attribute_value (the x value) of the control point will be the actual value of the numerical field for which the boost_amount is specified.",
            "For the freshness use case the attribute value will be the duration between the current time and the date in the datetime field specified. The value must be formatted as an XSD `dayTimeDuration` value (a restricted subset of an ISO 8601 duration value). The pattern for this is: `nDnM]`. E.g. `5D`, `3DT12H30M`, `T24H`."
          ]
        },
        "fieldName": {
          "type": "string",
          "description": "Optional. The name of the field whose value will be used to determine the boost amount."
        },
        "interpolationType": {
          "enumDescriptions": [
            "Interpolation type is unspecified. In this case, it defaults to Linear.",
            "Piecewise linear interpolation will be applied."
          ],
          "type": "string",
          "enum": [
            "INTERPOLATION_TYPE_UNSPECIFIED",
            "LINEAR"
          ],
          "description": "Optional. The interpolation type to be applied to connect the control points listed below."
        },
        "controlPoints": {
          "items": {
            "$ref": "DataStoreToolBoostSpecConditionBoostSpecBoostControlSpecControlPoint"
          },
          "description": "Optional. The control points used to define the curve. The monotonic function (defined through the interpolation_type above) passes through the control points listed here.",
          "type": "array"
        }
      },
      "description": "Specification for custom ranking based on customer specified attribute value. It provides more controls for customized ranking than the simple (condition, boost) combination above.",
      "type": "object"
    },
    "DataStoreToolEngineSource": {
      "description": "Configuration for searching within an Engine, potentially targeting specific DataStores.",
      "type": "object",
      "properties": {
        "engine": {
          "type": "string",
          "description": "Required. Full resource name of the Engine. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}`"
        },
        "dataStoreSources": {
          "description": "Optional. Use to target specific DataStores within the Engine. If empty, the search applies to all DataStores associated with the Engine.",
          "items": {
            "$ref": "DataStoreToolDataStoreSource"
          },
          "type": "array"
        },
        "filter": {
          "description": "Optional. A filter applied to the search across the Engine. Not relevant and not used if 'data_store_sources' is provided. See: https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata",
          "type": "string"
        }
      },
      "id": "DataStoreToolEngineSource"
    },
    "EndpointControlPolicy": {
      "type": "object",
      "properties": {
        "allowedOrigins": {
          "description": "Optional. The allowed HTTP(s) origins that tools in the App are able to directly call. The enforcement depends on the value of enforcement_scope and the VPC-SC status of the project. If a port number is not provided, all ports will be allowed. Otherwise, the port number must match exactly. For example, \"https://example.com\" will match \"https://example.com:443\" and any other port. \"https://example.com:443\" will only match \"https://example.com:443\".",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "enforcementScope": {
          "description": "Optional. The scope in which this policy's allowed_origins list is enforced.",
          "type": "string",
          "enum": [
            "ENFORCEMENT_SCOPE_UNSPECIFIED",
            "VPCSC_ONLY",
            "ALWAYS"
          ],
          "enumDescriptions": [
            "Unspecified. This policy will be treated as VPCSC_ONLY.",
            "This policy applies only when VPC-SC is active.",
            "This policy ALWAYS applies, regardless of VPC-SC status."
          ]
        }
      },
      "id": "EndpointControlPolicy",
      "description": "Defines project/location level endpoint control policy."
    },
    "ListLocationsResponse": {
      "type": "object",
      "id": "ListLocationsResponse",
      "description": "The response message for Locations.ListLocations.",
      "properties": {
        "locations": {
          "description": "A list of locations that matches the specified filter in the request.",
          "items": {
            "$ref": "Location"
          },
          "type": "array"
        },
        "nextPageToken": {
          "description": "The standard List next-page token.",
          "type": "string"
        }
      }
    }
  },
  "id": "ces:v1beta",
  "kind": "discovery#restDescription",
  "auth": {
    "oauth2": {
      "scopes": {
        "https://www.googleapis.com/auth/cloud-platform": {
          "description": "See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account."
        },
        "https://www.googleapis.com/auth/ces": {
          "description": "Create, update, delete, and manage your Next Gen Agents"
        }
      }
    }
  },
  "version": "v1beta",
  "documentationLink": "https://docs.cloud.google.com/customer-engagement-ai/conversational-agents/ps",
  "description": "",
  "discoveryVersion": "v1",
  "revision": "20261106",
  "rootUrl": "https://ces.googleapis.com/",
  "icons": {
    "x16": "http://www.google.com/images/icons/product/search-16.gif",
    "x32": "http://www.google.com/images/icons/product/search-32.gif"
  },
  "fullyEncodeReservedExpansion": true,
  "basePath": "",
  "parameters": {
    "uploadType": {
      "type": "string",
      "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
      "location": "query"
    },
    "alt": {
      "type": "string",
      "default": "json",
      "enumDescriptions": [
        "Responses with Content-Type of application/json",
        "Media download with context-dependent Content-Type",
        "Responses with Content-Type of application/x-protobuf"
      ],
      "enum": [
        "json",
        "media",
        "proto"
      ],
      "location": "query",
      "description": "Data format for response."
    },
    "access_token": {
      "type": "string",
      "description": "OAuth access token.",
      "location": "query"
    },
    "prettyPrint": {
      "description": "Returns response with indentations and line breaks.",
      "type": "boolean",
      "default": "true",
      "location": "query"
    },
    "upload_protocol": {
      "location": "query",
      "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
      "type": "string"
    },
    "oauth_token": {
      "location": "query",
      "type": "string",
      "description": "OAuth 2.0 token for the current user."
    },
    "quotaUser": {
      "location": "query",
      "type": "string",
      "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters."
    },
    "callback": {
      "location": "query",
      "description": "JSONP",
      "type": "string"
    },
    "$.xgafv": {
      "enumDescriptions": [
        "v1 error format",
        "v2 error format"
      ],
      "enum": [
        "1",
        "2"
      ],
      "location": "query",
      "description": "V1 error format.",
      "type": "string"
    },
    "key": {
      "type": "string",
      "location": "query",
      "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token."
    },
    "fields": {
      "location": "query",
      "type": "string",
      "description": "Selector specifying which fields to include in a partial response."
    }
  },
  "mtlsRootUrl": "https://ces.mtls.googleapis.com/",
  "resources": {
    "projects": {
      "resources": {
        "locations": {
          "methods": {
            "getSecuritySettings": {
              "response": {
                "$ref": "SecuritySettings"
              },
              "parameterOrder": [
                "name"
              ],
              "parameters": {
                "name": {
                  "location": "path",
                  "type": "string",
                  "pattern": "^projects/[^/]+/locations/[^/]+/securitySettings$",
                  "description": "Required. The resource name of the security settings to retrieve. Format: `projects/{project}/locations/{location}/securitySettings`",
                  "required": true
                }
              },
              "id": "ces.projects.locations.getSecuritySettings",
              "scopes": [
                "https://www.googleapis.com/auth/ces",
                "https://www.googleapis.com/auth/cloud-platform"
              ],
              "path": "v1beta/{+name}",
              "description": "Retrieves the security settings for the project and location.",
              "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/securitySettings",
              "httpMethod": "GET"
            },
            "updateSecuritySettings": {
              "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/securitySettings",
              "httpMethod": "PATCH",
              "path": "v1beta/{+name}",
              "request": {
                "$ref": "SecuritySettings"
              },
              "scopes": [
                "https://www.googleapis.com/auth/ces",
                "https://www.googleapis.com/auth/cloud-platform"
              ],
              "parameterOrder": [
                "name"
              ],
              "response": {
                "$ref": "SecuritySettings"
              },
              "parameters": {
                "name": {
                  "required": true,
                  "location": "path",
                  "type": "string",
                  "description": "Identifier. The unique identifier of the security settings. Format: `projects/{project}/locations/{location}/securitySettings`",
                  "pattern": "^projects/[^/]+/locations/[^/]+/securitySettings$"
                },
                "updateMask": {
                  "location": "query",
                  "type": "string",
                  "format": "google-fieldmask",
                  "description": "Optional. Field mask is used to control which fields get updated. If the mask is not present, all fields will be updated."
                }
              },
              "id": "ces.projects.locations.updateSecuritySettings",
              "description": "Updates the security settings for the project and location."
            },
            "get": {
              "parameters": {
                "name": {
                  "description": "Resource name for the location.",
                  "pattern": "^projects/[^/]+/locations/[^/]+$",
                  "required": true,
                  "type": "string",
                  "location": "path"
                }
              },
              "id": "ces.projects.locations.get",
              "parameterOrder": [
                "name"
              ],
              "scopes": [
                "https://www.googleapis.com/auth/ces",
                "https://www.googleapis.com/auth/cloud-platform"
              ],
              "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}",
              "response": {
                "$ref": "Location"
              },
              "httpMethod": "GET",
              "path": "v1beta/{+name}",
              "description": "Gets information about a location."
            },
            "list": {
              "parameterOrder": [
                "name"
              ],
              "response": {
                "$ref": "ListLocationsResponse"
              },
              "httpMethod": "GET",
              "path": "v1beta/{+name}/locations",
              "id": "ces.projects.locations.list",
              "description": "Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.",
              "parameters": {
                "extraLocationTypes": {
                  "repeated": true,
                  "location": "query",
                  "type": "string",
                  "description": "Optional. Do not use this field unless explicitly documented otherwise. This is primarily for internal usage."
                },
                "pageToken": {
                  "type": "string",
                  "description": "A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page.",
                  "location": "query"
                },
                "name": {
                  "required": true,
                  "description": "The resource that owns the locations collection, if applicable.",
                  "pattern": "^projects/[^/]+$",
                  "type": "string",
                  "location": "path"
                },
                "filter": {
                  "type": "string",
                  "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like `\"displayName=tokyo\"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).",
                  "location": "query"
                },
                "pageSize": {
                  "description": "The maximum number of results to return. If not set, the service selects a default.",
                  "format": "int32",
                  "location": "query",
                  "type": "integer"
                }
              },
              "scopes": [
                "https://www.googleapis.com/auth/ces",
                "https://www.googleapis.com/auth/cloud-platform"
              ],
              "flatPath": "v1beta/projects/{projectsId}/locations"
            }
          },
          "resources": {
            "operations": {
              "methods": {
                "delete": {
                  "httpMethod": "DELETE",
                  "path": "v1beta/{+name}",
                  "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}",
                  "parameterOrder": [
                    "name"
                  ],
                  "parameters": {
                    "name": {
                      "required": true,
                      "type": "string",
                      "description": "The name of the operation resource to be deleted.",
                      "location": "path",
                      "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$"
                    }
                  },
                  "response": {
                    "$ref": "Empty"
                  },
                  "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.",
                  "id": "ces.projects.locations.operations.delete",
                  "scopes": [
                    "https://www.googleapis.com/auth/ces",
                    "https://www.googleapis.com/auth/cloud-platform"
                  ]
                },
                "get": {
                  "response": {
                    "$ref": "Operation"
                  },
                  "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.",
                  "httpMethod": "GET",
                  "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}",
                  "path": "v1beta/{+name}",
                  "id": "ces.projects.locations.operations.get",
                  "parameters": {
                    "name": {
                      "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$",
                      "location": "path",
                      "description": "The name of the operation resource.",
                      "required": true,
                      "type": "string"
                    }
                  },
                  "parameterOrder": [
                    "name"
                  ],
                  "scopes": [
                    "https://www.googleapis.com/auth/ces",
                    "https://www.googleapis.com/auth/cloud-platform"
                  ]
                },
                "list": {
                  "id": "ces.projects.locations.operations.list",
                  "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/operations",
                  "httpMethod": "GET",
                  "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.",
                  "path": "v1beta/{+name}/operations",
                  "response": {
                    "$ref": "ListOperationsResponse"
                  },
                  "parameters": {
                    "pageToken": {
                      "description": "The standard list page token.",
                      "location": "query",
                      "type": "string"
                    },
                    "name": {
                      "pattern": "^projects/[^/]+/locations/[^/]+$",
                      "description": "The name of the operation's parent resource.",
                      "required": true,
                      "location": "path",
                      "type": "string"
                    },
                    "filter": {
                      "description": "The standard list filter.",
                      "location": "query",
                      "type": "string"
                    },
                    "returnPartialSuccess": {
                      "type": "boolean",
                      "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.",
                      "location": "query"
                    },
                    "pageSize": {
                      "type": "integer",
                      "format": "int32",
                      "location": "query",
                      "description": "The standard list page size."
                    }
                  },
                  "parameterOrder": [
                    "name"
                  ],
                  "scopes": [
                    "https://www.googleapis.com/auth/ces",
                    "https://www.googleapis.com/auth/cloud-platform"
                  ]
                },
                "cancel": {
                  "parameterOrder": [
                    "name"
                  ],
                  "id": "ces.projects.locations.operations.cancel",
                  "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.",
                  "response": {
                    "$ref": "Empty"
                  },
                  "httpMethod": "POST",
                  "request": {
                    "$ref": "CancelOperationRequest"
                  },
                  "scopes": [
                    "https://www.googleapis.com/auth/ces",
                    "https://www.googleapis.com/auth/cloud-platform"
                  ],
                  "path": "v1beta/{+name}:cancel",
                  "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel",
                  "parameters": {
                    "name": {
                      "type": "string",
                      "location": "path",
                      "required": true,
                      "description": "The name of the operation resource to be cancelled.",
                      "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$"
                    }
                  }
                }
              }
            },
            "apps": {
              "methods": {
                "patch": {
                  "id": "ces.projects.locations.apps.patch",
                  "scopes": [
                    "https://www.googleapis.com/auth/ces",
                    "https://www.googleapis.com/auth/cloud-platform"
                  ],
                  "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}",
                  "httpMethod": "PATCH",
                  "path": "v1beta/{+name}",
                  "parameters": {
                    "updateMask": {
                      "format": "google-fieldmask",
                      "description": "Optional. Field mask is used to control which fields get updated. If the mask is not present, all fields will be updated.",
                      "type": "string",
                      "location": "query"
                    },
                    "name": {
                      "type": "string",
                      "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
                      "description": "Identifier. The unique identifier of the app. Format: `projects/{project}/locations/{location}/apps/{app}`",
                      "location": "path",
                      "required": true
                    }
                  },
                  "parameterOrder": [
                    "name"
                  ],
                  "request": {
                    "$ref": "App"
                  },
                  "description": "Updates the specified app.",
                  "response": {
                    "$ref": "App"
                  }
                },
                "chatAiAssistant": {
                  "parameters": {
                    "app": {
                      "description": "Required. The app to run assistant for. Format: `projects/{project}/locations/{location}/apps/{app}`",
                      "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
                      "type": "string",
                      "location": "path",
                      "required": true
                    }
                  },
                  "parameterOrder": [
                    "app"
                  ],
                  "request": {
                    "$ref": "ChatAiAssistantRequest"
                  },
                  "description": "Runs Arc, the AI assistant, for the specified assistant session.",
                  "path": "v1beta/{+app}:chatAiAssistant",
                  "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}:chatAiAssistant",
                  "response": {
                    "$ref": "ChatAiAssistantResponse"
                  },
                  "scopes": [
                    "https://www.googleapis.com/auth/ces",
                    "https://www.googleapis.com/auth/cloud-platform"
                  ],
                  "httpMethod": "POST",
                  "id": "ces.projects.locations.apps.chatAiAssistant"
                },
                "get": {
                  "response": {
                    "$ref": "App"
                  },
                  "path": "v1beta/{+name}",
                  "httpMethod": "GET",
                  "scopes": [
                    "https://www.googleapis.com/auth/ces",
                    "https://www.googleapis.com/auth/cloud-platform"
                  ],
                  "id": "ces.projects.locations.apps.get",
                  "description": "Gets details of the specified app.",
                  "parameters": {
                    "name": {
                      "description": "Required. The resource name of the app to retrieve.",
                      "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
                      "location": "path",
                      "required": true,
                      "type": "string"
                    }
                  },
                  "parameterOrder": [
                    "name"
                  ],
                  "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}"
                },
                "generateAppResource": {
                  "parameterOrder": [
                    "parent"
                  ],
                  "parameters": {
                    "parent": {
                      "location": "path",
                      "description": "Required. The resource name of the app to generate the resource for.",
                      "required": true,
                      "type": "string",
                      "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$"
                    }
                  },
                  "id": "ces.projects.locations.apps.generateAppResource",
                  "request": {
                    "$ref": "GenerateAppResourceRequest"
                  },
                  "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}:generateAppResource",
                  "path": "v1beta/{+parent}:generateAppResource",
                  "httpMethod": "POST",
                  "response": {
                    "$ref": "Operation"
                  },
                  "scopes": [
                    "https://www.googleapis.com/auth/ces",
                    "https://www.googleapis.com/auth/cloud-platform"
                  ],
                  "description": "Generates specific resources (e.g. agent) in the app using LLM assistant."
                },
                "retrieveToolSchema": {
                  "parameters": {
                    "parent": {
                      "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
                      "type": "string",
                      "required": true,
                      "description": "Required. The resource name of the app which the tool/toolset belongs to. Format: `projects/{project}/locations/{location}/apps/{app}`",
                      "location": "path"
                    }
                  },
                  "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}:retrieveToolSchema",
                  "description": "Retrieve the schema of the given tool. The schema is computed on the fly for the given instance of the tool.",
                  "request": {
                    "$ref": "RetrieveToolSchemaRequest"
                  },
                  "scopes": [
                    "https://www.googleapis.com/auth/ces",
                    "https://www.googleapis.com/auth/cloud-platform"
                  ],
                  "httpMethod": "POST",
                  "id": "ces.projects.locations.apps.retrieveToolSchema",
                  "path": "v1beta/{+parent}:retrieveToolSchema",
                  "parameterOrder": [
                    "parent"
                  ],
                  "response": {
                    "$ref": "RetrieveToolSchemaResponse"
                  }
                },
                "executeTool": {
                  "scopes": [
                    "https://www.googleapis.com/auth/ces",
                    "https://www.googleapis.com/auth/cloud-platform"
                  ],
                  "description": "Executes the given tool with the given arguments.",
                  "httpMethod": "POST",
                  "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}:executeTool",
                  "parameterOrder": [
                    "parent"
                  ],
                  "path": "v1beta/{+parent}:executeTool",
                  "response": {
                    "$ref": "ExecuteToolResponse"
                  },
                  "request": {
                    "$ref": "ExecuteToolRequest"
                  },
                  "id": "ces.projects.locations.apps.executeTool",
                  "parameters": {
                    "parent": {
                      "type": "string",
                      "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
                      "required": true,
                      "description": "Required. The resource name of the app which the tool/toolset belongs to. Format: `projects/{project}/locations/{location}/apps/{app}`",
                      "location": "path"
                    }
                  }
                },
                "testPersonaVoice": {
                  "path": "v1beta/{+app}:testPersonaVoice",
                  "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}:testPersonaVoice",
                  "parameterOrder": [
                    "app"
                  ],
                  "parameters": {
                    "app": {
                      "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
                      "description": "Required. the resource name of the app to test the persona voice for. Format: `projects/{project}/locations/{location}/apps/{app}`",
                      "location": "path",
                      "type": "string",
                      "required": true
                    }
                  },
                  "description": "Tests the voice of a persona. Also accepts a default persona.",
                  "response": {
                    "$ref": "TestPersonaVoiceResponse"
                  },
                  "request": {
                    "$ref": "TestPersonaVoiceRequest"
                  },
                  "scopes": [
                    "https://www.googleapis.com/auth/ces",
                    "https://www.googleapis.com/auth/cloud-platform"
                  ],
                  "id": "ces.projects.locations.apps.testPersonaVoice",
                  "httpMethod": "POST"
                },
                "getExtendedAgentCard": {
                  "description": "Gets the extended agent card for the authenticated agent.",
                  "path": "v1beta/{+tenant}/extendedAgentCard",
                  "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/extendedAgentCard",
                  "httpMethod": "GET",
                  "scopes": [
                    "https://www.googleapis.com/auth/ces",
                    "https://www.googleapis.com/auth/cloud-platform"
                  ],
                  "response": {
                    "$ref": "LfA2aV1AgentCard"
                  },
                  "parameterOrder": [
                    "tenant"
                  ],
                  "id": "ces.projects.locations.apps.getExtendedAgentCard",
                  "parameters": {
                    "tenant": {
                      "location": "path",
                      "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
                      "required": true,
                      "type": "string",
                      "description": "Optional. Opaque routing identifier. Must match the `tenant` value from the selected `AgentInterface` in the Agent Card when that field is set."
                    }
                  }
                },
                "delete": {
                  "parameters": {
                    "name": {
                      "location": "path",
                      "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
                      "required": true,
                      "type": "string",
                      "description": "Required. The resource name of the app to delete."
                    },
                    "etag": {
                      "description": "Optional. The current etag of the app. If an etag is not provided, the deletion will overwrite any concurrent changes. If an etag is provided and does not match the current etag of the app, deletion will be blocked and an ABORTED error will be returned.",
                      "location": "query",
                      "type": "string"
                    }
                  },
                  "description": "Deletes the specified app.",
                  "parameterOrder": [
                    "name"
                  ],
                  "response": {
                    "$ref": "Operation"
                  },
                  "path": "v1beta/{+name}",
                  "httpMethod": "DELETE",
                  "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}",
                  "id": "ces.projects.locations.apps.delete",
                  "scopes": [
                    "https://www.googleapis.com/auth/ces",
                    "https://www.googleapis.com/auth/cloud-platform"
                  ]
                },
                "runEvaluation": {
                  "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}:runEvaluation",
                  "request": {
                    "$ref": "RunEvaluationRequest"
                  },
                  "parameters": {
                    "app": {
                      "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
                      "type": "string",
                      "required": true,
                      "location": "path",
                      "description": "Required. The app to evaluate. Format: `projects/{project}/locations/{location}/apps/{app}`"
                    }
                  },
                  "id": "ces.projects.locations.apps.runEvaluation",
                  "path": "v1beta/{+app}:runEvaluation",
                  "parameterOrder": [
                    "app"
                  ],
                  "httpMethod": "POST",
                  "response": {
                    "$ref": "Operation"
                  },
                  "description": "Runs an evaluation of the app.",
                  "scopes": [
                    "https://www.googleapis.com/auth/ces",
                    "https://www.googleapis.com/auth/cloud-platform"
                  ]
                },
                "list": {
                  "path": "v1beta/{+parent}/apps",
                  "scopes": [
                    "https://www.googleapis.com/auth/ces",
                    "https://www.googleapis.com/auth/cloud-platform"
                  ],
                  "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps",
                  "id": "ces.projects.locations.apps.list",
                  "httpMethod": "GET",
                  "response": {
                    "$ref": "ListAppsResponse"
                  },
                  "parameterOrder": [
                    "parent"
                  ],
                  "parameters": {
                    "orderBy": {
                      "location": "query",
                      "description": "Optional. Field to sort by. Only \"name\" and \"create_time\" is supported. See https://google.aip.dev/132#ordering for more details.",
                      "type": "string"
                    },
                    "pageToken": {
                      "type": "string",
                      "location": "query",
                      "description": "Optional. The next_page_token value returned from a previous list AgentService.ListApps call."
                    },
                    "pageSize": {
                      "format": "int32",
                      "type": "integer",
                      "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.",
                      "location": "query"
                    },
                    "parent": {
                      "pattern": "^projects/[^/]+/locations/[^/]+$",
                      "location": "path",
                      "description": "Required. The resource name of the location to list apps from.",
                      "type": "string",
                      "required": true
                    },
                    "filter": {
                      "type": "string",
                      "description": "Optional. Filter to be applied when listing the apps. See https://google.aip.dev/160 for more details.",
                      "location": "query"
                    }
                  },
                  "description": "Lists apps in the given project and location."
                },
                "exportApp": {
                  "scopes": [
                    "https://www.googleapis.com/auth/ces",
                    "https://www.googleapis.com/auth/cloud-platform"
                  ],
                  "parameterOrder": [
                    "name"
                  ],
                  "request": {
                    "$ref": "ExportAppRequest"
                  },
                  "parameters": {
                    "name": {
                      "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
                      "type": "string",
                      "required": true,
                      "description": "Required. The resource name of the app to export.",
                      "location": "path"
                    }
                  },
                  "response": {
                    "$ref": "Operation"
                  },
                  "description": "Exports the specified app.",
                  "path": "v1beta/{+name}:exportApp",
                  "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}:exportApp",
                  "id": "ces.projects.locations.apps.exportApp",
                  "httpMethod": "POST"
                },
                "create": {
                  "description": "Creates a new app in the given project and location.",
                  "httpMethod": "POST",
                  "request": {
                    "$ref": "App"
                  },
                  "parameterOrder": [
                    "parent"
                  ],
                  "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps",
                  "scopes": [
                    "https://www.googleapis.com/auth/ces",
                    "https://www.googleapis.com/auth/cloud-platform"
                  ],
                  "id": "ces.projects.locations.apps.create",
                  "parameters": {
                    "parent": {
                      "description": "Required. The resource name of the location to create an app in.",
                      "location": "path",
                      "pattern": "^projects/[^/]+/locations/[^/]+$",
                      "required": true,
                      "type": "string"
                    },
                    "appId": {
                      "type": "string",
                      "description": "Optional. The ID to use for the app, which will become the final component of the app's resource name. If not provided, a unique ID will be automatically assigned for the app.",
                      "location": "query"
                    }
                  },
                  "response": {
                    "$ref": "Operation"
                  },
                  "path": "v1beta/{+parent}/apps"
                },
                "importEvaluations": {
                  "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}:importEvaluations",
                  "id": "ces.projects.locations.apps.importEvaluations",
                  "description": "Imports evaluations into the app.",
                  "parameters": {
                    "parent": {
                      "description": "Required. The app to import the evaluations into. Format: `projects/{project}/locations/{location}/apps/{app}`",
                      "required": true,
                      "location": "path",
                      "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
                      "type": "string"
                    }
                  },
                  "scopes": [
                    "https://www.googleapis.com/auth/ces",
                    "https://www.googleapis.com/auth/cloud-platform"
                  ],
                  "parameterOrder": [
                    "parent"
                  ],
                  "path": "v1beta/{+parent}:importEvaluations",
                  "request": {
                    "$ref": "ImportEvaluationsRequest"
                  },
                  "httpMethod": "POST",
                  "response": {
                    "$ref": "Operation"
                  }
                },
                "importApp": {
                  "description": "Imports the specified app.",
                  "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps:importApp",
                  "httpMethod": "POST",
                  "id": "ces.projects.locations.apps.importApp",
                  "parameterOrder": [
                    "parent"
                  ],
                  "parameters": {
                    "parent": {
                      "required": true,
                      "type": "string",
                      "location": "path",
                      "description": "Required. The parent resource name with the location of the app to import.",
                      "pattern": "^projects/[^/]+/locations/[^/]+$"
                    }
                  },
                  "scopes": [
                    "https://www.googleapis.com/auth/ces",
                    "https://www.googleapis.com/auth/cloud-platform"
                  ],
                  "path": "v1beta/{+parent}/apps:importApp",
                  "request": {
                    "$ref": "ImportAppRequest"
                  },
                  "response": {
                    "$ref": "Operation"
                  }
                },
                "runAssistant": {
                  "id": "ces.projects.locations.apps.runAssistant",
                  "response": {
                    "$ref": "RunAssistantResponse"
                  },
                  "httpMethod": "POST",
                  "path": "v1beta/{+app}:runAssistant",
                  "description": "Runs the assistant agent for the specified assistant session.",
                  "parameters": {
                    "app": {
                      "required": true,
                      "type": "string",
                      "location": "path",
                      "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
                      "description": "Required. The app to run assistant for. Format: `projects/{project}/locations/{location}/apps/{app}`"
                    }
                  },
                  "request": {
                    "$ref": "RunAssistantRequest"
                  },
                  "scopes": [
                    "https://www.googleapis.com/auth/ces",
                    "https://www.googleapis.com/auth/cloud-platform"
                  ],
                  "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}:runAssistant",
                  "parameterOrder": [
                    "app"
                  ]
                },
                "generateOnboardingSuggestions": {
                  "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}:generateOnboardingSuggestions",
                  "parameters": {
                    "name": {
                      "description": "Required. The app whose zero state is being rendered. Format: `projects/{project}/locations/{location}/apps/{app}`",
                      "required": true,
                      "type": "string",
                      "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
                      "location": "path"
                    }
                  },
                  "description": "Generates personalized onboarding suggestions for the Arc zero state: classifies the requesting user (new / exploring / returning) from their assistant-session history in the app and returns suggestion chips (resume a session, continue work, or start something new) to render before any message is sent.",
                  "path": "v1beta/{+name}:generateOnboardingSuggestions",
                  "id": "ces.projects.locations.apps.generateOnboardingSuggestions",
                  "scopes": [
                    "https://www.googleapis.com/auth/ces",
                    "https://www.googleapis.com/auth/cloud-platform"
                  ],
                  "httpMethod": "POST",
                  "parameterOrder": [
                    "name"
                  ],
                  "request": {
                    "$ref": "GenerateOnboardingSuggestionsRequest"
                  },
                  "response": {
                    "$ref": "GenerateOnboardingSuggestionsResponse"
                  }
                }
              },
              "resources": {
                "sessions": {
                  "methods": {
                    "runSession": {
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "response": {
                        "$ref": "RunSessionResponse"
                      },
                      "parameters": {
                        "session": {
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/sessions/[^/]+$",
                          "description": "Required. The unique identifier of the session. Format: `projects/{project}/locations/{location}/apps/{app}/sessions/{session}`",
                          "type": "string",
                          "location": "path",
                          "required": true
                        }
                      },
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/sessions/{sessionsId}:runSession",
                      "description": "Initiates a single-turn interaction with the CES agent within a session.",
                      "id": "ces.projects.locations.apps.sessions.runSession",
                      "parameterOrder": [
                        "session"
                      ],
                      "httpMethod": "POST",
                      "request": {
                        "$ref": "RunSessionRequest"
                      },
                      "path": "v1beta/{+session}:runSession"
                    },
                    "generateChatToken": {
                      "parameters": {
                        "name": {
                          "location": "path",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/sessions/[^/]+$",
                          "required": true,
                          "description": "Required. The session name to generate the chat token for. Format: projects/{project}/locations/{location}/apps/{app}/sessions/{session}",
                          "type": "string"
                        }
                      },
                      "parameterOrder": [
                        "name"
                      ],
                      "description": "Generates a session scoped token for chat widget to authenticate with Session APIs.",
                      "response": {
                        "$ref": "GenerateChatTokenResponse"
                      },
                      "request": {
                        "$ref": "GenerateChatTokenRequest"
                      },
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/sessions/{sessionsId}:generateChatToken",
                      "path": "v1beta/{+name}:generateChatToken",
                      "httpMethod": "POST",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "id": "ces.projects.locations.apps.sessions.generateChatToken"
                    },
                    "streamRunSession": {
                      "response": {
                        "$ref": "RunSessionResponse"
                      },
                      "httpMethod": "POST",
                      "request": {
                        "$ref": "RunSessionRequest"
                      },
                      "id": "ces.projects.locations.apps.sessions.streamRunSession",
                      "parameters": {
                        "session": {
                          "location": "path",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/sessions/[^/]+$",
                          "required": true,
                          "type": "string",
                          "description": "Required. The unique identifier of the session. Format: `projects/{project}/locations/{location}/apps/{app}/sessions/{session}`"
                        }
                      },
                      "parameterOrder": [
                        "session"
                      ],
                      "path": "v1beta/{+session}:streamRunSession",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/sessions/{sessionsId}:streamRunSession",
                      "description": "Initiates a single-turn interaction with the CES agent. Uses server-side streaming to deliver incremental results and partial responses as they are generated. By default, complete responses (e.g., messages from callbacks or full LLM responses) are sent to the client as soon as they are available. To enable streaming individual text chunks directly from the model, set enable_text_streaming to true."
                    }
                  }
                },
                "examples": {
                  "methods": {
                    "patch": {
                      "id": "ces.projects.locations.apps.examples.patch",
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/examples/{examplesId}",
                      "parameters": {
                        "name": {
                          "description": "Identifier. The unique identifier of the example. Format: `projects/{project}/locations/{location}/apps/{app}/examples/{example}`",
                          "required": true,
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/examples/[^/]+$",
                          "location": "path",
                          "type": "string"
                        },
                        "updateMask": {
                          "location": "query",
                          "type": "string",
                          "description": "Optional. Field mask is used to control which fields get updated. If the mask is not present, all fields will be updated.",
                          "format": "google-fieldmask"
                        }
                      },
                      "path": "v1beta/{+name}",
                      "request": {
                        "$ref": "Example"
                      },
                      "response": {
                        "$ref": "Example"
                      },
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "parameterOrder": [
                        "name"
                      ],
                      "description": "Updates the specified example.",
                      "httpMethod": "PATCH"
                    },
                    "create": {
                      "parameters": {
                        "parent": {
                          "required": true,
                          "location": "path",
                          "type": "string",
                          "description": "Required. The resource name of the app to create an example in.",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$"
                        },
                        "exampleId": {
                          "description": "Optional. The ID to use for the example, which will become the final component of the example's resource name. If not provided, a unique ID will be automatically assigned for the example.",
                          "location": "query",
                          "type": "string"
                        }
                      },
                      "description": "Creates a new example in the given app.",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "path": "v1beta/{+parent}/examples",
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/examples",
                      "parameterOrder": [
                        "parent"
                      ],
                      "httpMethod": "POST",
                      "response": {
                        "$ref": "Example"
                      },
                      "request": {
                        "$ref": "Example"
                      },
                      "id": "ces.projects.locations.apps.examples.create"
                    },
                    "get": {
                      "id": "ces.projects.locations.apps.examples.get",
                      "parameterOrder": [
                        "name"
                      ],
                      "parameters": {
                        "name": {
                          "location": "path",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/examples/[^/]+$",
                          "required": true,
                          "type": "string",
                          "description": "Required. The resource name of the example to retrieve."
                        }
                      },
                      "response": {
                        "$ref": "Example"
                      },
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "path": "v1beta/{+name}",
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/examples/{examplesId}",
                      "description": "Gets details of the specified example.",
                      "httpMethod": "GET"
                    },
                    "list": {
                      "httpMethod": "GET",
                      "path": "v1beta/{+parent}/examples",
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/examples",
                      "id": "ces.projects.locations.apps.examples.list",
                      "parameterOrder": [
                        "parent"
                      ],
                      "response": {
                        "$ref": "ListExamplesResponse"
                      },
                      "parameters": {
                        "pageSize": {
                          "location": "query",
                          "format": "int32",
                          "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.",
                          "type": "integer"
                        },
                        "orderBy": {
                          "description": "Optional. Field to sort by. Only \"name\" and \"create_time\" is supported. See https://google.aip.dev/132#ordering for more details.",
                          "type": "string",
                          "location": "query"
                        },
                        "pageToken": {
                          "description": "Optional. The next_page_token value returned from a previous list AgentService.ListExamples call.",
                          "location": "query",
                          "type": "string"
                        },
                        "parent": {
                          "required": true,
                          "location": "path",
                          "type": "string",
                          "description": "Required. The resource name of the app to list examples from.",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$"
                        },
                        "filter": {
                          "type": "string",
                          "location": "query",
                          "description": "Optional. Filter to be applied when listing the examples. See https://google.aip.dev/160 for more details."
                        }
                      },
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "description": "Lists examples in the given app."
                    },
                    "delete": {
                      "parameterOrder": [
                        "name"
                      ],
                      "id": "ces.projects.locations.apps.examples.delete",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "parameters": {
                        "name": {
                          "type": "string",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/examples/[^/]+$",
                          "required": true,
                          "description": "Required. The resource name of the example to delete.",
                          "location": "path"
                        },
                        "etag": {
                          "type": "string",
                          "description": "Optional. The current etag of the example. If an etag is not provided, the deletion will overwrite any concurrent changes. If an etag is provided and does not match the current etag of the example, deletion will be blocked and an ABORTED error will be returned.",
                          "location": "query"
                        }
                      },
                      "description": "Deletes the specified example.",
                      "path": "v1beta/{+name}",
                      "response": {
                        "$ref": "Empty"
                      },
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/examples/{examplesId}",
                      "httpMethod": "DELETE"
                    }
                  }
                },
                "evaluationExpectations": {
                  "methods": {
                    "create": {
                      "parameters": {
                        "evaluationExpectationId": {
                          "description": "Optional. The ID to use for the evaluation expectation, which will become the final component of the evaluation expectation's resource name. If not provided, a unique ID will be automatically assigned for the evaluation expectation.",
                          "type": "string",
                          "location": "query"
                        },
                        "parent": {
                          "required": true,
                          "location": "path",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
                          "type": "string",
                          "description": "Required. The app to create the evaluation expectation for. Format: `projects/{project}/locations/{location}/apps/{app}`"
                        }
                      },
                      "description": "Creates an evaluation expectation.",
                      "response": {
                        "$ref": "EvaluationExpectation"
                      },
                      "parameterOrder": [
                        "parent"
                      ],
                      "httpMethod": "POST",
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/evaluationExpectations",
                      "path": "v1beta/{+parent}/evaluationExpectations",
                      "request": {
                        "$ref": "EvaluationExpectation"
                      },
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "id": "ces.projects.locations.apps.evaluationExpectations.create"
                    },
                    "delete": {
                      "id": "ces.projects.locations.apps.evaluationExpectations.delete",
                      "response": {
                        "$ref": "Empty"
                      },
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "parameters": {
                        "name": {
                          "location": "path",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/evaluationExpectations/[^/]+$",
                          "required": true,
                          "description": "Required. The resource name of the evaluation expectation to delete.",
                          "type": "string"
                        },
                        "etag": {
                          "type": "string",
                          "location": "query",
                          "description": "Optional. The current etag of the evaluation expectation. If an etag is not provided, the deletion will overwrite any concurrent changes. If an etag is provided and does not match the current etag of the evaluation expectation, deletion will be blocked and an ABORTED error will be returned."
                        }
                      },
                      "description": "Deletes an evaluation expectation.",
                      "path": "v1beta/{+name}",
                      "parameterOrder": [
                        "name"
                      ],
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/evaluationExpectations/{evaluationExpectationsId}",
                      "httpMethod": "DELETE"
                    },
                    "list": {
                      "parameters": {
                        "orderBy": {
                          "description": "Optional. Field to sort by. Only \"name\" and \"create_time\", and \"update_time\" are supported. Time fields are ordered in descending order, and the name field is ordered in ascending order. If not included, \"update_time\" will be the default. See https://google.aip.dev/132#ordering for more details.",
                          "type": "string",
                          "location": "query"
                        },
                        "pageSize": {
                          "type": "integer",
                          "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.",
                          "format": "int32",
                          "location": "query"
                        },
                        "pageToken": {
                          "type": "string",
                          "description": "Optional. The next_page_token value returned from a previous list EvaluationService.ListEvaluationExpectations call.",
                          "location": "query"
                        },
                        "parent": {
                          "location": "path",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
                          "required": true,
                          "type": "string",
                          "description": "Required. The resource name of the app to list evaluation expectations from."
                        },
                        "filter": {
                          "location": "query",
                          "type": "string",
                          "description": "Optional. Filter to be applied when listing the evaluation expectations. See https://google.aip.dev/160 for more details."
                        }
                      },
                      "id": "ces.projects.locations.apps.evaluationExpectations.list",
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/evaluationExpectations",
                      "httpMethod": "GET",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "response": {
                        "$ref": "ListEvaluationExpectationsResponse"
                      },
                      "description": "Lists all evaluation expectations in the given app.",
                      "parameterOrder": [
                        "parent"
                      ],
                      "path": "v1beta/{+parent}/evaluationExpectations"
                    },
                    "patch": {
                      "httpMethod": "PATCH",
                      "id": "ces.projects.locations.apps.evaluationExpectations.patch",
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/evaluationExpectations/{evaluationExpectationsId}",
                      "path": "v1beta/{+name}",
                      "description": "Updates an evaluation expectation.",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "request": {
                        "$ref": "EvaluationExpectation"
                      },
                      "parameters": {
                        "name": {
                          "required": true,
                          "location": "path",
                          "description": "Identifier. The unique identifier of this evaluation expectation. Format: `projects/{project}/locations/{location}/apps/{app}/evaluationExpectations/{evaluation_expectation}`",
                          "type": "string",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/evaluationExpectations/[^/]+$"
                        },
                        "updateMask": {
                          "location": "query",
                          "format": "google-fieldmask",
                          "description": "Optional. Field mask is used to control which fields get updated. If the mask is not present, all fields will be updated.",
                          "type": "string"
                        }
                      },
                      "parameterOrder": [
                        "name"
                      ],
                      "response": {
                        "$ref": "EvaluationExpectation"
                      }
                    },
                    "get": {
                      "parameters": {
                        "name": {
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/evaluationExpectations/[^/]+$",
                          "type": "string",
                          "required": true,
                          "location": "path",
                          "description": "Required. The resource name of the evaluation expectation to retrieve."
                        }
                      },
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "parameterOrder": [
                        "name"
                      ],
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/evaluationExpectations/{evaluationExpectationsId}",
                      "id": "ces.projects.locations.apps.evaluationExpectations.get",
                      "path": "v1beta/{+name}",
                      "response": {
                        "$ref": "EvaluationExpectation"
                      },
                      "httpMethod": "GET",
                      "description": "Gets details of the specified evaluation expectation."
                    }
                  }
                },
                "changelogs": {
                  "methods": {
                    "list": {
                      "parameterOrder": [
                        "parent"
                      ],
                      "parameters": {
                        "orderBy": {
                          "location": "query",
                          "description": "Optional. Field to sort by. Only \"name\" and \"create_time\" is supported. See https://google.aip.dev/132#ordering for more details.",
                          "type": "string"
                        },
                        "parent": {
                          "description": "Required. The resource name of the app to list changelogs from.",
                          "required": true,
                          "location": "path",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
                          "type": "string"
                        },
                        "filter": {
                          "description": "Optional. Filter to be applied when listing the changelogs. See https://google.aip.dev/160 for more details. The filter string can be used to filter by `action`, `resource_type`, `resource_name`, `author`, and `create_time`. The `:` comparator can be used for case-insensitive partial matching on string fields, while `=` performs an exact case-sensitive match. Examples: * `action:update` (case-insensitive partial match) * `action=\"Create\"` (case-sensitive exact match) * `resource_type:agent` * `resource_name:my-agent` * `author:me@example.com` * `create_time \u003e \"2025-01-01T00:00:00Z\"` * `create_time \u003c= \"2025-01-01T00:00:00Z\" AND resource_type:tool`",
                          "type": "string",
                          "location": "query"
                        },
                        "pageSize": {
                          "format": "int32",
                          "location": "query",
                          "type": "integer",
                          "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default."
                        },
                        "pageToken": {
                          "description": "Optional. The next_page_token value returned from a previous list AgentService.ListChangelogs call.",
                          "type": "string",
                          "location": "query"
                        }
                      },
                      "id": "ces.projects.locations.apps.changelogs.list",
                      "response": {
                        "$ref": "ListChangelogsResponse"
                      },
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/changelogs",
                      "httpMethod": "GET",
                      "path": "v1beta/{+parent}/changelogs",
                      "description": "Lists the changelogs of the specified app."
                    },
                    "get": {
                      "path": "v1beta/{+name}",
                      "response": {
                        "$ref": "Changelog"
                      },
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "httpMethod": "GET",
                      "id": "ces.projects.locations.apps.changelogs.get",
                      "parameters": {
                        "name": {
                          "type": "string",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/changelogs/[^/]+$",
                          "required": true,
                          "description": "Required. The resource name of the changelog to retrieve.",
                          "location": "path"
                        }
                      },
                      "parameterOrder": [
                        "name"
                      ],
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/changelogs/{changelogsId}",
                      "description": "Gets the specified changelog."
                    }
                  }
                },
                "message": {
                  "methods": {
                    "stream": {
                      "response": {
                        "$ref": "LfA2aV1StreamResponse"
                      },
                      "request": {
                        "$ref": "LfA2aV1SendMessageRequest"
                      },
                      "path": "v1beta/{+tenant}/message:stream",
                      "httpMethod": "POST",
                      "parameterOrder": [
                        "tenant"
                      ],
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/message:stream",
                      "id": "ces.projects.locations.apps.message.stream",
                      "parameters": {
                        "tenant": {
                          "description": "Optional. Opaque routing identifier. Must match the `tenant` value from the selected `AgentInterface` in the Agent Card when that field is set.",
                          "required": true,
                          "location": "path",
                          "type": "string",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$"
                        }
                      },
                      "description": "Sends a streaming message to an agent, allowing for real-time interaction and status updates. Streaming version of `SendMessage`"
                    },
                    "send": {
                      "response": {
                        "$ref": "LfA2aV1SendMessageResponse"
                      },
                      "parameters": {
                        "tenant": {
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
                          "description": "Optional. Opaque routing identifier. Must match the `tenant` value from the selected `AgentInterface` in the Agent Card when that field is set.",
                          "location": "path",
                          "required": true,
                          "type": "string"
                        }
                      },
                      "id": "ces.projects.locations.apps.message.send",
                      "parameterOrder": [
                        "tenant"
                      ],
                      "path": "v1beta/{+tenant}/message:send",
                      "request": {
                        "$ref": "LfA2aV1SendMessageRequest"
                      },
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "description": "Sends a message to an agent.",
                      "httpMethod": "POST",
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/message:send"
                    }
                  }
                },
                "toolsets": {
                  "methods": {
                    "patch": {
                      "request": {
                        "$ref": "Toolset"
                      },
                      "path": "v1beta/{+name}",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "parameters": {
                        "updateMask": {
                          "description": "Optional. Field mask is used to control which fields get updated. If the mask is not present, all fields will be updated.",
                          "type": "string",
                          "location": "query",
                          "format": "google-fieldmask"
                        },
                        "name": {
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/toolsets/[^/]+$",
                          "description": "Identifier. The unique identifier of the toolset. Format: `projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset}`",
                          "location": "path",
                          "required": true,
                          "type": "string"
                        }
                      },
                      "response": {
                        "$ref": "Toolset"
                      },
                      "id": "ces.projects.locations.apps.toolsets.patch",
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/toolsets/{toolsetsId}",
                      "httpMethod": "PATCH",
                      "parameterOrder": [
                        "name"
                      ],
                      "description": "Updates the specified toolset."
                    },
                    "list": {
                      "id": "ces.projects.locations.apps.toolsets.list",
                      "parameterOrder": [
                        "parent"
                      ],
                      "path": "v1beta/{+parent}/toolsets",
                      "response": {
                        "$ref": "ListToolsetsResponse"
                      },
                      "parameters": {
                        "pageSize": {
                          "location": "query",
                          "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.",
                          "type": "integer",
                          "format": "int32"
                        },
                        "pageToken": {
                          "location": "query",
                          "description": "Optional. The next_page_token value returned from a previous list AgentService.ListToolsets call.",
                          "type": "string"
                        },
                        "orderBy": {
                          "location": "query",
                          "type": "string",
                          "description": "Optional. Field to sort by. Only \"name\" and \"create_time\" is supported. See https://google.aip.dev/132#ordering for more details."
                        },
                        "parent": {
                          "type": "string",
                          "location": "path",
                          "required": true,
                          "description": "Required. The resource name of the app to list toolsets from.",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$"
                        },
                        "filter": {
                          "type": "string",
                          "description": "Optional. Filter to be applied when listing the toolsets. See https://google.aip.dev/160 for more details.",
                          "location": "query"
                        }
                      },
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/toolsets",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "httpMethod": "GET",
                      "description": "Lists toolsets in the given app."
                    },
                    "retrieveTools": {
                      "request": {
                        "$ref": "RetrieveToolsRequest"
                      },
                      "path": "v1beta/{+toolset}:retrieveTools",
                      "id": "ces.projects.locations.apps.toolsets.retrieveTools",
                      "httpMethod": "POST",
                      "response": {
                        "$ref": "RetrieveToolsResponse"
                      },
                      "parameterOrder": [
                        "toolset"
                      ],
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/toolsets/{toolsetsId}:retrieveTools",
                      "description": "Retrieve the list of tools included in the specified toolset.",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "parameters": {
                        "toolset": {
                          "location": "path",
                          "type": "string",
                          "required": true,
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/toolsets/[^/]+$",
                          "description": "Required. The name of the toolset to retrieve the tools for. Format: `projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset}`"
                        }
                      }
                    },
                    "delete": {
                      "id": "ces.projects.locations.apps.toolsets.delete",
                      "httpMethod": "DELETE",
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/toolsets/{toolsetsId}",
                      "description": "Deletes the specified toolset.",
                      "parameters": {
                        "force": {
                          "location": "query",
                          "description": "Optional. Indicates whether to forcefully delete the toolset, even if it is still referenced by app/agents. * If `force = false`, the deletion fails if any agents still reference the toolset. * If `force = true`, all existing references from agents will be removed and the toolset will be deleted.",
                          "type": "boolean"
                        },
                        "name": {
                          "description": "Required. The resource name of the toolset to delete.",
                          "required": true,
                          "location": "path",
                          "type": "string",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/toolsets/[^/]+$"
                        },
                        "etag": {
                          "type": "string",
                          "location": "query",
                          "description": "Optional. The current etag of the toolset. If an etag is not provided, the deletion will overwrite any concurrent changes. If an etag is provided and does not match the current etag of the toolset, deletion will be blocked and an ABORTED error will be returned."
                        }
                      },
                      "response": {
                        "$ref": "Empty"
                      },
                      "parameterOrder": [
                        "name"
                      ],
                      "path": "v1beta/{+name}",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ]
                    },
                    "create": {
                      "description": "Creates a new toolset in the given app.",
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/toolsets",
                      "httpMethod": "POST",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "id": "ces.projects.locations.apps.toolsets.create",
                      "response": {
                        "$ref": "Toolset"
                      },
                      "parameters": {
                        "toolsetId": {
                          "description": "Optional. The ID to use for the toolset, which will become the final component of the toolset's resource name. If not provided, a unique ID will be automatically assigned for the toolset.",
                          "type": "string",
                          "location": "query"
                        },
                        "parent": {
                          "required": true,
                          "location": "path",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
                          "type": "string",
                          "description": "Required. The resource name of the app to create a toolset in."
                        }
                      },
                      "path": "v1beta/{+parent}/toolsets",
                      "request": {
                        "$ref": "Toolset"
                      },
                      "parameterOrder": [
                        "parent"
                      ]
                    },
                    "get": {
                      "path": "v1beta/{+name}",
                      "parameters": {
                        "name": {
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/toolsets/[^/]+$",
                          "location": "path",
                          "type": "string",
                          "description": "Required. The resource name of the toolset to retrieve.",
                          "required": true
                        }
                      },
                      "parameterOrder": [
                        "name"
                      ],
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/toolsets/{toolsetsId}",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "description": "Gets details of the specified toolset.",
                      "httpMethod": "GET",
                      "id": "ces.projects.locations.apps.toolsets.get",
                      "response": {
                        "$ref": "Toolset"
                      }
                    }
                  }
                },
                "conversations": {
                  "methods": {
                    "get": {
                      "description": "Gets details of the specified conversation.",
                      "parameterOrder": [
                        "name"
                      ],
                      "httpMethod": "GET",
                      "response": {
                        "$ref": "Conversation"
                      },
                      "path": "v1beta/{+name}",
                      "id": "ces.projects.locations.apps.conversations.get",
                      "parameters": {
                        "name": {
                          "required": true,
                          "type": "string",
                          "description": "Required. The resource name of the conversation to retrieve.",
                          "location": "path",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/conversations/[^/]+$"
                        },
                        "source": {
                          "deprecated": true,
                          "location": "query",
                          "enum": [
                            "SOURCE_UNSPECIFIED",
                            "LIVE",
                            "SIMULATOR",
                            "EVAL",
                            "AGENT_TOOL"
                          ],
                          "enumDescriptions": [
                            "Unspecified source.",
                            "The conversation is from the live end user.",
                            "The conversation is from the simulator.",
                            "The conversation is from the evaluation.",
                            "The conversation is from an agent tool. Agent tool runs the agent in a separate session, which is persisted for testing and debugging purposes."
                          ],
                          "type": "string",
                          "description": "Optional. Indicate the source of the conversation. If not set, all source will be searched."
                        }
                      },
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/conversations/{conversationsId}"
                    },
                    "list": {
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/conversations",
                      "parameterOrder": [
                        "parent"
                      ],
                      "id": "ces.projects.locations.apps.conversations.list",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "description": "Lists conversations in the given app.",
                      "path": "v1beta/{+parent}/conversations",
                      "parameters": {
                        "source": {
                          "location": "query",
                          "enumDescriptions": [
                            "Unspecified source.",
                            "The conversation is from the live end user.",
                            "The conversation is from the simulator.",
                            "The conversation is from the evaluation.",
                            "The conversation is from an agent tool. Agent tool runs the agent in a separate session, which is persisted for testing and debugging purposes."
                          ],
                          "type": "string",
                          "description": "Optional. Indicate the source of the conversation. If not set, Source.Live will be applied by default. Will be deprecated in favor of `sources` field.",
                          "enum": [
                            "SOURCE_UNSPECIFIED",
                            "LIVE",
                            "SIMULATOR",
                            "EVAL",
                            "AGENT_TOOL"
                          ]
                        },
                        "parent": {
                          "type": "string",
                          "description": "Required. The resource name of the app to list conversations from.",
                          "required": true,
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
                          "location": "path"
                        },
                        "filter": {
                          "description": "Optional. Filter to be applied when listing the conversations. See https://google.aip.dev/160 for more details.",
                          "type": "string",
                          "location": "query"
                        },
                        "pageSize": {
                          "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.",
                          "type": "integer",
                          "location": "query",
                          "format": "int32"
                        },
                        "sources": {
                          "enumDescriptions": [
                            "Unspecified source.",
                            "The conversation is from the live end user.",
                            "The conversation is from the simulator.",
                            "The conversation is from the evaluation.",
                            "The conversation is from an agent tool. Agent tool runs the agent in a separate session, which is persisted for testing and debugging purposes."
                          ],
                          "description": "Optional. Indicate the sources of the conversations. If not set, all available sources will be applied by default.",
                          "enum": [
                            "SOURCE_UNSPECIFIED",
                            "LIVE",
                            "SIMULATOR",
                            "EVAL",
                            "AGENT_TOOL"
                          ],
                          "repeated": true,
                          "location": "query",
                          "type": "string"
                        },
                        "pageToken": {
                          "location": "query",
                          "description": "Optional. The next_page_token value returned from a previous list AgentService.ListConversations call.",
                          "type": "string"
                        }
                      },
                      "response": {
                        "$ref": "ListConversationsResponse"
                      },
                      "httpMethod": "GET"
                    },
                    "delete": {
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "response": {
                        "$ref": "Empty"
                      },
                      "path": "v1beta/{+name}",
                      "parameters": {
                        "name": {
                          "location": "path",
                          "required": true,
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/conversations/[^/]+$",
                          "type": "string",
                          "description": "Required. The resource name of the conversation to delete."
                        },
                        "source": {
                          "description": "Optional. Indicate the source of the conversation. If not set, Source.Live will be applied by default.",
                          "enum": [
                            "SOURCE_UNSPECIFIED",
                            "LIVE",
                            "SIMULATOR",
                            "EVAL",
                            "AGENT_TOOL"
                          ],
                          "location": "query",
                          "enumDescriptions": [
                            "Unspecified source.",
                            "The conversation is from the live end user.",
                            "The conversation is from the simulator.",
                            "The conversation is from the evaluation.",
                            "The conversation is from an agent tool. Agent tool runs the agent in a separate session, which is persisted for testing and debugging purposes."
                          ],
                          "deprecated": true,
                          "type": "string"
                        }
                      },
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/conversations/{conversationsId}",
                      "parameterOrder": [
                        "name"
                      ],
                      "id": "ces.projects.locations.apps.conversations.delete",
                      "httpMethod": "DELETE",
                      "description": "Deletes the specified conversation."
                    },
                    "generateEvaluation": {
                      "id": "ces.projects.locations.apps.conversations.generateEvaluation",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "path": "v1beta/{+conversation}:generateEvaluation",
                      "parameterOrder": [
                        "conversation"
                      ],
                      "httpMethod": "POST",
                      "response": {
                        "$ref": "Operation"
                      },
                      "description": "Creates a golden evaluation from a conversation.",
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/conversations/{conversationsId}:generateEvaluation",
                      "request": {
                        "$ref": "GenerateEvaluationRequest"
                      },
                      "parameters": {
                        "conversation": {
                          "location": "path",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/conversations/[^/]+$",
                          "required": true,
                          "type": "string",
                          "description": "Required. The conversation to create the golden evaluation for. Format: `projects/{project}/locations/{location}/apps/{app}/conversations/{conversation}`"
                        }
                      }
                    },
                    "batchDelete": {
                      "description": "Batch deletes the specified conversations.",
                      "response": {
                        "$ref": "Operation"
                      },
                      "request": {
                        "$ref": "BatchDeleteConversationsRequest"
                      },
                      "parameterOrder": [
                        "parent"
                      ],
                      "httpMethod": "POST",
                      "id": "ces.projects.locations.apps.conversations.batchDelete",
                      "path": "v1beta/{+parent}/conversations:batchDelete",
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/conversations:batchDelete",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "parameters": {
                        "parent": {
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
                          "description": "Required. The resource name of the app to delete conversations from. Format: `projects/{project}/locations/{location}/apps/{app}`",
                          "type": "string",
                          "required": true,
                          "location": "path"
                        }
                      }
                    }
                  }
                },
                "tools": {
                  "methods": {
                    "delete": {
                      "description": "Deletes the specified tool.",
                      "httpMethod": "DELETE",
                      "response": {
                        "$ref": "Empty"
                      },
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "parameters": {
                        "name": {
                          "location": "path",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/tools/[^/]+$",
                          "required": true,
                          "type": "string",
                          "description": "Required. The resource name of the tool to delete."
                        },
                        "etag": {
                          "type": "string",
                          "location": "query",
                          "description": "Optional. The current etag of the tool. If an etag is not provided, the deletion will overwrite any concurrent changes. If an etag is provided and does not match the current etag of the tool, deletion will be blocked and an ABORTED error will be returned."
                        },
                        "force": {
                          "location": "query",
                          "type": "boolean",
                          "description": "Optional. Indicates whether to forcefully delete the tool, even if it is still referenced by agents/examples. * If `force = false`, the deletion will fail if any agents still reference the tool. * If `force = true`, all existing references from agents will be removed and the tool will be deleted."
                        }
                      },
                      "id": "ces.projects.locations.apps.tools.delete",
                      "path": "v1beta/{+name}",
                      "parameterOrder": [
                        "name"
                      ],
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/tools/{toolsId}"
                    },
                    "get": {
                      "parameters": {
                        "name": {
                          "type": "string",
                          "description": "Required. The resource name of the tool to retrieve.",
                          "required": true,
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/tools/[^/]+$",
                          "location": "path"
                        }
                      },
                      "response": {
                        "$ref": "Tool"
                      },
                      "parameterOrder": [
                        "name"
                      ],
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/tools/{toolsId}",
                      "id": "ces.projects.locations.apps.tools.get",
                      "httpMethod": "GET",
                      "path": "v1beta/{+name}",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "description": "Gets details of the specified tool."
                    },
                    "list": {
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/tools",
                      "path": "v1beta/{+parent}/tools",
                      "parameters": {
                        "pageToken": {
                          "type": "string",
                          "location": "query",
                          "description": "Optional. The next_page_token value returned from a previous list AgentService.ListTools call."
                        },
                        "orderBy": {
                          "location": "query",
                          "description": "Optional. Field to sort by. Only \"name\" and \"create_time\" is supported. See https://google.aip.dev/132#ordering for more details.",
                          "type": "string"
                        },
                        "pageSize": {
                          "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.",
                          "location": "query",
                          "format": "int32",
                          "type": "integer"
                        },
                        "parent": {
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
                          "description": "Required. The resource name of the app to list tools from.",
                          "location": "path",
                          "type": "string",
                          "required": true
                        },
                        "filter": {
                          "location": "query",
                          "type": "string",
                          "description": "Optional. Filter to be applied when listing the tools. Use \"include_system_tools=true\" to include system tools in the response. See https://google.aip.dev/160 for more details."
                        }
                      },
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "description": "Lists tools in the given app.",
                      "id": "ces.projects.locations.apps.tools.list",
                      "parameterOrder": [
                        "parent"
                      ],
                      "response": {
                        "$ref": "ListToolsResponse"
                      },
                      "httpMethod": "GET"
                    },
                    "patch": {
                      "parameters": {
                        "updateMask": {
                          "description": "Optional. Field mask is used to control which fields get updated. If the mask is not present, all fields will be updated.",
                          "type": "string",
                          "location": "query",
                          "format": "google-fieldmask"
                        },
                        "name": {
                          "required": true,
                          "location": "path",
                          "type": "string",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/tools/[^/]+$",
                          "description": "Identifier. The resource name of the tool. Format: * `projects/{project}/locations/{location}/apps/{app}/tools/{tool}` for standalone tools. * `projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset}/tools/{tool}` for tools retrieved from a toolset. These tools are dynamic and output-only; they cannot be referenced directly where a tool is expected."
                        }
                      },
                      "path": "v1beta/{+name}",
                      "request": {
                        "$ref": "Tool"
                      },
                      "response": {
                        "$ref": "Tool"
                      },
                      "description": "Updates the specified tool.",
                      "httpMethod": "PATCH",
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/tools/{toolsId}",
                      "parameterOrder": [
                        "name"
                      ],
                      "id": "ces.projects.locations.apps.tools.patch",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ]
                    },
                    "create": {
                      "description": "Creates a new tool in the given app.",
                      "parameterOrder": [
                        "parent"
                      ],
                      "parameters": {
                        "parent": {
                          "required": true,
                          "description": "Required. The resource name of the app to create a tool in.",
                          "location": "path",
                          "type": "string",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$"
                        },
                        "toolId": {
                          "type": "string",
                          "description": "Optional. The ID to use for the tool, which will become the final component of the tool's resource name. If not provided, a unique ID will be automatically assigned for the tool.",
                          "location": "query"
                        }
                      },
                      "response": {
                        "$ref": "Tool"
                      },
                      "path": "v1beta/{+parent}/tools",
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/tools",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "id": "ces.projects.locations.apps.tools.create",
                      "request": {
                        "$ref": "Tool"
                      },
                      "httpMethod": "POST"
                    }
                  }
                },
                "evaluationRuns": {
                  "methods": {
                    "list": {
                      "response": {
                        "$ref": "ListEvaluationRunsResponse"
                      },
                      "path": "v1beta/{+parent}/evaluationRuns",
                      "httpMethod": "GET",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "parameterOrder": [
                        "parent"
                      ],
                      "description": "Lists all evaluation runs in the given app.",
                      "id": "ces.projects.locations.apps.evaluationRuns.list",
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/evaluationRuns",
                      "parameters": {
                        "pageSize": {
                          "format": "int32",
                          "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.",
                          "location": "query",
                          "type": "integer"
                        },
                        "pageToken": {
                          "description": "Optional. The next_page_token value returned from a previous list EvaluationService.ListEvaluationRuns call.",
                          "type": "string",
                          "location": "query"
                        },
                        "orderBy": {
                          "description": "Optional. Field to sort by. Only \"name\" and \"create_time\", and \"update_time\" are supported. Time fields are ordered in descending order, and the name field is ordered in ascending order. If not included, \"update_time\" will be the default. See https://google.aip.dev/132#ordering for more details.",
                          "location": "query",
                          "type": "string"
                        },
                        "parent": {
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
                          "required": true,
                          "description": "Required. The resource name of the app to list evaluation runs from.",
                          "location": "path",
                          "type": "string"
                        },
                        "filter": {
                          "location": "query",
                          "description": "Optional. Filter to be applied when listing the evaluation runs. See https://google.aip.dev/160 for more details.",
                          "type": "string"
                        }
                      }
                    },
                    "delete": {
                      "path": "v1beta/{+name}",
                      "httpMethod": "DELETE",
                      "parameterOrder": [
                        "name"
                      ],
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/evaluationRuns/{evaluationRunsId}",
                      "id": "ces.projects.locations.apps.evaluationRuns.delete",
                      "response": {
                        "$ref": "Operation"
                      },
                      "description": "Deletes an evaluation run.",
                      "parameters": {
                        "name": {
                          "location": "path",
                          "required": true,
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/evaluationRuns/[^/]+$",
                          "description": "Required. The resource name of the evaluation run to delete.",
                          "type": "string"
                        }
                      },
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ]
                    },
                    "get": {
                      "path": "v1beta/{+name}",
                      "parameters": {
                        "name": {
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/evaluationRuns/[^/]+$",
                          "type": "string",
                          "description": "Required. The resource name of the evaluation run to retrieve.",
                          "location": "path",
                          "required": true
                        }
                      },
                      "response": {
                        "$ref": "EvaluationRun"
                      },
                      "parameterOrder": [
                        "name"
                      ],
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/evaluationRuns/{evaluationRunsId}",
                      "description": "Gets details of the specified evaluation run.",
                      "httpMethod": "GET",
                      "id": "ces.projects.locations.apps.evaluationRuns.get",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ]
                    },
                    "export": {
                      "response": {
                        "$ref": "Operation"
                      },
                      "request": {
                        "$ref": "ExportEvaluationRunsRequest"
                      },
                      "id": "ces.projects.locations.apps.evaluationRuns.export",
                      "httpMethod": "POST",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "description": "Exports evaluations runs.",
                      "parameters": {
                        "parent": {
                          "location": "path",
                          "required": true,
                          "description": "Required. The resource name of the app to export evaluation runs from. Format: `projects/{project}/locations/{location}/apps/{app}`",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
                          "type": "string"
                        }
                      },
                      "parameterOrder": [
                        "parent"
                      ],
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/evaluationRuns:export",
                      "path": "v1beta/{+parent}/evaluationRuns:export"
                    }
                  }
                },
                "evaluations": {
                  "methods": {
                    "export": {
                      "response": {
                        "$ref": "Operation"
                      },
                      "parameterOrder": [
                        "parent"
                      ],
                      "id": "ces.projects.locations.apps.evaluations.export",
                      "parameters": {
                        "parent": {
                          "type": "string",
                          "location": "path",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
                          "required": true,
                          "description": "Required. The resource name of the app to export evaluations from. Format: `projects/{project}/locations/{location}/apps/{app}`"
                        }
                      },
                      "request": {
                        "$ref": "ExportEvaluationsRequest"
                      },
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "path": "v1beta/{+parent}/evaluations:export",
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/evaluations:export",
                      "description": "Exports evaluations.",
                      "httpMethod": "POST"
                    },
                    "uploadEvaluationAudio": {
                      "request": {
                        "$ref": "UploadEvaluationAudioRequest"
                      },
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/evaluations/{evaluationsId}:uploadEvaluationAudio",
                      "path": "v1beta/{+name}:uploadEvaluationAudio",
                      "description": "Uploads audio for use in Golden Evaluations. Stores the audio in the Cloud Storage bucket defined in 'App.logging_settings.evaluation_audio_recording_config.gcs_bucket' and returns a transcript.",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "parameters": {
                        "name": {
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/evaluations/[^/]+$",
                          "type": "string",
                          "location": "path",
                          "description": "Required. The resource name of the Evaluation for which to upload the evaluation audio. Format: `projects/{project}/locations/{location}/apps/{app}/evaluations/{evaluation}`",
                          "required": true
                        }
                      },
                      "parameterOrder": [
                        "name"
                      ],
                      "id": "ces.projects.locations.apps.evaluations.uploadEvaluationAudio",
                      "response": {
                        "$ref": "UploadEvaluationAudioResponse"
                      },
                      "httpMethod": "POST"
                    },
                    "create": {
                      "httpMethod": "POST",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "request": {
                        "$ref": "Evaluation"
                      },
                      "response": {
                        "$ref": "Evaluation"
                      },
                      "path": "v1beta/{+parent}/evaluations",
                      "parameterOrder": [
                        "parent"
                      ],
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/evaluations",
                      "id": "ces.projects.locations.apps.evaluations.create",
                      "description": "Creates an evaluation.",
                      "parameters": {
                        "evaluationId": {
                          "location": "query",
                          "type": "string",
                          "description": "Optional. The ID to use for the evaluation, which will become the final component of the evaluation's resource name. If not provided, a unique ID will be automatically assigned for the evaluation."
                        },
                        "parent": {
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
                          "required": true,
                          "description": "Required. The app to create the evaluation for. Format: `projects/{project}/locations/{location}/apps/{app}`",
                          "type": "string",
                          "location": "path"
                        }
                      }
                    },
                    "list": {
                      "description": "Lists all evaluations in the given app.",
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/evaluations",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "id": "ces.projects.locations.apps.evaluations.list",
                      "httpMethod": "GET",
                      "parameterOrder": [
                        "parent"
                      ],
                      "parameters": {
                        "pageSize": {
                          "type": "integer",
                          "location": "query",
                          "format": "int32",
                          "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default."
                        },
                        "evaluationRunFilter": {
                          "location": "query",
                          "description": "Optional. Filter string for fields on the associated EvaluationRun resources. See https://google.aip.dev/160 for more details. Supported fields: create_time, initiated_by, app_version_display_name",
                          "type": "string"
                        },
                        "lastTenResults": {
                          "location": "query",
                          "description": "Optional. Whether to include the last 10 evaluation results for each evaluation in the response.",
                          "type": "boolean"
                        },
                        "pageToken": {
                          "location": "query",
                          "description": "Optional. The next_page_token value returned from a previous list EvaluationService.ListEvaluations call.",
                          "type": "string"
                        },
                        "orderBy": {
                          "type": "string",
                          "location": "query",
                          "description": "Optional. Field to sort by. Only \"name\" and \"create_time\", and \"update_time\" are supported. Time fields are ordered in descending order, and the name field is ordered in ascending order. If not included, \"update_time\" will be the default. See https://google.aip.dev/132#ordering for more details."
                        },
                        "evaluationFilter": {
                          "description": "Optional. Filter to be applied on the evaluation when listing the evaluations. See https://google.aip.dev/160 for more details. Supported fields: evaluation_datasets",
                          "type": "string",
                          "location": "query"
                        },
                        "parent": {
                          "required": true,
                          "description": "Required. The resource name of the app to list evaluations from.",
                          "location": "path",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
                          "type": "string"
                        },
                        "filter": {
                          "location": "query",
                          "type": "string",
                          "deprecated": true,
                          "description": "Optional. Deprecated: Use evaluation_filter and evaluation_run_filter instead."
                        }
                      },
                      "response": {
                        "$ref": "ListEvaluationsResponse"
                      },
                      "path": "v1beta/{+parent}/evaluations"
                    },
                    "get": {
                      "httpMethod": "GET",
                      "description": "Gets details of the specified evaluation.",
                      "path": "v1beta/{+name}",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "response": {
                        "$ref": "Evaluation"
                      },
                      "parameters": {
                        "name": {
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/evaluations/[^/]+$",
                          "location": "path",
                          "description": "Required. The resource name of the evaluation to retrieve.",
                          "required": true,
                          "type": "string"
                        }
                      },
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/evaluations/{evaluationsId}",
                      "parameterOrder": [
                        "name"
                      ],
                      "id": "ces.projects.locations.apps.evaluations.get"
                    },
                    "patch": {
                      "parameters": {
                        "updateMask": {
                          "type": "string",
                          "description": "Optional. Field mask is used to control which fields get updated. If the mask is not present, all fields will be updated.",
                          "format": "google-fieldmask",
                          "location": "query"
                        },
                        "name": {
                          "location": "path",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/evaluations/[^/]+$",
                          "type": "string",
                          "description": "Identifier. The unique identifier of this evaluation. Format: `projects/{project}/locations/{location}/apps/{app}/evaluations/{evaluation}`",
                          "required": true
                        }
                      },
                      "description": "Updates an evaluation.",
                      "id": "ces.projects.locations.apps.evaluations.patch",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "request": {
                        "$ref": "Evaluation"
                      },
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/evaluations/{evaluationsId}",
                      "httpMethod": "PATCH",
                      "parameterOrder": [
                        "name"
                      ],
                      "path": "v1beta/{+name}",
                      "response": {
                        "$ref": "Evaluation"
                      }
                    },
                    "delete": {
                      "path": "v1beta/{+name}",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "id": "ces.projects.locations.apps.evaluations.delete",
                      "description": "Deletes an evaluation.",
                      "httpMethod": "DELETE",
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/evaluations/{evaluationsId}",
                      "parameterOrder": [
                        "name"
                      ],
                      "response": {
                        "$ref": "Empty"
                      },
                      "parameters": {
                        "force": {
                          "type": "boolean",
                          "location": "query",
                          "description": "Optional. Indicates whether to forcefully delete the evaluation, even if it is still referenced by evaluation datasets. * If `force = false`, the deletion will fail if any datasets still reference the evaluation. * If `force = true`, all existing references from datasets will be removed and the evaluation will be deleted."
                        },
                        "name": {
                          "required": true,
                          "description": "Required. The resource name of the evaluation to delete.",
                          "type": "string",
                          "location": "path",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/evaluations/[^/]+$"
                        },
                        "etag": {
                          "type": "string",
                          "location": "query",
                          "description": "Optional. The current etag of the evaluation. If an etag is not provided, the deletion will overwrite any concurrent changes. If an etag is provided and does not match the current etag of the evaluation, deletion will be blocked and an ABORTED error will be returned."
                        }
                      }
                    }
                  },
                  "resources": {
                    "results": {
                      "methods": {
                        "get": {
                          "description": "Gets details of the specified evaluation result.",
                          "scopes": [
                            "https://www.googleapis.com/auth/ces",
                            "https://www.googleapis.com/auth/cloud-platform"
                          ],
                          "httpMethod": "GET",
                          "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/evaluations/{evaluationsId}/results/{resultsId}",
                          "response": {
                            "$ref": "EvaluationResult"
                          },
                          "id": "ces.projects.locations.apps.evaluations.results.get",
                          "path": "v1beta/{+name}",
                          "parameters": {
                            "name": {
                              "description": "Required. The resource name of the evaluation result to retrieve.",
                              "location": "path",
                              "required": true,
                              "type": "string",
                              "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/evaluations/[^/]+/results/[^/]+$"
                            }
                          },
                          "parameterOrder": [
                            "name"
                          ]
                        },
                        "list": {
                          "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/evaluations/{evaluationsId}/results",
                          "httpMethod": "GET",
                          "id": "ces.projects.locations.apps.evaluations.results.list",
                          "description": "Lists all evaluation results for a given evaluation.",
                          "path": "v1beta/{+parent}/results",
                          "parameters": {
                            "pageSize": {
                              "type": "integer",
                              "format": "int32",
                              "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.",
                              "location": "query"
                            },
                            "parent": {
                              "location": "path",
                              "type": "string",
                              "required": true,
                              "description": "Required. The resource name of the evaluation to list evaluation results from. To filter by evaluation run, use `-` as the evaluation ID and specify the evaluation run ID in the filter. For example: `projects/{project}/locations/{location}/apps/{app}/evaluations/-`",
                              "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/evaluations/[^/]+$"
                            },
                            "filter": {
                              "type": "string",
                              "location": "query",
                              "description": "Optional. Filter to be applied when listing the evaluation results. See https://google.aip.dev/160 for more details."
                            },
                            "orderBy": {
                              "location": "query",
                              "type": "string",
                              "description": "Optional. Field to sort by. Only \"name\" and \"create_time\", and \"update_time\" are supported. Time fields are ordered in descending order, and the name field is ordered in ascending order. If not included, \"update_time\" will be the default. See https://google.aip.dev/132#ordering for more details."
                            },
                            "pageToken": {
                              "location": "query",
                              "type": "string",
                              "description": "Optional. The next_page_token value returned from a previous list EvaluationService.ListEvaluationResults call."
                            }
                          },
                          "scopes": [
                            "https://www.googleapis.com/auth/ces",
                            "https://www.googleapis.com/auth/cloud-platform"
                          ],
                          "response": {
                            "$ref": "ListEvaluationResultsResponse"
                          },
                          "parameterOrder": [
                            "parent"
                          ]
                        },
                        "export": {
                          "request": {
                            "$ref": "ExportEvaluationResultsRequest"
                          },
                          "parameterOrder": [
                            "parent"
                          ],
                          "parameters": {
                            "parent": {
                              "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/evaluations/[^/]+$",
                              "type": "string",
                              "location": "path",
                              "description": "Required. The resource name of the evaluation to export evaluation results from. Format: `projects/{project}/locations/{location}/apps/{app}/evaluations/{evaluation}`",
                              "required": true
                            }
                          },
                          "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/evaluations/{evaluationsId}/results:export",
                          "description": "Exports evaluations results.",
                          "response": {
                            "$ref": "Operation"
                          },
                          "id": "ces.projects.locations.apps.evaluations.results.export",
                          "scopes": [
                            "https://www.googleapis.com/auth/ces",
                            "https://www.googleapis.com/auth/cloud-platform"
                          ],
                          "httpMethod": "POST",
                          "path": "v1beta/{+parent}/results:export"
                        },
                        "runEvaluationResultMetrics": {
                          "scopes": [
                            "https://www.googleapis.com/auth/ces",
                            "https://www.googleapis.com/auth/cloud-platform"
                          ],
                          "description": "Runs metrics on an existing evaluation result.",
                          "response": {
                            "$ref": "Operation"
                          },
                          "path": "v1beta/{+evaluationResultId}:runEvaluationResultMetrics",
                          "parameters": {
                            "evaluationResultId": {
                              "location": "path",
                              "required": true,
                              "description": "Required. The evaluation result to run metrics for. Format: `projects/{project}/locations/{location}/apps/{app}/evaluations/{evaluation}/results/{evaluation_result_id}`",
                              "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/evaluations/[^/]+/results/[^/]+$",
                              "type": "string"
                            }
                          },
                          "parameterOrder": [
                            "evaluationResultId"
                          ],
                          "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/evaluations/{evaluationsId}/results/{resultsId}:runEvaluationResultMetrics",
                          "id": "ces.projects.locations.apps.evaluations.results.runEvaluationResultMetrics",
                          "request": {
                            "$ref": "RunEvaluationResultMetricsRequest"
                          },
                          "httpMethod": "POST"
                        },
                        "delete": {
                          "description": "Deletes an evaluation result.",
                          "httpMethod": "DELETE",
                          "parameterOrder": [
                            "name"
                          ],
                          "path": "v1beta/{+name}",
                          "response": {
                            "$ref": "Empty"
                          },
                          "scopes": [
                            "https://www.googleapis.com/auth/ces",
                            "https://www.googleapis.com/auth/cloud-platform"
                          ],
                          "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/evaluations/{evaluationsId}/results/{resultsId}",
                          "parameters": {
                            "name": {
                              "location": "path",
                              "required": true,
                              "type": "string",
                              "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/evaluations/[^/]+/results/[^/]+$",
                              "description": "Required. The resource name of the evaluation result to delete."
                            }
                          },
                          "id": "ces.projects.locations.apps.evaluations.results.delete"
                        }
                      }
                    }
                  }
                },
                "evaluationDatasets": {
                  "methods": {
                    "list": {
                      "httpMethod": "GET",
                      "parameterOrder": [
                        "parent"
                      ],
                      "response": {
                        "$ref": "ListEvaluationDatasetsResponse"
                      },
                      "description": "Lists all evaluation datasets in the given app.",
                      "id": "ces.projects.locations.apps.evaluationDatasets.list",
                      "parameters": {
                        "pageSize": {
                          "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.",
                          "format": "int32",
                          "type": "integer",
                          "location": "query"
                        },
                        "orderBy": {
                          "location": "query",
                          "type": "string",
                          "description": "Optional. Field to sort by. Only \"name\" and \"create_time\", and \"update_time\" are supported. Time fields are ordered in descending order, and the name field is ordered in ascending order. If not included, \"update_time\" will be the default. See https://google.aip.dev/132#ordering for more details."
                        },
                        "parent": {
                          "type": "string",
                          "location": "path",
                          "required": true,
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
                          "description": "Required. The resource name of the app to list evaluation datasets from."
                        },
                        "filter": {
                          "location": "query",
                          "description": "Optional. Filter to be applied when listing the evaluation datasets. See https://google.aip.dev/160 for more details.",
                          "type": "string"
                        },
                        "pageToken": {
                          "description": "Optional. The next_page_token value returned from a previous list EvaluationService.ListEvaluationDatasets call.",
                          "location": "query",
                          "type": "string"
                        }
                      },
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/evaluationDatasets",
                      "path": "v1beta/{+parent}/evaluationDatasets"
                    },
                    "create": {
                      "request": {
                        "$ref": "EvaluationDataset"
                      },
                      "id": "ces.projects.locations.apps.evaluationDatasets.create",
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/evaluationDatasets",
                      "description": "Creates an evaluation dataset.",
                      "parameterOrder": [
                        "parent"
                      ],
                      "httpMethod": "POST",
                      "path": "v1beta/{+parent}/evaluationDatasets",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "parameters": {
                        "parent": {
                          "required": true,
                          "type": "string",
                          "description": "Required. The app to create the evaluation for. Format: `projects/{project}/locations/{location}/apps/{app}`",
                          "location": "path",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$"
                        },
                        "evaluationDatasetId": {
                          "location": "query",
                          "type": "string",
                          "description": "Optional. The ID to use for the evaluation dataset, which will become the final component of the evaluation dataset's resource name. If not provided, a unique ID will be automatically assigned for the evaluation."
                        }
                      },
                      "response": {
                        "$ref": "EvaluationDataset"
                      }
                    },
                    "get": {
                      "response": {
                        "$ref": "EvaluationDataset"
                      },
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "path": "v1beta/{+name}",
                      "parameterOrder": [
                        "name"
                      ],
                      "description": "Gets details of the specified evaluation dataset.",
                      "parameters": {
                        "name": {
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/evaluationDatasets/[^/]+$",
                          "description": "Required. The resource name of the evaluation dataset to retrieve.",
                          "required": true,
                          "type": "string",
                          "location": "path"
                        }
                      },
                      "id": "ces.projects.locations.apps.evaluationDatasets.get",
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/evaluationDatasets/{evaluationDatasetsId}",
                      "httpMethod": "GET"
                    },
                    "delete": {
                      "response": {
                        "$ref": "Empty"
                      },
                      "parameters": {
                        "name": {
                          "description": "Required. The resource name of the evaluation dataset to delete.",
                          "required": true,
                          "location": "path",
                          "type": "string",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/evaluationDatasets/[^/]+$"
                        },
                        "etag": {
                          "description": "Optional. The current etag of the evaluation dataset. If an etag is not provided, the deletion will overwrite any concurrent changes. If an etag is provided and does not match the current etag of the evaluation dataset, deletion will be blocked and an ABORTED error will be returned.",
                          "location": "query",
                          "type": "string"
                        }
                      },
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "parameterOrder": [
                        "name"
                      ],
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/evaluationDatasets/{evaluationDatasetsId}",
                      "path": "v1beta/{+name}",
                      "description": "Deletes an evaluation dataset.",
                      "id": "ces.projects.locations.apps.evaluationDatasets.delete",
                      "httpMethod": "DELETE"
                    },
                    "patch": {
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "id": "ces.projects.locations.apps.evaluationDatasets.patch",
                      "parameterOrder": [
                        "name"
                      ],
                      "response": {
                        "$ref": "EvaluationDataset"
                      },
                      "httpMethod": "PATCH",
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/evaluationDatasets/{evaluationDatasetsId}",
                      "request": {
                        "$ref": "EvaluationDataset"
                      },
                      "path": "v1beta/{+name}",
                      "parameters": {
                        "name": {
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/evaluationDatasets/[^/]+$",
                          "location": "path",
                          "type": "string",
                          "description": "Identifier. The unique identifier of this evaluation dataset. Format: `projects/{project}/locations/{location}/apps/{app}/evaluationDatasets/{evaluationDataset}`",
                          "required": true
                        },
                        "updateMask": {
                          "format": "google-fieldmask",
                          "location": "query",
                          "type": "string",
                          "description": "Optional. Field mask is used to control which fields get updated. If the mask is not present, all fields will be updated."
                        }
                      },
                      "description": "Updates an evaluation dataset."
                    }
                  }
                },
                "guardrails": {
                  "methods": {
                    "delete": {
                      "description": "Deletes the specified guardrail.",
                      "response": {
                        "$ref": "Empty"
                      },
                      "parameters": {
                        "name": {
                          "type": "string",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/guardrails/[^/]+$",
                          "location": "path",
                          "required": true,
                          "description": "Required. The resource name of the guardrail to delete."
                        },
                        "etag": {
                          "location": "query",
                          "description": "Optional. The current etag of the guardrail. If an etag is not provided, the deletion will overwrite any concurrent changes. If an etag is provided and does not match the current etag of the guardrail, deletion will be blocked and an ABORTED error will be returned.",
                          "type": "string"
                        },
                        "force": {
                          "type": "boolean",
                          "description": "Optional. Indicates whether to forcefully delete the guardrail, even if it is still referenced by app/agents. * If `force = false`, the deletion fails if any apps/agents still reference the guardrail. * If `force = true`, all existing references from apps/agents will be removed and the guardrail will be deleted.",
                          "location": "query"
                        }
                      },
                      "parameterOrder": [
                        "name"
                      ],
                      "path": "v1beta/{+name}",
                      "httpMethod": "DELETE",
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/guardrails/{guardrailsId}",
                      "id": "ces.projects.locations.apps.guardrails.delete",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ]
                    },
                    "list": {
                      "id": "ces.projects.locations.apps.guardrails.list",
                      "httpMethod": "GET",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "response": {
                        "$ref": "ListGuardrailsResponse"
                      },
                      "description": "Lists guardrails in the given app.",
                      "parameterOrder": [
                        "parent"
                      ],
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/guardrails",
                      "path": "v1beta/{+parent}/guardrails",
                      "parameters": {
                        "pageToken": {
                          "type": "string",
                          "description": "Optional. The next_page_token value returned from a previous list AgentService.ListGuardrails call.",
                          "location": "query"
                        },
                        "pageSize": {
                          "location": "query",
                          "format": "int32",
                          "type": "integer",
                          "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default."
                        },
                        "parent": {
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
                          "type": "string",
                          "location": "path",
                          "description": "Required. The resource name of the app to list guardrails from.",
                          "required": true
                        },
                        "filter": {
                          "description": "Optional. Filter to be applied when listing the guardrails. See https://google.aip.dev/160 for more details.",
                          "type": "string",
                          "location": "query"
                        },
                        "orderBy": {
                          "location": "query",
                          "type": "string",
                          "description": "Optional. Field to sort by. Only \"name\" and \"create_time\" is supported. See https://google.aip.dev/132#ordering for more details."
                        }
                      }
                    },
                    "get": {
                      "id": "ces.projects.locations.apps.guardrails.get",
                      "parameters": {
                        "name": {
                          "description": "Required. The resource name of the guardrail to retrieve.",
                          "location": "path",
                          "required": true,
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/guardrails/[^/]+$",
                          "type": "string"
                        }
                      },
                      "parameterOrder": [
                        "name"
                      ],
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "path": "v1beta/{+name}",
                      "response": {
                        "$ref": "Guardrail"
                      },
                      "httpMethod": "GET",
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/guardrails/{guardrailsId}",
                      "description": "Gets details of the specified guardrail."
                    },
                    "create": {
                      "description": "Creates a new guardrail in the given app.",
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/guardrails",
                      "parameters": {
                        "parent": {
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
                          "type": "string",
                          "description": "Required. The resource name of the app to create a guardrail in.",
                          "location": "path",
                          "required": true
                        },
                        "guardrailId": {
                          "type": "string",
                          "description": "Optional. The ID to use for the guardrail, which will become the final component of the guardrail's resource name. If not provided, a unique ID will be automatically assigned for the guardrail.",
                          "location": "query"
                        }
                      },
                      "parameterOrder": [
                        "parent"
                      ],
                      "id": "ces.projects.locations.apps.guardrails.create",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "path": "v1beta/{+parent}/guardrails",
                      "httpMethod": "POST",
                      "response": {
                        "$ref": "Guardrail"
                      },
                      "request": {
                        "$ref": "Guardrail"
                      }
                    },
                    "patch": {
                      "parameters": {
                        "updateMask": {
                          "type": "string",
                          "description": "Optional. Field mask is used to control which fields get updated. If the mask is not present, all fields will be updated.",
                          "location": "query",
                          "format": "google-fieldmask"
                        },
                        "name": {
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/guardrails/[^/]+$",
                          "description": "Identifier. The unique identifier of the guardrail. Format: `projects/{project}/locations/{location}/apps/{app}/guardrails/{guardrail}`",
                          "location": "path",
                          "type": "string",
                          "required": true
                        }
                      },
                      "path": "v1beta/{+name}",
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/guardrails/{guardrailsId}",
                      "id": "ces.projects.locations.apps.guardrails.patch",
                      "parameterOrder": [
                        "name"
                      ],
                      "response": {
                        "$ref": "Guardrail"
                      },
                      "httpMethod": "PATCH",
                      "request": {
                        "$ref": "Guardrail"
                      },
                      "description": "Updates the specified guardrail.",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ]
                    }
                  }
                },
                "agents": {
                  "methods": {
                    "list": {
                      "response": {
                        "$ref": "ListAgentsResponse"
                      },
                      "path": "v1beta/{+parent}/agents",
                      "httpMethod": "GET",
                      "description": "Lists agents in the given app.",
                      "id": "ces.projects.locations.apps.agents.list",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/agents",
                      "parameterOrder": [
                        "parent"
                      ],
                      "parameters": {
                        "pageToken": {
                          "location": "query",
                          "type": "string",
                          "description": "Optional. The next_page_token value returned from a previous list AgentService.ListAgents call."
                        },
                        "parent": {
                          "location": "path",
                          "type": "string",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
                          "required": true,
                          "description": "Required. The resource name of the app to list agents from."
                        },
                        "filter": {
                          "location": "query",
                          "type": "string",
                          "description": "Optional. Filter to be applied when listing the agents. See https://google.aip.dev/160 for more details."
                        },
                        "pageSize": {
                          "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.",
                          "type": "integer",
                          "format": "int32",
                          "location": "query"
                        },
                        "orderBy": {
                          "type": "string",
                          "description": "Optional. Field to sort by. Only \"name\" and \"create_time\" is supported. See https://google.aip.dev/132#ordering for more details.",
                          "location": "query"
                        }
                      }
                    },
                    "create": {
                      "description": "Creates a new agent in the given app.",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "response": {
                        "$ref": "Agent"
                      },
                      "httpMethod": "POST",
                      "parameterOrder": [
                        "parent"
                      ],
                      "id": "ces.projects.locations.apps.agents.create",
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/agents",
                      "path": "v1beta/{+parent}/agents",
                      "request": {
                        "$ref": "Agent"
                      },
                      "parameters": {
                        "agentId": {
                          "type": "string",
                          "location": "query",
                          "description": "Optional. The ID to use for the agent, which will become the final component of the agent's resource name. If not provided, a unique ID will be automatically assigned for the agent."
                        },
                        "parent": {
                          "location": "path",
                          "description": "Required. The resource name of the app to create an agent in.",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
                          "required": true,
                          "type": "string"
                        }
                      }
                    },
                    "patch": {
                      "path": "v1beta/{+name}",
                      "httpMethod": "PATCH",
                      "parameterOrder": [
                        "name"
                      ],
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/agents/{agentsId}",
                      "request": {
                        "$ref": "Agent"
                      },
                      "parameters": {
                        "updateMask": {
                          "format": "google-fieldmask",
                          "location": "query",
                          "type": "string",
                          "description": "Optional. Field mask is used to control which fields get updated. If the mask is not present, all fields will be updated."
                        },
                        "name": {
                          "description": "Identifier. The unique identifier of the agent. Format: `projects/{project}/locations/{location}/apps/{app}/agents/{agent}`",
                          "required": true,
                          "type": "string",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/agents/[^/]+$",
                          "location": "path"
                        }
                      },
                      "response": {
                        "$ref": "Agent"
                      },
                      "description": "Updates the specified agent.",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "id": "ces.projects.locations.apps.agents.patch"
                    },
                    "delete": {
                      "id": "ces.projects.locations.apps.agents.delete",
                      "httpMethod": "DELETE",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/agents/{agentsId}",
                      "description": "Deletes the specified agent.",
                      "parameterOrder": [
                        "name"
                      ],
                      "path": "v1beta/{+name}",
                      "parameters": {
                        "force": {
                          "type": "boolean",
                          "description": "Optional. Indicates whether to forcefully delete the agent, even if it is still referenced by other app/agents/examples. * If `force = false`, the deletion fails if other agents/examples reference it. * If `force = true`, delete the agent and remove it from all referencing apps/agents/examples.",
                          "location": "query"
                        },
                        "name": {
                          "required": true,
                          "location": "path",
                          "description": "Required. The resource name of the agent to delete.",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/agents/[^/]+$",
                          "type": "string"
                        },
                        "etag": {
                          "description": "Optional. The current etag of the agent. If an etag is not provided, the deletion will overwrite any concurrent changes. If an etag is provided and does not match the current etag of the agent, deletion will be blocked and an ABORTED error will be returned.",
                          "type": "string",
                          "location": "query"
                        }
                      },
                      "response": {
                        "$ref": "Empty"
                      }
                    },
                    "get": {
                      "path": "v1beta/{+name}",
                      "httpMethod": "GET",
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/agents/{agentsId}",
                      "response": {
                        "$ref": "Agent"
                      },
                      "description": "Gets details of the specified agent.",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "parameters": {
                        "name": {
                          "location": "path",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/agents/[^/]+$",
                          "required": true,
                          "description": "Required. The resource name of the agent to retrieve.",
                          "type": "string"
                        }
                      },
                      "parameterOrder": [
                        "name"
                      ],
                      "id": "ces.projects.locations.apps.agents.get"
                    }
                  }
                },
                "deployments": {
                  "resources": {
                    "message": {
                      "methods": {
                        "send": {
                          "id": "ces.projects.locations.apps.deployments.message.send",
                          "scopes": [
                            "https://www.googleapis.com/auth/ces",
                            "https://www.googleapis.com/auth/cloud-platform"
                          ],
                          "parameters": {
                            "tenant": {
                              "required": true,
                              "type": "string",
                              "location": "path",
                              "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/deployments/[^/]+$",
                              "description": "Optional. Opaque routing identifier. Must match the `tenant` value from the selected `AgentInterface` in the Agent Card when that field is set."
                            }
                          },
                          "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/deployments/{deploymentsId}/message:send",
                          "path": "v1beta/{+tenant}/message:send",
                          "description": "Sends a message to an agent.",
                          "httpMethod": "POST",
                          "request": {
                            "$ref": "LfA2aV1SendMessageRequest"
                          },
                          "response": {
                            "$ref": "LfA2aV1SendMessageResponse"
                          },
                          "parameterOrder": [
                            "tenant"
                          ]
                        },
                        "stream": {
                          "path": "v1beta/{+tenant}/message:stream",
                          "description": "Sends a streaming message to an agent, allowing for real-time interaction and status updates. Streaming version of `SendMessage`",
                          "scopes": [
                            "https://www.googleapis.com/auth/ces",
                            "https://www.googleapis.com/auth/cloud-platform"
                          ],
                          "httpMethod": "POST",
                          "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/deployments/{deploymentsId}/message:stream",
                          "response": {
                            "$ref": "LfA2aV1StreamResponse"
                          },
                          "request": {
                            "$ref": "LfA2aV1SendMessageRequest"
                          },
                          "parameters": {
                            "tenant": {
                              "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/deployments/[^/]+$",
                              "description": "Optional. Opaque routing identifier. Must match the `tenant` value from the selected `AgentInterface` in the Agent Card when that field is set.",
                              "location": "path",
                              "type": "string",
                              "required": true
                            }
                          },
                          "id": "ces.projects.locations.apps.deployments.message.stream",
                          "parameterOrder": [
                            "tenant"
                          ]
                        }
                      }
                    }
                  },
                  "methods": {
                    "get": {
                      "parameters": {
                        "name": {
                          "required": true,
                          "location": "path",
                          "description": "Required. The name of the deployment. Format: `projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}`",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/deployments/[^/]+$",
                          "type": "string"
                        }
                      },
                      "id": "ces.projects.locations.apps.deployments.get",
                      "path": "v1beta/{+name}",
                      "response": {
                        "$ref": "Deployment"
                      },
                      "httpMethod": "GET",
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/deployments/{deploymentsId}",
                      "parameterOrder": [
                        "name"
                      ],
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "description": "Gets details of the specified deployment."
                    },
                    "getExtendedAgentCard": {
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "id": "ces.projects.locations.apps.deployments.getExtendedAgentCard",
                      "parameters": {
                        "tenant": {
                          "required": true,
                          "location": "path",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/deployments/[^/]+$",
                          "type": "string",
                          "description": "Optional. Opaque routing identifier. Must match the `tenant` value from the selected `AgentInterface` in the Agent Card when that field is set."
                        }
                      },
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/deployments/{deploymentsId}/extendedAgentCard",
                      "parameterOrder": [
                        "tenant"
                      ],
                      "response": {
                        "$ref": "LfA2aV1AgentCard"
                      },
                      "path": "v1beta/{+tenant}/extendedAgentCard",
                      "httpMethod": "GET",
                      "description": "Gets the extended agent card for the authenticated agent."
                    },
                    "create": {
                      "httpMethod": "POST",
                      "response": {
                        "$ref": "Deployment"
                      },
                      "parameterOrder": [
                        "parent"
                      ],
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/deployments",
                      "parameters": {
                        "parent": {
                          "required": true,
                          "description": "Required. The parent app. Format: `projects/{project}/locations/{location}/apps/{app}`",
                          "location": "path",
                          "type": "string",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$"
                        },
                        "deploymentId": {
                          "type": "string",
                          "description": "Optional. The ID to use for the deployment, which will become the final component of the deployment's resource name. If not provided, a unique ID will be automatically assigned for the deployment.",
                          "location": "query"
                        }
                      },
                      "description": "Creates a new deployment in the given app.",
                      "id": "ces.projects.locations.apps.deployments.create",
                      "path": "v1beta/{+parent}/deployments",
                      "request": {
                        "$ref": "Deployment"
                      }
                    },
                    "delete": {
                      "parameters": {
                        "name": {
                          "type": "string",
                          "location": "path",
                          "required": true,
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/deployments/[^/]+$",
                          "description": "Required. The name of the deployment to delete. Format: `projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}`"
                        },
                        "etag": {
                          "location": "query",
                          "type": "string",
                          "description": "Optional. The etag of the deployment. If an etag is provided and does not match the current etag of the deployment, deletion will be blocked and an ABORTED error will be returned."
                        }
                      },
                      "path": "v1beta/{+name}",
                      "response": {
                        "$ref": "Empty"
                      },
                      "parameterOrder": [
                        "name"
                      ],
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "httpMethod": "DELETE",
                      "description": "Deletes the specified deployment.",
                      "id": "ces.projects.locations.apps.deployments.delete",
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/deployments/{deploymentsId}"
                    },
                    "list": {
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/deployments",
                      "id": "ces.projects.locations.apps.deployments.list",
                      "httpMethod": "GET",
                      "description": "Lists deployments in the given app.",
                      "parameterOrder": [
                        "parent"
                      ],
                      "path": "v1beta/{+parent}/deployments",
                      "parameters": {
                        "parent": {
                          "required": true,
                          "description": "Required. The parent app. Format: `projects/{project}/locations/{location}/apps/{app}`",
                          "location": "path",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
                          "type": "string"
                        },
                        "pageSize": {
                          "format": "int32",
                          "type": "integer",
                          "description": "Optional. The maximum number of deployments to return. The service may return fewer than this value. If unspecified, at most 50 deployments will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.",
                          "location": "query"
                        },
                        "orderBy": {
                          "type": "string",
                          "description": "Optional. Field to sort by. Only \"name\" and \"create_time\" is supported. See https://google.aip.dev/132#ordering for more details.",
                          "location": "query"
                        },
                        "pageToken": {
                          "location": "query",
                          "type": "string",
                          "description": "Optional. A page token, received from a previous `ListDeployments` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListDeployments` must match the call that provided the page token."
                        }
                      },
                      "response": {
                        "$ref": "ListDeploymentsResponse"
                      },
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ]
                    },
                    "patch": {
                      "response": {
                        "$ref": "Deployment"
                      },
                      "path": "v1beta/{+name}",
                      "request": {
                        "$ref": "Deployment"
                      },
                      "parameters": {
                        "updateMask": {
                          "format": "google-fieldmask",
                          "description": "Optional. The list of fields to update.",
                          "location": "query",
                          "type": "string"
                        },
                        "name": {
                          "location": "path",
                          "description": "Identifier. The resource name of the deployment. Format: `projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}`",
                          "required": true,
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/deployments/[^/]+$",
                          "type": "string"
                        }
                      },
                      "id": "ces.projects.locations.apps.deployments.patch",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "parameterOrder": [
                        "name"
                      ],
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/deployments/{deploymentsId}",
                      "httpMethod": "PATCH",
                      "description": "Updates the specified deployment."
                    }
                  }
                },
                "scheduledEvaluationRuns": {
                  "methods": {
                    "get": {
                      "parameterOrder": [
                        "name"
                      ],
                      "path": "v1beta/{+name}",
                      "id": "ces.projects.locations.apps.scheduledEvaluationRuns.get",
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/scheduledEvaluationRuns/{scheduledEvaluationRunsId}",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "parameters": {
                        "name": {
                          "description": "Required. The resource name of the scheduled evaluation run to retrieve.",
                          "type": "string",
                          "required": true,
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/scheduledEvaluationRuns/[^/]+$",
                          "location": "path"
                        }
                      },
                      "description": "Gets details of the specified scheduled evaluation run.",
                      "response": {
                        "$ref": "ScheduledEvaluationRun"
                      },
                      "httpMethod": "GET"
                    },
                    "list": {
                      "parameters": {
                        "pageToken": {
                          "description": "Optional. The next_page_token value returned from a previous list EvaluationService.ListScheduledEvaluationRuns call.",
                          "type": "string",
                          "location": "query"
                        },
                        "pageSize": {
                          "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.",
                          "format": "int32",
                          "location": "query",
                          "type": "integer"
                        },
                        "orderBy": {
                          "location": "query",
                          "description": "Optional. Field to sort by. Supported fields are: \"name\" (ascending), \"create_time\" (descending), \"update_time\" (descending), \"next_scheduled_execution\" (ascending), and \"last_completed_run.create_time\" (descending). If not included, \"update_time\" will be the default. See https://google.aip.dev/132#ordering for more details.",
                          "type": "string"
                        },
                        "parent": {
                          "location": "path",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
                          "required": true,
                          "type": "string",
                          "description": "Required. The resource name of the app to list scheduled evaluation runs from."
                        },
                        "filter": {
                          "type": "string",
                          "location": "query",
                          "description": "Optional. Filter to be applied when listing the scheduled evaluation runs. See https://google.aip.dev/160 for more details. Currently supports filtering by: * request.evaluations:evaluation_id * request.evaluation_dataset:evaluation_dataset_id"
                        }
                      },
                      "description": "Lists all scheduled evaluation runs in the given app.",
                      "response": {
                        "$ref": "ListScheduledEvaluationRunsResponse"
                      },
                      "id": "ces.projects.locations.apps.scheduledEvaluationRuns.list",
                      "path": "v1beta/{+parent}/scheduledEvaluationRuns",
                      "httpMethod": "GET",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "parameterOrder": [
                        "parent"
                      ],
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/scheduledEvaluationRuns"
                    },
                    "delete": {
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "parameterOrder": [
                        "name"
                      ],
                      "response": {
                        "$ref": "Empty"
                      },
                      "parameters": {
                        "name": {
                          "type": "string",
                          "required": true,
                          "description": "Required. The resource name of the scheduled evaluation run to delete.",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/scheduledEvaluationRuns/[^/]+$",
                          "location": "path"
                        },
                        "etag": {
                          "type": "string",
                          "location": "query",
                          "description": "Optional. The etag of the ScheduledEvaluationRun. If provided, it must match the server's etag."
                        }
                      },
                      "description": "Deletes a scheduled evaluation run.",
                      "id": "ces.projects.locations.apps.scheduledEvaluationRuns.delete",
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/scheduledEvaluationRuns/{scheduledEvaluationRunsId}",
                      "path": "v1beta/{+name}",
                      "httpMethod": "DELETE"
                    },
                    "patch": {
                      "id": "ces.projects.locations.apps.scheduledEvaluationRuns.patch",
                      "request": {
                        "$ref": "ScheduledEvaluationRun"
                      },
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/scheduledEvaluationRuns/{scheduledEvaluationRunsId}",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "parameterOrder": [
                        "name"
                      ],
                      "httpMethod": "PATCH",
                      "response": {
                        "$ref": "ScheduledEvaluationRun"
                      },
                      "description": "Updates a scheduled evaluation run.",
                      "path": "v1beta/{+name}",
                      "parameters": {
                        "updateMask": {
                          "description": "Optional. Field mask is used to control which fields get updated. If the mask is not present, all fields will be updated.",
                          "type": "string",
                          "format": "google-fieldmask",
                          "location": "query"
                        },
                        "name": {
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/scheduledEvaluationRuns/[^/]+$",
                          "required": true,
                          "location": "path",
                          "description": "Identifier. The unique identifier of the scheduled evaluation run config. Format: projects/{projectId}/locations/{locationId}/apps/{appId}/scheduledEvaluationRuns/{scheduledEvaluationRunId}",
                          "type": "string"
                        }
                      }
                    },
                    "create": {
                      "parameterOrder": [
                        "parent"
                      ],
                      "id": "ces.projects.locations.apps.scheduledEvaluationRuns.create",
                      "response": {
                        "$ref": "ScheduledEvaluationRun"
                      },
                      "request": {
                        "$ref": "ScheduledEvaluationRun"
                      },
                      "httpMethod": "POST",
                      "path": "v1beta/{+parent}/scheduledEvaluationRuns",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "description": "Creates a scheduled evaluation run.",
                      "parameters": {
                        "parent": {
                          "type": "string",
                          "location": "path",
                          "description": "Required. The app to create the scheduled evaluation run for. Format: `projects/{project}/locations/{location}/apps/{app}`",
                          "required": true,
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$"
                        },
                        "scheduledEvaluationRunId": {
                          "type": "string",
                          "description": "Optional. The ID to use for the scheduled evaluation run, which will become the final component of the scheduled evaluation run's resource name. If not provided, a unique ID will be automatically assigned.",
                          "location": "query"
                        }
                      },
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/scheduledEvaluationRuns"
                    }
                  }
                },
                "assistantSessions": {
                  "methods": {
                    "delete": {
                      "parameters": {
                        "name": {
                          "type": "string",
                          "description": "Required. The name of the assistant session to delete. Format: `projects/{project}/locations/{location}/apps/{app}/assistantSessions/{assistant_session}`",
                          "required": true,
                          "location": "path",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/assistantSessions/[^/]+$"
                        }
                      },
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "path": "v1beta/{+name}",
                      "response": {
                        "$ref": "Empty"
                      },
                      "parameterOrder": [
                        "name"
                      ],
                      "description": "Deletes the specified assistant session.",
                      "id": "ces.projects.locations.apps.assistantSessions.delete",
                      "httpMethod": "DELETE",
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/assistantSessions/{assistantSessionsId}"
                    },
                    "list": {
                      "parameters": {
                        "parent": {
                          "required": true,
                          "type": "string",
                          "description": "Required. The app to list assistant sessions from. Format: `projects/{project}/locations/{location}/apps/{app}`",
                          "location": "path",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$"
                        },
                        "filter": {
                          "type": "string",
                          "description": "Optional. Filter to be applied when listing the assistant sessions. See https://google.aip.dev/160 for more details.",
                          "location": "query"
                        },
                        "pageToken": {
                          "description": "Optional. The next_page_token value returned from a previous list AssistantService.ListAssistantSessions call.",
                          "location": "query",
                          "type": "string"
                        },
                        "pageSize": {
                          "location": "query",
                          "format": "int32",
                          "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.",
                          "type": "integer"
                        }
                      },
                      "response": {
                        "$ref": "ListAssistantSessionsResponse"
                      },
                      "path": "v1beta/{+parent}/assistantSessions",
                      "httpMethod": "GET",
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/assistantSessions",
                      "description": "Lists all assistant sessions in the given app.",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "id": "ces.projects.locations.apps.assistantSessions.list",
                      "parameterOrder": [
                        "parent"
                      ]
                    },
                    "streamChatAiAssistant": {
                      "response": {
                        "$ref": "StreamChatAiAssistantResponse"
                      },
                      "path": "v1beta/{+name}:streamChatAiAssistant",
                      "httpMethod": "POST",
                      "request": {
                        "$ref": "StreamChatAiAssistantRequest"
                      },
                      "description": "Runs Arc, the AI assistant, for the specified assistant session in a streaming fashion.",
                      "parameterOrder": [
                        "name"
                      ],
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "id": "ces.projects.locations.apps.assistantSessions.streamChatAiAssistant",
                      "parameters": {
                        "name": {
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/assistantSessions/[^/]+$",
                          "type": "string",
                          "description": "Required. The assistant session to be used to run the assistant. Format: `projects/{project}/locations/{location}/apps/{app}/assistantSessions/{assistant_session}`",
                          "location": "path",
                          "required": true
                        }
                      },
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/assistantSessions/{assistantSessionsId}:streamChatAiAssistant"
                    },
                    "cancelAssistantTurn": {
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/assistantSessions/{assistantSessionsId}:cancelAssistantTurn",
                      "id": "ces.projects.locations.apps.assistantSessions.cancelAssistantTurn",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "httpMethod": "POST",
                      "parameterOrder": [
                        "name"
                      ],
                      "request": {
                        "$ref": "CancelAssistantTurnRequest"
                      },
                      "path": "v1beta/{+name}:cancelAssistantTurn",
                      "description": "Cancels the assistant session's in-flight turn, if any: the explicit user stop for a turn running detached from any stream. A cancel landing on a task that does not host the turn preempts it through the session turn epoch instead, ending it within one lease renewal.",
                      "parameters": {
                        "name": {
                          "required": true,
                          "location": "path",
                          "description": "Required. The assistant session whose in-flight turn to cancel.",
                          "type": "string",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/assistantSessions/[^/]+$"
                        }
                      },
                      "response": {
                        "$ref": "CancelAssistantTurnResponse"
                      }
                    },
                    "get": {
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "parameterOrder": [
                        "name"
                      ],
                      "parameters": {
                        "name": {
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/assistantSessions/[^/]+$",
                          "location": "path",
                          "required": true,
                          "description": "Required. The name of the assistant session to retrieve. Format: `projects/{project}/locations/{location}/apps/{app}/assistantSessions/{assistant_session}`",
                          "type": "string"
                        }
                      },
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/assistantSessions/{assistantSessionsId}",
                      "description": "Gets details of the specified assistant session.",
                      "id": "ces.projects.locations.apps.assistantSessions.get",
                      "response": {
                        "$ref": "AssistantSession"
                      },
                      "path": "v1beta/{+name}",
                      "httpMethod": "GET"
                    },
                    "create": {
                      "httpMethod": "POST",
                      "request": {
                        "$ref": "CreateAssistantSessionRequest"
                      },
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/assistantSessions",
                      "id": "ces.projects.locations.apps.assistantSessions.create",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "parameters": {
                        "parent": {
                          "location": "path",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
                          "required": true,
                          "description": "Required. The app to create the assistant session in Format: `projects/{project}/locations/{location}/apps/{app}`",
                          "type": "string"
                        }
                      },
                      "description": "Creates a new assistant session in the given app.",
                      "response": {
                        "$ref": "AssistantSession"
                      },
                      "path": "v1beta/{+parent}/assistantSessions",
                      "parameterOrder": [
                        "parent"
                      ]
                    }
                  }
                },
                "versions": {
                  "methods": {
                    "patch": {
                      "httpMethod": "PATCH",
                      "request": {
                        "$ref": "AppVersion"
                      },
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/versions/{versionsId}",
                      "response": {
                        "$ref": "AppVersion"
                      },
                      "parameters": {
                        "updateMask": {
                          "type": "string",
                          "format": "google-fieldmask",
                          "description": "Optional. The list of fields to update. If empty, fields `display_name` and `description` will be updated.",
                          "location": "query"
                        },
                        "name": {
                          "description": "Identifier. The unique identifier of the app version. Format: `projects/{project}/locations/{location}/apps/{app}/versions/{version}`",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/versions/[^/]+$",
                          "type": "string",
                          "location": "path",
                          "required": true
                        }
                      },
                      "path": "v1beta/{+name}",
                      "id": "ces.projects.locations.apps.versions.patch",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "description": "Updates the specified app version.",
                      "parameterOrder": [
                        "name"
                      ]
                    },
                    "getExtendedAgentCard": {
                      "path": "v1beta/{+tenant}/extendedAgentCard",
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/versions/{versionsId}/extendedAgentCard",
                      "description": "Gets the extended agent card for the authenticated agent.",
                      "parameters": {
                        "tenant": {
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/versions/[^/]+$",
                          "location": "path",
                          "type": "string",
                          "description": "Optional. Opaque routing identifier. Must match the `tenant` value from the selected `AgentInterface` in the Agent Card when that field is set.",
                          "required": true
                        }
                      },
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "response": {
                        "$ref": "LfA2aV1AgentCard"
                      },
                      "parameterOrder": [
                        "tenant"
                      ],
                      "id": "ces.projects.locations.apps.versions.getExtendedAgentCard",
                      "httpMethod": "GET"
                    },
                    "restore": {
                      "request": {
                        "$ref": "RestoreAppVersionRequest"
                      },
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/versions/{versionsId}:restore",
                      "parameters": {
                        "name": {
                          "type": "string",
                          "description": "Required. The resource name of the app version to restore.",
                          "location": "path",
                          "required": true,
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/versions/[^/]+$"
                        }
                      },
                      "path": "v1beta/{+name}:restore",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "httpMethod": "POST",
                      "parameterOrder": [
                        "name"
                      ],
                      "description": "Restores the specified app version. This will create a new app version from the current draft app and overwrite the current draft with the specified app version.",
                      "response": {
                        "$ref": "Operation"
                      },
                      "id": "ces.projects.locations.apps.versions.restore"
                    },
                    "list": {
                      "response": {
                        "$ref": "ListAppVersionsResponse"
                      },
                      "path": "v1beta/{+parent}/versions",
                      "id": "ces.projects.locations.apps.versions.list",
                      "parameters": {
                        "parent": {
                          "required": true,
                          "description": "Required. The resource name of the app to list app versions from.",
                          "type": "string",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
                          "location": "path"
                        },
                        "filter": {
                          "location": "query",
                          "type": "string",
                          "description": "Optional. Filter to be applied when listing the app versions. See https://google.aip.dev/160 for more details."
                        },
                        "orderBy": {
                          "description": "Optional. Field to sort by. Only \"name\" and \"create_time\" is supported. See https://google.aip.dev/132#ordering for more details.",
                          "type": "string",
                          "location": "query"
                        },
                        "pageToken": {
                          "description": "Optional. The next_page_token value returned from a previous list AgentService.ListAppVersions call.",
                          "type": "string",
                          "location": "query"
                        },
                        "pageSize": {
                          "type": "integer",
                          "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.",
                          "location": "query",
                          "format": "int32"
                        }
                      },
                      "description": "Lists all app versions in the given app.",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "parameterOrder": [
                        "parent"
                      ],
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/versions",
                      "httpMethod": "GET"
                    },
                    "delete": {
                      "response": {
                        "$ref": "Empty"
                      },
                      "parameterOrder": [
                        "name"
                      ],
                      "description": "Deletes the specified app version.",
                      "id": "ces.projects.locations.apps.versions.delete",
                      "httpMethod": "DELETE",
                      "path": "v1beta/{+name}",
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/versions/{versionsId}",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "parameters": {
                        "name": {
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/versions/[^/]+$",
                          "type": "string",
                          "description": "Required. The resource name of the app version to delete.",
                          "location": "path",
                          "required": true
                        },
                        "etag": {
                          "type": "string",
                          "description": "Optional. The current etag of the app version. If an etag is not provided, the deletion will overwrite any concurrent changes. If an etag is provided and does not match the current etag of the app version, deletion will be blocked and an ABORTED error will be returned.",
                          "location": "query"
                        }
                      }
                    },
                    "create": {
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/versions",
                      "parameterOrder": [
                        "parent"
                      ],
                      "httpMethod": "POST",
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "description": "Creates a new app version in the given app.",
                      "request": {
                        "$ref": "AppVersion"
                      },
                      "path": "v1beta/{+parent}/versions",
                      "response": {
                        "$ref": "AppVersion"
                      },
                      "parameters": {
                        "parent": {
                          "type": "string",
                          "description": "Required. The resource name of the app to create an app version in.",
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$",
                          "required": true,
                          "location": "path"
                        },
                        "appVersionId": {
                          "location": "query",
                          "type": "string",
                          "description": "Optional. The ID to use for the app version, which will become the final component of the app version's resource name. If not provided, a unique ID will be automatically assigned for the app version."
                        }
                      },
                      "id": "ces.projects.locations.apps.versions.create"
                    },
                    "get": {
                      "scopes": [
                        "https://www.googleapis.com/auth/ces",
                        "https://www.googleapis.com/auth/cloud-platform"
                      ],
                      "id": "ces.projects.locations.apps.versions.get",
                      "response": {
                        "$ref": "AppVersion"
                      },
                      "parameters": {
                        "name": {
                          "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/versions/[^/]+$",
                          "description": "Required. The resource name of the app version to retrieve.",
                          "type": "string",
                          "location": "path",
                          "required": true
                        }
                      },
                      "path": "v1beta/{+name}",
                      "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/versions/{versionsId}",
                      "httpMethod": "GET",
                      "parameterOrder": [
                        "name"
                      ],
                      "description": "Gets details of the specified app version."
                    }
                  },
                  "resources": {
                    "message": {
                      "methods": {
                        "stream": {
                          "httpMethod": "POST",
                          "parameterOrder": [
                            "tenant"
                          ],
                          "description": "Sends a streaming message to an agent, allowing for real-time interaction and status updates. Streaming version of `SendMessage`",
                          "response": {
                            "$ref": "LfA2aV1StreamResponse"
                          },
                          "path": "v1beta/{+tenant}/message:stream",
                          "id": "ces.projects.locations.apps.versions.message.stream",
                          "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/versions/{versionsId}/message:stream",
                          "request": {
                            "$ref": "LfA2aV1SendMessageRequest"
                          },
                          "parameters": {
                            "tenant": {
                              "required": true,
                              "location": "path",
                              "description": "Optional. Opaque routing identifier. Must match the `tenant` value from the selected `AgentInterface` in the Agent Card when that field is set.",
                              "type": "string",
                              "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/versions/[^/]+$"
                            }
                          },
                          "scopes": [
                            "https://www.googleapis.com/auth/ces",
                            "https://www.googleapis.com/auth/cloud-platform"
                          ]
                        },
                        "send": {
                          "request": {
                            "$ref": "LfA2aV1SendMessageRequest"
                          },
                          "description": "Sends a message to an agent.",
                          "id": "ces.projects.locations.apps.versions.message.send",
                          "httpMethod": "POST",
                          "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/versions/{versionsId}/message:send",
                          "parameterOrder": [
                            "tenant"
                          ],
                          "response": {
                            "$ref": "LfA2aV1SendMessageResponse"
                          },
                          "scopes": [
                            "https://www.googleapis.com/auth/ces",
                            "https://www.googleapis.com/auth/cloud-platform"
                          ],
                          "parameters": {
                            "tenant": {
                              "location": "path",
                              "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/versions/[^/]+$",
                              "required": true,
                              "description": "Optional. Opaque routing identifier. Must match the `tenant` value from the selected `AgentInterface` in the Agent Card when that field is set.",
                              "type": "string"
                            }
                          },
                          "path": "v1beta/{+tenant}/message:send"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "canonicalName": "Customer Engagement Suite",
  "servicePath": "",
  "endpoints": [
    {
      "location": "us",
      "description": "Regional Endpoint",
      "endpointUrl": "https://ces.us.rep.googleapis.com/"
    },
    {
      "description": "Regional Endpoint",
      "endpointUrl": "https://ces.eu.rep.googleapis.com/",
      "location": "eu"
    }
  ],
  "ownerName": "Google"
}
