discovery について
Runpodのカタログを参照し、GPU・CPU、在庫、価格、テンプレート、ワーカー、パブリックエンドポイントについて回答する検索スキルです。条件に合う結果の絞り込みやモデルのVRAM見積もりを行い、デプロイや変更は行いません。
主な機能
- 01GPUとCPUのカタログ参照
- 02製品・データセンター別の在庫確認
- 03価格とCUDA容量の確認
- 04Hubワーカーと公開テンプレートの検索
- 05従量課金モデルエンドポイントの検索
- 06モデルに必要なVRAMの見積もり
活用シーン
- 01価格と在庫によるGPUの比較
- 02地域やCUDA別のGPU容量確認
- 03既成ワーカーやテンプレートの検索
- 04モデルのデプロイに必要なハードウェアの見積もり
MCP 対応
`runpod-mcp`のツールでRunpodのカタログと在庫を読み取り、MCPクライアント向けに情報を提供します。検索と構成の推奨のみを行い、リソースの作成・更新・停止・削除は行いません。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ runpod/ runpod-plugins-official --skill discoveryインストール後、Claude Code で/discoveryを入力して読み込まれたか確認します。
詳細
ディスカバリー
Runpod のカタログをもとに、利用可能性、要件への適合性、価格に関する質問に回答し、何も変更しません。4 つのカタログに共通する方針は 1 つです。プロンプトの実際の制約に合わせて絞り込み、ツールが返した項目だけを挙げ、価格と在庫状況は出力のとおりに記載し、カード、リージョン、リポジトリを捏造するのではなく「該当なし」と伝えます。
デプロイ用スキルが参照する、モデル→VRAM のサイジング計算も担当します。モデルのパラメーター数と精度をもとに、必要な VRAM を推定し、実際に在庫のある中で適合する最小の GPU クラスを示します。サイジングは助言であり、このスキルは推奨するだけで、デプロイはしません。
カタログの生データの読み取りには runpod-mcp のツール呼び出しを使用します。このスキルは、その上にあるディスカバリーの流れを担います。つまり、絞り込み、適合性の確認、価格の提示、該当なしの場合の誠実な回答です。
必要な機能
機能として記載しています。このサーバーで各機能を提供するツールは、以下のツールバインディングに示されています。ここに挙げる機能はすべて読み取り専用です。
- 価格とリアルタイムの利用可能状況を含む GPU カタログを読み取ります。
- ユーザーが作成するプロダクトについて、データセンターごとの GPU の利用可能状況を読み取ります。つまり、現在どのデータセンターに空きのあるカードがあるかを確認します(在庫状況は Pod、Cluster、Serverless によって異なります)。
- GPU タイプごとにキャパシティのある CUDA バージョンを読み取ります(利用可能状況の読み取りにおける
cudaVersions、マトリクス表示ではget-capacity)。CUDA の下限は互換性だけでなく、キャパシティに関する質問でもあります。 - データセンターとそのリージョンを読み取ります。在庫とネットワークボリュームのティアがどこにあるかを確認します。
- CPU Pod および CPU Serverless のサイジングに関する質問向けに、CPU カタログを読み取ります。
- Hub のワーカーマーケットプレイスを閲覧し、このタスク向けのビルド済みワーカーがあるか確認します。
- 公開テンプレートカタログを閲覧し、このイメージ/ワークロード向けの公式、認証済み、またはコミュニティ提供のテンプレートがあるか確認します。
- 従量課金制の公開エンドポイントカタログを読み取り、デプロイ不要のマネージドモデル API を確認します。
確認の流れ
GPU の利用可能状況と価格
利用可能状況を含めて GPU カタログを読み取り、実際の制約に合わせて絞り込みます。VRAM のティア(「N GB GPU」)が指定されている場合は、そのティアに絞り込みます。GPU 全体を列挙してはいけません。該当する各項目について、出力から表示名、メモリ容量、時間あたりの価格、在庫状況を記載します。質問の意図に合わせ、価格順または在庫数順で短い表にまとめます。そのティアに在庫のある項目がない場合、在庫切れのカードを利用可能であるかのように列挙せず、その旨を伝えます。
リージョン別の在庫/CUDA
異なる質問には、それぞれ異なる読み取りが必要です。混同しないでください。
- リージョンまたはデータセンターにおける
<card>のキャパシティ。 カタログ読み取り時に利用可能状況の拡張を指定します。include:["AVAILABILITY"]とproduct(["POD"]、["CLUSTER"]、または["SERVERLESS"])を指定したlist-gpu-typesまたはget-gpu-typeは、GPU タイプごとのdataCenters配列を返します(2 つのパラメーターはセットで指定し、在庫状況はプロダクトによって異なります)。include:["GPU_AVAILABILITY"]を指定したlist-data-centers/get-data-centerは、データセンターごとに同じ情報を返します(list-data-centersではregionsフィルターも使用できます)。指定された GPU タイプとリージョンに絞り込み、どのデータセンターに在庫があるか、どこが在庫切れかを報告し、読み取り結果にある名称を記載します。 - 在庫のある CUDA バージョン、またはエンドポイントの
allowedCudaVersionsの選択。 これは利用可能状況の読み取りで回答します。各 GPU タイプのcudaVersionsに、空きキャパシティのあるホスト CUDA バージョンが列挙されます(cudaVersions/minCudaVersionで絞り込みます)。get-capacityでは、GPU タイプ全体を同じマトリクスで確認できます。どちらにもデータセンターの情報は含まれないため、そこからデータセンター名を挙げてはいけません。データセンターごとの回答は、利用可能状況の読み取り結果に含まれるdataCentersに基づいてください。
モデルを GPU に合わせて選定する
モデルの実際のパラメーター数と精度から必要な VRAM を見積もり、標準構成で収まる最小の GPU を提示します。概算の VRAM は、重み ≈ パラメーター数(B)×パラメーターあたりのバイト数(fp16 → 2、int8 → 1、int4/awq/gptq → 0.5)に、KV キャッシュとアクティベーション用として約 20%を加えます。長いコンテキストや高い同時実行数でのサービングには、より多くの KV キャッシュ用余裕が必要になるため、その旨を伝えます。GPU カタログを確認し、見積もりを上回るメモリがあり、実際に在庫がある最小クラスを推奨し、余裕を持たせるために次のサイズも提示します。どの精度とコンテキストを前提にサイズを選定したかを、見積もりとともに明記します。ユーザーがパラメーター数を指定しておらず、モデルからも読み取れない場合は、推測せずに一度だけ質問します。どのカードをいくらで買えるかという質問は、この手順で対応します。今すぐカタログを読み取り、推奨カードの時間単価と現在の在庫を、読み取った情報に基づく確定事項として明記します。「後でライブ容量を確認できます」と申し出て終わったり、「在庫があるはずです」と曖昧にしたりしてはいけません。在庫確認は 1 回の呼び出しで済むため、必ず実行します。
Hub の事前構築済みワーカー
タスクに合った事前構築済みワーカーを Hub で検索します(言語、画像、音声、動画、埋め込みの用語とカテゴリで検索)。カタログに表示されたリポジトリ名と所有者、各リポジトリの用途を示します。設定が確認できる場合は、必要なハードウェアも記載します。すべてのリポジトリをその掲載情報に基づいて記載し、記憶を頼りにリポジトリが存在すると断言してはいけません。一致するものがなければ、「Hub で見つかりませんでした」と伝えて終了します。見つかったリポジトリのデプロイには serverless-deploy を使用します。
すぐに使える公開テンプレート
ユーザーがワークロードに使える既存のイメージやテンプレートについて尋ねた場合は、公開テンプレートカタログを確認します。source で検索対象を選択します。official は Runpod が厳選したテンプレート(デフォルト)、verified は Runpod が検証したコミュニティテンプレート、community はその他の公開共有テンプレートです。各エントリの serverless フラグで、Pod テンプレートかサーバーレステンプレートかを判断し、どの対象を検索したか、どちらの種類を提示するかを明記します。読み取り結果に含まれるテンプレートだけを ID とともに提示し、見つからなければ作り上げずに「見つかりませんでした」と伝えて終了します。カタログは最大 100 件を返し、ページ分割には対応していません。そのため、一覧には上限があることを伝え、網羅的であるかのように示してはいけません。テンプレートからのデプロイには pod-deploy または serverless-deploy を使用し、ユーザー自身のテンプレートには lifecycle-crud を使用します。
デプロイ不要の従量課金制
ユーザーがインフラを稼働させず、単発の結果(「このモデルを入力データで一度実行する」など)を求めている場合は、公開エンドポイントのカタログを読み取ります。これはデプロイ不要の、管理された従量課金制のモデル API(テキスト、画像、動画、音声)です。モダリティで絞り込み、条件に合う稼働中のエンドポイントを、所有者とモデル名とともに提示します。単発のリクエストには、多くの場合これが適切な選択肢です。エンドポイントを立ち上げるよりも、こちらを推奨します。対象のモダリティがカタログにない場合はその旨を伝えますが、選択肢がないまま終わってはいけません。実際に利用できる最も近い方法(通常は、そのモダリティ向けの Hub ワーカーをサーバーレスでデプロイする方法)を、従量課金制ではなくデプロイが必要な方法だと明示して提示し、ユーザーが次の手段を選べるようにします。デプロイ可能なワーカーを従量課金制のように提示してはいけません。
厳守事項
- このスキルでは、変更を伴うツールを決して呼び出してはいけません。読み取りによる確認のみを行い、作成、更新、停止、削除は行いません。
- ツールが返したエントリだけを提示します。GPU クラス、リージョン、価格、Hub リポジトリ、公開エンドポイントを作り上げてはいけません。
- 出力にある価格と在庫を引用します。ツールが返していない価格を計算したり、「およそこのくらいのはず」といった数値を示したりしてはいけません。
- 空の結果はそのまま報告します。「見つかりませんでした」は正しい回答であり、もっともらしい情報をでっち上げるより適切です。
- サイズ選定は前提を明示した推奨であり、デプロイではありません。モデルを収めて実行する役割は
serverless-deployが担います。 - プロンプトにある実際の制約に合わせて絞り込みます。ユーザーが特定のティアやリージョンについて尋ねた場合、カタログ全体を列挙してはいけません。
- 回答の内容に矛盾がないようにします。在庫の要約行は、要約対象のデータセンターテーブルと一致している必要があります。2 回の読み取り結果が異なる場合は、矛盾させず、より新しい結果を提示します。
エラー処理
productなしでinclude:["AVAILABILITY"]を指定する場合、または include なしでproductを指定する場合 → API は 400 を返します。ユーザーが作成する製品について、両方を指定してください。- カタログの読み取り結果が空のリストの場合 → そのフィルターでは「該当なし」と報告してください。検索範囲を黙って広げたり、項目を捏造したりしないでください。
- ユーザーが指定した VRAM の区分に該当するカードがない場合 → その区分のカードはカタログに存在しない(または在庫がない)と伝えてください。依頼されていないのに近いカードへ丸めないでください。
- 読み取りに失敗した場合 → 失敗を報告して、そこで停止してください。記憶に基づいて回答しないでください。
ツールの対応関係
| 機能 | ツール |
|---|---|
| GPU カタログ+価格+在庫 | list-gpu-types / get-gpu-type(product とともに include:["AVAILABILITY"] を指定) |
| データセンターごとの GPU の利用可否 | 同じ読み取り(dataCenters[]);list-data-centers / get-data-center(include:["GPU_AVAILABILITY"] を指定) |
| GPU タイプごとの、容量を含む CUDA バージョン | 同じ読み取り(cudaVersions);マトリックス表示には get-capacity |
| データセンター | list-data-centers、get-data-center |
| CPU カタログ | list-cpu-types、get-cpu-type(product とともに include:["AVAILABILITY"] を指定) |
| Hub の参照 | list-hub-repos(searchTerm、category、includeConfig) |
| 公開テンプレートカタログの参照 | list-public-templates(source:official / verified / community) |
| 従量課金制の Public Endpoints | list-public-endpoints(modality、owner) |
ここに記載されたツールがセッションのツール一覧にない場合は、その旨を伝え、結果を捏造せず、代わりに最も近い読み取りツールを使用してください。
契約
複数のジャーニーにまたがる回答契約(読み取りで確認した確定情報に基づくこと、曖昧な表現で逃げずに確定的に答えること、変更操作はこの会話で作成したものに紐づけること、最終メッセージを単独で完結させること、失敗を正直に伝えること、許可されたツールのみを使うこと)は、runpod-mcp スキルで定義されており、このジャーニーのすべての返信に適用されます。この会話で runpod-mcp スキルが読み込まれていない場合は、次のツール呼び出しの前に今すぐ読み込んでください。このスキルには、変更してよいリソース、リクエストが実行可能となる条件、ユーザーの判断を待って停止すべきタイミングに関するルールが記載されています。ここでは繰り返しません。