AI 原生 BaaS 平台 Supabase 版
AI 原生 BaaS 平台 Supabase 版
AI 原生 BaaS 平台 Supabase 版
文档指南
请输入
用户指南
Supabase 引擎用户指南
Workspace 管理
任务管理
使用 Supabase 控制台
使用 Authentication
使用 Realtime
PostgreSQL 引擎用户指南
Workspace 管理
任务管理
插件
AI Function 智能处理（rds_ai）
veDB MySQL 引擎用户指南（邀测）
Workspace 管理
任务管理
API 参考
Workspace 管理
分支管理
算力管理
账号管理
连接管理
前端部署
大模型访问管理
SQL 限流
开发者工具
最佳实践
相关协议
- 文档首页
AI 原生 BaaS 平台 Supabase 版用户指南PostgreSQL 引擎用户指南插件AI Function 智能处理（rds_ai）快速开始
复制全文
下载 pdf快速开始
文档反馈
问问助手这篇文档解决什么问题
- 第一次接触 rds_ai 时，应该先完成哪些最小配置。
- 怎样在几分钟内跑通一个可以验证成功的 SQL 示例。
- 如果失败，优先去哪篇文档继续排查。
前置条件
- 实例已安装 pgcrypto；检索场景还需要 vector。
- 已准备可用的模型访问凭据，并允许对应模型域名访问。
说明
新装或从 1.3 升级后，预置模型不会自动保留。第一次调用前，建议由高权限角色先执行 SELECT rds_ai.load_preset_models();。
最小步骤
- 创建扩展：执行 CREATE EXTENSION rds_ai CASCADE;。
- 落仓预置模型：执行 SELECT rds_ai.load_preset_models();。
- 配置域名白名单：允许当前模型端点所在域名。
- 设置 API Key：使用 rds_ai.set_apikey() 写入访问凭据。
- 确认默认模型：使用 rds_ai.get_default_model() 检查 ai_query 的默认模型。
- 发起调用：执行一次最小 ai_query 请求。
CREATE EXTENSION rds_ai CASCADE;
SELECT rds_ai.load_preset_models();
ALTER SYSTEM SET rds.ai_domain_allowlist =
'https://ark.cn-beijing.volces.com/';
SELECT pg_reload_conf();
SELECT rds_ai.set_apikey('ark', 'replace-with-real-api-key');
SELECT * FROM rds_ai.get_default_model();
SELECT rds_ai.ai_query('你好');
成功标志
- get_default_model() 中 ai_query 对应模型非空。
- ai_query 返回模型文本，而不是默认模型为空、认证失败或网络访问错误。
- 继续进入后续能力页时，不需要重新解释实例级基础配置。
最小排查路径
如果你遇到 | 优先看 |
如果你遇到 | 优先看 |
扩展创建失败 | |
默认模型为空 | |
domain not allowed / 认证失败 | |
想继续做检索或 RAG |
相关文档
最近更新时间：2026.10.21 12:50:07
这个页面对您有帮助吗？
有用
有用
无用
无用