Agent skill · modelstudioai
bailian-kb
管理阿里云百炼知识库（建库、上传文档、部署检索服务、Chunk 运维、数据中心文件管理），命令行工具为 bl（bailian-cli）。 当用户要创建/更新/删除知识库、上传或导入文档（本地/OSS）、创建/部署/调参检索或问答服务、 增删改查 Chunk、管理数据中心类目/文件/集合时使用本 skill。 检索与问答不走本 skill——用原生工具 kb_search（取证据）/ kb_chat（成品问答）； bl knowledge search / chat 仅用于部署后的验证调试（如 --agent-version beta 调试草稿版）。 kb_search / kb_chat 的凭据与工作空间由插件自动解析（~/.dsh/settings.yaml 的 bailian-kb 段、 ~/.dsh/.credentials.yaml 的 DASHSCOPE_API_KEY），不要自己去读或传。 普通问答、编程、写作、翻译、泛搜索不触发本 skill。
What it needs
About 2k tokens when loaded.
What this skill does
百炼知识库管理（bl） 检索面与管理面的分工：查知识用 kbsearch（取证据）/ kbchat（成品问答）原生工具；本 skill 只覆盖管理长尾——知识库全生命周期、文档、检索服务、Chunk、数据中心。 本 skill 不负责判断何时该检索。可用检索服务的清单（含 agentid）由插件自动注入到会话上下文里，kbsearch / kbchat 直接取用；不需要为了检索先加载本 skill。 检索服务清单的行为语义 清单由插件从百炼 API 拉取后缓存，按会话周期性刷新（约 30 分钟），只含 deployed 状态的服务； 刚用 bl 新建或部署的服务不会立刻出现在清单里。不用等刷新——命令输出里刚拿到的 agentid 直接可用； 服务很多时清单只列最近修改的若干条并标明总数。要找特定服务用 bl knowledge service list --scene search --name <关键词>； 清单里确实没有能回答用户问题的服务时，如实告知用户，不要挑一个最像的 agentid 去试。 前置检查 1. 安装校验：运行 bl knowledge list --help。若报 Unknown command 或 bl 未安装，执行 npm install -g bailian-cli（需 Node.js ≥ 18.17）；已安装但命令缺失时先 bl update 升级。 安装失败时把错误原样报告给用户，不要静默跳过。 2. 鉴权：需要 DASHSCOPEAPIKEY（环境变量，或 bl auth login --api-key sk-xxx，或 bl config set --key apikey --value sk-xxx）。 3. workspace 解析优先级：--workspace-id 参数 > 环境变量 BAILIANWORKSPACEID > bl config set --key workspaceid --value ws-xxx。 何时用哪个命令 用户意图 命令 备注 ---------------------------------------- --------------------------------------------------- -------------------------------- 查知识 / 问答（日常检索） 原生工具 kbsearch / kbchat 不走 bl 建库 / 查看 / 改名 / 删库 / 监控 bl knowledge create/list/info/update/delete/stats bl knowledge create --help 上传本地文档、看解析状态、删文档、打标签 bl knowledge doc upload/list/status/delete/tag bl knowledge doc upload --help 从 OSS 批量导入 bl knowledge doc import-oss Bucket 需预先授权服务角色 创建 / 部署 / 调参检索（问答）服务 bl knowledge service create/update/deploy/… bl knowledge service --help 修正错误切片、屏蔽某段内容 bl knowledge chunk add/list/update/delete bl knowledge chunk --help 数据中心类目 / 文件 / 集合管理 bl knowledge category/file/collection … bl knowledge category --help CLI 配置、升级 bl config show/set、bl update bl config --help 部署后验证、调试草稿版服务 bl knowledge search/chat --agent-version beta bl knowledge search --help 核心工作流：建库到可检索 部署完成后用原生工具 kbsearch 带该 agentid 验证检索；若要在部署前调试草稿配置，用 bl knowledge search --agent-id <id> --agent-version beta。 已有文件再入库的简写：bl knowledge doc upload --file ./a.md --index-id <index-id> --wait（上传+导入一步完成）。 ID 速查（极易混淆） ID 来源 用在哪 ----------------------- -------------------------------------------- …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills modelstudioai/bailian-kb