実行への対応状況と次の手順
カタログ検索・入力準備・計画作成・ジョブ送信を区別し、現在の応答に合う次の手順を確認します。
ツールの掲載だけでは現在実行できるとは限りません。プロジェクトを選び、list_execution_options で現在のアカウントの対応状況を確認します。リリースの公開は組織単位なので、同じ組織のプロジェクトには同じ結果が表示されます。
どこまで進められるか
options— 現在の呼び出し方法で計画に使えるリリースです。releaseIdとmanifestHashの両方を保持します。掲載だけで送信が承認されるわけではありません。preparationOnly— 入力準備の経路があるツールです。一覧名だけで後続の段階がすべて使えないと判断せず、各項目のworkflowSupportを読みます。workflowSupport.inputPreparation— 入力準備への対応状況です。workflowSupport.planCreation— このプロジェクトで準備計画を作れるリリースがあるかを示します。workflowSupport.jobSubmission— 現在の呼び出し方法での送信対応状況です。plan-review-requiredも送信許可ではなく、その計画の確認が必要という意味です。
reason は機械で読む識別子、reasonText はその説明です。返されていない理由を推測しないでください。最新の計画確認では入力・権限・リリース・承認などの送信条件を再確認します。
すぐ実行されるか、待機するか
executionCapacity は、この組織の GPU ジョブを受け付ける実行サーバーの現状です。送信可否とは別で、サーバーがない場合や満杯の場合もジョブを受け付け、キューで待機します。
state—available(空きあり)、busy(すべて使用中、空き次第実行)、none(直近2分以内に接続したサーバーなし)、unknown(サーバーはあるが空き容量が未報告)。cleanDevicesはジョブが割り当てられていない GPU 数、maxFreeMbは一つのデバイスで共有できる最大の空き容量(MiB)です。それを超えるジョブは空きを待ちます。platformServersとorganizationServersは、それぞれ Nadoo Bio が運用するサーバーと組織が接続したサーバーの数です。
応答の実行サーバー案内をそのまま伝えます。待ち時間の見積もりは含まれないため、推測して案内しないでください。
実行環境がまだない場合
runtime_consumer_unavailable は現在このツールの実行環境がないことを意味します。API キーのスコープ追加や人の承認では解決できません。
対応している入力準備または計画作成の段階まで進めます。計画作成後の送信可否は get_plan の submissionAvailable で確認します。制約を解消できる担当は fixableBy・fixableByText に示されます。platform なら Nadoo Bio による実行環境の配備、organization-operator なら組織の運用担当者によるリリース公開が必要です。
計画に使えるリリースがない場合
release_unavailable は、現在のプロジェクトで計画を作れる有効な公開リリースがないことを示します。この理由だけではライセンス・アカウント権限・公開漏れのどれが原因かは判断できません。
入力準備が対応済みならそこまで進め、実行オプションを再照会してリリースの有無を確認します。リリース ID は応答の値をそのまま使います。
Web で新しい計画が必要な場合
session_submission_required の場合、現在の API キー方式で作った計画は承認後も送信できません。応答の実行計画を表示リンクを開き、同じプロジェクトの Web 入力画面で新しい計画を作成・確認します。
既存の API キー計画が Web 計画に変わるわけではありません。元の計画と入力記録は保持します。新しい Web 計画でも、入力・権限・実行条件によって送信が制限される場合があります。
対象の計画を先に確認する場合
plan_review_required の場合は応答のリリースを使い、入力を固定した計画を作成・確認します。送信可否はその時点の確認結果に従います。準備成功・人の承認・ジョブ受付・実行完了はそれぞれ異なる状態です。
Nadoo Bio API キーで Boltz を実行する
ここで使うのは Nadoo Bio 発行のキーで、別の Boltz サービスのキーではありません。エージェントが計画を作り、ユーザーが Web で利用条件を確認・承認した後、同じ planId・planHash で submit_plan を呼び出します。送信時にキーの権限・承認期限・運用設定・使用量を再確認します。
Boltz バッチの approval.status が pending なら、返されたリンクで人が計画と利用条件を確認・承認します。reviewMode: exact_plan_list は一度に最大100件の選択した計画だけを承認する方式です。承認と送信は別で、送信を依頼された後に元の batchId で submit_batch を呼び出します。旧版の individual_plan_approval_required には、get_plan の個別確認リンクと submit_plan を使います。
人の承認後、get_plan で現在の承認状態と usageTerms を確認します。条件があれば acceptedAt を確認し、返された usageTerms.termsHash を submit_batch.acceptedTermsHash にそのまま渡します。ハッシュの送信は同意の代わりにはなりません。条件ハッシュが異なる計画には一つのハッシュを共用せず、各計画の現在の条件を確認して submit_plan で個別送信します。応答消失後の再試行では元の本文と要求 ID を維持します。
空の一覧と権限エラー
空の一覧だけでは権限不足とは判断できません。scope_required などの実際のエラーが返された場合にだけ、その権限要件を説明します。大半のツールが実行できない、別のアカウントなら解決すると一般化しないでください。
対応している段階・返された理由・次にできる作業を一緒に伝えます。配列エラーと正規化は入力検証結果の読み方を参照してください。