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、连接、倾斜、内存、文件布局、AQE 与 Delta Lake。

Data & Analytics2026年10月8日

Aidp Semantic Model

oracle-samples

维护 .aidp/semantic.md 业务语义层,定义指标、连接、同义词和值字典,为自然语言转 SQL 提供依据。

Data & Analytics2026年10月8日