知识库语义检索测试

POST

/admin/knowledge-documents/search

将查询文本向量化后与知识库分块做余弦相似度计算，按相似度降序返回 Top-N 分块，用于验证知识库召回效果。仅检索已完成索引且启用的文档。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json

示例

{
    "query": "string",
    "limit": 5
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

Objective-C

Ruby

OCaml

Dart

cURLcURL-WindowsPowerShell

curl --location 'http://prod-cn.your-api-server.com/admin/knowledge-documents/search' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "query": "string",
    "limit": 5
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

[
    {
        "chunk_id": 0,
        "document_id": 0,
        "document_title": "string",
        "content": "string",
        "score": 0
    }
]

修改于 2026-10-22 04:15:16

知识库文档分块列表

定时任务列表