ai_chat_topics

Controls the topics that are available to the AI Assistant, Dashboard Assistant, MCP, and embedded chat instances.

For the AI Assistant and embedded chat instances, 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 Query helper used in workbooks.

Syntax

ai_chat_topics: [topic_one, topic_two, ...]

ai_chat_topics · string[]

An array of topic names that determine which topics are available in the AI Assistant. 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.

To exclude a topic or tag, prefix the clause with a -. For example: -personal_stuff or -tag:internal

Examples

Limit access to specified topics

ai_chat_topics: [ sales, orders ]

Exclude entire model

ai_chat_topics: []

Include all topics, exclude specific ones

ai_chat_topics: [all_topics, -personal_stuff]

Filter by tag

ai_chat_topics: [tag:customer_facing]

Include all topics except those with a specific tag

ai_chat_topics: [all_topics, -tag:internal]