研究者向けガイド

実行と承認

計画の入力と使用量を確認し、エージェント承認・ジョブ送信・受付状態の復旧を区別する方法です。

入力の準備後に実行計画を確認します。計画には今回の入力と設定が固定されます。作成しただけではジョブは始まりません。

実行前の確認

プロジェクトの実行計画一覧から確認を開き、次を確認します。

  • ツールと確認済み入力が目的の作業に合っているか。
  • 設定値・ファイル・鎖・領域が正しいか。
  • 使用件数と送信期限が適切か。
  • 現在送信できるか、制限理由があるか。

料金が未設定なら金額がまだ決まっていない状態で、無料ではありません。使用件数と料金は別に確認します。費用が表示されなければ金額は確定できません。

計画 ID とハッシュ

応答の planId は計画を探す識別子、planHash は確認した内容を識別するハッシュです。確認した計画と送信する計画が同じかを両方で確かめます。返された値をそのまま保持してください。

送信の requestKey は同じ送信要求を識別するもので、planId・planHash とは異なります。紛失した要求キーを planHash で代用・推測することはできません。

  1. 計画と受付状態を照会します。 get_plan({planId: "known-plan-id"}) の引数は planId だけで、requestKey・planHash は送りません。元の要求キーがなくても照会できますが、この照会では requestKey の返却・復元は行いません。
  2. 受付済みジョブを確認します。 submittedJobId があれば状態と詳細リンクを確認します。なければ受付の有無は未確認です。送信処理中の場合もあるため、この値だけで失敗・未受付と判断しません。
  3. 元の要求を保持している場合だけ同じ要求で再試行します。 元の requestKey と同一の送信本文を一緒に使います。
  4. 元の要求がなければ、まず記録を確保します。 照会と元の要求記録の確認にとどめ、新しい要求・計画をすぐ送信しません。キーやハッシュの置き換えは復旧ではありません。

同じ受付済み計画を別のキーで送ると plan_already_submitted で拒否されます。未受付計画の新しいキーが必ず拒否されるという意味ではありません。重複受付の防止と元の受付記録の復旧は別です。新しい計画を作って送信すると同じ入力のジョブが重複する可能性があります。

入力や設定を変える場合は新しい計画を準備して確認します。以前の承認は変更後の内容には適用しません。同じ計画でもモデルの乱数や実行環境で出力は変わり得るため、ハッシュが同じでも数値の一致は保証されません。

入力の出典

外部データベースの資料は研究者が公式サイトから直接取得します。Nadoo Bio は ID や URL から代理ダウンロードしません。

  • タンパク質構造は PDB・mmCIF としてアップロードし、形式検査後に鎖・領域を選びます。
  • 配列は FASTA のアップロードか直接入力を使います。分子は取得済みの SMILES を入力するか、対応する保管ファイルを選びます。
  • ダウンロードの権限と商用計算・外部処理・共有の権限は異なる場合があります。利用範囲に合う資料を用意してください。
  • 原資料と一緒に、出典データベース・識別子・リリース・取得日・ライセンス告知を保管します。形式検査の通過は利用権の確認ではありません。
  • 過去のサーバー照会で残った入力の出典は既存計画で引き続き確認できます。直接入力した資料を原データベースと照合済みとは表示しません。エージェントの get_plan.inputSources も過去に記録された出典だけを返します。

エージェント承認とジョブ送信

  1. 入力準備
  2. 計画確認
  3. 人の承認
  4. ジョブ送信
  5. 結果確認

人の承認が必要なエージェント作成計画には、エージェント実行を承認が表示されます。内容を確認して承認すると、その計画で送信を進められます。承認は送信を許可する段階で、エージェントの自動再開やジョブ予約は行いません。実際の送信にはエージェントが承認済み計画で submit_plan を呼び出す必要があります。Web のジョブを送信を追加で押す必要はありません。送信時に現在の条件を再確認します。

Web で直接準備した送信可能な計画は別の経路です。確認事項を読んでジョブを送信を押します。ジョブを受け付けましたと表示されたら、ジョブ一覧を表示で進行を確認します。受付は計算完了ではありません。

承認期限や送信期限が過ぎたら、画面に従って再確認または新しい計画を準備します。実行条件が変わった場合も、以前の承認だけでは送信できるとは限りません。

Nadoo Bio API キーで作った Boltz 計画は、ユーザーが Web で利用条件と対象計画を確認・承認してから、エージェントが submit_plan で送信します。別の Boltz サービスのキーは不要です。複数配列は Boltz のバッチを準備するを参照してください。

応答が失われた場合

送信後に応答がなくても、すぐ新しい計画や要求を作らないでください。受付を確認する要求がありますと表示されたら再試行を使います。保存された同じ要求で受付を確認し、未受付なら同じ要求を再送します。

要求を保存は元の要求が画面に残り、ボタンが表示されるときだけ使えます。残っている要求をファイルに保存する機能で、紛失した要求は復元できません。保存ファイルは実行完了の証明でも結果ファイルでもありません。

ブラウザーに元の要求がなければ、ダウンロードや同一要求の再試行では復旧できません。画面の案内とジョブ一覧で受付を確認し、元の要求記録を確保するまでは新規送信しません。応答が元の要求と一致しない場合も、新しい要求へ自動で置き換えません。

送信できない場合

表示された状態次の操作
送信期限切れ入力を確認して新しい計画を準備。
実行条件の変更最新条件で新しい計画を確認。
アクセス権限なしログイン中のユーザーとプロジェクト権限を確認。
実行環境が未対応対応する入力準備まで進み、現在の対応状況を確認。

入力準備・計画作成・人の承認だけでは実行環境は用意されません。API キーと Web で送信できる範囲も異なる場合があります。各応答理由は実行への対応状況と次の手順で説明します。

ジョブと結果を確認する

ジョブ一覧で進行と失敗理由を確認します。エージェントの画面リンクからも開けますが、権限確認は引き続き適用されます。結果が出たら結果を読み解くに沿って指標・出力・実行記録を合わせて確認してください。

このページの内容