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）语义生成（ai_query）
复制全文
下载 pdf语义生成（ai_query）
文档反馈
问问助手- 定义
rds_ai.ai_query 调用已注册的 chat 模型，根据输入文本生成并返回文本结果。
- 语法
- 使用默认模型
rds_ai.ai_query(input text) RETURNS text
- 显式指定模型
rds_ai.ai_query(
content text,
model_name text,
body_extra text DEFAULT '{}',
header_extra text DEFAULT '{}'
) RETURNS text
- 参数
参数 | 类型 | 默认值 | 说明 |
参数 | 类型 | 默认值 | 说明 |
input | text | 无 | 使用默认模型时的输入文本；该重载为 STRICT，SQL NULL 直接返回 SQL NULL。 |
content | text | 无 | 显式指定模型时的输入文本；建议传入非空文本。 |
model_name | text | 无 | 已注册且类型为 chat 或 LLM 的模型名称。 |
body_extra | text | {} | JSON 对象字符串，合并到请求体；可用于设置 temperature（控制输出随机性）、max_tokens（限制最大输出 token 数）、thinking（控制模型思考模式）等供应商参数。实际是否支持及取值范围以目标模型为准。 |
header_extra | text | {} | JSON 对象字符串，合并到请求头；同名头覆盖会话 GUC 和模型模板中的值，头名大小写不敏感。 |
- 返回
返回 text，内容是模型响应经模型元数据中的 json_path 提取后的结果；默认模型重载在 input 为 SQL NULL 时返回 SQL NULL。
- 错误行为
- 默认模型未配置、显式模型不存在或模型类型不兼容时抛出错误。
- body_extra 或 header_extra 不是 JSON 对象、与请求模板无法合并时抛出错误。
- URL 不在白名单、API Key/代理配置无效、连接或总超时、HTTP 非成功状态、响应过大时抛出错误。
- 响应无法按 json_path 提取，或 token 提取表达式失败时抛出错误。
- 达到实例并发上限时等待可用名额；达到日/月 token 配额时拒绝请求并抛出错误。
- 示例
- 使用默认模型
SELECT rds_ai.ai_query('Hello world');
- 显式指定模型和请求参数
SELECT rds_ai.ai_query(
'Hello world',
'Doc-Chat-Model'
);
最近更新时间：2026.10.21 12:50:07
这个页面对您有帮助吗？
有用
有用
无用
无用