claude-skills/

Anthropic公式スキル・プラグインの日本語ディレクトリ

last sync 22h ago
スキルOfficialdevelopment

📦aidp-models-catalog

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

説明

AIDP DataLake で利用可能／インストール済みのモデルを一覧表示し、そのパラメータを確認するとともに、MLOps モデルレジストリを閲覧します。 次のような場合に使用: - ユーザーが「利用可能なモデルは何か」と尋ねているとき - `ai_generate()` や Agent フローで使用するモデル名が必要なとき - 特定モデルのパラメータを確認したいとき - 登録済みモデルやそのバージョンを一覧表示したいとき レジストリの閲覧には、公式の `aidp` CLI（`mlops` グループに統合済み）を使用します。また、LA `Models` プラットフォームカタログ API を `oci raw-request` 経由で利用する方法も検証済みであり、CLI が使えない場合のフォールバックとして機能します。

原文を表示

List the models available/installed in the AIDP DataLake and inspect their parameters, and browse the MLOps model registry. Use when the user asks "what models are available", needs a model name for ai_generate()/agent flows, wants a model's parameters, or wants to list registered models / versions. Registry browse uses the official `aidp` CLI (folded into the `mlops` group); the LA `Models` platform-catalog API via `oci raw-request` is verified and the no-CLI fallback.

ユースケース

  • ✓利用可能なモデルを確認するとき
  • ✓モデルのパラメータを確認したいとき
  • ✓登録済みモデルを一覧表示したいとき
  • ✓使用するモデル名を確認するとき

本文（日本語訳）

aidp-models-catalog — 利用可能なモデルと各種パラメータ

2つの異なる操作対象:

  • プラットフォーム モデルカタログ — ai_generate() / agent フローから呼び出せるモデル群（LA Models API）
  • MLOps/MLflow レジストリ — 登録済みモデルとそのバージョン（aidp-mlops グループ。aidp-mlops も参照）

CLI（推奨） — レジストリ参照: aidp mlops <command> --instance-id <DATALAKE_OCID> --auth api_key --profile DEFAULT --region <r>

  • aidp mlops list-registered-models | get-registered-model | list-model-versions
  • （公式 CLI ではモデルレジストリは mlops グループに統合されており、独立した models グループは存在しない）

フォールバック（CLI 不使用時）/ プラットフォームカタログ: oci raw-request 経由の LA Models REST API（エンドポイント・認証ともに同一） — ai_generate() のモデル名を解決する際の検証済みパスとなる。

検証優先（でたらめ禁止）: プラットフォームの Models API は 20240831 において Limited Availability。
?modelType= を用いたリスト呼び出しは以下のとおり 実機検証済み 200。
MLOps レジストリ側は Preview のため未プローブ。
実際に使用する前に必ずライブ読み取りで名前を確認し、references/rest-endpoint-map.md に記録すること。

次のような場合に使用

  • 「利用可能なモデルは何か？」「ai_generate に指定するモデル名は？」「モデルのパラメータを確認したい」「登録済みモデルまたはモデルバージョンを一覧表示したい」

プラットフォームカタログ — エンドポイント（DataLake スコープ; LA 20240831）

ベース URL: https://aidp.<region>.oci.oraclecloud.com/20240831/dataLakes/<DATALAKE_OCID>/…

  • GET /models?modelType=<GENERATIVE_AI|BASE|EMBEDDING|LLM> — インストール済みモデルの一覧（実機検証済み 200）
  • GET /models/{id} — モデルの詳細
  • GET /models/{id}/modelParameters — パラメータ一覧

ワークフロー

  1. プラットフォームカタログ: GET /models?modelType=GENERATIVE_AI（認証ラダー; 401/403 の場合はセッション再取得） → 利用可能なモデル名・ID を提示。 BASE / EMBEDDING / LLM でも繰り返し、他カタログを列挙する。 詳細は GET /models/{id} / …/modelParameters で取得。

  2. レジストリ参照: aidp mlops list-registered-models → list-model-versions（CLI 推奨）

  3. 確認済みのモデル名を aidp-ai-sql（ai_generate('<model>', …)）または aidp-agent-flows に渡す。

oci raw-request --http-method GET \
  --target-uri "https://aidp.us-ashburn-1.oci.oraclecloud.com/20240831/dataLakes/<DATALAKE_OCID>/models?modelType=GENERATIVE_AI" \
  --profile DEFAULT

注意事項

  • ai_generate 実行前にモデル名を推測するのではなく、このスキルで実在するモデル名を解決すること。
  • 読み取り専用。破壊的操作は一切なし。
  • パラメータ必須のため、裸の GET /models は 400 になる場合がある — 列挙には modelType を付与すること（上記で検証済み）。
  • ai_generate の利用可否はこのカタログとは独立している。 GET /models?modelType=GENERATIVE_AI がフレッシュなインスタンスで items: [] を返しても、 ai_generate('openai.gpt-5.4', …) は正常に実行できる場合がある — モデルの解決は REST カタログではなく Spark エンジンレベルで行われるためである。 ここでリストが空でも ai_generate が利用不可を意味するわけではない。 AI-in-SQL の確認は本エンドポイントではなく、aidp-ai-sql のスモークテスト （SELECT ai_generate('<model>', 'hello') を実行するシンプルなセル）で行うこと。

参照

原文（English）を表示

aidp-models-catalog — available models & parameters

Two distinct surfaces:

  • Platform model catalog — what you can call from ai_generate() / agent flows (LA Models API).
  • MLOps/MLflow registry — registered models + versions (the aidp-mlops group; see also aidp-mlops).

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

  • aidp mlops list-registered-models | get-registered-model | list-model-versions
  • (The official CLI folds the model registry into the mlops group — there is no separate models group.)

Fallback (no CLI) / platform catalog: the LA Models REST API via oci raw-request (identical endpoint + auth) — this is the verified path for resolving an ai_generate() model name.

Verify-first (no-fabrication): the platform Models API is Limited Availability on 20240831; the ?modelType= list call is LIVE-VERIFIED 200 below. The MLOps registry side is Preview (not yet probed). Confirm a name with a live read before relying on it; record in references/rest-endpoint-map.md.

When to use

  • "What models are available?", "what's the model name for ai_generate?", "show model parameters", "list registered models / model versions".

Platform catalog — endpoints (DataLake-scoped; LA 20240831)

Base: https://aidp.<region>.oci.oraclecloud.com/20240831/dataLakes/<DATALAKE_OCID>/…

  • GET /models?modelType=<GENERATIVE_AI|BASE|EMBEDDING|LLM> — list installed models (LIVE-VERIFIED 200)
  • GET /models/{id} — model detail
  • GET /models/{id}/modelParameters — parameters

Workflow

  1. Platform catalog: GET /models?modelType=GENERATIVE_AI (auth ladder; on 401/403 → session refresh) → present available model names/ids. Repeat with BASE / EMBEDDING / LLM to enumerate other catalogs. GET /models/{id} / …/modelParameters for detail.
  2. Registry browse: aidp mlops list-registered-models → list-model-versions (CLI preferred).
  3. Feed the confirmed model name to aidp-ai-sql (ai_generate('<model>', …)) or aidp-agent-flows.
oci raw-request --http-method GET \
  --target-uri "https://aidp.us-ashburn-1.oci.oraclecloud.com/20240831/dataLakes/<DATALAKE_OCID>/models?modelType=GENERATIVE_AI" \
  --profile DEFAULT

Notes

  • Use this to resolve a real model name before ai_generate rather than guessing one.
  • Read-only; no destructive ops.
  • A bare GET /models may 400 on a required param — pass modelType (verified above) to enumerate.
  • ai_generate availability is independent of this catalog. GET /models?modelType=GENERATIVE_AI can return items: [] on a fresh instance while ai_generate('openai.gpt-5.4', …) still executes fine — the model is resolved at the Spark engine level, not via this REST catalog. An empty list here does not mean ai_generate is unavailable. Confirm AI-in-SQL with the smoke test in aidp-ai-sql (a trivial SELECT ai_generate('<model>', 'hello') cell), not with this endpoint.

References

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