リファレンス自動化リファレンス

実行への対応状況と次の手順

カタログ検索・入力準備・計画作成・ジョブ送信を区別し、現在の応答に合う次の手順を確認します。

ツールの掲載だけでは現在実行できるとは限りません。プロジェクトを選び、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 などの実際のエラーが返された場合にだけ、その権限要件を説明します。大半のツールが実行できない、別のアカウントなら解決すると一般化しないでください。

対応している段階・返された理由・次にできる作業を一緒に伝えます。配列エラーと正規化は入力検証結果の読み方を参照してください。

このページの内容