AIDP DataLake内で利用可能なモデルの一覧表示と、それらのパラメータ(設定値)の確認、および MLOps(機械学習の運用管理)モデルレジストリの閲覧ができます。 **次のような場合に使用:** - ユーザーが「どんなモデルが使える?」と尋ねた場合 - ai_generate()やエージェントの処理フロー内で、モデル名が必要な場合 - 特定モデルのパラメータを知りたい場合 - 登録されたモデルやそのバージョン一覧を表示したい場合 レジストリの参照には、公式の `aidp` コマンドライン(`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)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-versionsmlops グループに統合されており、独立した models グループは存在しない)フォールバック(CLI 不使用時)/ プラットフォームカタログ:
oci raw-request 経由の LA Models REST API(エンドポイント・認証ともに同一) —
ai_generate() のモデル名を解決する際の検証済みパスとなる。
検証優先(でたらめ禁止): プラットフォームの
ModelsAPI は20240831において Limited Availability。
?modelType=を用いたリスト呼び出しは以下のとおり 実機検証済み 200。
MLOps レジストリ側は Preview のため未プローブ。
実際に使用する前に必ずライブ読み取りで名前を確認し、references/rest-endpoint-map.mdに記録すること。
ai_generate に指定するモデル名は?」「モデルのパラメータを確認したい」「登録済みモデルまたはモデルバージョンを一覧表示したい」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 — パラメータ一覧プラットフォームカタログ:
GET /models?modelType=GENERATIVE_AI(認証ラダー; 401/403 の場合はセッション再取得)
→ 利用可能なモデル名・ID を提示。
BASE / EMBEDDING / LLM でも繰り返し、他カタログを列挙する。
詳細は GET /models/{id} / …/modelParameters で取得。
レジストリ参照:
aidp mlops list-registered-models → list-model-versions(CLI 推奨)
確認済みのモデル名を 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') を実行するシンプルなセル)で行うこと。aidp-ai-sql、aidp-agent-flows、aidp-mlopsaidp-models-catalog — available models & parametersTwo distinct surfaces:
ai_generate() / agent flows (LA Models API).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-versionsmlops 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
ModelsAPI is Limited Availability on20240831; 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 inreferences/rest-endpoint-map.md.
ai_generate?", "show model parameters",
"list registered models / model versions".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 detailGET /models/{id}/modelParameters — parametersGET /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.aidp mlops list-registered-models → list-model-versions (CLI preferred).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
ai_generate rather than guessing one.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.aidp-ai-sql, aidp-agent-flows, aidp-mlops原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。