リファレンスAI スキル複数件をまとめて扱う

複数件をまとめて扱う

複数候補の計画を作り、送信可能な状態か確認するときに使います。

スキルのバージョン: 1.0.0。資料: skill://nadoobio-batch-screening/SKILL.md。

原則

  • 候補が複数ある場合は create_plan を繰り返さず、CSV または FASTA をプロジェクトに保存して create_batch_plans を使います。
  • まず inspect_input でファイルの generation・sha256・inspectionVersion を読み、そのまま渡します。値が変わると batch_source_changed になります。
  • 列位置を推測しません。preview_batch_plans を mappings: [] で呼び、headers(列番号:名前)とデータ行数を確認します。この呼び出しは計画を作りません。
  • 列は名前ではなく位置(columnIndex)で対応付けます。名前列がある場合は nameColumn で指定します。
  • 対応付け後、同じ引数で preview_batch_plans をもう一度呼び、拒否行や設定の問題を確認してから create_batch_plans を呼びます。
  • 利用者が計画作成を依頼し、プレビューに拒否行や設定の問題がなければ、同じ会話で create_batch_plans まで進めます。計画作成は実行ではありません。プレビューと作成結果を併せて伝えます。

結果の読み方

  • rows の rejected はその行だけを修正し、新しい batchRequestId で作り直します。再試行しても作成済み計画は増えません。
  • 作成応答の approval.status と reason を先に読みます。pending なら返された approval.href を人に渡し、Web で計画・入力・設定・利用条件を確認して選んだ計画だけを承認します。reviewMode: exact_plan_list では1回に最大100件を確認し、1ページの承認を全件の承認とは説明しません。API キーで人の同意を代行記録しません。承認後に利用者が提出を依頼したら、元の batchId で submit_batch を呼びます。旧版の individual_plan_approval_required では各計画の get_plan 確認リンクと submit_plan の経路を使います。その他の unavailable は応答理由に従って案内します。
  • submit_batch は行順に提出します。stoppedByQuota:true なら quota を伝えて停止します。同じ submitRequestId で再試行すると受付済み行は skipped で返されます。

入力形式と設定の組み合わせ

  • 対応入力・鎖数・必要資料は現在の get_tool_schema と list_execution_options の応答で確認します。単独実行の全入力をバッチでも使えるとは想定しません。
  • CSV の対応付けには実際の headers と schema の設定キーを使います。列番号は0始まりです。FASTA の配列・名前の列位置と設定の組み合わせ可否はプレビュー応答で確認します。
  • 利用者が選んでいない設定を勝手に補いません。入力行数と組み合わせで生成する計画数を区別し、エラー・空行を含む実際の件数はプレビュー応答に従います。
  • 設定・列対応・組み合わせ軸が変わったら新しい作成要求にします。応答だけを失った場合は元の本文と同じ batchRequestId または submitRequestId で復旧します。
  • planHash は入力と設定の追跡用で、環境が違ってもバイトが一致する保証ではありません。完了後は結果・出典とサーバーが返した詳細・構造リンクを併せて示します。

提出前の条件確認

人の承認後、get_plan で現在の承認状態と usageTerms を確認します。条件があれば acceptedAt を確認し、返された usageTerms.termsHash を submit_batch.acceptedTermsHash にそのまま渡します。ハッシュの送信は同意の代わりにはなりません。条件ハッシュが異なる計画には一つのハッシュを共用せず、各計画の現在の条件を確認して submit_plan で個別送信します。応答消失後の再試行では元の本文と要求 ID を維持します。

バッチ作成要求の再照会では、approval.counts に現在の承認待ち・承認済み・期限切れ・受付済みの件数が返ります。approval.status が partial なら残りの待機・期限切れ項目だけを確認し、approved なら現在の条件と送信可否を確認します。submitted なら既存ジョブのリンクを案内し、新しい承認やバッチの再作成を求めません。approval.required: false はその照会で新たな計画承認が不要という意味で、現在の利用条件・権限・上限を満たしたという意味ではありません。

このページの内容