> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omni.co/llms.txt
> Use this file to discover all available pages before exploring further.

# sample_values

> Provides sample values to the Omni Agent to better understand field content and usage.

Sample values that help the [Omni Agent](/ai/chat) understand the type of data contained in this dimension. These values are used by the AI to make better field selection decisions and provide more accurate query results.

Refer to the [Optimizing models for AI](/modeling/develop/ai-optimization) guide for more information on best practices.

## Syntax

```yaml theme={null}
<dimension_name>:
  sample_values: [<value_1>, <value_2>, ...]
```

## Properties

<ParamField path="dimension_name" type="object">
  The name of the dimension. Dimension names must:

  * Be unique within the view
  * Start with a letter
  * Contain only alphanumeric characters and underscores

  <Expandable title="dimension_name properties" defaultOpen="true">
    <ParamField path="sample_values" type="string[]">
      A list of representative values from the dimension. The list doesn't need to be exhaustive. These values help the AI understand the content and context of the field.
    </ParamField>
  </Expandable>
</ParamField>

## Examples

```yaml title="Product category samples" theme={null}
product_category:
  sample_values: [Electronics, Clothing, Home & Garden, Sports, Books]
```

```yaml title="Status field samples" theme={null}
order_status:
  sample_values: [pending, processing, shipped, delivered, cancelled]
```