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_rank）
复制全文
下载 pdf文本重排（ai_rank）
文档反馈
问问助手- 定义
rds_ai.ai_rank 使用已注册的 rank 模型对候选文本数组按与查询的相关性打分，并按分数从高到低返回结果，常用于向量检索后的二次精排。
- 语法
rds_ai.ai_rank(
query text,
document text[],
args jsonb DEFAULT '{}',
model_name text DEFAULT NULL
) RETURNS TABLE(score_value double precision, text_value text)
- 参数
参数 | 类型 | 默认值 | 说明 |
参数 | 类型 | 默认值 | 说明 |
query | text | 无 | 用于重排的查询文本，不能为 SQL NULL。 |
document | text[] | 无 | 待重排的候选文本数组，必须是一维且不含 NULL 元素；为空数组时直接返回空结果。 |
args | jsonb | {} | 重排参数对象，仅支持 top_n 和 instruct 两个键。top_n 为 1~2147483647 的正整数，限制返回条数，缺省时返回全部候选；instruct 为字符串，作为重排指令随请求传给模型。 |
model_name | text | SQL NULL | rank 模型名称；为 SQL NULL 时使用 ai_rank 默认模型，未设置默认模型时抛出错误。 |
- 返回
- 返回 TABLE(score_value double precision, text_value text)。score_value 为模型给出的相关性分数，text_value 为对应的原始候选文本。
- 结果按 score_value 从高到低排列；分数相同时按模型返回的原始序号升序稳定排列，最多返回 top_n 条。
- document 为空数组时返回空结果集。
- 错误行为
- args 不是 JSON 对象、包含 top_n / instruct 以外的键，或 top_n / instruct 的类型或取值不合法时抛出参数错误。
- query 为 SQL NULL，或 document 为多维数组、含 NULL 元素时抛出错误。
- 默认模型未设置、model_name 为空字符串、模型不存在或类型不是 rank 时抛出错误。
- 未配置专用 rerank API Key 时回退到全局 API Key；两者都缺失时抛出鉴权错误。
- rerank HTTP 请求非 200、响应体不是合法 JSON、results 结构非法（非数组、元素非对象，index 越界/重复/非法，relevance_score 非数值），或 Token 提取失败/为负时抛出错误。
- 白名单、超时、响应大小、并发和 token 配额行为与其他模型调用一致。
- 示例
- 按相关性重排并取前 1 条
SELECT *
FROM rds_ai.ai_rank(
'PostgreSQL 如何创建向量索引？',
ARRAY['使用 CREATE INDEX 创建索引', 'VACUUM 用于回收空间'],
'{"top_n":1}'::jsonb
);
- 设置 ai_rank 默认模型与专用 rerank 密钥后调用
SELECT rds_ai.set_default_model('ai_rank', 'qwen3-reranker-0.6b');
SELECT rds_ai.set_rerank_apikey('context-search-rerank', 'replace-with-rerank-api-key');
SELECT text_value, score_value
FROM rds_ai.ai_rank(
'如何回收表空间？',
ARRAY['VACUUM 用于回收空间', 'CREATE INDEX 创建索引']
);
最近更新时间：2026.10.21 12:50:07
这个页面对您有帮助吗？
有用
有用
无用
无用