Boltz のバッチを準備する
CSV・FASTA の単一タンパク質配列から複数の計画を準備し、入力・設定の組み合わせ・送信可否を確認します。
複数のタンパク質配列を同じ条件で予測したり、設定を変えて比較したりするには、プロジェクトの実行計画 → 表から複数作成を使います。計画の作成だけでは GPU 計算は始まりません。Boltz が選択肢に出るかは、組織に公開された実行可能な版によって決まります。
対応する入力
現在のバッチ入力は、CSV の1データ行または FASTA の1項目につきタンパク質鎖を一つ受け付けます。鎖は連続したタンパク質配列で、この経路では鎖 A として保存します。: で連結した複数鎖・核酸・リガンド(タンパク質に結合する小分子)・行ごとの MSA ファイルには対応していません。複数成分は個別の複合体入力を使ってください。
MSA なしで単一配列から予測することを明示的に確認します。MSA は似たタンパク質配列を並べて対応付けた参考情報です。省略すると予測品質が下がる場合があり、単一配列モードを選んだだけで品質が検証されるわけではありません。
以下は CSV の例です。列名とジョブ名には韓国語を使えます。配列には元のアミノ酸1文字コードをそのまま使います。
名前,配列
候補1,ACDEFGHIKLMNPQRSTVWY
候補2,MQIFVKTLTGKTITLEVEPSDTIENVKAKIQDKEGIPPDQQRLIFAGKQLEDGRTLSDYNIQKESTLHLVLRLRGGこれは入力形式の例であり、研究候補の推薦や予測品質の保証ではありません。FASTA では各 > ヘッダーとその後の配列を一つの項目にします。
ファイルから計画まで
- Boltz の版を選択
- ファイル選択・追加
- 列を指定
- プレビュー
- 計画作成
- Boltz のツールと版を選び、単一配列モードの条件を確認します。
- 検査済みの保管ファイルを選ぶか、ここでファイルをアップロードから CSV・FASTA を追加します。アップロード完了と入力検査完了は別です。検査を終えて一覧に出たファイルを選んでください。一覧は検査完了まで自動更新されます。時間がかかる場合や一覧の取得に失敗した場合はファイル一覧を更新を押します。
- 画面に表示された実際の列名を見て、タンパク質配列の列を指定します。ジョブ名の列は計算入力とは別で、名前が入った列を選びます。
- 設定の組み合わせを選び、プレビューを押します。データ行・作成できる計画・修正する入力と設定・スキップする空行を区別して確認します。
- エラーを直して計画を作成を押します。保存された計画と現在の送信条件・利用条件・使用量を確認してから送信します。すべての計画にファイルのジョブ名があれば追加入力は不要です。名前がない計画がある場合だけ代替名を入力し、その行の名前にだけ行番号が付きます。
設定の組み合わせ
seed(乱数の初期値)、numSamples(生成構造数)、numRecycles(構造の更新回数)、stepScale(サンプリングのステップ倍率)を組み合わせられます。同じ設定をファイルの列と組み合わせ軸の両方に指定しないでください。
例えば有効な配列2行に seed 7・11 を適用すると計画は4件です。numSamples=2 は一つの計画で構造を2個生成する設定で、データ行を2行にする設定ではありません。最終件数はエラー・空行を反映したプレビューと作成結果で確認します。更新回数やサンプル数を増やしても精度は保証されません。
AI ツールから準備する
MCP と CLI は同じバッチ計画サービスを使います。list_execution_options で現在のリリース・manifestHash を確認し、inspect_input の原資料 SHA・generation・inspectionVersion を保持します。preview_batch_plans を mappings: [] で呼び出して実際の headers を読み、列を対応付けて再度プレビューします。
上の CSV のように第1列が名前、第2列が配列だと確認できた場合、次の設定を使えます。これは要求全体ではなく、列の対応付け・共通設定・組み合わせ部分の例です。
{
"toolType": "boltz",
"mappings": [{"settingName": "sequence", "columnIndex": 1}],
"nameColumn": 0,
"baseSettings": {"proteinMsaMode": "single-sequence", "numSamples": 1, "numRecycles": 1},
"sweep": {"mode": "cross", "axes": [{"settingName": "seed", "kind": "list", "values": ["7", "11"]}]}
}列番号は0から始まります。実際の要求にはプロジェクト・原ファイル・検査情報・リリース・manifestHash が必要で、作成には batchRequestId も必要です。作成応答の approval.status と reason を確認します。
Nadoo Bio API キーで作った Boltz 計画は、返されたバッチ承認リンクで入力・設定・利用条件を確認してから選択して承認できます。一度に最大100件を確認し、次のページは別途確認します。承認ではジョブは送信されません。承認後に送信を依頼すると、エージェントが元の batchId で submit_batch を呼び出します。未承認・期限切れ・条件変更は行ごとに拒否されます。応答消失時は同じ submitRequestId と本文で確認し、新しいジョブを作りません。旧サーバーが individual_plan_approval_required を返す場合は get_plan の個別確認リンクと submit_plan を使います。
人の承認後、get_plan で現在の承認状態と usageTerms を確認します。条件があれば acceptedAt を確認し、返された usageTerms.termsHash を submit_batch.acceptedTermsHash にそのまま渡します。ハッシュの送信は同意の代わりにはなりません。条件ハッシュが異なる計画には一つのハッシュを共用せず、各計画の現在の条件を確認して submit_plan で個別送信します。応答消失後の再試行では元の本文と要求 ID を維持します。
バッチ作成要求の再照会では、approval.counts に現在の承認待ち・承認済み・期限切れ・受付済みの件数が返ります。approval.status が partial なら残りの待機・期限切れ項目だけを確認し、approved なら現在の条件と送信可否を確認します。submitted なら既存ジョブのリンクを案内し、新しい承認やバッチの再作成を求めません。approval.required: false はその照会で新たな計画承認が不要という意味で、現在の利用条件・権限・上限を満たしたという意味ではありません。
再試行と結果の追跡
応答が失われたら元の要求を保持し、同じ要求 ID と本文で受付を確認します。作成の batchRequestId と送信の submitRequestId は別です。同じ ID でファイル・列対応・設定・組み合わせを変えないでください。入力を変える場合は新しい要求を用意します。部分失敗や上限による停止を全件成功と解釈せず、受付済みジョブから確認します。
原ファイル SHA、計画の planId・planHash、行・組み合わせ番号、ジョブ・実行試行・結果の来歴を合わせて追跡できます。seed とハッシュは入力・設定の確認に使い、すべての GPU やライブラリで同一座標を保証するものではありません。
完了したジョブは結果詳細と構造リンクを開いて確認します。構造リンクにも現在の組織・プロジェクト権限が必要です。構造ファイルの検査完了と、3D ビューアーでの正常表示は別です。計算完了を実際の結合・生物学的機能・実験成功と解釈しないでください。