docs(knowledge): 优化知识库文档内容及CLI说明

- 修改表格/图片知识库必须提供`--doc-id`的描述,更准确表达要求
- 调整CLI命令文档中过期或不准确信息,说明集合删除暂不支持
- 更新chunk添加命令中`--doc-id`的说明,强调对所有知识库类型均必需
- 精简chunk删除命令备注,明确批量操作自动分批处理
- 优化文档删除命令描述,强调删除异步传播及输出行为
- 修正文档状态命令中错误提示用词,更清晰表达
- 文件列表命令修改说明,明确默认分类ID不解析
- 知识库信息命令删除过时备注,突出索引设置不可变
- 服务删除命令简洁描述幂等性和权限要求
- 服务列表命令调整对场景参数的描述,明确必传要求
This commit is contained in:
zeyu.fz
2026-08-14 13:40:08 +08:00
parent eb4f9af3e7
commit d5c4bd3572
12 changed files with 27 additions and 36 deletions
+1 -1
View File
@@ -29,7 +29,7 @@ bl knowledge chunk add --index-id <id> (--content <text> | --field <k=v>) [flags
| `--field <key=value>` | array | 否¹ | 任意字段键值对(可重复),用于表格/图片知识库,键为 Excel 列名;与 content/title/image 互斥 |
> ¹ `--content`/`--content-file`/`--title`/`--image-url` 与 `--field` 互斥,必须提供其一。
> ² 表格/图片知识库必须提供 `--doc-id`,服务端无此字段会返回 HTTP 500(`dataId不能为空`)。文档型知识库可选。
> ² 表格/图片知识库必须提供 `--doc-id`。文档型知识库可选。
**参数约束**
-1
View File
@@ -110,7 +110,6 @@ json 模式:返回知识库完整配置 JSON。
**注意事项**
- CLI 通过 `index/list` 的 `pipeline_id` 参数精确过滤目标知识库,单次请求即可获取详情。
- 索引设置(向量模型、切片大小等)不可变,修改需重建知识库。
**示例**
+1 -1
View File
@@ -776,7 +776,7 @@ bl config set workspace_id ws-xxx
**问题**:没有 `collection delete` 命令。
**原因**:服务端无集合删除 API。
**原因**:暂不支持通过 CLI 删除。
**解决**:创建集合需谨慎。如需隔离,创建新集合并迁移文件。