GET
/
api
/
knowledgebases
/
query
curl --request GET \
  --url https://app.pathors.com/api/knowledgebases/query \
  --header 'x-api-key: <x-api-key>'
{
  "id": "<string>",
  "content": "<string>",
  "contentLength": 123
}

​
查询文本片段

基于语义搜索查询从知识库中获取相关的文本片段。

​
接口

GET /api/knowledgebases/query

​
请求头

​
x-api-key
string
required

用于认证的项目 API 密钥

​
查询参数

​
q
string
required

用于匹配知识库内容的搜索查询

​
topK
number

返回结果的最大数量。默认为 5

​
scoreThreshold
number

返回结果的最低相关性分数阈值。默认为 0.3

请求示例：

GET /api/knowledgebases/query?q=搜索关键词&topK=5&scoreThreshold=0.3

​
响应

返回与查询匹配的文本片段数组，按相关性排序。

​
id
string

文本片段的唯一标识符

​
content
string

文本片段的内容

​
contentLength
number

文本片段的内容长度

响应示例：

[
  {
    "id": "chunk_abc123",
    "content": "产品功能包括实时分析...",
    "contentLength": 82
  }
]

​
错误响应

状态码描述
400无效的查询参数
401无效的 API 密钥
404未找到知识库
500内部服务器错误

​
工作原理

  1. 查询文本使用与知识库相同的模型转换为嵌入向量
  2. 使用嵌入向量对存储的文本片段进行语义相似度搜索
  3. 返回最相关的文本片段，按相似度分数排序
  4. 结果数量限制为指定的 topK 参数值

​
使用说明

  • 查询使用语义搜索处理，而不是精确文本匹配
  • 结果按与查询的相关性排序返回
  • 响应包含来自所有数据集中最相关的文本片段
  • 使用 topK 参数控制返回结果的数量
  • 制定查询时请考虑上下文以获得最佳结果

​
相关接口