在终端调用百炼知识库全部能力：检索/问答服务调用、知识库生命周期管理、文档与分片管理、分类与数据合集管理。
知识库相关能力目前仅对中国站（aliyun.com）账号开放。
任意命令追加 --help 可查看完整参数说明，例如 bl knowledge search --help。删除类高危操作需要显式追加 --yes 才会执行，未加时仅预览操作详情。
检索与问答
search / chat 通过 --agent-id 调用已发布的检索/问答服务，具体检索策略（多路召回、排序、重排序等）由服务端配置决定。
| 能力 | 命令 | 说明 | 常用参数 |
|---|
| 语义检索 | bl knowledge search | 调用检索服务进行语义检索 | --query 查询内容、--agent-id 检索服务 ID |
| RAG 问答 | bl knowledge chat | 调用问答服务进行 RAG 问答，支持流式输出 | --message 消息内容、--agent-id 问答服务 ID |
| 直接检索（已弃用） | bl knowledge retrieve | 直接对知识库检索，建议改用 search | --index-id 知识库 ID、--query 查询内容 |
bl knowledge search --query "如何配置切片策略？" --agent-id <检索服务ID> --workspace-id <工作空间ID>
bl knowledge chat --message "什么是 RAG？" --agent-id <问答服务ID> --workspace-id <工作空间ID>
知识库管理
| 能力 | 命令 | 说明 |
|---|
| 创建知识库 | bl knowledge create | 创建知识库，并导入数据中心的文件或分类 |
| 知识库列表 | bl knowledge list | 列出工作空间内的知识库 |
| 知识库详情 | bl knowledge info | 查看知识库的索引配置详情 |
| 更新知识库 | bl knowledge update | 更新知识库名称、描述或重排序阈值 |
| 删除知识库 | bl knowledge delete | 删除知识库及其全部文档与分片（数据中心文件不受影响） |
| 用量统计 | bl knowledge stats | 查看知识库的存储与 QPS 监控数据 |
bl knowledge create --name demo --description "产品文档" --doc-id <文件ID> --workspace-id <工作空间ID> --wait
文档与文件管理
数据中心文件（file）是原始素材，导入知识库后成为文档（doc）；两者删除操作互相独立。
| 能力 | 命令 | 说明 |
|---|
| 上传文档 | bl knowledge doc upload | 上传本地文件或目录到数据中心，可选直接导入知识库 |
| OSS 批量导入 | bl knowledge doc import-oss | 从已授权的 OSS Bucket 批量导入文件到数据中心 |
| 文档列表 | bl knowledge doc list | 查看知识库内文档的解析/索引状态 |
| 导入任务状态 | bl knowledge doc status | 查询知识库导入任务的执行状态 |
| 文档打标签 | bl knowledge doc tag | 批量更新数据中心文件的标签 |
| 删除文档 | bl knowledge doc delete | 从知识库中删除文档及其分片 |
| 文件详情 | bl knowledge file get | 查看数据中心文件详情（大小、MD5、标签、时间戳） |
| 文件列表 | bl knowledge file list | 按分类列出数据中心文件 |
| 删除文件 | bl knowledge file delete | 永久删除数据中心文件 |
bl knowledge doc upload --file ./docs/ --index-id <知识库ID> --wait
分片管理
| 能力 | 命令 | 说明 |
|---|
| 新增分片 | bl knowledge chunk add | 向知识库直接添加一个分片 |
| 分片列表 | bl knowledge chunk list | 列出知识库中分片的内容与状态 |
| 更新分片 | bl knowledge chunk update | 更新分片内容，或切换其检索可见性 |
| 删除分片 | bl knowledge chunk delete | 从知识库中删除分片（不可恢复） |
bl knowledge chunk add --index-id <知识库ID> --doc-id <文档ID> --content "分片正文" --title intro
分类与数据合集
分类（category）用于按业务域组织数据中心文件；数据合集（collection）是文件的存储位置，默认使用平台托管存储，也可绑定自定义 OSS Bucket。
| 能力 | 命令 | 说明 |
|---|
| 新建分类 | bl knowledge category add | 创建数据中心分类，支持子分类 |
| 分类列表 | bl knowledge category list | 列出数据中心分类 |
| 删除分类 | bl knowledge category delete | 删除数据中心分类 |
| 新建数据合集 | bl knowledge collection create | 创建 FILE 类型数据合集（默认托管存储，或绑定自定义 OSS Bucket） |
| 数据合集详情 | bl knowledge collection get | 查看数据合集详情 |
检索/问答服务管理
服务（agent）是 search / chat 的调用入口：先创建服务并绑定知识库，调试通过后发布为正式版本。
| 能力 | 命令 | 说明 |
|---|
| 创建服务 | bl knowledge service create | 创建检索/问答服务（初始状态为 draft/beta） |
| 服务列表 | bl knowledge service list | 列出工作空间内的检索/问答服务 |
| 服务详情 | bl knowledge service get | 查看服务详情及各版本配置 |
| 更新服务 | bl knowledge service update | 更新服务名称、描述，或调整 draft 的模型/参数配置 |
| 发布服务 | bl knowledge service deploy | 将 beta draft 发布为新的正式版本 |
| 复制服务 | bl knowledge service copy | 将服务复制为一份新的 draft |
| 删除服务 | bl knowledge service delete | 删除检索/问答服务（软删除） |
bl knowledge service create --name my-qa --scene chat --index-id <知识库ID> --workspace-id <工作空间ID>
