google-api-python-client 2.173.0__py3-none-any.whl → 2.174.0__py3-none-any.whl

googleapiclient/discovery_cache/documents/dialogflow.v2beta1.json

@@ -8602,7 +8602,7 @@
 }
 }
 },
-"revision": "20250612",
+"revision": "20250617",
 "rootUrl": "https://dialogflow.googleapis.com/",
 "schemas": {
 "GoogleCloudDialogflowCxV3AdvancedSettings": {
@@ -9322,6 +9322,13 @@
 "description": "If the flag is true, the agent will utilize LLM to generate a text response. If LLM generation fails, the defined responses in the fulfillment will be respected. This flag is only useful for fulfillments associated with no-match event handlers.",
 "type": "boolean"
 },
+"generators": {
+"description": "A list of Generators to be called during this fulfillment.",
+"items": {
+"$ref": "GoogleCloudDialogflowCxV3FulfillmentGeneratorSettings"
+},
+"type": "array"
+},
 "messages": {
 "description": "The list of rich message responses to present to the user.",
 "items": {
@@ -9398,6 +9405,28 @@
 },
 "type": "object"
 },
+"GoogleCloudDialogflowCxV3FulfillmentGeneratorSettings": {
+"description": "Generator settings used by the LLM to generate a text response.",
+"id": "GoogleCloudDialogflowCxV3FulfillmentGeneratorSettings",
+"properties": {
+"generator": {
+"description": "Required. The generator to call. Format: `projects//locations//agents//generators/`.",
+"type": "string"
+},
+"inputParameters": {
+"additionalProperties": {
+"type": "string"
+},
+"description": "Map from placeholder parameter in the Generator to corresponding session parameters. By default, Dialogflow uses the session parameter with the same name to fill in the generator template. e.g. If there is a placeholder parameter `city` in the Generator, Dialogflow default to fill in the `$city` with `$session.params.city`. However, you may choose to fill `$city` with `$session.params.desination-city`. - Map key: parameter ID - Map value: session parameter name",
+"type": "object"
+},
+"outputParameter": {
+"description": "Required. Output parameter which should contain the generator response.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDialogflowCxV3FulfillmentSetParameterAction": {
 "description": "Setting a parameter value.",
 "id": "GoogleCloudDialogflowCxV3FulfillmentSetParameterAction",
@@ -11739,6 +11768,13 @@
 "description": "If the flag is true, the agent will utilize LLM to generate a text response. If LLM generation fails, the defined responses in the fulfillment will be respected. This flag is only useful for fulfillments associated with no-match event handlers.",
 "type": "boolean"
 },
+"generators": {
+"description": "A list of Generators to be called during this fulfillment.",
+"items": {
+"$ref": "GoogleCloudDialogflowCxV3beta1FulfillmentGeneratorSettings"
+},
+"type": "array"
+},
 "messages": {
 "description": "The list of rich message responses to present to the user.",
 "items": {
@@ -11815,6 +11851,28 @@
 },
 "type": "object"
 },
+"GoogleCloudDialogflowCxV3beta1FulfillmentGeneratorSettings": {
+"description": "Generator settings used by the LLM to generate a text response.",
+"id": "GoogleCloudDialogflowCxV3beta1FulfillmentGeneratorSettings",
+"properties": {
+"generator": {
+"description": "Required. The generator to call. Format: `projects//locations//agents//generators/`.",
+"type": "string"
+},
+"inputParameters": {
+"additionalProperties": {
+"type": "string"
+},
+"description": "Map from placeholder parameter in the Generator to corresponding session parameters. By default, Dialogflow uses the session parameter with the same name to fill in the generator template. e.g. If there is a placeholder parameter `city` in the Generator, Dialogflow default to fill in the `$city` with `$session.params.city`. However, you may choose to fill `$city` with `$session.params.desination-city`. - Map key: parameter ID - Map value: session parameter name",
+"type": "object"
+},
+"outputParameter": {
+"description": "Required. Output parameter which should contain the generator response.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDialogflowCxV3beta1FulfillmentSetParameterAction": {
 "description": "Setting a parameter value.",
 "id": "GoogleCloudDialogflowCxV3beta1FulfillmentSetParameterAction",
@@ -13793,6 +13851,11 @@
 "format": "google-datetime",
 "type": "string"
 },
+"doneTime": {
+"description": "The time when the operation finished.",
+"format": "google-datetime",
+"type": "string"
+},
 "state": {
 "description": "State of CreateConversationModel operation.",
 "enum": [
@@ -13836,6 +13899,11 @@
 "description": "Timestamp when delete conversation model request was created. The time is measured on server side.",
 "format": "google-datetime",
 "type": "string"
+},
+"doneTime": {
+"description": "The time when the operation finished.",
+"format": "google-datetime",
+"type": "string"
 }
 },
 "type": "object"
@@ -13852,6 +13920,11 @@
 "description": "Timestamp when request to deploy conversation model was submitted. The time is measured on server side.",
 "format": "google-datetime",
 "type": "string"
+},
+"doneTime": {
+"description": "The time when the operation finished.",
+"format": "google-datetime",
+"type": "string"
 }
 },
 "type": "object"
@@ -15254,6 +15327,11 @@ true
 "description": "Metadata in google::longrunning::Operation for Knowledge operations.",
 "id": "GoogleCloudDialogflowV2KnowledgeOperationMetadata",
 "properties": {
+"doneTime": {
+"description": "The time when the operation finished.",
+"format": "google-datetime",
+"type": "string"
+},
 "exportOperationMetadata": {
 "$ref": "GoogleCloudDialogflowV2ExportOperationMetadata",
 "description": "Metadata for the Export Data Operation such as the destination of export."
@@ -15944,6 +16022,11 @@ true
 "description": "Timestamp when the request to undeploy conversation model was submitted. The time is measured on server side.",
 "format": "google-datetime",
 "type": "string"
+},
+"doneTime": {
+"description": "The time when the operation finished.",
+"format": "google-datetime",
+"type": "string"
 }
 },
 "type": "object"
@@ -20549,6 +20632,11 @@ true
 "description": "Metadata in google::longrunning::Operation for Knowledge operations.",
 "id": "GoogleCloudDialogflowV2beta1KnowledgeOperationMetadata",
 "properties": {
+"doneTime": {
+"description": "The time when the operation finished.",
+"format": "google-datetime",
+"type": "string"
+},
 "exportOperationMetadata": {
 "$ref": "GoogleCloudDialogflowV2beta1ExportOperationMetadata",
 "description": "Metadata for the Export Data Operation such as the destination of export."

googleapiclient/discovery_cache/documents/dialogflow.v3.json

@@ -5309,7 +5309,7 @@
 }
 }
 },
-"revision": "20250612",
+"revision": "20250617",
 "rootUrl": "https://dialogflow.googleapis.com/",
 "schemas": {
 "GoogleCloudDialogflowCxV3Action": {
@@ -7768,6 +7768,13 @@
 "description": "If the flag is true, the agent will utilize LLM to generate a text response. If LLM generation fails, the defined responses in the fulfillment will be respected. This flag is only useful for fulfillments associated with no-match event handlers.",
 "type": "boolean"
 },
+"generators": {
+"description": "A list of Generators to be called during this fulfillment.",
+"items": {
+"$ref": "GoogleCloudDialogflowCxV3FulfillmentGeneratorSettings"
+},
+"type": "array"
+},
 "messages": {
 "description": "The list of rich message responses to present to the user.",
 "items": {
@@ -7844,6 +7851,28 @@
 },
 "type": "object"
 },
+"GoogleCloudDialogflowCxV3FulfillmentGeneratorSettings": {
+"description": "Generator settings used by the LLM to generate a text response.",
+"id": "GoogleCloudDialogflowCxV3FulfillmentGeneratorSettings",
+"properties": {
+"generator": {
+"description": "Required. The generator to call. Format: `projects//locations//agents//generators/`.",
+"type": "string"
+},
+"inputParameters": {
+"additionalProperties": {
+"type": "string"
+},
+"description": "Map from placeholder parameter in the Generator to corresponding session parameters. By default, Dialogflow uses the session parameter with the same name to fill in the generator template. e.g. If there is a placeholder parameter `city` in the Generator, Dialogflow default to fill in the `$city` with `$session.params.city`. However, you may choose to fill `$city` with `$session.params.desination-city`. - Map key: parameter ID - Map value: session parameter name",
+"type": "object"
+},
+"outputParameter": {
+"description": "Required. Output parameter which should contain the generator response.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDialogflowCxV3FulfillmentSetParameterAction": {
 "description": "Setting a parameter value.",
 "id": "GoogleCloudDialogflowCxV3FulfillmentSetParameterAction",
@@ -10463,6 +10492,10 @@ false
 "Text that contains the tokenized words of the phrase will be matched, e.g. \"foo\" will match \"a foo bar\" and \"foo bar\", but not \"foobar\"."
 ],
 "type": "string"
+},
+"promptSecuritySettings": {
+"$ref": "GoogleCloudDialogflowCxV3SafetySettingsPromptSecuritySettings",
+"description": "Optional. Settings for prompt security checks."
 }
 },
 "type": "object"
@@ -10482,6 +10515,17 @@ false
 },
 "type": "object"
 },
+"GoogleCloudDialogflowCxV3SafetySettingsPromptSecuritySettings": {
+"description": "Settings for prompt security checks.",
+"id": "GoogleCloudDialogflowCxV3SafetySettingsPromptSecuritySettings",
+"properties": {
+"enablePromptSecurity": {
+"description": "Optional. Enable prompt security checks.",
+"type": "boolean"
+}
+},
+"type": "object"
+},
 "GoogleCloudDialogflowCxV3SearchConfig": {
 "description": "Search configuration for UCS search queries.",
 "id": "GoogleCloudDialogflowCxV3SearchConfig",
@@ -13020,6 +13064,13 @@ false
 "description": "If the flag is true, the agent will utilize LLM to generate a text response. If LLM generation fails, the defined responses in the fulfillment will be respected. This flag is only useful for fulfillments associated with no-match event handlers.",
 "type": "boolean"
 },
+"generators": {
+"description": "A list of Generators to be called during this fulfillment.",
+"items": {
+"$ref": "GoogleCloudDialogflowCxV3beta1FulfillmentGeneratorSettings"
+},
+"type": "array"
+},
 "messages": {
 "description": "The list of rich message responses to present to the user.",
 "items": {
@@ -13096,6 +13147,28 @@ false
 },
 "type": "object"
 },
+"GoogleCloudDialogflowCxV3beta1FulfillmentGeneratorSettings": {
+"description": "Generator settings used by the LLM to generate a text response.",
+"id": "GoogleCloudDialogflowCxV3beta1FulfillmentGeneratorSettings",
+"properties": {
+"generator": {
+"description": "Required. The generator to call. Format: `projects//locations//agents//generators/`.",
+"type": "string"
+},
+"inputParameters": {
+"additionalProperties": {
+"type": "string"
+},
+"description": "Map from placeholder parameter in the Generator to corresponding session parameters. By default, Dialogflow uses the session parameter with the same name to fill in the generator template. e.g. If there is a placeholder parameter `city` in the Generator, Dialogflow default to fill in the `$city` with `$session.params.city`. However, you may choose to fill `$city` with `$session.params.desination-city`. - Map key: parameter ID - Map value: session parameter name",
+"type": "object"
+},
+"outputParameter": {
+"description": "Required. Output parameter which should contain the generator response.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDialogflowCxV3beta1FulfillmentSetParameterAction": {
 "description": "Setting a parameter value.",
 "id": "GoogleCloudDialogflowCxV3beta1FulfillmentSetParameterAction",
@@ -15074,6 +15147,11 @@ false
 "format": "google-datetime",
 "type": "string"
 },
+"doneTime": {
+"description": "The time when the operation finished.",
+"format": "google-datetime",
+"type": "string"
+},
 "state": {
 "description": "State of CreateConversationModel operation.",
 "enum": [
@@ -15117,6 +15195,11 @@ false
 "description": "Timestamp when delete conversation model request was created. The time is measured on server side.",
 "format": "google-datetime",
 "type": "string"
+},
+"doneTime": {
+"description": "The time when the operation finished.",
+"format": "google-datetime",
+"type": "string"
 }
 },
 "type": "object"
@@ -15133,6 +15216,11 @@ false
 "description": "Timestamp when request to deploy conversation model was submitted. The time is measured on server side.",
 "format": "google-datetime",
 "type": "string"
+},
+"doneTime": {
+"description": "The time when the operation finished.",
+"format": "google-datetime",
+"type": "string"
 }
 },
 "type": "object"
@@ -16535,6 +16623,11 @@ true
 "description": "Metadata in google::longrunning::Operation for Knowledge operations.",
 "id": "GoogleCloudDialogflowV2KnowledgeOperationMetadata",
 "properties": {
+"doneTime": {
+"description": "The time when the operation finished.",
+"format": "google-datetime",
+"type": "string"
+},
 "exportOperationMetadata": {
 "$ref": "GoogleCloudDialogflowV2ExportOperationMetadata",
 "description": "Metadata for the Export Data Operation such as the destination of export."
@@ -17225,6 +17318,11 @@ true
 "description": "Timestamp when the request to undeploy conversation model was submitted. The time is measured on server side.",
 "format": "google-datetime",
 "type": "string"
+},
+"doneTime": {
+"description": "The time when the operation finished.",
+"format": "google-datetime",
+"type": "string"
 }
 },
 "type": "object"
@@ -19242,6 +19340,11 @@ true
 "description": "Metadata in google::longrunning::Operation for Knowledge operations.",
 "id": "GoogleCloudDialogflowV2beta1KnowledgeOperationMetadata",
 "properties": {
+"doneTime": {
+"description": "The time when the operation finished.",
+"format": "google-datetime",
+"type": "string"
+},
 "exportOperationMetadata": {
 "$ref": "GoogleCloudDialogflowV2beta1ExportOperationMetadata",
 "description": "Metadata for the Export Data Operation such as the destination of export."

googleapiclient/discovery_cache/documents/dialogflow.v3beta1.json

@@ -5436,7 +5436,7 @@
 }
 }
 },
-"revision": "20250612",
+"revision": "20250617",
 "rootUrl": "https://dialogflow.googleapis.com/",
 "schemas": {
 "GoogleCloudDialogflowCxV3AdvancedSettings": {
@@ -6156,6 +6156,13 @@
 "description": "If the flag is true, the agent will utilize LLM to generate a text response. If LLM generation fails, the defined responses in the fulfillment will be respected. This flag is only useful for fulfillments associated with no-match event handlers.",
 "type": "boolean"
 },
+"generators": {
+"description": "A list of Generators to be called during this fulfillment.",
+"items": {
+"$ref": "GoogleCloudDialogflowCxV3FulfillmentGeneratorSettings"
+},
+"type": "array"
+},
 "messages": {
 "description": "The list of rich message responses to present to the user.",
 "items": {
@@ -6232,6 +6239,28 @@
 },
 "type": "object"
 },
+"GoogleCloudDialogflowCxV3FulfillmentGeneratorSettings": {
+"description": "Generator settings used by the LLM to generate a text response.",
+"id": "GoogleCloudDialogflowCxV3FulfillmentGeneratorSettings",
+"properties": {
+"generator": {
+"description": "Required. The generator to call. Format: `projects//locations//agents//generators/`.",
+"type": "string"
+},
+"inputParameters": {
+"additionalProperties": {
+"type": "string"
+},
+"description": "Map from placeholder parameter in the Generator to corresponding session parameters. By default, Dialogflow uses the session parameter with the same name to fill in the generator template. e.g. If there is a placeholder parameter `city` in the Generator, Dialogflow default to fill in the `$city` with `$session.params.city`. However, you may choose to fill `$city` with `$session.params.desination-city`. - Map key: parameter ID - Map value: session parameter name",
+"type": "object"
+},
+"outputParameter": {
+"description": "Required. Output parameter which should contain the generator response.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDialogflowCxV3FulfillmentSetParameterAction": {
 "description": "Setting a parameter value.",
 "id": "GoogleCloudDialogflowCxV3FulfillmentSetParameterAction",
@@ -10942,6 +10971,13 @@
 "description": "If the flag is true, the agent will utilize LLM to generate a text response. If LLM generation fails, the defined responses in the fulfillment will be respected. This flag is only useful for fulfillments associated with no-match event handlers.",
 "type": "boolean"
 },
+"generators": {
+"description": "A list of Generators to be called during this fulfillment.",
+"items": {
+"$ref": "GoogleCloudDialogflowCxV3beta1FulfillmentGeneratorSettings"
+},
+"type": "array"
+},
 "messages": {
 "description": "The list of rich message responses to present to the user.",
 "items": {
@@ -11018,6 +11054,28 @@
 },
 "type": "object"
 },
+"GoogleCloudDialogflowCxV3beta1FulfillmentGeneratorSettings": {
+"description": "Generator settings used by the LLM to generate a text response.",
+"id": "GoogleCloudDialogflowCxV3beta1FulfillmentGeneratorSettings",
+"properties": {
+"generator": {
+"description": "Required. The generator to call. Format: `projects//locations//agents//generators/`.",
+"type": "string"
+},
+"inputParameters": {
+"additionalProperties": {
+"type": "string"
+},
+"description": "Map from placeholder parameter in the Generator to corresponding session parameters. By default, Dialogflow uses the session parameter with the same name to fill in the generator template. e.g. If there is a placeholder parameter `city` in the Generator, Dialogflow default to fill in the `$city` with `$session.params.city`. However, you may choose to fill `$city` with `$session.params.desination-city`. - Map key: parameter ID - Map value: session parameter name",
+"type": "object"
+},
+"outputParameter": {
+"description": "Required. Output parameter which should contain the generator response.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDialogflowCxV3beta1FulfillmentSetParameterAction": {
 "description": "Setting a parameter value.",
 "id": "GoogleCloudDialogflowCxV3beta1FulfillmentSetParameterAction",
@@ -13965,6 +14023,10 @@ false
 "Text that contains the tokenized words of the phrase will be matched, e.g. \"foo\" will match \"a foo bar\" and \"foo bar\", but not \"foobar\"."
 ],
 "type": "string"
+},
+"promptSecuritySettings": {
+"$ref": "GoogleCloudDialogflowCxV3beta1SafetySettingsPromptSecuritySettings",
+"description": "Optional. Settings for prompt security checks."
 }
 },
 "type": "object"
@@ -13984,6 +14046,17 @@ false
 },
 "type": "object"
 },
+"GoogleCloudDialogflowCxV3beta1SafetySettingsPromptSecuritySettings": {
+"description": "Settings for prompt security checks.",
+"id": "GoogleCloudDialogflowCxV3beta1SafetySettingsPromptSecuritySettings",
+"properties": {
+"enablePromptSecurity": {
+"description": "Optional. Enable prompt security checks.",
+"type": "boolean"
+}
+},
+"type": "object"
+},
 "GoogleCloudDialogflowCxV3beta1SearchConfig": {
 "description": "Search configuration for UCS search queries.",
 "id": "GoogleCloudDialogflowCxV3beta1SearchConfig",
@@ -16444,6 +16517,11 @@ false
 "format": "google-datetime",
 "type": "string"
 },
+"doneTime": {
+"description": "The time when the operation finished.",
+"format": "google-datetime",
+"type": "string"
+},
 "state": {
 "description": "State of CreateConversationModel operation.",
 "enum": [
@@ -16487,6 +16565,11 @@ false
 "description": "Timestamp when delete conversation model request was created. The time is measured on server side.",
 "format": "google-datetime",
 "type": "string"
+},
+"doneTime": {
+"description": "The time when the operation finished.",
+"format": "google-datetime",
+"type": "string"
 }
 },
 "type": "object"
@@ -16503,6 +16586,11 @@ false
 "description": "Timestamp when request to deploy conversation model was submitted. The time is measured on server side.",
 "format": "google-datetime",
 "type": "string"
+},
+"doneTime": {
+"description": "The time when the operation finished.",
+"format": "google-datetime",
+"type": "string"
 }
 },
 "type": "object"
@@ -17905,6 +17993,11 @@ true
 "description": "Metadata in google::longrunning::Operation for Knowledge operations.",
 "id": "GoogleCloudDialogflowV2KnowledgeOperationMetadata",
 "properties": {
+"doneTime": {
+"description": "The time when the operation finished.",
+"format": "google-datetime",
+"type": "string"
+},
 "exportOperationMetadata": {
 "$ref": "GoogleCloudDialogflowV2ExportOperationMetadata",
 "description": "Metadata for the Export Data Operation such as the destination of export."
@@ -18595,6 +18688,11 @@ true
 "description": "Timestamp when the request to undeploy conversation model was submitted. The time is measured on server side.",
 "format": "google-datetime",
 "type": "string"
+},
+"doneTime": {
+"description": "The time when the operation finished.",
+"format": "google-datetime",
+"type": "string"
 }
 },
 "type": "object"
@@ -20612,6 +20710,11 @@ true
 "description": "Metadata in google::longrunning::Operation for Knowledge operations.",
 "id": "GoogleCloudDialogflowV2beta1KnowledgeOperationMetadata",
 "properties": {
+"doneTime": {
+"description": "The time when the operation finished.",
+"format": "google-datetime",
+"type": "string"
+},
 "exportOperationMetadata": {
 "$ref": "GoogleCloudDialogflowV2beta1ExportOperationMetadata",
 "description": "Metadata for the Export Data Operation such as the destination of export."

googleapiclient/discovery_cache/documents/discoveryengine.v1.json

@@ -7052,7 +7052,7 @@
 }
 }
 },
-"revision": "20250609",
+"revision": "20250617",
 "rootUrl": "https://discoveryengine.googleapis.com/",
 "schemas": {
 "GoogleApiDistribution": {
@@ -14184,6 +14184,13 @@
 "query": {
 "$ref": "GoogleCloudDiscoveryengineV1Query",
 "description": "Optional. The user query. May not be set if this turn is merely regenerating an answer to a different turn"
+},
+"queryConfig": {
+"additionalProperties": {
+"type": "string"
+},
+"description": "Optional. Represents metadata related to the query config, for example LLM model and version used, model parameters (temperature, grounding parameters, etc.). The prefix \"google.\" is reserved for Google-developed functionality.",
+"type": "object"
 }
 },
 "type": "object"
@@ -19302,7 +19309,7 @@
 "description": "The query expansion specification that specifies the conditions under which query expansion occurs."
 },
 "rankingExpression": {
-"description": "Optional. The ranking expression controls the customized ranking on retrieval documents. This overrides ServingConfig.ranking_expression. The syntax and supported features depend on the `ranking_expression_backend` value. If `ranking_expression_backend` is not provided, it defaults to `RANK_BY_EMBEDDING`. If ranking_expression_backend is not provided or set to `RANK_BY_EMBEDDING`, it should be a single function or multiple functions that are joined by \"+\". * ranking_expression = function, { \" + \", function }; Supported functions: * double * relevance_score * double * dotProduct(embedding_field_path) Function variables: * `relevance_score`: pre-defined keywords, used for measure relevance between query and document. * `embedding_field_path`: the document embedding field used with query embedding vector. * `dotProduct`: embedding function between `embedding_field_path` and query embedding vector. Example ranking expression: If document has an embedding field doc_embedding, the ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`. If ranking_expression_backend is set to `RANK_BY_FORMULA`, the following expression types (and combinations of those chained using + or * operators) are supported: * `double` * `signal` * `log(signal)` * `exp(signal)` * `rr(signal, double > 0)` -- reciprocal rank transformation with second argument being a denominator constant. * `is_nan(signal)` -- returns 0 if signal is NaN, 1 otherwise. * `fill_nan(signal1, signal2 | double)` -- if signal1 is NaN, returns signal2 | double, else returns signal1. Here are a few examples of ranking formulas that use the supported ranking expression types: - `0.2 * semantic_similarity_score + 0.8 * log(keyword_similarity_score)` -- mostly rank by the logarithm of `keyword_similarity_score` with slight `semantic_smilarity_score` adjustment. - `0.2 * exp(fill_nan(semantic_similarity_score, 0)) + 0.3 * is_nan(keyword_similarity_score)` -- rank by the exponent of `semantic_similarity_score` filling the value with 0 if it's NaN, also add constant 0.3 adjustment to the final score if `semantic_similarity_score` is NaN. - `0.2 * rr(semantic_similarity_score, 16) + 0.8 * rr(keyword_similarity_score, 16)` -- mostly rank by the reciprocal rank of `keyword_similarity_score` with slight adjustment of reciprocal rank of `semantic_smilarity_score`. The following signals are supported: * `semantic_similarity_score`: semantic similarity adjustment that is calculated using the embeddings generated by a proprietary Google model. This score determines how semantically similar a search query is to a document. * `keyword_similarity_score`: keyword match adjustment uses the Best Match 25 (BM25) ranking function. This score is calculated using a probabilistic model to estimate the probability that a document is relevant to a given query. * `relevance_score`: semantic relevance adjustment that uses a proprietary Google model to determine the meaning and intent behind a user's query in context with the content in the documents. * `pctr_rank`: predicted conversion rate adjustment as a rank use predicted Click-through rate (pCTR) to gauge the relevance and attractiveness of a search result from a user's perspective. A higher pCTR suggests that the result is more likely to satisfy the user's query and intent, making it a valuable signal for ranking. * `freshness_rank`: freshness adjustment as a rank * `base_rank`: the default rank of the result",
+"description": "Optional. The ranking expression controls the customized ranking on retrieval documents. This overrides ServingConfig.ranking_expression. The syntax and supported features depend on the `ranking_expression_backend` value. If `ranking_expression_backend` is not provided, it defaults to `RANK_BY_EMBEDDING`. If ranking_expression_backend is not provided or set to `RANK_BY_EMBEDDING`, it should be a single function or multiple functions that are joined by \"+\". * ranking_expression = function, { \" + \", function }; Supported functions: * double * relevance_score * double * dotProduct(embedding_field_path) Function variables: * `relevance_score`: pre-defined keywords, used for measure relevance between query and document. * `embedding_field_path`: the document embedding field used with query embedding vector. * `dotProduct`: embedding function between `embedding_field_path` and query embedding vector. Example ranking expression: If document has an embedding field doc_embedding, the ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`. If ranking_expression_backend is set to `RANK_BY_FORMULA`, the following expression types (and combinations of those chained using + or * operators) are supported: * `double` * `signal` * `log(signal)` * `exp(signal)` * `rr(signal, double > 0)` -- reciprocal rank transformation with second argument being a denominator constant. * `is_nan(signal)` -- returns 0 if signal is NaN, 1 otherwise. * `fill_nan(signal1, signal2 | double)` -- if signal1 is NaN, returns signal2 | double, else returns signal1. Here are a few examples of ranking formulas that use the supported ranking expression types: - `0.2 * semantic_similarity_score + 0.8 * log(keyword_similarity_score)` -- mostly rank by the logarithm of `keyword_similarity_score` with slight `semantic_smilarity_score` adjustment. - `0.2 * exp(fill_nan(semantic_similarity_score, 0)) + 0.3 * is_nan(keyword_similarity_score)` -- rank by the exponent of `semantic_similarity_score` filling the value with 0 if it's NaN, also add constant 0.3 adjustment to the final score if `semantic_similarity_score` is NaN. - `0.2 * rr(semantic_similarity_score, 16) + 0.8 * rr(keyword_similarity_score, 16)` -- mostly rank by the reciprocal rank of `keyword_similarity_score` with slight adjustment of reciprocal rank of `semantic_smilarity_score`. The following signals are supported: * `semantic_similarity_score`: semantic similarity adjustment that is calculated using the embeddings generated by a proprietary Google model. This score determines how semantically similar a search query is to a document. * `keyword_similarity_score`: keyword match adjustment uses the Best Match 25 (BM25) ranking function. This score is calculated using a probabilistic model to estimate the probability that a document is relevant to a given query. * `relevance_score`: semantic relevance adjustment that uses a proprietary Google model to determine the meaning and intent behind a user's query in context with the content in the documents. * `pctr_rank`: predicted conversion rate adjustment as a rank use predicted Click-through rate (pCTR) to gauge the relevance and attractiveness of a search result from a user's perspective. A higher pCTR suggests that the result is more likely to satisfy the user's query and intent, making it a valuable signal for ranking. * `freshness_rank`: freshness adjustment as a rank * `topicality_rank`: topicality adjustment as a rank. Uses proprietary Google model to determine the keyword-based overlap between the query and the document. * `base_rank`: the default rank of the result",
 "type": "string"
 },
 "rankingExpressionBackend": {
@@ -20077,6 +20084,13 @@ false
 "query": {
 "$ref": "GoogleCloudDiscoveryengineV1alphaQuery",
 "description": "Optional. The user query. May not be set if this turn is merely regenerating an answer to a different turn"
+},
+"queryConfig": {
+"additionalProperties": {
+"type": "string"
+},
+"description": "Optional. Represents metadata related to the query config, for example LLM model and version used, model parameters (temperature, grounding parameters, etc.). The prefix \"google.\" is reserved for Google-developed functionality.",
+"type": "object"
 }
 },
 "type": "object"
@@ -22889,7 +22903,7 @@ false
 "description": "The query expansion specification that specifies the conditions under which query expansion occurs."
 },
 "rankingExpression": {
-"description": "Optional. The ranking expression controls the customized ranking on retrieval documents. This overrides ServingConfig.ranking_expression. The syntax and supported features depend on the `ranking_expression_backend` value. If `ranking_expression_backend` is not provided, it defaults to `RANK_BY_EMBEDDING`. If ranking_expression_backend is not provided or set to `RANK_BY_EMBEDDING`, it should be a single function or multiple functions that are joined by \"+\". * ranking_expression = function, { \" + \", function }; Supported functions: * double * relevance_score * double * dotProduct(embedding_field_path) Function variables: * `relevance_score`: pre-defined keywords, used for measure relevance between query and document. * `embedding_field_path`: the document embedding field used with query embedding vector. * `dotProduct`: embedding function between `embedding_field_path` and query embedding vector. Example ranking expression: If document has an embedding field doc_embedding, the ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`. If ranking_expression_backend is set to `RANK_BY_FORMULA`, the following expression types (and combinations of those chained using + or * operators) are supported: * `double` * `signal` * `log(signal)` * `exp(signal)` * `rr(signal, double > 0)` -- reciprocal rank transformation with second argument being a denominator constant. * `is_nan(signal)` -- returns 0 if signal is NaN, 1 otherwise. * `fill_nan(signal1, signal2 | double)` -- if signal1 is NaN, returns signal2 | double, else returns signal1. Here are a few examples of ranking formulas that use the supported ranking expression types: - `0.2 * semantic_similarity_score + 0.8 * log(keyword_similarity_score)` -- mostly rank by the logarithm of `keyword_similarity_score` with slight `semantic_smilarity_score` adjustment. - `0.2 * exp(fill_nan(semantic_similarity_score, 0)) + 0.3 * is_nan(keyword_similarity_score)` -- rank by the exponent of `semantic_similarity_score` filling the value with 0 if it's NaN, also add constant 0.3 adjustment to the final score if `semantic_similarity_score` is NaN. - `0.2 * rr(semantic_similarity_score, 16) + 0.8 * rr(keyword_similarity_score, 16)` -- mostly rank by the reciprocal rank of `keyword_similarity_score` with slight adjustment of reciprocal rank of `semantic_smilarity_score`. The following signals are supported: * `semantic_similarity_score`: semantic similarity adjustment that is calculated using the embeddings generated by a proprietary Google model. This score determines how semantically similar a search query is to a document. * `keyword_similarity_score`: keyword match adjustment uses the Best Match 25 (BM25) ranking function. This score is calculated using a probabilistic model to estimate the probability that a document is relevant to a given query. * `relevance_score`: semantic relevance adjustment that uses a proprietary Google model to determine the meaning and intent behind a user's query in context with the content in the documents. * `pctr_rank`: predicted conversion rate adjustment as a rank use predicted Click-through rate (pCTR) to gauge the relevance and attractiveness of a search result from a user's perspective. A higher pCTR suggests that the result is more likely to satisfy the user's query and intent, making it a valuable signal for ranking. * `freshness_rank`: freshness adjustment as a rank * `base_rank`: the default rank of the result",
+"description": "Optional. The ranking expression controls the customized ranking on retrieval documents. This overrides ServingConfig.ranking_expression. The syntax and supported features depend on the `ranking_expression_backend` value. If `ranking_expression_backend` is not provided, it defaults to `RANK_BY_EMBEDDING`. If ranking_expression_backend is not provided or set to `RANK_BY_EMBEDDING`, it should be a single function or multiple functions that are joined by \"+\". * ranking_expression = function, { \" + \", function }; Supported functions: * double * relevance_score * double * dotProduct(embedding_field_path) Function variables: * `relevance_score`: pre-defined keywords, used for measure relevance between query and document. * `embedding_field_path`: the document embedding field used with query embedding vector. * `dotProduct`: embedding function between `embedding_field_path` and query embedding vector. Example ranking expression: If document has an embedding field doc_embedding, the ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`. If ranking_expression_backend is set to `RANK_BY_FORMULA`, the following expression types (and combinations of those chained using + or * operators) are supported: * `double` * `signal` * `log(signal)` * `exp(signal)` * `rr(signal, double > 0)` -- reciprocal rank transformation with second argument being a denominator constant. * `is_nan(signal)` -- returns 0 if signal is NaN, 1 otherwise. * `fill_nan(signal1, signal2 | double)` -- if signal1 is NaN, returns signal2 | double, else returns signal1. Here are a few examples of ranking formulas that use the supported ranking expression types: - `0.2 * semantic_similarity_score + 0.8 * log(keyword_similarity_score)` -- mostly rank by the logarithm of `keyword_similarity_score` with slight `semantic_smilarity_score` adjustment. - `0.2 * exp(fill_nan(semantic_similarity_score, 0)) + 0.3 * is_nan(keyword_similarity_score)` -- rank by the exponent of `semantic_similarity_score` filling the value with 0 if it's NaN, also add constant 0.3 adjustment to the final score if `semantic_similarity_score` is NaN. - `0.2 * rr(semantic_similarity_score, 16) + 0.8 * rr(keyword_similarity_score, 16)` -- mostly rank by the reciprocal rank of `keyword_similarity_score` with slight adjustment of reciprocal rank of `semantic_smilarity_score`. The following signals are supported: * `semantic_similarity_score`: semantic similarity adjustment that is calculated using the embeddings generated by a proprietary Google model. This score determines how semantically similar a search query is to a document. * `keyword_similarity_score`: keyword match adjustment uses the Best Match 25 (BM25) ranking function. This score is calculated using a probabilistic model to estimate the probability that a document is relevant to a given query. * `relevance_score`: semantic relevance adjustment that uses a proprietary Google model to determine the meaning and intent behind a user's query in context with the content in the documents. * `pctr_rank`: predicted conversion rate adjustment as a rank use predicted Click-through rate (pCTR) to gauge the relevance and attractiveness of a search result from a user's perspective. A higher pCTR suggests that the result is more likely to satisfy the user's query and intent, making it a valuable signal for ranking. * `freshness_rank`: freshness adjustment as a rank * `topicality_rank`: topicality adjustment as a rank. Uses proprietary Google model to determine the keyword-based overlap between the query and the document. * `base_rank`: the default rank of the result",
 "type": "string"
 },
 "rankingExpressionBackend": {