Semantic-model tasks

Use semantic-model to manage semantic models, model entries, and data sources. Knowledge-base development operations in AI Studio use this command group. Resources belong to the current workspace.

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

Manage semantic models and entries

Task

Commands

Notes

Manage semantic models

create, get, update, delete

Confirm the model and workspace relationship before a write.

Manage model entries

list-entries, create-entry, update-entry, delete-entry

Use the returned model and entry IDs.

Import, export, or validate a model

import, export, validate

Provide complex definitions only with confirmed --json or --json-file input.

Creating, importing, deleting, or validating can affect model content. Query the model or related jobs after the operation to confirm the result.

Manage source processing and segments

Prepare and update sources

Task

Commands

Notes

Create a model with or without sources

create-with-sources, create-empty

Choose the creation method based on whether sources are already available.

Upload local files

upload-local-file, upload-model-local-file

Save the returned file or source identifier.

Preview and inspect candidate sources

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

Confirm the candidate count and whether a source already exists before appending.

Append, backfill, or delete sources

append-sources, backfill-legacy-sources, delete-source

Confirm the target model and source before a write; deletion does not undo follow-up processing that has already started.

Inspect or govern an individual source

get-source-document, update-source-governance

Use the model and source identifiers.

Process segments and confirm jobs

Task

Commands

Notes

Import or manage segments

import-initial-segments, create-segment, update-segment, delete-segment, update-segment-enabled

Use the source and segment identifiers.

Re-embed or change the current version

reembed-segments, set-current-segment-version

The operation starts follow-up processing; submission does not mean the content is ready to use.

Inspect or reconcile source jobs

list-source-jobs, reconcile-source-jobs

Query jobs after source or segment changes; reconcile only when state is abnormal.

Uploading, appending, backfilling, re-embedding, and reconciliation can start follow-up processing. After submission, query the source and its jobs; do not assume newly added content is usable until processing reaches the expected state.

Last updated on