Skip to main content
Sets the number of characters of field metadata (names, descriptions, sample values, synonyms, SQL) the Omni Agent receives for this topic before Omni prunes field details to fit. If a model-level budget isn’t defined with ai_settings.topic_prune_characters, the system default of 75,000 characters (roughly 19,000 tokens) is used instead.

​
Syntax

​
Properties

​
integer
The character budget for this topic’s AI field context. Must be between 10,000 and 200,000. A value outside this range is a validator error.

​
Behavior

Omni warns in the model validator (topic_ai_context_too_large) when a topic’s estimated AI field context exceeds its effective budget, or when the topic has more than 2,000 fields. Because the context size is an estimate rather than an exact measurement, the warning message describes it as “estimated”. This warning only appears for topics that show AI is actually in use: The autofix option for topic_ai_context_too_large won’t display if:
  • The topic is over the 2,000-field limit, since only ai_fields reduces the field count
  • Raising ai_prune_characters to clear the estimate would exceed 200,000

​
Examples

Raise the character budget for this topic's AI context