ARTICLE · 1304976
DSH官方插件盘点-百炼知识库检索 回答更靠谱

百炼 × DeepSeek Harness
百炼知识库检索,原始片段和引用都在
插件包 bailian-kb-dsh
维护方 阿里云百炼难度 照着做就行
日期 2026.10 (DSH 仍处于开发者预览阶段)
一句话 这个插件解决的是“答得对不对”的问题。它把百炼上已经部署好的检索服务接进 DSH:先查你的知识库,再基于查到的片段回答,引用能追到原文。
读完你会得到
·内部知识问答:产品文档、售后手册放在百炼,回答带来源,不用靠模型记忆。
·先证据后结论:kb_search 返回打分片段,适合需要核对原文的场景。
·文档入库管理:用 bl CLI 建库、灌文档、部署检索服务,插件里直接管。
另外附上:安装流程图、配置对照表、常见问题排查顺序、安全提醒和官方资料链接。
01使用场景
先说清楚它解决什么问题。如果下面这几条都不沾边,别装,装了也是负担。
场景 1 内部知识问答 产品文档、售后手册放在百炼,回答带来源,不用靠模型记忆。
场景 2 先证据后结论 kb_search 返回打分片段,适合需要核对原文的场景。
场景 3 文档入库管理 用 bl CLI 建库、灌文档、部署检索服务,插件里直接管。
不适合 没有百炼工作空间,或者只在百炼建了知识库但没部署检索服务的。
02准备工作
需要 | 说明 |
Node.js | >=22.12 |
百炼账号 | workspace id 和 DashScope API Key |
检索服务 | 至少一个已部署的 retrieval / Q&A 服务,拿到 agent_id |
可选 | npm i -g bailian-cli,用来建库和灌文档 |
版本号不是摆设。DSH 还在快速迭代,插件和宿主对不上,最常见的表现就是装完不显示、扫码乱码、启动报错。
03安装步骤

先把整个流程看一眼,再往下做
第 1 步 装插件
装到 web profile,不需要手改 YAML。
dsh plugin --profile web add bailian-kb-dsh
第 2 步 确认装上了
dump 配置里能看到 tool-bailian-kb 这一行。
dsh --profile web --dump-config
第 3 步 填配置
设置页「Bailian KB」填 API Key、workspace、默认检索/问答服务。
第 4 步 验证并保存
用 Verify and save 校验 Key 和 workspace 是否匹配。
04配置与使用
项目 | 怎么配 / 能做什么 |
workspaceId | 必填,所有知识调用的归属空间 |
defaultRetrieveAgentId | 默认检索服务,不填就在提问时指定 |
defaultChatAgentId | 默认问答服务,适合综合多篇资料 |
chatTimeoutMs | 默认 300000,长文档问答可以再加 |
装完先把一条最简单的任务跑通,再逐步加权限和范围。不要一上来就把所有开关打开。
05常见问题
·没部署服务就没得查:知识库建了不等于能检索,要 deploy 成服务拿 agent_id。
·endpoint 不能改:固定 cn-beijing.maas.aliyuncs.com,海外账号注意。
·清空 workspace 会报错:插件不会自动回退到 bl 配置。
·Key 权限要对:DashScope Key 要有知识库检索权限。
06安全提醒
先看这一条 知识库是公司资产。给插件单独的 Key,限定 workspace,不要和训练、批量任务共用一个高权限 Key。
07参考资料
· bailian-kb-dsh README · Aliyun Model Studio CLIhttps://github.com/modelstudioai/cli/tree/main/packages/bailian-kb-dsh
· npm · bailian-kb-dshhttps://www.npmjs.com/package/bailian-kb-dsh
· DeepSeek Harness · 阿里云百炼文档https://help.aliyun.com/zh/model-studio/deepseek-harness
以上链接截至 2026 年 10 月。DSH 和插件都还在快速迭代,界面、包名和参数以官方页面当前版本为准。















































































