跳转到主要内容
POST
从知识库检索分段 / 测试检索

授权

Authorization
string
header
必填

每个请求都通过 API Key 认证:Authorization: Bearer {API_KEY}。应用接口使用应用 API Key,知识库接口使用知识库 API Key(快速开始)。

API Key 应保存在服务端,切勿嵌入客户端代码。缺失或无效的 Key 会返回 HTTP 401unauthorized)。

路径参数

dataset_id
string<uuid>
必填

知识库 ID。从 获取知识库列表 获取。

请求体

application/json
query
string
必填

搜索查询文本。

Maximum string length: 250
retrieval_model
object

检索模型配置。控制查询此知识库时如何搜索和排序分段。

attachment_ids
string[] | null

要包含在检索上下文中的附件 ID 列表。

external_retrieval_model
object

外部知识库的检索设置。

响应

检索结果。

query
object

原始查询对象。

records
object[]

匹配的检索记录列表。