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/searchis a POST in MLflow). Confirm the working path/verb with a liveaidp mlops list-experiments(CLI) before relying on the REST surface; record inreferences/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) — orexperiments/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>)
Experiment runs (<DLID> <WS>)
Experiment / run tags (<DLID> <WS>)
Registered models (<DLID> only — no <WS>)
Model versions (<DLID> only — except create-workspace-model-version which is <DLID> <WS>)
Timestamps (
start_time/end_time/metrictimestamp) 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) — noteupdate-*-tags(plural) takes batchedset_tags/delete_tagsarrays.
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-notebooksfor the training run itself


