跳转到主要内容
千问AI平台 home page
文档
开始使用

快速开始

5 步创建知识库，完成一次检索与问答

完成本指南后，将创建一个文档知识库，上传文档，在 Playground 中体验检索与问答，并通过 API 发起一次检索请求。
首次登录控制台时自动开通 RAG 知识库服务，并发放 720 小时免费额度。

前置条件

操作步骤

1

创建知识库并上传文档

进入控制台 知识管理，点击 创建知识库。
  1. 填写名称和描述，知识库类型选择 文档搜索，使用场景选择 基础文档问答，点击 下一步。
  2. 数据来源选择 上传文件，拖拽或点击上传一份 PDF / Word / Markdown 文件。
  3. 索引设置保持默认，点击 创建知识库。
系统自动完成解析、切片、向量化与索引构建。知识库状态变为 已就绪 即可检索。
知识库类型、使用场景、切片策略等完整配置说明见创建知识库。
2

在 Playground 中试问答

点击左侧 Playground，选择刚创建的知识库，在顶部切换到 知识问答，输入一个问题。系统先检索相关切片，再调用大模型生成带引用的回答。可切换不同模型（Qwen / DeepSeek）对比效果。
3

通过 API 接入应用

先将千问AI平台 API Key 配置到环境变量：
export DASHSCOPE_API_KEY="sk-xxxxxxxxxxxxxxxx"
再发起一次检索请求：
curl -X POST https://dashscope.aliyuncs.com/api/v1/indices/rag/index/retrieve \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "index_id": "<知识库ID>",
    "query": "<查询内容>",
    "top_k": 5
  }'
index_id 在知识管理页面点击对应知识库即可复制。返回的 nodes 数组包含命中切片，按相关性分数倒序排列。

下一步

快速开始 - 千问AI平台