Skip to content

AI Configuration

Configure AI providers and model settings for the WitFoo Analytics AI assistant.

Opening AI Setup

Open the Settings menu in the page header, then go to General Settings > AI Setup. The page needs the ai:manage permission.

Provider Setup

The AI Providers section lists the configured providers. Click Add Provider to add one. Each row can be enabled, disabled, edited or deleted.

Supported Providers

Provider Notes
Anthropic Claude Needs an API key
OpenAI Needs an API key
Google Gemini Needs an API key
IBM watsonx.ai Needs an API key and a project ID
Ollama (Local) Needs a base URL instead of an API key

Configuration Fields

Field Description
Provider AI service provider
API Key Provider API key, encrypted at rest. Not shown for Ollama.
Model ID The model to use. Available Models lists the models the provider offers.
Project ID IBM watsonx.ai only
Region IBM watsonx.ai only. Leave it blank for us-south.
Base URL Ollama only. Default: http://localhost:11434
Max Tokens Maximum response length (256 to 100,000)
Temperature Response creativity (0 to 2)

Stored URLs are shown without credentials

The settings pages show a configuration's base URL without its user information, query or fragment. To remove a credential from a stored URL, clear the field, save, and enter the URL again.

Other sections

AI Setup also holds the Model Profile, Response Jobs and Summaries settings.

When a setting cannot be read

When AI Setup cannot read a setting, it shows an error and a Retry instead of default values. Save stays disabled until a retry succeeds, so a failed read can never be saved over your settings.

MCP Authentication

The MCP Authentication section of AI Setup decides who can connect over MCP. It is shown to holders of mcp:manage. See MCP Configuration.

Permissions

Action Required Permission
Open AI Setup and change providers ai:manage
Change the MCP mode and manage keys mcp:manage