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

> Configure AI behavior for the model, including query scope, analysis validation, context management, and AI model and thinking settings.

Configure AI behavior for the model, including query scope, analysis validation, context management, and AI model and thinking settings.

Use this parameter to:

* **Expand query scope** — Let the AI query any view in the model - not just topics - for more unconstrained analysis
* **Enable analysis validation** — Have the AI automatically check its work for errors before returning results
* **Manage conversation context** — Control how aggressively Claude prunes conversation history to balance cost optimization with context preservation
* **Tune model and thinking levels** — **Supported for Claude models only.** Control the tradeoff between speed and accuracy for different task types (analysis, model building, summarization)
* **Disable specific AI tools** — Restrict the Blobby chat assistant from using specific auxiliary tools like Slack, Google Calendar, GitHub, visualize, or learn from conversation
* **Control AI-generated custom fields and CTEs** — Restrict whether the AI can generate custom fields and CTEs (common table expressions) based on user permission levels

## Syntax

```yaml theme={null}
ai_settings:
  <sub-parameters>:
  ...
```

## Properties

<ParamField path="ai_settings" type="object">
  The parent object containing all AI settings sub-parameters:

  | Parameter                                                                                                  | Description                                                                                                                                |
  | ---------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
  | [allow\_ctes](/modeling/models/parameters/ai-settings/allow-ctes)                                          | Controls whether the AI can generate CTEs (common table expressions) in its queries, based on user permission levels.                      |
  | [allow\_custom\_fields](/modeling/models/parameters/ai-settings/allow-custom-fields)                       | Controls whether the AI can generate custom fields in its queries, based on user permission levels.                                        |
  | [analyze\_configuration](/modeling/models/parameters/ai-settings/analyze-configuration)                    | Controls the model and thinking level for complex analytical tasks, such as query and visualization generation.                            |
  | [build\_configuration](/modeling/models/parameters/ai-settings/build-configuration)                        | Controls the model and thinking level for model-building tasks, such as the modeling subagent and topic metadata generation.               |
  | [conversation\_prune\_length](/modeling/models/parameters/ai-settings/conversation-prune-length)           | Controls how aggressively Claude prunes conversation history to balance cost optimization with context preservation.                       |
  | [disabled\_tools](/modeling/models/parameters/ai-settings/disabled-tools)                                  | Disables specific auxiliary tools in the AI chat interface, such as Slack, Google Calendar, GitHub, visualize, or learn from conversation. |
  | [query\_all\_views\_and\_fields](/modeling/models/parameters/ai-settings/query-all-views-and-fields)       | Controls whether the AI can query any view in the model or only views organized within topics.                                             |
  | [simple\_summarize\_configuration](/modeling/models/parameters/ai-settings/simple-summarize-configuration) | Controls the model and thinking level for lightweight tasks, such as summaries, documentation search, and field metadata.                  |
  | [validate\_analysis](/modeling/models/parameters/ai-settings/validate-analysis)                            | Controls whether the AI automatically validates its analysis for errors before returning results.                                          |
</ParamField>

## Examples

```yaml title="Expand query scope and validate analysis" theme={null}
ai_settings:
  query_all_views_and_fields: enabled
  validate_analysis: enabled
```

```yaml title="Override model categories (provider-agnostic)" theme={null}
ai_settings:
  analyze_configuration:
    model: smartest
    thinking: medium
  build_configuration:
    model: standard
    thinking: high
  simple_summarize_configuration:
    model: fastest
    thinking: low
```

```yaml title="Restrict AI capabilities for Restricted Queriers" theme={null}
ai_settings:
  allow_custom_fields: not_for_restricted_queriers
  allow_ctes: not_for_restricted_queriers
```