You need to enable JavaScript to run this app.
文档中心
AI 原生 BaaS 平台 Supabase 版

AI 原生 BaaS 平台 Supabase 版

复制全文
下载 pdf
AI Function 智能处理(rds_ai)
配置与访问控制
复制全文
下载 pdf
配置与访问控制
支持范围与依赖​
  • 当前支持 PostgreSQL 17。​
  • rds_ai 依赖 pgcrypto;检索相关能力还依赖 vector。​
扩展安装与升级​
安装与升级示例如下:​
​
-- 已安装旧版本时升级​
ALTER EXTENSION rds_ai UPDATE TO '1.4';​
​
-- 需要显式创建 1.4 时​
CREATE EXTENSION rds_ai VERSION '1.4' CASCADE;​
​
说明​
预置模型采用按需落仓方式管理。升级完成后,建议重新检查默认模型、API Key 和代理密码是否仍然有效。​
模型与默认模型​
​
概念​
说明​
Model​
描述模型 ID、类型、端点、请求模板和响应解析方式。​
默认模型​
不同函数族依赖不同类型的默认模型,例如 ai_query 依赖 chat 模型,ai_embed 依赖 embedding 模型,ai_rank 依赖 rank 模型。​
预置模型​
建议先用平台预置模型跑通,再按需要新增自定义模型。​
​
常用模型管理接口:​
​
SELECT rds_ai.load_preset_models();​
SELECT * FROM rds_ai.list_model();​
SELECT * FROM rds_ai.get_default_model();​
SELECT rds_ai.set_default_model('ai_query', 'your-chat-model');​
​
API Key 与凭据管理​
  • 使用 set_apikey / remove_apikey 管理模型访问凭据。​
  • 不要在 SQL、日志、截图或工单里暴露真实 API Key。​
  • 如需代理,统一由高权限角色配置代理密码,并在迁移或恢复后重新核验。​
域名白名单与网络限制​
  • 模型调用会校验 rds.ai_domain_allowlist。​
  • 预置模型和自定义模型的端点域名都必须被显式允许。​
  • 如果切换模型服务商,白名单通常也需要同步更新。​
白名单配置示例如下:​
​
ALTER SYSTEM SET rds.ai_domain_allowlist =​
'https://ark.cn-beijing.volces.com/';​
SELECT pg_reload_conf();​
​
角色与权限边界​
  • 平台管理员:负责启用扩展、安装依赖、设置实例级白名单和平台策略。​
  • 高权限数据库角色:负责模型、API Key、默认模型、统计与限流管理。​
  • 普通应用用户:可调用公开 AI 函数,但 ai_retrieve、ai_rag 等以 SECURITY INVOKER 运行的函数会按调用者身份继续校验表权限与 RLS。​
上线前检查清单​
  • 扩展版本是否正确。​
  • 预置模型是否已落仓。​
  • 默认模型是否设置完整。​
  • API Key 是否可用。​
  • 目标域名是否进入 allowlist。​
  • 调用者是否具备需要的对象权限。​
相关文档​
最近更新时间:2026.10.21 12:50:07
这个页面对您有帮助吗?
有用
有用
无用
无用