语义向量搜索
GET
/v1/ai/{project_id}/search使用可调阈值和 top-k 限制跨向量命名空间执行高性能语义相似性查询。
该页面已自动翻译。英文版具有权威性。
#
查询
查询参数
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
query | string | 是的 | 搜索短语或自然语言查询。 |
namespace | string | 是的 | 要查询的目标分区命名空间。 |
top_k | number | 不 | 返回的最大文档数(默认 5,最大 100)。 |
threshold | number | 不 | 从 0.0 到 1.0 的最小余弦相似度阈值(默认 0.7)。 |
#
性能
动态 HNSW 调整
信息
搜索端点根据请求的 top_k ((top_k * 4).max(64)) 动态设置 PostgreSQL的 hnsw.ef_search 变量,即使在过滤后索引候选时也能保证高召回率。
v1.0·修订 2026年10月31日