> ## Documentation Index
> Fetch the complete documentation index at: https://help.teable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Settings

> Configure AI Chat, AI fields, AI automation, and App Builder for a self-hosted instance.

<Tip>Available for self-hosted Business plan and above</Tip>

Path: Admin Panel → 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.

| Requirement             | Required?                                                     | Notes                                                                                              |
| ----------------------- | ------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| **Agent Runtime setup** | Required for AI Chat and App Builder                          | Used by AI Chat and App Builder                                                                    |
| **Custom provider**     | Required when AI Chat or App Builder uses your own key (BYOK) | Use an **OpenAI Compatible** or **Anthropic** provider                                             |
| **OpenAI API Key**      | Optional                                                      | Only needed if you want to enable **Voice input** in AI Chat                                       |
| **Public access**       | Required when the **Vercel** deployment engine is selected    | Your **Teable instance** and **object storage (MinIO / S3)** must be publicly accessible to Vercel |

## Setup steps

Start with the AI Chat runtime, app deployment, and model setup:

<Steps>
  <Step title="Configure the AI Chat runtime and app deployment">
    Choose a [deployment option](/en/deploy/choose) and complete the deployment, then click **Run test** and **Test Connection**.
  </Step>

  <Step title="Configure LLM API">
    Set up your model connection and complete the initial test.
  </Step>

  <Step title="Configure Recommended Models">
    Choose the recommended models for AI fields and AI automation.
  </Step>

  <Step title="Set chat model">
    Choose the default model for AI Chat.
  </Step>
</Steps>

### Configure the runtime

Click **Run test** to verify the AI Chat runtime.

### Configure LLM API

In **LLM API**, add a model provider and test its models. If you use your own key (BYOK), choose **OpenAI Compatible** or **Anthropic** as the provider type.

Open **Model Settings** for a model when you need to review or override these values:

| Setting        | Effect                                                                    |
| -------------- | ------------------------------------------------------------------------- |
| **Context**    | Optional. Sets the maximum input tokens used for context compaction.      |
| **Max output** | Optional. Sets the maximum tokens the model can generate in one response. |

### Configure Recommended Models

Choose the recommended models users can select in **AI fields** and **AI automation**.

### Set chat model

Choose the default model for sidebar **AI Chat**. The chat model must come from the recommended model list.

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

| Deployment engine | Setup requirements                                                                                                                                               |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Vercel**        | Enter a Vercel access token, click **Test Connection**, and use **Test Public Access** to confirm that Vercel can reach your Teable instance and object storage. |
| **Teable Infra**  | Uses the configured Teable Infra container runtime. No additional credentials or public access test is required here.                                            |

You can add these optional App Builder settings when needed:

| Optional item     | When you need it                                             |
| ----------------- | ------------------------------------------------------------ |
| **Custom domain** | When you want to publish apps under your own domain          |
| **App Auth**      | When generated apps need **Email OTP** or **Google** sign-in |

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.

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

<AccordionGroup>
  <Accordion title="I get a credit exceeded error">
    Check the account or provider used by your configured model service. Top up or change the model configuration if needed.
  </Accordion>
</AccordionGroup>