语义模型和数据来源

使用 semantic-model 管理语义模型、模型条目和数据来源。AI Studio 中的知识库开发操作使用这一命令组。资源均属于当前工作区。

moi-cli -o semantic-model list
moi-cli semantic-model --help

管理模型和数据来源

要完成的事

使用命令

操作说明

管理语义模型

create、get、update、delete

创建、读取、更新或删除模型前，确认模型和工作区的对应关系。

管理模型条目

list-entries、create-entry、update-entry、delete-entry

使用返回的模型和条目 ID 操作条目。

导入、导出或校验模型

import、export、validate

复杂定义使用该子命令已确认的 --json 或 --json-file 传入。

创建、导入、删除或校验均可能影响模型内容。执行后继续读取模型或相关作业确认结果。

管理来源处理和分段

准备和更新来源

要完成的事

使用命令

操作说明

创建模型并附带来源

create-with-sources、create-empty

根据是否已有来源选择创建方式。

上传本地文件

upload-local-file、upload-model-local-file

上传后保存返回的文件或来源标识。

预览和检查候选来源

preview-source-selection-counts、preview-model-source-selection-counts、list-sources、list-sources-page、check-source-existence

追加前确认候选数量和来源是否已存在。

追加、回填或删除来源

append-sources、backfill-legacy-sources、delete-source

写入前确认目标模型和来源；删除不等于撤销已开始的后续处理。

查看或治理单个来源

get-source-document、update-source-governance

使用模型和来源标识读取或更新来源。

处理分段并确认作业

要完成的事

使用命令

操作说明

维护当前分段

create-segment、update-segment、delete-segment、update-segment-enabled

先用 get-source-document 读取当前快照的 etag，在操作的 JSON 参数中传入 if_match。

重新生成分段嵌入

reembed-segments

在 JSON 参数中传入 if_match；完成向量写入后返回文档快照。

查看或协调来源作业

list-source-jobs、reconcile-source-jobs

查询来源处理作业；状态异常时再协调并回查。

来源上传、追加或回填后，查询来源和来源作业确认处理完成。分段写入要求文件来源已有 kb_file_id 且向量索引可用，表来源不支持。

每次分段修改后，使用返回文档的 etag 作为下一次 if_match。发生冲突时，重新读取快照并确认修改内容后再提交。import-initial-segments 和 set-current-segment-version 已移除；当前命令不提供批量初始分段导入或历史版本切换。

最后更新于