跳转到主要内容
私有化部署商业版及以上适用
路径：管理面板 → AI 配置 AI 配置 页用于配置 AI 对话、AI 字段、AI 自动化 和 应用构建器。右侧的 待配置项 会提示当前还缺少哪些关键配置，建议按顺序逐项完成。

​
开始前的准备

在进入 AI 配置页之前，先确认下面这些准备项已经就绪。AI 聊天运行环境 和 应用构建器 都依赖 Vercel。
只需要一个 Vercel 账户，就可以完成这些配置。当前版本中，如果实例无法访问 Vercel，部分 AI 和 应用构建器 能力会受影响。Teable 正在推进 AI 和应用构建器的完整私有化部署支持，后续版本将不再依赖 Vercel 服务。
准备项是否必需说明
Vercel 账户必需需要一个可用的 Vercel 账户
Vercel API 密钥必需用于 AI 聊天运行环境
Team / Project必需需要一个可用的 Team 和 Project；如果还没有，也可以在 Vercel 中创建
AI Gateway API 密钥使用 AI Gateway 时只在选择 AI Gateway 作为模型服务商时需要
OpenAI Realtime API Key可选只有需要在 AI 对话中启用 语音输入 时才需要
公网访问必需Teable 实例 和 对象存储（MinIO / S3） 需要被公网访问
Vercel 相关费用主要分成两部分：
项目说明
Vercel 基础费用约为 $20/月，用于 App 部署和 AI 运行环境相关基础设施
AI Gateway 模型调用费用按实际调用量单独计费
请确认 Vercel 账户已绑定信用卡，Credit 状态正常，并已开启自动充值。

​
配置步骤

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

配置 LLM API

先完成模型接入和基础验证。
2

配置推荐模型

先给用户一组清晰的主力模型。
3

设置聊天模型

为 AI 对话指定默认模型。
4

配置运行环境与应用构建器

完成 Vercel 相关配置，并确认公网访问准备项已经满足。

​
配置 LLM API

先在 LLM API 中选择模型接入方式。
填写 AI Gateway API 密钥 后，点击 测试。测试通过后，再继续后面的步骤。

​
配置推荐模型

这一步决定了用户可以选择哪些模型。建议先提供一组清晰的主力模型，方便用户按任务复杂度选择。一个常见的做法是：
模型适合场景
Opus复杂任务和高质量输出
Sonnet日常任务，兼顾效果和成本
Haiku轻量任务和快速响应

​
设置聊天模型

这里要为侧边栏 AI 对话 指定默认模型。这个模型需要从推荐模型列表中选择，所以如果这一步是灰的，通常说明前一步还没完成。 这里应选择支持工具调用、并且已经过测试的稳定模型，否则 Agent 能力会明显受限。

​
可选：配置语音输入

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

​
配置运行环境与应用构建器

先完成 AI 聊天运行环境，再完成 应用构建器。
1

完成 AI 聊天运行环境

在 AI 聊天运行环境 中，先填写并验证 Vercel API 密钥，再选择 Team 和 Project，点击 保存，然后点击 测试连接。配置测试通过后，右侧对应的待配置项会变绿。
2

完成应用构建器基础配置

在 应用构建器 中的 Vercel 部署 填写 Vercel 访问令牌。这是发布应用所需的核心配置。
如果你还需要自定义域名，或者你的服务器不能直接访问 Vercel API，可以再补充下面这些可选配置：
可选项什么时候需要
自定义域名需要把应用发布到自己的域名下
应用登录生成的应用需要支持 邮箱验证码 或 Google 登录时
Vercel API 代理地址服务器不能直接访问 Vercel API，或需要通过代理、网关访问
在 应用登录 中，可以为生成的应用配置登录提供方：
  • 邮箱验证码 使用独立 SMTP 邮箱发送应用登录验证码。
  • Google 登录 需要填写客户端 ID 和客户端密钥，并将页面中显示的回调地址添加到 Google Cloud Console 的已授权重定向 URI。
Teable 登录 默认可用。只有完整配置 SMTP 后，邮箱验证码 才会出现在应用构建器的登录设置中；只有同时配置 Google 客户端 ID 和密钥后，Google 登录才会出现。
点击页面中的 测试公网访问，确认 Teable 实例 和 对象存储（MinIO / S3） 都已经可以从公网访问。
如何验证配置是否完成 完成配置后，先确认右侧 待配置项 的必填项都已变绿。然后依次测试 AI 对话、AI 字段、AI 自动化 和 应用构建器。

​
常见问题

先回到上一步完成 配置推荐模型。聊天模型只能从推荐模型列表中选择。
先回看右侧 待配置项，确认缺的是哪一项。很多时候不是当前这一步没保存，而是前面的配置还没有补齐。
这通常表示 AI 聊天运行环境 还没完成。请确认下面三项都已经填写完成：
  • Vercel API 密钥
  • Team
  • Project
只填写 Token 还不够。选择 Team 和 Project 后，需要先保存，再测试连接。
先检查 Vercel 账户里的 Credit 或余额状态，必要时充值，并确认已经开启自动充值。
如果你使用的是 Vercel AI Gateway，请求数据仍会发送到你选择的模型服务商进行处理，因此可能会涉及第三方服务商。如果你对数据安全和合规性有要求，可以在 Vercel AI Gateway 中开启下面这个选项：
  • Only allow providers with Zero Data Retention (ZDR)
开启后，可用模型会限制在支持 Zero Data Retention 的服务商范围内。
即使开启了 ZDR，请求仍然会发送到所选模型服务商处理；区别在于，范围会限制为支持零数据保留的服务商。
Last modified on June 4, 2026