服务渠道

​

接入方式对比

​

REST API

Authorization: Bearer <API-Key>

curl -X POST 'https://{workspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/indices/knowledge/search' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer $DASHSCOPE_API_KEY' \
  -d '{
    "query": "${YOUR_QUERY}",
    "agent_id": "${YOUR_APP_ID}"
  }'

curl -X POST https://{workspaceId}.cn-beijing.maas.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
  }'

​

MCP Server

​

前置条件

• 已创建至少一个知识库，且包含已解析完成的文档
• 已获取 API Key
• 已安装支持 MCP 协议的客户端（Qoder、Claude Code、Codex 等）

​

接入步骤

1. 获取 API Key 在控制台 API Key 页创建 API Key。建议将 API Key 存为环境变量：
   Copy

   export DASHSCOPE_API_KEY="sk-xxxxxxxxxxxxxxxx"
   
2. 在客户端中添加 MCP Server 根据你使用的客户端，选择对应的配置方式：
   • Qoder / QoderWork
   • Claude Code
   • Codex

   打开 MCP 配置文件，添加以下内容：

   Copy

   {
     "mcpServers": {
       "rag_mcp": {
         "type": "streamableHttp",
         "url": "https://{workspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/indices/rag/mcp",
         "headers": {
           "Authorization": "Bearer ${DASHSCOPE_API_KEY}"
         }
       }
     }
   }
   

   在终端中执行：

   Copy

   claude mcp add --transport http rag-mcp-server \
     https://{workspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/indices/rag/mcp \
     --header "Authorization: Bearer ${DASHSCOPE_API_KEY}"
   

   在 Codex 配置文件中添加：

   Copy

   [mcp_servers.rag_mcp_server]
   url = "https://{workspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/indices/rag/mcp"
   http_headers = {
       "Authorization" = "Bearer ${DASHSCOPE_API_KEY}"
   }
   

   Codex 0.120.0 及以上版本支持。
3. 验证连接 配置完成后，在客户端中尝试调用知识库。例如在 Claude Code 中输入：

   帮我在知识库里搜索"如何创建知识库"

   如果 AI 助手成功调用了 Retrieve 工具并返回检索结果，说明接入成功。

​

连接信息

​

提供的工具（Tools）

• Qoder / QoderWork
• Claude Code
• Codex（0.120.0+）
• 其他支持 MCP 协议的客户端

​

CLI

​

前置条件

• 已安装 Node.js（14 及以上版本）
• 已创建至少一个知识库，且包含已解析完成的文档
• 已获取 API Key

​

上手步骤

1. 设置 API Key 将 API Key 存为环境变量，后续命令会自动读取：
   Copy

   export DASHSCOPE_API_KEY="sk-xxxxxxxxxxxxxxxx"
   
2. 获取知识库 ID 在控制台 数据接入 → 知识管理 页面，点击目标知识库，复制页面上的知识库 ID（如 r0t4r2c4ig）。
3. 运行第一次检索 无需安装，通过 npx 直接运行：
   Copy

   npx bailian-cli knowledge retrieve \
     --api-key "$DASHSCOPE_API_KEY" \
     --index-id "你的知识库ID" \
     --query "你的问题"
   
   命令会输出检索到的文档切片及相关性分数。

​

启用重排序

npx bailian-cli knowledge retrieve \
  --api-key "$DASHSCOPE_API_KEY" \
  --index-id "r0t4r2c4ig" \
  --query "阿里云百炼" \
  --rerank true \
  --dense-similarity-top-k 80 \
  --sparse-similarity-top-k 20 \
  --rerank-top-n 4 \
  --rerank-model "qwen3-rerank-hybrid" \
  --rerank-mode "similar"

​

参数参考

​

Agent Skill

​

阿里云百炼 Agent

​

方式一：Agent 绑定（推荐）

1. 在阿里云百炼控制台创建应用 → 智能体应用 → Agent 2.0
2. 在「知识库」区域选择「外部知识库 → KnowledgeStudio」
3. 粘贴 API Key 与知识库 ID，发布后即可调用

​

方式二：Workflow 绑定

1. 在阿里云百炼控制台创建应用 → 工作流应用
2. 在画布拖入「知识库检索」节点，选择「KnowledgeStudio」作为检索源
3. 连接开始节点 / 大模型节点 / 结束节点，发布为应用

​

选型建议