> ## 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.

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://docs.omni.co/feedback

```json
{
  "path": "/modeling/dimensions/parameters/sample-values",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# 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]
```