スキルOfficialdevelopment

📊aidp-mlops

プラグイン: oracle-ai-data-platform-workbench-engineer-agent
ソース: GitHub で見る ↗

説明

AIDP の MLflow 互換 MLOps において、実験・実行・メトリクス／パラメータ・登録済みモデル・モデルバージョンを追跡・管理します。次のような場合に使用: - 実験のログ記録・追跡を行いたい - 実行やメトリクスの一覧を取得したい - モデルを登録したい - モデルバージョンのステージを遷移させたい - モデルレジストリをクエリしたい主要な実行エンジンは公式の `aidp` CLI（`aidp mlops …`）です。 CLI が利用できない場合のフォールバックとして、`oci raw-request` 経由でプレビュー版 MLflow REST API を使用します。実行前に必ず動作確認を行ってください。

原文を表示

Track ML work in AIDP's MLflow-compatible MLOps — experiments, runs, metrics/params, registered models, and model versions. Use when the user wants to log/track experiments, list runs or metrics, register a model, transition a model-version stage, or query the model registry. Primary engine is the official `aidp` CLI (`aidp mlops …`); the same Preview MLflow REST API via `oci raw-request` is the no-CLI fallback. Verify live first.

ユースケース

✓実験のログ記録・追跡を行いたい
✓実行やメトリクスの一覧を取得したい
✓モデルを登録したい
✓モデルバージョンのステージを遷移させたい
✓モデルレジストリをクエリしたい

本文（日本語訳）

`aidp-mlops` — MLflowエクスペリメント & モデルレジストリ（プレビュー）

AIDPのMLflow互換MLOpsサーフェスと対話します。これはAIDPネイティブのMLOpsであり、OCI Data Scienceとは別物です。

CLI（推奨）: aidp mlops <command> --instance-id <DATALAKE_OCID> --auth api_key --profile DEFAULT --region <r>

エクスペリメント/ラン: aidp mlops list-experiments | create-experiment | list-experiment-runs | log-experiment-run-metric
レジストリ: aidp mlops list-registered-models | create-registered-model | create-model-version | transition-model-version-stage
全サーフェス = 46サブコマンド — 下記のグループ別コマンドインデックスを参照（experiments / runs / registered-models / model-versions / tags / artifacts）

フォールバック（CLIなし）: oci raw-request 経由で同一のMLflow RESTサーフェスを使用（エンドポイント・認証は同一。references/oci-raw-request.md を参照）。

プレビュー＋事前検証必須（不確定情報の非提示）: MLOpsはプレビュー段階です。2026-06-10に調査実施: GET …/workspaces/<ws>/mlops/api/2.0/mlflow/experiments/search → 404 — このテナンシーでMLOpsがプロビジョニングされていないか、あるいは（可能性が高い）MLflowのエンドポイントが POSTメソッド前提になっている可能性があります（experiments/search はMLflowではPOST）。 RESTサーフェスに依存する前に、実際の aidp mlops list-experiments（CLI）で動作するパス・メソッドを確認し、 references/rest-endpoint-map.md に記録してください。未検証のエンドポイントを断言しないこと。

次のような場合に使用

「エクスペリメントまたはランのトラッキング・ログ記録」「ラン/メトリクスの一覧表示」「モデルの登録」「モデルバージョンの昇格」「モデルレジストリのクエリ」

ワークフロー

aidp mlops list-experiments（CLI）— または experiments/search（RESTフォールバック・認証ラダー）で動作確認する。
標準的なMLflowパターンに従う: エクスペリメントの作成/検索 → ランの作成 → パラメータ/メトリクスのログ記録 → モデルの登録 → モデルバージョンの作成/遷移。リクエストボディはMLflow RESTスキーマに準拠。
トレーニング処理自体はノートブック（aidp-notebooks）でコードを実行し、そこからMLOpsにログを記録する。

変更を伴う操作（create-experiment、ランのログ記録、create-registered-model、create-model-version、 transition-model-version-stage）: ボディを .aidp/payloads/ に保存し、実行前に確認してください（references/payloads.md）。

`aidp mlops` コマンドインデックス全体（46サブコマンド）

すべて (プレビュー) 。位置引数はグループによって異なります: experiment/run/artifact 系コマンドは <DLID> <WS>（ワークスペーススコープ）を取り、 registered-model/model-version 系コマンドは <DLID> のみ（<WS> なし）を取ります。 --body <JSON> の行は変更操作 または POST検索読み取りを示します — ボディを .aidp/payloads/ に保存し実行前に確認してください（references/payloads.md）。以下のフィールド名は docs/cli/README.md のmlopsセクション（2455〜4049行）から確認済みです。ソース: CLI README §ML Ops。

Experiments（<DLID> <WS>）

コマンド	変更?	ボディ / オプション（必須項目は *）
`list-experiments`	読み取り（POST）	body `ListExperimentsDetails`: `filter` · `max_results` · `order_by[]` · `page_token` · `view_type`（`ACTIVE_ONLY`\|`DELETED_ONLY`\|`ALL`）
`get-experiment-by-id`	読み取り	opt `--experiment-id*`（削除済みエクスペリメントにも使用可）
`get-experiment-by-name`	読み取り	opt `--experiment-name*`（名前が重複する場合はアクティブなものを優先）
`create-experiment`	あり	body `CreateExperimentDetails`: `name` · `artifact_location` · `tags[]`（各 `ExperimentTag {key,value}`）
`update-experiment`	あり	body `UpdateExperimentDetails`: `experiment_id*` · `new_name`
`delete-experiment`	あり	body `DeleteExperimentDetails`: `experiment_id*`
`restore-experiment`	あり	body `RestoreExperimentDetails`: `experiment_id*`

Experiment runs（<DLID> <WS>）

コマンド	変更?	ボディ / オプション（必須項目は *）
`list-experiment-runs`	読み取り（POST）	body `ListExperimentRunsDetails`: `experiment_ids[]` · `filter` · `max_results` · `order_by[]` · `page_token` · `run_view_type`（`ACTIVE_ONLY`\|`DELETED_ONLY`\|`ALL`）
`get-experiment-run-by-id`	読み取り	opt `--run-id*`
`get-experiment-run-metric-history`	読み取り	opt `--run-id* --metric-key*` · `--page-token --max-results`
`list-artifacts`	読み取り	opt `--run-id*` · `--path --page-token`
`list-logged-models`	読み取り（POST）	body `ListLoggedModelsDetails`: `experiment_ids[]` · `filter` · `max_results` · `order_by[]`（各 `LoggedModelOrder {field_name*,ascending}`） · `page_token`
`create-experiment-run`	あり	body `CreateExperimentRunDetails`: `experiment_id` · `run_name` · `start_time` · `tags[]`（`ExperimentRunTag {key,value}`）
`update-experiment-run`	あり	body `UpdateExperimentRunDetails`: `run_id*` · `end_time` · `run_name` · `status`（`RUNNING`\|`SCHEDULED`\|`FINISHED`\|`FAILED`\|`KILLED`\|`INTERNAL_ERROR`）
`delete-experiment-run`	あり	body `DeleteExperimentRunDetails`: `run_id*`
`restore-experiment-run`	あり	body `RestoreExperimentRunDetails`: `run_id*`
`log-experiment-run-metric`	あり	body `LogExperimentRunMetricDetails`: `key* run_id* timestamp* value*` · `step`
`log-experiment-run-param`	あり	body `LogExperimentRunParamDetails`: `key* run_id* value*`
`log-experiment-run-model`	あり	body `LogExperimentRunModelDetails`: `model_json* run_id*`
`log-experiment-run-inputs`	あり	body `LogExperimentRunInputsDetails`: `run_id` · `dataset_inputs[]`（`DatasetInput {dataset,tags[]}`; `Dataset {digest,name,source,source_type,profile,schema}`; `InputTag {key,value}`）
`log-experiment-run-batch`	あり	body `LogExperimentRunBatchDetails`: `run_id*` · `metrics[]`（`ExperimentRunMetric {key,value,timestamp,step}`） · `params[]`（`ExperimentRunParam {key,value}`） · `tags[]`（`ExperimentRunTag {key,value}`）

Experiment / run タグ（<DLID> <WS>）

コマンド	変更?	ボディ（必須項目は *）
`set-experiment-tag`	あり	`SetExperimentTagDetails`: `experiment_id* key* value*`
`delete-experiment-tag`	あり	`DeleteExperimentTagDetails`: `experiment_id* key*`
`update-experiment-tags`	あり	`UpdateExperimentTagsDetails`: `experiment_id` · `set_tags[]`（`ExperimentTag {key,value}`） · `delete_tags[]`（`ExperimentTagKey {key*}`）
`set-experiment-run-tag`	あり	`SetExperimentRunTagDetails`: `run_id* key* value*`
`delete-experiment-run-tag`	あり	`DeleteExperimentRunTagDetails`: `run_id* key*`
`update-experiment-run-tags`	あり	`UpdateExperimentRunTagsDetails`: `run_id` · `set_tags[]`（`ExperimentRunTag {key,value}`） · `delete_tags[]`（`ExperimentRunTagKey {key}`）

Registered models（<DLID> のみ — <WS> なし）

コマンド	変更?	ボディ / オプション（必須項目は *）
`list-registered-models`	読み取り	opt `--filter --max-results`（デフォルト100、最大1000）`--page-token --order-by`
`get-registered-model`	読み取り	opt `--name*`
`create-registered-model`	あり	body `CreateRegisteredModelDetails`: `name*` · `description` · `deployment_job_id` · `tags[]`（`RegisteredModelTag {key,value}`）
`update-registered-model`	あり	body `UpdateRegisteredModelDetails`: `name*` · `description` · `deployment_job_id`
`rename-registered-model`	あり	body `RenameRegisteredModelDetails`: `name*` · `new_name`
`delete-registered-model`	あり	body `DeleteRegisteredModelDetails`: `name*`
`set-registered-model-tag`	あり	body `SetRegisteredModelTagDetails`: `name* key* value*`
`delete-registered-model-tag`	あり	body `DeleteRegisteredModelTagDetails`: `name* key*`
`update-registered-model-tags`	あり	body `UpdateRegisteredModelTagsDetails`: `name` · `set_tags[]`（`RegisteredModelTag {key,value}`） · `delete_tags[]`（`RegisteredModelTagKey {key}`）

Model versions（<DLID> のみ — ただし create-workspace-model-version は <DLID> <WS>）

コマンド	変更?	ボディ / オプション（必須項目は *）
`list-model-versions`	読み取り	opt `--filter --max-results --page-token --order-by`
`get-model-version`	読み取り	opt `--name* --version*`
`create-model-version`	あり	body `CreateModelVersionDetails`: `name* source*` · `description` · `model_id` · `run_id` · `run_link` · `tags[]`（`ModelVersionTag {key,value}`）
`create-workspace-model-version`	あり	`<DLID> <WS>` · body `CreateModelVersionDetails`（上記と同一フィールド）
`update-model-version`	あり	body `UpdateModelVersionDetails`: `name* version*` · `description`
`delete-model-version`	あり	body `DeleteModelVersionDetails`: `name* version*`
`transition-model-version-stage`	あり（影響大）	body `TransitionModelVersionStageDetails`: `name* version* stage* archive_existing_versions*` — `stage` はSDK上フリー文字列（enum定数なし）。有効なステージ名は実際の環境で確認してから使用すること
`set-model-version-tag`	あり	body `SetModelVersionTagDetails`: `name* version* key* value*`
`delete-model-version-tag`	あり	body `DeleteModelVersionTagDetails`: `name* version* key*`
`update-model-version-tags`	あり	body `UpdateModelVersionTagsDetails`: `name* version` · `set_tags[]`（`ModelVersionTag {key,value}`） · `delete_tags[]`（`ModelVersionTagKey {key}`）

タイムスタンプ（start_time / end_time / メトリクスの timestamp）は Unixエポックミリ秒です（SDKフィールドドキュメント準拠）。タグ関連コマンドは計13個: set- / delete- / update- × {experiment、experiment-run、 model-version、registered-model} tag(s) — update-*-tags（複数形）はバッチ処理用の set_tags / delete_tags 配列を取ることに注意。

フォールバック（CLIなし）— RESTエンドポイント（ワークスペーススコープMLflow; プレビュー、`20260430` → `20240831` を試してください）

ベースURL: …/workspaces/{ws}/mlops/api/2.0/mlflow/…

Experiments: experiments/create|search|get
Runs: runs/create|update|search|get · runs/log-metric|log-parameter|log-batch
Registered models: registered-models/create|get|search
Model versions: model-versions/create|get|search|transition-stage

ガードレール

ステージ遷移（Productionへの昇格など

原文（English）を表示

`aidp-mlops` — MLflow experiments & model registry (Preview)

Interact with AIDP's MLflow-compatible MLOps surface. This is AIDP-native MLOps — distinct from OCI Data Science.

CLI (preferred): aidp mlops <command> --instance-id <DATALAKE_OCID> --auth api_key --profile DEFAULT --region <r>

Experiments/runs: aidp mlops list-experiments | create-experiment | list-experiment-runs | log-experiment-run-metric
Registry: aidp mlops list-registered-models | create-registered-model | create-model-version | transition-model-version-stage
Full surface = 46 subcommands — see the grouped command index below (experiments / runs / registered-models / model-versions / tags / artifacts).

Fallback (no CLI): same MLflow REST surface via oci raw-request (identical endpoint + auth; see references/oci-raw-request.md).

Preview + verify-first (no-fabrication): MLOps is Preview. Probed 2026-06-10: GET …/workspaces/<ws>/mlops/api/2.0/mlflow/experiments/search → 404 — either MLOps isn't provisioned in this tenancy, or (likely) the MLflow endpoints are POST-shaped (experiments/search is a POST in MLflow). Confirm the working path/verb with a live aidp mlops list-experiments (CLI) before relying on the REST surface; record in references/rest-endpoint-map.md. Don't assert unverified endpoints.

When to use

"Track/log an experiment or run", "list runs/metrics", "register a model", "promote a model version", "query the model registry".

Workflow

Verify with aidp mlops list-experiments (CLI) — or experiments/search (REST fallback; auth ladder).
Standard MLflow patterns: create/find an experiment → create a run → log params/metrics → register the model → create/transition a model version. Bodies follow the MLflow REST schema.
For training itself, run code in a notebook (aidp-notebooks) and log to MLOps from there.

Mutating ops (create-experiment, run logging, create-registered-model, create-model-version, transition-model-version-stage): persist the body to .aidp/payloads/ and confirm first (references/payloads.md).

Full `aidp mlops` command index (46 subcommands)

All (Preview). Positional args differ by group: experiment/run/artifact commands take <DLID> <WS> (workspace-scoped); registered-model/model-version commands take <DLID> only (no <WS>). --body <JSON> rows are mutating or POST-search reads — persist the body to .aidp/payloads/ and confirm first (references/payloads.md). Field names below are confirmed from docs/cli/README.md mlops section (lines 2455–4049). Source: CLI README §ML Ops.

Experiments (<DLID> <WS>)

Command	Mutates?	Body / options (required *)
`list-experiments`	read (POST)	body `ListExperimentsDetails`: `filter` · `max_results` · `order_by[]` · `page_token` · `view_type` (`ACTIVE_ONLY`\|`DELETED_ONLY`\|`ALL`)
`get-experiment-by-id`	read	opt `--experiment-id*` (works on deleted experiments)
`get-experiment-by-name`	read	opt `--experiment-name*` (prefers active on name clash)
`create-experiment`	yes	body `CreateExperimentDetails`: `name` · `artifact_location` · `tags[]` (each `ExperimentTag {key,value}`)
`update-experiment`	yes	body `UpdateExperimentDetails`: `experiment_id*` · `new_name`
`delete-experiment`	yes	body `DeleteExperimentDetails`: `experiment_id*`
`restore-experiment`	yes	body `RestoreExperimentDetails`: `experiment_id*`

Experiment runs (<DLID> <WS>)

Command	Mutates?	Body / options (required *)
`list-experiment-runs`	read (POST)	body `ListExperimentRunsDetails`: `experiment_ids[]` · `filter` · `max_results` · `order_by[]` · `page_token` · `run_view_type` (`ACTIVE_ONLY`\|`DELETED_ONLY`\|`ALL`)
`get-experiment-run-by-id`	read	opt `--run-id*`
`get-experiment-run-metric-history`	read	opt `--run-id* --metric-key*` · `--page-token --max-results`
`list-artifacts`	read	opt `--run-id*` · `--path --page-token`
`list-logged-models`	read (POST)	body `ListLoggedModelsDetails`: `experiment_ids[]` · `filter` · `max_results` · `order_by[]` (each `LoggedModelOrder {field_name*,ascending}`) · `page_token`
`create-experiment-run`	yes	body `CreateExperimentRunDetails`: `experiment_id` · `run_name` · `start_time` · `tags[]` (`ExperimentRunTag {key,value}`)
`update-experiment-run`	yes	body `UpdateExperimentRunDetails`: `run_id*` · `end_time` · `run_name` · `status` (`RUNNING`\|`SCHEDULED`\|`FINISHED`\|`FAILED`\|`KILLED`\|`INTERNAL_ERROR`)
`delete-experiment-run`	yes	body `DeleteExperimentRunDetails`: `run_id*`
`restore-experiment-run`	yes	body `RestoreExperimentRunDetails`: `run_id*`
`log-experiment-run-metric`	yes	body `LogExperimentRunMetricDetails`: `key* run_id* timestamp* value*` · `step`
`log-experiment-run-param`	yes	body `LogExperimentRunParamDetails`: `key* run_id* value*`
`log-experiment-run-model`	yes	body `LogExperimentRunModelDetails`: `model_json* run_id*`
`log-experiment-run-inputs`	yes	body `LogExperimentRunInputsDetails`: `run_id` · `dataset_inputs[]` (`DatasetInput {dataset,tags[]}`; `Dataset {digest,name,source,source_type,profile,schema}`; `InputTag {key,value}`)
`log-experiment-run-batch`	yes	body `LogExperimentRunBatchDetails`: `run_id*` · `metrics[]` (`ExperimentRunMetric {key,value,timestamp,step}`) · `params[]` (`ExperimentRunParam {key,value}`) · `tags[]` (`ExperimentRunTag {key,value}`)

Experiment / run tags (<DLID> <WS>)

Command	Mutates?	Body (required *)
`set-experiment-tag`	yes	`SetExperimentTagDetails`: `experiment_id* key* value*`
`delete-experiment-tag`	yes	`DeleteExperimentTagDetails`: `experiment_id* key*`
`update-experiment-tags`	yes	`UpdateExperimentTagsDetails`: `experiment_id` · `set_tags[]` (`ExperimentTag {key,value}`) · `delete_tags[]` (`ExperimentTagKey {key*}`)
`set-experiment-run-tag`	yes	`SetExperimentRunTagDetails`: `run_id* key* value*`
`delete-experiment-run-tag`	yes	`DeleteExperimentRunTagDetails`: `run_id* key*`
`update-experiment-run-tags`	yes	`UpdateExperimentRunTagsDetails`: `run_id` · `set_tags[]` (`ExperimentRunTag {key,value}`) · `delete_tags[]` (`ExperimentRunTagKey {key}`)

Registered models (<DLID> only — no <WS>)

Command	Mutates?	Body / options (required *)
`list-registered-models`	read	opt `--filter --max-results` (default 100, max 1000) `--page-token --order-by`
`get-registered-model`	read	opt `--name*`
`create-registered-model`	yes	body `CreateRegisteredModelDetails`: `name*` · `description` · `deployment_job_id` · `tags[]` (`RegisteredModelTag {key,value}`)
`update-registered-model`	yes	body `UpdateRegisteredModelDetails`: `name*` · `description` · `deployment_job_id`
`rename-registered-model`	yes	body `RenameRegisteredModelDetails`: `name*` · `new_name`
`delete-registered-model`	yes	body `DeleteRegisteredModelDetails`: `name*`
`set-registered-model-tag`	yes	body `SetRegisteredModelTagDetails`: `name* key* value*`
`delete-registered-model-tag`	yes	body `DeleteRegisteredModelTagDetails`: `name* key*`
`update-registered-model-tags`	yes	body `UpdateRegisteredModelTagsDetails`: `name` · `set_tags[]` (`RegisteredModelTag {key,value}`) · `delete_tags[]` (`RegisteredModelTagKey {key}`)

Model versions (<DLID> only — except create-workspace-model-version which is <DLID> <WS>)

Command	Mutates?	Body / options (required *)
`list-model-versions`	read	opt `--filter --max-results --page-token --order-by`
`get-model-version`	read	opt `--name* --version*`
`create-model-version`	yes	body `CreateModelVersionDetails`: `name* source*` · `description` · `model_id` · `run_id` · `run_link` · `tags[]` (`ModelVersionTag {key,value}`)
`create-workspace-model-version`	yes	`<DLID> <WS>` · body `CreateModelVersionDetails` (same fields as above)
`update-model-version`	yes	body `UpdateModelVersionDetails`: `name* version*` · `description`
`delete-model-version`	yes	body `DeleteModelVersionDetails`: `name* version*`
`transition-model-version-stage`	yes (impactful)	body `TransitionModelVersionStageDetails`: `name* version* stage* archive_existing_versions*` — `stage` is a free string in the SDK (no enum constants); confirm valid stage names live before relying on them
`set-model-version-tag`	yes	body `SetModelVersionTagDetails`: `name* version* key* value*`
`delete-model-version-tag`	yes	body `DeleteModelVersionTagDetails`: `name* version* key*`
`update-model-version-tags`	yes	body `UpdateModelVersionTagsDetails`: `name* version` · `set_tags[]` (`ModelVersionTag {key,value}`) · `delete_tags[]` (`ModelVersionTagKey {key}`)

Timestamps (start_time/end_time/metric timestamp) are Unix epoch milliseconds (per SDK field docs). The 13 tag commands are: set-/delete-/update- × {experiment, experiment-run, model-version, registered-model} tag(s) — note update-*-tags (plural) takes batched set_tags/delete_tags arrays.

Fallback (no CLI) — REST endpoints (workspace-scoped MLflow; Preview, try `20260430` → `20240831`)

Base: …/workspaces/{ws}/mlops/api/2.0/mlflow/…

Experiments: experiments/create|search|get
Runs: runs/create|update|search|get · runs/log-metric|log-parameter|log-batch
Registered models: registered-models/create|get|search
Model versions: model-versions/create|get|search|transition-stage

Guardrails

Stage transitions (e.g. to Production) are impactful — confirm.
Preview surface may shift — cite live status; don't assert unverified endpoints.

References

references/aidp-cli-map.md (skill → CLI map) · references/payloads.md (persist + confirm bodies) · references/oci-raw-request.md (base URL + auth ladder) · references/no-mcp-rest-map.md (control-plane runs MCP-free) · references/rest-endpoint-map.md (record verified MLflow paths here) · pairs with aidp-notebooks for the training run itself

原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。