# BoostSpec

- [JSON representation](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1beta/BoostSpec#SCHEMA_REPRESENTATION)
- [ConditionBoostSpec](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1beta/BoostSpec#ConditionBoostSpec)
  - [JSON representation](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1beta/BoostSpec#ConditionBoostSpec.SCHEMA_REPRESENTATION)

Specification to boost suggestions based on the condition of the suggestion.

| JSON representation |
|---|
| ``` { "conditionBoostSpecs": [ { object (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1beta/BoostSpec#ConditionBoostSpec`) } ] } ``` |

| Fields ||
|---|---|
| `conditionBoostSpecs[]` | ``object (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1beta/BoostSpec#ConditionBoostSpec`)`` Condition boost specifications. If a suggestion matches multiple conditions in the specifications, boost values from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20. Note: Currently only support language condition boost. |

## ConditionBoostSpec

Boost applies to suggestions which match a condition.

| JSON representation |
|---|
| ``` { "condition": string, "boost": number } ``` |

| Fields ||
|---|---|
| `condition` | `string` An expression which specifies a boost condition. The syntax is the same as [filter expression syntax](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata#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"))` |
| `boost` | `number` 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. |