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

# ai_context

> Free text that can provide context about a topic to the Omni Agent.

Free text that can provide context to the [Omni Agent](/ai/chat).

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

## Syntax

```yaml theme={null}
ai_context: "<context_text>"
```

Or for multiline context:

```yaml theme={null}
ai_context: |
  <multiline_context_text>
```

## Properties

<ParamField path="ai_context" type="string">
  Free text that provides context to the Omni Agent. Can include behavioral prompting, use case descriptions, or other contextual information to improve AI query results.

  You can reference [user attributes](/administration/users/attributes) using `${omni_attributes.<attribute_name>}` syntax to personalize the context for each user.
</ParamField>

<Note>
  Only user attribute references are allowed in `ai_context`. Field references and filter conditions are not supported.
</Note>

## Examples

```yaml theme={null}
ai_context: |
  you are the head of finance. you are concerned with the status of customer payments. you often need to project into the future how many invoices are due and for how much. you also need to know if any invoices are late so you can reach out to those customers.
```

```yaml title="Personalized context using user attributes" theme={null}
ai_context: |
  You are a sales analyst. When someone asks about their team or pipeline, always filter by account.segment = ${omni_attributes.segment} and account.region = ${omni_attributes.region}.
```