> ## 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 的私有化部署仍处于早期阶段，配置流程较繁琐；请联系 Teable：**[support@teable.ai](mailto:support@teable.ai)**，获取部署协助。

| 准备项                         | 是否必需          | 说明                                           |
| --------------------------- | ------------- | -------------------------------------------- |
| **Agent Runtime 配置**        | AI 对话和应用构建器必需 | 用于 AI 对话和应用构建器                               |
| **自定义服务商**                  | 可选            | 用于已支持的模型调用                                   |
| **OpenAI Realtime API Key** | 可选            | 只有需要在 AI 对话中启用 **语音输入** 时才需要                 |
| **公网访问**                    | 应用发布和附件访问必需   | **Teable 实例** 和 **对象存储（MinIO / S3）** 需要被公网访问 |

## 配置步骤

建议按 **待配置项** 的顺序完成配置，先让必填项变绿，再去测试功能。很多“按钮是灰的”或“功能仍不可用”的情况，通常只是前置项还没完成。

建议按下面四步完成：

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

  <Step title="配置推荐模型">
    先给用户一组清晰的主力模型。
  </Step>

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

  <Step title="配置 Agent Runtime 与应用构建器">
    确认 Agent Runtime 配置状态，再完成应用构建器的访问检查。
  </Step>
</Steps>

### 配置 LLM API

在 **LLM API** 中添加或确认已支持的模型调用所使用的模型服务商。如果添加自定义服务商，请填入它支持的模型，并完成模型测试。

### 配置推荐模型

这一步决定了用户可以选择哪些模型。建议先提供一组清晰的主力模型，方便用户按任务复杂度选择。一个常见的做法是：

| 模型         | 适合场景         |
| ---------- | ------------ |
| **Opus**   | 复杂任务和高质量输出   |
| **Sonnet** | 日常任务，兼顾效果和成本 |
| **Haiku**  | 轻量任务和快速响应    |

### 设置聊天模型

这里要为侧边栏 **AI 对话** 指定默认模型。这个模型需要从推荐模型列表中选择，所以如果这一步是灰的，通常说明前一步还没完成。

这里建议选择已经完成测试、表现稳定的模型。

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

**语音输入** 可以让用户在 AI 对话中用麦克风输入消息。

你可以调整 **单次最长时长（秒）** 和 **每用户每分钟签发次数**。启用并保存语音输入后，用户会在 AI 对话输入框中看到麦克风按钮。

### 配置 Agent Runtime 与应用构建器

私有化部署如需使用 **AI 对话** 和 **应用构建器**，需要先完成 Agent Runtime 配置。Agent Runtime 的私有化部署仍处于早期阶段，配置流程较繁琐；请联系 Teable：**[support@teable.ai](mailto:support@teable.ai)**，获取部署协助。

<Steps>
  <Step title="确认 Agent Runtime 状态">
    确认当前部署已包含所需的 Agent Runtime 配置。
  </Step>

  <Step title="完成应用构建器配置">
    确认 **测试公网访问** 通过，再按需配置自定义域名、应用登录等可选项。
  </Step>
</Steps>

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

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

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

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

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

<Tip>
  点击页面中的 **测试公网访问**，确认 **Teable 实例** 和 **对象存储（MinIO / S3）** 都已经可以从公网访问。
</Tip>

**如何验证配置是否完成**

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

## 常见问题

<AccordionGroup>
  <Accordion title="设置聊天模型是灰的">
    先回到上一步完成 **配置推荐模型**。聊天模型只能从推荐模型列表中选择。
  </Accordion>

  <Accordion title="明明填了 API Key，右侧还是没变绿">
    先回看右侧 **待配置项**，确认缺的是哪一项。很多时候不是当前这一步没保存，而是前面的配置还没有补齐。
  </Accordion>

  <Accordion title="提示还缺少 Agent Runtime 配置">
    请检查当前部署是否已完成 Agent Runtime 配置。Agent Runtime 的私有化部署仍处于早期阶段，配置流程较繁琐；请联系 Teable：**[support@teable.ai](mailto:support@teable.ai)**，获取部署协助。
  </Accordion>

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