リファレンス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 はその照会で新たな計画承認が不要という意味で、現在の利用条件・権限・上限を満たしたという意味ではありません。