单轮 RAG 查询

POST

/rag/query

根据用户问题检索相关文档并生成回答，返回 SSE 流式响应。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "question": "习近平同志指出了什么",
    "document_ids": [
        6
    ],
    "top_k": 2
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/rag/query' \
--header 'X-User-ID: {{X-User-ID}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "question": "习近平同志指出了什么",
    "document_ids": [
        6
    ],
    "top_k": 2
}'

返回响应

🟢200成功

text/event-stream

SSE (Server-Sent Events) 流式响应。

SSE 数据格式

每条消息格式为 data: <json>\n\n，其中 JSON 结构：

{
  "role": "assistant",
  "content": "文本片段"
}

流结束标志：data: [DONE]\n\n

错误响应（SSE 格式）

data: {"error": "错误信息"}

Body

示例

data: {"role": "assistant", "content": "机器"}

data: {"role": "assistant", "content": "学习"}

data: {"role": "assistant", "content": "是一种"}

data: {"role": "assistant", "content": "人工智能的分支..."}

data: [DONE]

🟠422422 参数错误

修改于 2025-12-04 05:17:20

[说明] 完整使用流程示例

多轮对话 RAG