bailian-kb

A command-line manager for Alibaba Cloud Bailian knowledge bases, which are collections of documents prepared for search and question answering. It handles the stored documents, search services, text chunks, and data-centre files rather than everyday searches.

In plain words
What is it for?
Use it to create, update, inspect, or delete knowledge bases; upload documents from local storage or OSS; deploy search or question-answering services; manage text chunks; and organise data-centre files.
Why use it?
It separates the work of building and maintaining a knowledge base from using it to answer questions. This helps keep document uploads, parsing, service deployment, and chunk changes organised.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/modelstudioai/cli/bailian-kb
Any agent
npx skills add modelstudioai/cli --skill bailian-kb
Clone the repo
git clone --depth 1 https://github.com/modelstudioai/cli

Made for: Claude Code, Codex.

Per session 234 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,191 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00234 $0.02191
Opus 5 $0.00117 $0.01095
Sonnet 5 $0.00047 $0.00438
Haiku 4.5 $0.00023 $0.00219

Measured yesterday against content hash acb12b7763a3, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

bailian-kb scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

packages/bailian-kb-dsh/skills/bailian-kb/SKILL.md · 97 lines

How it starts

The opening of the file, as written. The whole thing — 97 lines — stays where its author put it; the contents beside it link to each section on GitHub.

百炼知识库管理(bl)

检索面与管理面的分工:查知识用 kb_search(取证据)/ kb_chat(成品问答)原生工具;本 skill 只覆盖管理长尾——知识库全生命周期、文档、检索服务、Chunk、数据中心。

本 skill 不负责判断何时该检索。可用检索服务的清单(含 agent_id)由插件自动注入到会话上下文里,kb_search / kb_chat 直接取用;不需要为了检索先加载本 skill。

检索服务清单的行为语义

  • 清单由插件从百炼 API 拉取后缓存,按会话周期性刷新(约 30 分钟),只含 deployed 状态的服务;
  • 刚用 bl 新建或部署的服务不会立刻出现在清单里。不用等刷新——命令输出里刚拿到的 agent_id 直接可用;
  • 服务很多时清单只列最近修改的若干条并标明总数。要找特定服务用 bl knowledge service list --scene search --name <关键词>
  • 清单里确实没有能回答用户问题的服务时,如实告知用户,不要挑一个最像的 agent_id 去试

前置检查

  1. 安装校验:运行 bl knowledge list --help。若报 Unknown command 或 bl 未安装,执行 npm install -g bailian-cli(需 Node.js ≥ 18.17);已安装但命令缺失时先 bl update 升级。 安装失败时把错误原样报告给用户,不要静默跳过。
  2. 鉴权:需要 DASHSCOPE_API_KEY(环境变量,或 bl auth login --api-key sk-xxx,或 bl config set --key api_key --value sk-xxx)。
  3. workspace 解析优先级:--workspace-id 参数 > 环境变量 BAILIAN_WORKSPACE_ID > bl config set --key workspace_id --value ws-xxx

何时用哪个命令

用户意图 命令 备注
查知识 / 问答(日常检索) 原生工具 kb_search / kb_chat 不走 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/setbl update bl config --help
部署后验证、调试草稿版服务 bl knowledge search/chat --agent-version beta bl knowledge search --help

Read the full file on GitHub · 97 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 97 lines · 234 tokens per session scan A acb12b7763a3

Subscribe to this mod's changes

bailian-kb is a skill published in the GitHub repository modelstudioai/cli (320 stars, last pushed 4d ago), licensed Apache-2.0. It adds 234 tokens to every session and 2,191 once invoked, about $0.0012 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

alibabacloud-ecs-windows-os-troubleshooting

Troubleshoot and repair Alibaba Cloud ECS Windows instances from inside the GuestOS or remotely via Cloud Assistant. Use whenever the user reports any Windows symptom or asks for a health check on an ECS Windows instance, even vague ones like "check this machine": boot failures (BSOD, black screen, boot loop, stuck at…

aliyun/alibabacloud-ecs-troubleshoot-skills · 215 tokens

alibabacloud-ecs-linux-os-troubleshooting

Troubleshoot an Alibaba Cloud ECS Linux OS. Use when a user needs to diagnose a specified ECS Linux instance, such as instance stuck in Starting, boot stuck, SSH/VNC/Workbench login failure, network issues, disk/FS issues, performance anomalies, suspected mining or hidden processes, crash/hang, clock drift, or…

aliyun/alibabacloud-ecs-troubleshoot-skills · 84 tokens

qianwen-image-generation

Generate and edit images using Wan and Qwen Image models. Supports text-to-image, image editing (style transfer, subject consistency, text rendering), and interleaved text-image output. TRIGGER when: user wants to create illustrations, product images, artistic designs, posters, text-to-image generation, edit/transform…

QianWen-AI/qianwen-ai · 157 tokens

qianwen-audio-tts

Synthesize speech from text with Qwen TTS models. TRIGGER when: user wants to convert text to speech, create voiceovers, generate audio narration, read text aloud, build TTS applications, mentions speech synthesis/voice generation/audio output from text, or explicitly invokes this skill by name (e.g. use…

QianWen-AI/qianwen-ai · 105 tokens

qianwen-find-skills

Discover, compare, and optionally install published Agent Skills from QianWen. TRIGGER when: user asks to find or recommend a skill, asks whether a skill exists for a task, wants to browse skills by category, wants to compare candidates, asks to install a discovered skill, or explicitly invokes this skill by name…

QianWen-AI/qianwen-ai · 113 tokens

qianwen-text

Generate text, have conversations, write code, reason, and call functions with Qwen models. TRIGGER when: user asks to chat with Qwen, generate text, write code with Qwen, use Qwen function calling, or explicitly invokes this skill by name (e.g. use qianwen-text). DO NOT TRIGGER when: general coding questions without…

QianWen-AI/qianwen-ai · 111 tokens