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

> 为私有化部署实例配置 AI 对话、AI 字段、AI 自动化和应用构建器。

<Tip>私有化部署商业版及以上适用</Tip>

路径：管理面板 → AI 配置

**AI 配置** 页用于配置 **AI 对话**、**AI 字段**、**AI 自动化** 和 **应用构建器**。右侧的 **待配置项** 会提示当前还缺少哪些关键配置。

## 开始前的准备

在进入 AI 配置页之前，先确认下面这些准备项已经就绪。

| 准备项                  | 是否必需                    | 说明                                                      |
| -------------------- | ----------------------- | ------------------------------------------------------- |
| **Agent Runtime 配置** | AI 对话和应用构建器必需           | 用于 AI 对话和应用构建器                                          |
| **自定义服务商**           | AI 对话或应用构建器使用自带 Key 时必需 | 提供商类型选择 **OpenAI Compatible**（OpenAI 兼容）或 **Anthropic** |
| **OpenAI API Key**   | 可选                      | 只有需要在 AI 对话中启用 **语音输入** 时才需要                            |
| **公网访问**             | 选择 **Vercel** 部署引擎时必需   | **Teable 实例** 和 **对象存储（MinIO / S3）** 需要被 Vercel 从公网访问   |

## 配置步骤

先完成 AI 对话运行环境、应用部署和模型配置：

<Steps>
  <Step title="配置 AI 对话运行环境和应用部署">
    先查看[部署方式](/zh/deploy/choose)并完成部署，再点击 **运行测试** 和 **测试连接**。
  </Step>

  <Step title="配置 LLM API">
    先完成模型接入和基础验证。
  </Step>

  <Step title="配置推荐模型">
    选择供 AI 字段和 AI 自动化使用的推荐模型。
  </Step>

  <Step title="设置聊天模型">
    为 AI 对话指定默认模型。
  </Step>
</Steps>

### 配置运行环境

点击 **运行测试** 验证 AI 对话运行环境。

### 配置 LLM API

在 **LLM API** 中添加模型服务商，并完成模型测试。使用自带 Key 时，请将提供商类型选为 **OpenAI Compatible**（OpenAI 兼容）或 **Anthropic**。

如需检查或调整模型参数，请打开该模型的 **模型配置**：

| 配置项       | 作用                         |
| --------- | -------------------------- |
| **上下文窗口** | 可选。设置上下文压缩使用的最大输入 Token 数。 |
| **最大输出**  | 可选。设置模型单次响应最多生成的 Token 数。  |

### 配置推荐模型

选择用户可以在 **AI 字段** 和 **AI 自动化** 中使用的推荐模型。

### 设置聊天模型

为侧边栏 **AI 对话** 选择默认模型。聊天模型只能从推荐模型列表中选择。

### 启用 AI 功能

在 **AI 能力** 中按需启用 **AI 字段** 和 **AI 聊天**。使用 **AI 聊天** 前，需要先完成运行环境配置。

### 配置应用构建器

在 **部署引擎** 中选择应用的部署方式：

| 部署引擎             | 配置要求                                                                     |
| ---------------- | ------------------------------------------------------------------------ |
| **Vercel**       | 填写 Vercel 访问令牌，点击 **测试连接**，并使用 **测试公网访问** 确认 Vercel 可以访问 Teable 实例和对象存储。 |
| **Teable Infra** | 使用已配置的 Teable Infra 容器运行时，无需在此填写额外凭据或测试公网访问。                             |

如有需要，可以继续补充下面这些应用构建器可选配置：

| 可选项       | 什么时候需要                               |
| --------- | ------------------------------------ |
| **自定义域名** | 需要把应用发布到自己的域名下                       |
| **应用登录**  | 生成的应用需要支持 **邮箱验证码** 或 **Google** 登录时 |

在 **应用登录** 中，可以为生成的应用配置登录提供方：

* **邮箱验证码** 使用独立 SMTP 邮箱发送应用登录验证码。
* **Google 登录** 需要填写客户端 ID 和客户端密钥，并将页面中显示的回调地址添加到 Google Cloud Console 的已授权重定向 URI。

**Teable 登录** 默认可用。只有完整配置 SMTP 后，**邮箱验证码** 才会出现在应用构建器的登录设置中；只有同时配置 Google 客户端 ID 和密钥后，**Google** 登录才会出现。

### 可选：配置语音输入

如需在 AI 对话中使用语音输入，请启用该功能并填写 **OpenAI API Key**。只有使用自定义转写服务时，才需要配置 **转写 Endpoint**。你还可以按需限制录音时长和每分钟请求次数。

### 验证配置

完成配置后，先确认右侧 **待配置项** 的必填项都已变绿。然后依次测试 **AI 对话**、**AI 字段**、**AI 自动化** 和 **应用构建器**。

## 常见问题

<AccordionGroup>
  <Accordion title="出现 credit exceeded 报错">
    请检查当前模型服务对应的账户或服务商额度，必要时充值或调整模型配置。
  </Accordion>
</AccordionGroup>