> ## 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 measure magnitude and usage.

Sample values that help the [Omni Agent](/ai/chat) understand the typical range and magnitude of data in this measure. 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}
<measure_name>:
  sample_values: [<value_1>, <value_2>, ...]
```

## Properties

<ParamField path="measure_name" type="object[]">
  The name of the measure.

  <Expandable title="measure_name properties" defaultOpen="true">
    <ParamField path="sample_values" type="string[]">
      A list of representative values from the measure. This list doesn't have to be exhaustive. These values help the AI understand the typical range, scale, and context of the metric.
    </ParamField>
  </Expandable>
</ParamField>

## Examples

```yaml title="Revenue samples" theme={null}
total_revenue:
  sample_values: [1250.50, 5430.75, 890.25, 12500.00]
```

```yaml title="Count samples" theme={null}
order_count:
  sample_values: [5, 12, 3, 45, 2]
```