百炼知识库管理（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 去试。

执行入口与配置

下文 bl knowledge … 是命令语法示例，实际操作一律通过 kb_manage，把 bl knowledge 后面的部分拆成参数数组。例如 bl knowledge service list --scene search 对应 kb_manage({"args":["service","list","--scene","search"]})。

不要通过 shell 直接运行知识库命令，不要读取密钥或使用 bl auth login / bl config set。插件自动使用 dsh 当前凭据、Workspace 和固定端点；缺配置时引导用户在 dsh 插件设置页填写。参数不得包含 --api-key、--workspace-id、--base-url 或 --config。