query_seasons
弾(シーズン)一覧・期間取得
ブースター弾(シーズン)の一覧と各弾の期間(開始日・終了日)を取得します。弾番号・セットコード・弾名・進行中フラグで絞り込めます。「7弾はいつからいつまで?」「7弾と8弾を比較」のような、弾番号・弾名から期間を解決する起点に使います。
パラメータ
| 名前 | 型 | 必須 | デフォルト | 説明 |
|---|---|---|---|---|
season_number |
string | 任意 | - | 弾番号(例: 7, 8.5)。seasonNumber と完全一致 |
set_code |
string | 任意 | - | セットコード(例: hBP07)。setCode と完全一致 |
name |
string | 任意 | - | シーズン名(部分一致、例: ディーヴァ) |
current_only |
boolean | 任意 | false |
現環境(今日が発売日〜終了日の範囲内)のシーズンのみ返す。未発売の予約弾は含めない |
パラメータはすべて任意で、複数指定時は AND 結合です。指定しない場合は全弾を返します。
使用例
弾の期間を確認する
プロンプト例:
7弾はいつからいつまでですか?
弾比較の前段(期間解決)
プロンプト例:
7弾と8弾でメタはどう変わった?
AI は query_seasons で両弾の期間を解決し、その dateFrom / dateTo を compare_periods に渡してメタ変化を分析します。
レスポンス例:
{
"seasons": [
{
"id": "hBP08",
"setCode": "hBP08",
"seasonNumber": "8",
"label": "8弾",
"name": "バウンサーバウンド",
"dateFrom": "2026-06-19",
"dateTo": "2026-09-18",
"isExtra": false,
"isCurrent": false
}
]
}
注意事項
isCurrent: trueは「今日が発売日(dateFrom)〜終了日(dateTo)の範囲内」の弾=現環境です。dateToが空でも発売日が未来の弾(未発売の予約弾)はisCurrent: falseになります(「今の環境」を未発売弾と誤認しないため)。dateToが空文字""かつ発売済みの弾は進行中です。期間指定が必要な他ツールへは、終了日を「今日」で補完してください。- 並びは新しい弾が先頭(
sortOrder降順)です。 isExtra: trueは 8.5弾などのエクストラブースターです。- 弾の正本は DB の
seasonsテーブル(packages/configのBOOSTER_SEASONSからシード)です。