Skip to main content
知识检索与问答

知识问答

基于知识库的 SSE 流式问答

POST
/api/v2/apps/bailian-rag-agent/knowledge/chat
cURL
curl -X POST "https://{workspaceId}.cn-beijing.maas.aliyuncs.com/api/v2/apps/bailian-rag-agent/knowledge/chat" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "messages": [{"role": "user", "content": "什么是RAG?"}]
    },
    "parameters": {
      "agent_options": {
        "agent_id": "aid-xxx",
        "agent_version": "beta"
      }
    },
    "stream": true
  }'
{
  "output": {
    "choices": [
      {
        "message": {
          "role": "assistant",
          "extra": {
            "step_change": "generation_start",
            "step": "generating",
            "group": "generating"
          },
          "content": "根据检索到的文档...",
          "tool_calls": []
        },
        "finish_reason": ""
      }
    ]
  },
  "code": "200",
  "message": "Success",
  "request_id": "xxx"
}
该接口走 DashScope 应用网关(/api/v2/apps/bailian-rag-agent/),与知识库管理接口路径前缀不同。
响应以 SSE 流式事件返回,事件生命周期为:tool_calling → tool_return → plan_start → planning → plan_end → generation_start → generating → generation_endtool_calling → tool_return 可能循环多次。

Authorizations

string
header
required

DashScope API Key,在控制台 API Key 页面(https://rag.console.aliyun.com/settings/apikey)获取。

Body

application/json
object
required

输入参数。

object
required

请求参数。

boolean
defaulttrue
required

是否开启流式输出。

Response

200-application/json
object
string

响应码。

string

响应消息。

string

请求唯一标识,排查问题时请提供此 ID。