Skip to main content
Available for self-hosted Business plan and above
Path: System Admin → AI settings The AI settings page is used to configure AI Chat, AI fields, AI automation, and App Builder. The Pending configuration panel on the right shows which required items are still missing.

​
Before you start

Before you open the AI settings page, make sure the following items are ready.

​
Setup steps

The setup wizard at the top of the page walks through three steps for connecting and choosing models:
1

Configure LLM API

Set up your model connection and complete the initial test.
2

Configure Recommended Models

Choose the recommended models for AI fields and AI automation.
3

Set Chat Model

Choose a model for each of the four chat model tiers.
AI Chat and App Builder also need a runtime and app deployment, which are not part of the wizard. Choose a deployment option and complete the deployment first, then configure the runtime and App Builder as described below.

​
Configure LLM API

In the Configure LLM API step, click Add LLM provider to add a model provider, then test its models. If you use your own key (BYOK), choose OpenAI Compatible or Anthropic as the provider type. The Configure LLM API step with a custom provider added A model’s context window and maximum output per response are resolved automatically from the Model catalog; there is nothing to fill in. To check the values resolved for a model, open Model catalog, choose a Scope under Inspect model and select the model; Parameter details then lists the context, max output, and the source of each value. When the catalog holds no matching entry (a newly released or self-built model, for example), the model runs on the values set under Nothing matched in Matching rules: a context window of 200000 and a max output of 32000 by default, with Matching rule shown as the source of both in Parameter details. If those values do not fit the model, adjust them in Matching rules and click Save. Choose the recommended models users can select in AI fields and AI automation.

​
Set Chat Model

In Chat model tiers, pick a model for Ultra, Smart, Standard, and Lite; the models you can pick are the recommended models from step 2, Configure Recommended Models. Users choose by tier in the model menu of sidebar AI Chat and see the tier name rather than the model name, so you can swap the model behind a tier at any time without affecting anyone who already picked it. Each tier has two more controls on its right:
  • Set as default: the tier users land on when they open the model menu. An Ultra with no model cannot be the default.
  • Enabled: turn it off and the tier is no longer offered to users. The default tier cannot be turned off.

​
Configure the runtime

The runtime is configured in the AI Chat Runtime card below the wizard. After the deployment is complete, click Run test to verify the AI Chat runtime.

​
Enable AI features

In AI Capabilities, enable AI Field and AI Chat as needed. Configure the runtime before using AI Chat.

​
Configure App Builder

In Deployment Engine, choose how apps are deployed: You can add these optional App Builder settings when needed: In App Auth, you can configure sign-in providers for generated apps:
  • Email OTP uses an independent SMTP mailbox for app login verification emails.
  • Google OAuth requires a Client ID and Client Secret. Add the redirect URI shown on this page to the authorized redirect URI list in Google Cloud Console.
Teable sign-in is available by default. Email OTP appears in App Builder only after the SMTP settings are complete, and Google appears only after both OAuth credentials are configured. Auto-inject AI API Key into apps is on by default, so apps can call the platform’s AI models. Turn it off and apps can no longer reach them.

​
Optional. Configure Voice input

To use voice input in AI Chat, enable the feature and enter an OpenAI API Key. Configure the Transcription Endpoint only when using a custom transcription service. You can also limit the recording length and requests per minute.

​
Verify the setup

After the setup is done, first confirm that all required items in the Pending configuration panel are green. Then test AI Chat, AI fields, AI automation, and App Builder one by one.

​
FAQ

Check the account or provider used by your configured model service. Top up or change the model configuration if needed.
Last modified on October 21, 2026