Aidp Mlops

作者 oracle-samples90b42d6c24d4無授權條款收錄於 2026年10月8日更新於 2026年10月8日

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.

AI 產生的概覽

透過 AIDP 相容於 MLflow 的 MLOps CLI 或 REST API,追蹤機器學習實驗、執行、指標與已註冊模型。

功能
此技能引導代理使用 AIDP 相容於 MLflow 的 MLOps 介面,涵蓋實驗、執行、指標與參數、已註冊模型以及模型版本。它說明了偏好的 aidp mlops CLI 指令,包括依群組排列的 46 個子指令索引,以及透過 oci raw-request 呼叫 MLflow REST 端點的無 CLI 備援方案。它也描述了先驗證的工作流程、為變更操作保存請求內容,以及在有影響的階段轉換前先行確認。其產出是指令呼叫與請求內容,而非檔案。
適用情境
當使用者想要記錄或追蹤實驗、列出執行或指標、註冊模型、轉換模型版本階段,或在 AIDP 中查詢模型登錄時使用。當 CLI 無法使用、必須改用 MLflow REST 介面時也適用。
執行需求
需要 aidp CLI,並提供 AIDP 執行個體 ID、API 金鑰驗證、設定檔與區域;備援方案需要 OCI CLI 以執行 oci raw-request。需要能連線至 AIDP MLOps 端點的網路。不隨附指令碼,僅為說明文件。

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

  1. Verify with aidp mlops list-experiments (CLI) — or experiments/search (REST fallback; auth ladder).
  2. 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.
  3. 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>)

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

Experiment runs (<DLID> <WS>)

CommandMutates?Body / options (required *)
list-experiment-runsread (POST)body ListExperimentRunsDetails: experiment_ids[] · filter · max_results · order_by[] · page_token · run_view_type (ACTIVE_ONLY|DELETED_ONLY|ALL)
get-experiment-run-by-idreadopt --run-id*
get-experiment-run-metric-historyreadopt --run-id* --metric-key* · --page-token --max-results
list-artifactsreadopt --run-id* · --path --page-token
list-logged-modelsread (POST)body ListLoggedModelsDetails: experiment_ids[] · filter · max_results · order_by[] (each LoggedModelOrder {field_name*,ascending}) · page_token
create-experiment-runyesbody CreateExperimentRunDetails: experiment_id · run_name · start_time · tags[] (ExperimentRunTag {key,value})
update-experiment-runyesbody UpdateExperimentRunDetails: run_id* · end_time · run_name · status (RUNNING|SCHEDULED|FINISHED|FAILED|KILLED|INTERNAL_ERROR)
delete-experiment-runyesbody DeleteExperimentRunDetails: run_id*
restore-experiment-runyesbody RestoreExperimentRunDetails: run_id*
log-experiment-run-metricyesbody LogExperimentRunMetricDetails: key* run_id* timestamp* value* · step
log-experiment-run-paramyesbody LogExperimentRunParamDetails: key* run_id* value*
log-experiment-run-modelyesbody LogExperimentRunModelDetails: model_json* run_id*
log-experiment-run-inputsyesbody LogExperimentRunInputsDetails: run_id* · dataset_inputs[] (DatasetInput {dataset*,tags[]}; Dataset {digest*,name*,source*,source_type*,profile,schema}; InputTag {key*,value*})
log-experiment-run-batchyesbody LogExperimentRunBatchDetails: run_id* · metrics[] (ExperimentRunMetric {key,value,timestamp,step}) · params[] (ExperimentRunParam {key,value}) · tags[] (ExperimentRunTag {key,value})

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

CommandMutates?Body (required *)
set-experiment-tagyesSetExperimentTagDetails: experiment_id* key* value*
delete-experiment-tagyesDeleteExperimentTagDetails: experiment_id* key*
update-experiment-tagsyesUpdateExperimentTagsDetails: experiment_id* · set_tags[] (ExperimentTag {key*,value}) · delete_tags[] (ExperimentTagKey {key*})
set-experiment-run-tagyesSetExperimentRunTagDetails: run_id* key* value*
delete-experiment-run-tagyesDeleteExperimentRunTagDetails: run_id* key*
update-experiment-run-tagsyesUpdateExperimentRunTagsDetails: run_id* · set_tags[] (ExperimentRunTag {key,value}) · delete_tags[] (ExperimentRunTagKey {key*})

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

CommandMutates?Body / options (required *)
list-registered-modelsreadopt --filter --max-results (default 100, max 1000) --page-token --order-by
get-registered-modelreadopt --name*
create-registered-modelyesbody CreateRegisteredModelDetails: name* · description · deployment_job_id · tags[] (RegisteredModelTag {key,value})
update-registered-modelyesbody UpdateRegisteredModelDetails: name* · description · deployment_job_id
rename-registered-modelyesbody RenameRegisteredModelDetails: name* · new_name
delete-registered-modelyesbody DeleteRegisteredModelDetails: name*
set-registered-model-tagyesbody SetRegisteredModelTagDetails: name* key* value*
delete-registered-model-tagyesbody DeleteRegisteredModelTagDetails: name* key*
update-registered-model-tagsyesbody UpdateRegisteredModelTagsDetails: name* · set_tags[] (RegisteredModelTag {key,value}) · delete_tags[] (RegisteredModelTagKey {key*})

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

CommandMutates?Body / options (required *)
list-model-versionsreadopt --filter --max-results --page-token --order-by
get-model-versionreadopt --name* --version*
create-model-versionyesbody CreateModelVersionDetails: name* source* · description · model_id · run_id · run_link · tags[] (ModelVersionTag {key,value})
create-workspace-model-versionyes<DLID> <WS> · body CreateModelVersionDetails (same fields as above)
update-model-versionyesbody UpdateModelVersionDetails: name* version* · description
delete-model-versionyesbody DeleteModelVersionDetails: name* version*
transition-model-version-stageyes (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-tagyesbody SetModelVersionTagDetails: name* version* key* value*
delete-model-version-tagyesbody DeleteModelVersionTagDetails: name* version* key*
update-model-version-tagsyesbody 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

來源與署名

來源:oracle-samples/oracle-aidp-samples位於ai/claude-code-plugins/oracle-ai-data-platform-workbench-engineer-agent/skills/aidp-mlops提交90b42d6

授權條款: 無授權條款

內容歸原作者所有。SourceWeft 從公開儲存庫中收錄這些內容。

檢舉或申請下架

更多來自 oracle-samples/oracle-aidp-samples 的技能

Aidp Workspace Admin

oracle-samples

Provision and inspect AIDP DataLake instances and workspaces, including private-network workspaces attached to a customer VCN/subnet. Use when the user wants to create/list/get a workspace or DataLake instance, set up a new (e.g. private) AIDP environment, or replicate a customer setup. Create/delete are guarded — confirm before any provisioning.

待分類2026年10月8日

Aidp Volumes

oracle-samples

Work with AIDP volumes — list volumes, browse files inside a volume, upload/download via the PAR flow, and create directories. Use when the user mentions volumes, needs to stage large/binary files, or move data in/out of a volume (distinct from the workspace filesystem). Control-plane via the official `aidp` CLI.

待分類2026年10月8日

Aidp Verified Queries

oracle-samples

維護經過驗證的問題到 Spark SQL 配對庫,讓代理在產生新 SQL 前優先重用可信查詢。

Data & Analytics2026年10月8日

Aidp User Settings

oracle-samples

透過 aidp CLI 或 oci raw-request 備援方式管理 AIDP DataLake 使用者設定與偏好。

Productivity & Workflow2026年10月8日

Aidp Spark Optimization

oracle-samples

指導 Apache Spark 3.5.0 效能調校:分割區、shuffle、join、資料傾斜、記憶體、檔案配置、AQE 與 Delta Lake。

Data & Analytics2026年10月8日

Aidp Semantic Model

oracle-samples

維護 .aidp/semantic.md 業務語意層,定義指標、連接、同義詞與值字典,為自然語言轉 SQL 提供依據。

Data & Analytics2026年10月8日