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

​
开始前的准备

在进入 AI 配置页之前，先确认下面这些准备项已经就绪。Agent Runtime 的私有化部署仍处于早期阶段，配置流程较繁琐；请联系 Teable：support@teable.ai，获取部署协助。
准备项是否必需说明
Agent Runtime 配置AI 对话和应用构建器必需用于 AI 对话和应用构建器
自定义服务商可选用于已支持的模型调用
OpenAI Realtime API Key可选只有需要在 AI 对话中启用 语音输入 时才需要
公网访问应用发布和附件访问必需Teable 实例 和 对象存储（MinIO / S3） 需要被公网访问

​
配置步骤

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

配置 LLM API

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

配置推荐模型

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

设置聊天模型

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

配置 Agent Runtime 与应用构建器

确认 Agent Runtime 配置状态，再完成应用构建器的访问检查。

​
配置 LLM API

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

​
配置推荐模型

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

​
设置聊天模型

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

​
可选：配置语音输入

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

​
配置 Agent Runtime 与应用构建器

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

确认 Agent Runtime 状态

确认当前部署已包含所需的 Agent Runtime 配置。
2

完成应用构建器配置

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

​
常见问题

先回到上一步完成 配置推荐模型。聊天模型只能从推荐模型列表中选择。
先回看右侧 待配置项，确认缺的是哪一项。很多时候不是当前这一步没保存，而是前面的配置还没有补齐。
请检查当前部署是否已完成 Agent Runtime 配置。Agent Runtime 的私有化部署仍处于早期阶段，配置流程较繁琐；请联系 Teable：support@teable.ai，获取部署协助。
请检查当前模型服务对应的账户或服务商额度，必要时充值或调整模型配置。
最后修改于 2026年7月1日