> ## 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/models/ai-chat-topics",
  "feedback": "Description of the issue"
}
```

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

</AgentInstructions>

# ai_chat_topics

> Controls the topics that are available to the Omni Agent, Dashboard Agent, MCP, and embedded chat instances.

For the [Omni Agent](/ai/chat) and [embedded chat instances](/embed/customization/ai-chat), topics added to this parameter will display in the topic picker.

* **Limit access to specified topics** - Add the topic names in a list (`[ sales, orders ]`)
* **Exclude the entire model** - Specify an empty list (`[]`)
* **Include all topics in the model** - Leave this parameter unset

**Note**: This parameter doesn't apply to the [Workbook Agent](/ai/queries#generating-queries).

<Warning>
  This parameter changes what the AI is aware of, not what it has access to. All queries are run with the same permissions as the user and it's possible for the AI to make assumptions about schemas given enough context.
</Warning>

## Syntax

```yaml theme={null}
ai_chat_topics: [topic_one, topic_two, ...]
```

<ParamField path="ai_chat_topics" type="string[]">
  An array of topic names that determine which topics are available in the Omni Agent. Supports the following operators:

  | Operator      | Description                            | Order of operations |
  | ------------- | -------------------------------------- | ------------------- |
  | `all_topics`  | Includes all topics in the model       | 1                   |
  | `tag:<value>` | Includes topics with the specified tag | 2                   |
  | `topic_name`  | Includes a specific topic by name      | 3                   |

  Omni evaluates the operators according to the **Order of operations** value in the above table. This allows you to include all topics and then exclude specific ones, or build up your topic list selectively.

  <Tip>
    To exclude a topic or tag, prefix the clause with a `-`. For example: `-personal_stuff` or `-tag:internal`
  </Tip>
</ParamField>

## Examples

```yaml title="Limit access to specified topics" theme={null}
ai_chat_topics: [ sales, orders ]
```

```yaml title="Exclude entire model" theme={null}
ai_chat_topics: []
```

```yaml title="Include all topics, exclude specific ones" theme={null}
ai_chat_topics: [all_topics, -personal_stuff]
```

```yaml title="Filter by tag" theme={null}
ai_chat_topics: [tag:customer_facing]
```

```yaml title="Include all topics except those with a specific tag" theme={null}
ai_chat_topics: [all_topics, -tag:internal]
```