AI Chatbot fields and settings

Every field well and every setting in the format pane of version 1.1.0.0, read from the package you download. The internal names in grey are what a PBIR file or a report-authoring agent uses. Which features need a licence is on the AI Chatbot page; every setting works in edit mode with or without one.

2 fields · 19 cards · 105 settings Markdown for AI assistants catalog.json

Fields

Field	Takes	Needed	What it is for
Data`data`	Column or measure	Optional	—
Values`values`	Column or measure	Optional	—

License`licenseSettings`

Setting	Type and options
License Key`licenseKey`Optional. Enter your free or paid SmartVisuals licence key to enable AI chat and premium analytics	Text
Show Usage Indicator`showUsageBar`Shows how many messages from monthly limit you have used	On / off

AI Provider`apiProviderSettings`

Setting	Type and options
Select AI Provider`selectedProvider`Choose your AI provider (Bring Your Own Key)	SmartVisuals AI (included) `smartvisuals` OpenAI (GPT) `openai` Anthropic (Claude) `anthropic` Google (Gemini) `google` xAI (Grok) `xai` Azure OpenAI `azure`
Show Provider Switcher in Menu`showProviderSwitcher`Enable quick provider switching in hamburger menu	On / off
✓ Enable OpenAI`openaiEnabled`Show OpenAI in provider switcher menu	On / off
✓ Enable Anthropic`anthropicEnabled`Show Anthropic in provider switcher menu	On / off
✓ Enable Google`googleEnabled`Show Google in provider switcher menu	On / off
✓ Enable xAI`xaiEnabled`Show xAI (Grok) in provider switcher menu	On / off
✓ Enable Azure OpenAI`azureEnabled`Show Azure OpenAI in provider switcher menu	On / off
OpenAI API Key`openaiApiKey`Your OpenAI API key	Text
OpenAI Model`openaiModel`	GPT-6 Luna (fast, low cost) `gpt-6-luna` GPT-6 Sol `gpt-6-sol` GPT-6 Astra (most capable) `gpt-6-astra` Custom Model `custom`
Custom OpenAI Model Name`customOpenAiModel`Enter a model ID from your OpenAI account (e.g., gpt-6-sol)	Text
Anthropic API Key`anthropicApiKey`Your Anthropic API key	Text
Anthropic Model`anthropicModel`	Claude Haiku 5.5 `claude-haiku-5-5` Claude Sonnet 5.5 `claude-sonnet-5-5` Claude Opus 5.5 `claude-opus-5-5` Claude Fable 5.1 `claude-fable-5-1` Custom Model `custom`
Custom Anthropic Model Name`customAnthropicModel`Enter a model ID (e.g., claude-sonnet-5-5)	Text
Google API Key`googleApiKey`Your Google AI API key	Text
Google Model`googleModel`	Gemini 3.5 Flash-Lite (low cost) `gemini-3.5-flash-lite` Gemini 3.8 Flash `gemini-3.8-flash` Gemini 3.1 Pro (preview) `gemini-3.1-pro-preview` Custom Model `custom`
Custom Google Model Name`customGoogleModel`Enter a model ID (e.g., gemini-3.8-flash)	Text
xAI API Key`xaiApiKey`Your xAI API key	Text
xAI Model`xaiModel`	Grok 4.3 (lower cost, 1M context) `grok-4.3` Grok 4.7 `grok-4.7` Custom Model `custom`
Custom xAI Model Name`customXaiModel`Enter custom model name (e.g., grok-3)	Text
Azure API Key`azureApiKey`Your Azure OpenAI API key	Text
Azure Endpoint`azureEndpointUrl`Your Azure OpenAI endpoint URL (e.g. https://myresource.openai.azure.com)	Text
Deployment Name`azureDeploymentName`Your model deployment name	Text
API Version`azureApiVersionStr`API version (default: 2024-02-15-preview)	Text

Chatbot Behavior`chatSettings`

Setting	Type and options
Azure Endpoint`azureEndpoint`Your Azure OpenAI endpoint (only for Azure)	Text
Max Response Length`maxTokens`Maximum tokens in an AI answer (free plan: up to 1500)	Number
AI Creativity`temperature`0 = Focused, 1 = Creative	Number
System Prompt`systemPrompt`Instructions for AI behavior	Text
Welcome Message`welcomeMessage`Custom welcome message shown at the start of a conversation	Text
Save Conversation History`saveConversationHistory`Off by default. When on, the conversation (questions, answers and the data shown in them) is stored on SmartVisuals servers so it can be reopened later	On / off
Enable Context Memory`enableContextMemory`Include previous messages as context for AI responses	On / off
Context Message Count`maxContextMessages`How many previous messages to include as context	Number

Language`languageSettings`

Setting	Type and options
Interface Language`selectedLanguage`Choose your preferred language for the chatbot interface	Auto (Power BI language) `auto` 🇺🇸 English `en` 🇨🇿 Čeština `cs` 🇩🇪 Deutsch `de` 🇫🇷 Français `fr` 🇪🇸 Español `es`
Chat Language`chatLanguage`Language for AI responses (leave empty for auto-detection based on your question)	Text

Interface`uiSettings`

Setting	Type and options
Chatbot Name`chatbotName`Custom name for your AI assistant	Text
User Avatar`userAvatar`URL or emoji for user avatar (supports URLs and base64 images)	Text
Assistant Avatar`assistantAvatar`URL or emoji for assistant avatar (only for Blank theme)	Text
Show Avatars`showAvatars`	On / off
Show Typing Indicator`showTypingIndicator`	On / off
Enable Export`enableExport`	On / off
Show AI Suggestions`showSuggestions`	On / off
Enable Copy Button`showCopyButton`	On / off
Enable Animations`enableAnimations`	On / off

Geek Mode`geekModeSettings`

Setting	Type and options
Enable Geek Mode`enableGeekMode`Developer panel with data preview and metrics (Professional+)	On / off
Show in Menu`showInMenu`	On / off
Button Position`buttonPosition`	Text

Instant Insights (Offline)`instantInsightsSettings`

Setting	Type and options
Enable Instant Insights`enableInstantInsights`OFFLINE feature — basic insights (top values, trends, data quality) computed locally on your device. No AI, no API key and no internet involved. On by default — shown automatically when no licence key is set.	On / off
Show Automatically Without API Key`autoRunWhenNoKey`When enabled, offline insights replace the empty state if no license or API key is configured	On / off
Number of Insights`maxInsights`How many insight cards to show (1-8)	Number
Show in Menu`showInMenu`	On / off

Insight Discovery`insightDiscoverySettings`

Setting	Type and options
Enable Insight Discovery`enableInsightDiscovery`Automated dataset analysis that surfaces patterns and trends (Professional+)	On / off
Show in Menu`showInMenu`	On / off
Number of Queries`numberOfQueries`How many smart queries to run during discovery	Number
Query Delay (ms)`queryDelay`Delay between queries to avoid rate limiting	Number
Show Visual Indicator`visualIndicator`	On / off

Theme`themeSettings`

Setting	Type and options
Appearance`selectedTheme`	SmartVisuals (recommended) `smartvisuals` Modern - clean and bright `modern` Terminal - hacker style `terminal` Dark - easy on eyes `dark` Blank - fully customizable `blank`

Colors`colorSettings`

Setting	Type and options
Primary Color`primaryColor`Main theme color	Colour
Accent Color`secondaryColor`Secondary accent color	Colour
Background Color`backgroundColor`Chat area background	Colour
User Message Background`userMessageColor`	Colour
AI Message Background`assistantMessageColor`	Colour
Light Text Color`textColorLight`Text on dark backgrounds	Colour
Dark Text Color`textColorDark`Text on light backgrounds	Colour
User Bubble Text`userBubbleTextColor`Text color inside user message bubbles	Colour
AI Bubble Text`aiBubbleTextColor`Text color inside AI message bubbles	Colour
Input Text`inputTextColor`Text color in the input textbox	Colour
Header Text`headerTextColor`Header title and slogan text color	Colour
Highlight Color`highlightColor`Bold text, links, and emphasis inside messages	Colour
Icon Color`iconColor`Menu icons, send button, and UI controls	Colour
Scrollbar Color`scrollbarColor`Scrollbar thumb color	Colour
Button Color`buttonColor`Suggestion buttons and CTA elements	Colour
Border Accent`borderColor`Blockquote borders and secondary accents	Colour

Visual Effects`effectsSettings`

Setting	Type and options
Glassmorphism`enableGlassmorphism`Translucent blur effects for modern look	On / off
Background Gradients`enableBackgroundGradients`Gradient backgrounds for chat area	On / off
Message Gradients`enableMessageGradients`Gradient backgrounds for messages	On / off
Advanced Shadows`enableAdvancedShadows`Enhanced shadow effects	On / off
Hover Animations`enableHoverEffects`Interactive hover animations	On / off
Message Transparency`enableMessageTransparency`Semi-transparent message bubbles	On / off

Typography`fontSettings`

Setting	Type and options
Font Family`fontFamily`	Inter `Inter, sans-serif` Segoe UI `Segoe UI, sans-serif` Roboto `Roboto, sans-serif` Arial `Arial, sans-serif` Helvetica `Helvetica, sans-serif` Georgia `Georgia, serif` Times New Roman `Times New Roman, serif` Poppins `Poppins, sans-serif` Montserrat `Montserrat, sans-serif`
Base Font Size`fontSize`	Number

Layout`layoutSettings`

Setting	Type and options
Message Padding`messagePadding`	Compact `0.75em 1em` Normal `1em 1.25em` Spacious `1.25em 1.5em`
Message Corner Radius`messageRadius`	Square `0` Slightly Rounded `8px` Rounded `16px` Very Rounded `24px`
Space Between Messages`messageSpacing`	Tight `0.5em` Medium `1em` Large `1.5em`
Maximum Message Width`maxMessageWidth`	Narrow (60%) `60%` Medium (70%) `70%` Wide (80%) `80%` Very Wide (90%) `90%`

Data Context`dataDescriptionSettings`

Setting	Type and options
Enable Custom Descriptions`enableDescriptions`Use custom column descriptions for better AI understanding	On / off
Column Descriptions`columnDescriptions`Format: ColumnName=Description; (e.g. LY_castka=Last year amount; Revenue=Total revenue)	Text
Show Auto-detected Descriptions`showAutoDetected`Display what AI understands from your column names (debug)	On / off

Auto Charts`chartSettings`

Setting	Type and options
Enable Auto Charts`enableAutoCharts`Automatically generate charts from data responses	On / off
Show in Menu`showInMenu`Show chart toggle in hamburger menu	On / off

DAX Assistant`daxAssistantSettings`

Setting	Type and options
Enable DAX Assistant`enableDaxAssistant`	On / off
Show in Menu`showInMenu`	On / off
Visual Indicator`visualIndicator`	On / off

PDF Export`pdfExportSettings`

Setting	Type and options
Enable PDF Export to Email`enablePdfExport`Allow exporting conversations as PDF and sending via email	On / off
Email Recipients (To)`emailRecipients`Comma-separated email addresses (e.g., user@example.com, team@example.com)	Text
CC Recipients`ccRecipients`Comma-separated email addresses for CC	Text
From Name`fromName`Name that will appear as sender (default: Power BI Chatbot)	Text

Advanced`advancedSettings`

Setting	Type and options
Analysis Engine`analysisEngine`Tools: the AI calls local data tools for every number and shows how it got the answer. Classic: the earlier planner pipeline.	Tools (recommended) `tools` Classic `classic`
Show "How I got this"`showProvenance`Show the fields, filters and row counts behind each answer under the answer.	On / off
Enable Response Streaming`enableStreaming`Stream AI responses token by token (OpenAI & Grok only)	On / off
Enable Data Visualization`enableDataVisualization`Allow rich data visualization in responses	On / off
Enable Code Highlighting`enableCodeHighlight`Syntax highlighting for code blocks	On / off
Enable Auto Insights`enableAutoInsights`Automatic insight generation from data	On / off
Debug Mode`debugMode`Show debug information in console (Developer only)	On / off

Debug`debugSettings`

Setting	Type and options
Enable Debug Mode`enableDebugMode`Show debug information in console (Developer license only)	On / off

Setting a value in PBIR

In a visual.json, a setting goes under visual.objects, by card and internal name. Toggles take true or false, choices and text a value in single quotes ('auto'), numbers a D suffix (12D).

"visual": {
  "visualType": "powerBIChatbot76A36CD15A0D",
  "objects": {
    "licenseSettings": [{
      "properties": {
        "showUsageBar": { "expr": { "Literal": { "Value": "true" } } }
      }
    }]
  }
}

AI Chatbot fields and settings

Fields

LicenselicenseSettings

AI ProviderapiProviderSettings

Chatbot BehaviorchatSettings

LanguagelanguageSettings

InterfaceuiSettings

Geek ModegeekModeSettings

Instant Insights (Offline)instantInsightsSettings

Insight DiscoveryinsightDiscoverySettings

ThemethemeSettings

ColorscolorSettings

Visual EffectseffectsSettings

TypographyfontSettings

LayoutlayoutSettings

Data ContextdataDescriptionSettings

Auto ChartschartSettings

DAX AssistantdaxAssistantSettings

PDF ExportpdfExportSettings

AdvancedadvancedSettings

DebugdebugSettings