- Users need to explore tables that don’t fit neatly into topics or have not been added to topics yet
- You want the AI to automatically validate its analysis for critical errors and retry if there are any
- You want to control which model tier and thinking level the AI uses for different categories of tasks
For curated, self-service analytics, we recommend organizing your views into topics and keeping
query_all_views_and_fields disabled. Topics provide better structure, improved performance, and a more guided experience for users.Syntax
Copy
Ask AI
ai_settings:
query_all_views_and_fields: <enabled | disabled | default>
validate_analysis: <enabled | disabled | default>
analyze_configuration:
model: <opus | sonnet | haiku>
thinking: <none | low | medium | high>
build_configuration:
model: <opus | sonnet | haiku>
thinking: <none | low | medium | high>
simple_summarize_configuration:
model: <opus | sonnet | haiku>
thinking: <none | low | medium | high>
Properties
An object that contains various AI settings.
Hide ai_settings properties
Hide ai_settings properties
When enabled, the AI Assistant and Query helper can generate queries on any view in the model, not just views that are organized within topics. This is useful when you have ad-hoc tables that users want to query without creating a dedicated topic for each one.Accepted values:
-
enabled- The AI can query any view in the model -
disabled- The AI can only query views organized within topics -
default- Uses Omni’s default behavior (enabled)If your instance was created on or before March 5, 2026, the default behavior isdisabled. Instances created after this date areenabledby default.
- The AI can use any view in the model as a starting point for queries
- The AI can discover and join other views that are related to the selected view
- Users don’t need to specify a topic when asking the AI to generate queries
When enabled, the AI Assistant and Query helper automatically validate their analysis before returning results to users. The AI checks for critical errors such as degenerate pivot results, incorrect date ranges, or hallucinated calculations, and self-corrects issues before the user sees them.Accepted values:
enabled- Validation is always performed after the AI completes analytical workdisabled- Validation is never performeddefault- Uses the default behavior (disabled)
- Review its most recent queries and calculations for critical errors
- Check for common issues such as:
- Wrong topics selected
- Incorrect date filters (e.g., period-over-period date ranges)
- Degenerate calculation results (e.g., all zeros)
- Hallucinated numbers not supported by the data
- Malformed pivots or aggregations
- Automatically fix issues if critical errors are detected
- Display a validation indicator in the chat interface
Validation runs automatically at the end of each analytical turn. To prevent infinite loops, validation is limited to a maximum of 2-3 attempts per turn.
Controls the model and thinking level for complex analytical tasks, including query generation, visualization generation, formulas, calculations, AI summary visualization, and the agentic coordinator.
Show analyze_configuration properties
Show analyze_configuration properties
The model tier to use. Accepted values:
opus, sonnet, haiku.The thinking level, which controls how much reasoning the model performs before responding. Higher levels use more tokens but can improve accuracy on complex tasks. Accepted values:
none, low, medium, high.Controls the model and thinking level for model-building tasks, including the modeling subagent, learn from conversation, and topic metadata generation.
Controls the model and thinking level for lightweight tasks, including subtitle and description summaries, documentation search, and field metadata.
Examples
Enable querying all views
Copy
Ask AI
ai_settings:
query_all_views_and_fields: enabled
Restrict AI to topic views only
Copy
Ask AI
ai_settings:
query_all_views_and_fields: disabled
Enable AI analysis validation
Copy
Ask AI
ai_settings:
validate_analysis: enabled
Disable AI analysis validation
Copy
Ask AI
ai_settings:
validate_analysis: disabled
Override all model categories
Copy
Ask AI
ai_settings:
analyze_configuration:
model: opus
thinking: medium
build_configuration:
thinking: high
simple_summarize_configuration:
thinking: low