小売店で、商品の特長メモ・売価・季節の訴求から店頭POPの見出しと説明文の案を作り、価格と産地の表示のルールに合う案だけを選べるようにする

処理の起点を決める

毎週水曜日の12時に、依頼表を締めたところで動かします。 仕入担当が行を足し終えた時刻で区切り、それ以降に足された行は翌週に回すか、販促担当が手で作ります。締める時刻を決めておかないと、バッチを送った後に足された行が漏れます。

送った後は、30分ごとにバッチの状態を確かめる処理を動かします。 状態が completed になったら結果を取り出し、規則の点検に進みます。expired（24時間の枠の中で終わらなかった）になったときは、完了していた依頼の結果は出力のファイルに入り、残りはエラーのファイルに書かれます。 残りだけを同期の呼び出しでやり直します。

新商品の差し込みなど、水曜日の締めに間に合わない1枚は、同じ指示で同期の呼び出しを1回だけ行います。 バッチを待つ必要が無い数なので、別の経路を用意しておきます。

入力データを集める

質を決めるのは、特長メモです。 AIはメモに書かれたことしか書けない、という作り方にしているので、メモが「おいしいです」の一行だけなら、案も薄くなります。 仕入担当には、「誰が・いつ・どう食べるとよいか」が分かることを1つ以上書いてもらいます。

依頼表の1行の例です。

商品コード：4901234567890
訴求のテーマ：秋の鍋の売場
特長メモ：白菜の芯までやわらかい品種。鍋に入れると5分ほどで煮える。
          浅漬けにしても甘みが出る。1/4カットで冷蔵庫に入れやすい
POPの大きさ：B5

メモは、仕入担当が自分の言葉で書いたままで構いません。 箇条書きにそろえる必要はなく、「誰が・いつ・どう食べるとよいか」が1つ入っていれば、案の切り口が増えます。

原産地は、特長メモではなく商品マスタから取ります。 第3章の（c）のとおり、メモは古いまま残ることがあります。POPに産地を書くときの根拠は、商品マスタの原産地の列だけにします。 メモに「国産」とあって、マスタの原産地が違えば、その行は案を作らずに販促担当へ戻します。

禁止表現の一覧は、販促課で作ります。 「日本一」「最安値」「No.1」「絶対」のように根拠を示せない最上級の言葉、健康への効果をうたう言葉、他社と比べる言葉を並べ、それぞれに「使うなら根拠の資料が要る」「使わない」の区分を付けます。

データの取得方法を決める

依頼表、商品マスタ、売価マスタは、Python の処理が読み取るだけです。売価の履歴は、POSのデータから商品ごと・日ごとの売価（税込）を取り出します。比較の価格の判定に使うので、特売の期間を含めた最低8週間分を持ちます。

AIに渡すのは、商品名・規格・特長メモ・訴求のテーマ・文字数の上限だけです。 売価も売価の履歴も渡しません。数字を渡すと、AIはそれを文案に使いたがります。

AIへ渡す前に整形する

1. 締め時刻の確認 … 水曜12時より後の行は、今週のバッチに入れません
2. マスタとの照合 … 商品コードが商品マスタにない行、売価マスタに特売の売価がない行は、案を作らずに販促担当へ戻します
3. 産地の食い違いの確認 … 特長メモに産地の語（「国産」「〇〇県産」など）があり、商品マスタの原産地と合わない行は戻します
4. 特長メモの長さの確認 … 20字に満たないメモは、案が薄くなるので仕入担当へ書き足しを頼みます
5. 依頼のファイル作り … 1行ごとに custom_id（依頼表の行番号と週）を付け、/v1/responses への依頼として .jsonl に書きます

1. 表示ルール表の版の確認 … 禁止表現の一覧を直した週は、版の番号を依頼のファイルに書き込み、どの版で点検したかを後から追えるようにします

3番目を省かないでください。 POPの産地の誤りは、お客様が売場で読んで、そのまま買う理由になる情報です。AIの案が正しくても、渡したメモが古ければ、誤った産地のPOPが22店舗に並びます。

AIに処理させる

させるのは、特長メモと訴求のテーマから、見出しと説明文の案を3つ作り、それぞれの言葉がメモのどの文言にもとづくかを書き出すことだけです。

3行目の「根拠」が、この構成でいちばん大事なところです。 「甘い」「とろける」「朝どれ」は、POPに書きたくなる言葉です。メモに書かれていなければ、それは誰も確かめていない言葉です。 根拠の文言を写させ、写せない言葉を案から外させます。後段で、写した文言が本当にメモにあるかを機械で確かめます。

指示内容を固定する

あなたは食品スーパーの販促担当です。店頭POPの見出しと説明文の案を3つ作ってください。
下の「特長メモ」に書かれていることだけを材料にしてください。

【商品】{product_name}（{spec}）
【訴求のテーマ】{theme}
【特長メモ】{feature_memo}
【POPの大きさ】{size}　見出しは{headline_max}字以内、説明文は{body_max}字以内

【厳守事項】
- 価格、割引の額、割引率、「〇割引」「半額」「お買い得価格」など値段に関わる言葉を書かないでください。
  数字は使わないでください。価格はあとで別に入ります。
- 産地を書かないでください。産地はあとで別に入ります。
- 「日本一」「最安値」「No.1」「絶対」「どこよりも」など、比べたり一番だと言ったりする言葉を使わないでください。
- 健康や体への効果をうたう言葉を使わないでください。
- 特長メモに書かれていない特長（味、食感、鮮度、作り方など）を足さないでください。
- 案の中の特長の言葉ごとに、もとにした特長メモの文言を、そのまま書き写してください。
  書き写せない言葉は、案に入れないでください。
- 文字数の上限に収まらないときは、案の数を減らしてください。
- 3つの案は、それぞれ違う切り口にしてください（食べ方、季節、手軽さ など）。
- 案を良くするためにメモに足してほしいことがあれば、needs_info に書いてください。

「数字は使わないでください」を書いても、数字は混ざります。 「3分でできる」はメモにあれば使ってよい言葉ですが、「3割引」と区別がつかなくなります。指示では一律に数字を禁じ、メモにある数字（調理時間など）を使いたいときは、販促担当が選んだ後に手で足します。 後段の点検でも、数字の入った案は一律に外します。

「違う切り口にしてください」も効きます。 何も言わないと、3つの案は語尾が違うだけの同じ案になります。選ぶ意味のある3つにするために、切り口を指定します。

出力形式を固定する

次の形のJSONで受け取ります。 Batch API の各依頼の本体に、構造化出力の指定（text: { format: { type: "json_schema", strict: true, schema: ... } }）を入れます。

{
  "pop_id": "2026W41-037",
  "candidates": [
    { "angle": "食べ方 | 季節 | 手軽さ | その他",
      "headline": "",
      "body": "",
      "claims": [ { "word": "", "memo_quote": "" } ] }
  ],
  "dropped_reason": "",
  "needs_info": ""
}

上の依頼表の例なら、案の1つは次のように返ります。

{ "angle": "食べ方",
  "headline": "芯までやわらか白菜",
  "body": "鍋に入れるとすぐ煮えて、芯までやわらか。浅漬けにしても甘みが出ます",
  "claims": [ { "word": "芯までやわらか", "memo_quote": "白菜の芯までやわらかい品種" },
              { "word": "甘みが出ます", "memo_quote": "浅漬けにしても甘みが出る" } ] }

メモの「5分ほど」は数字なので、案では「すぐ」に置き換わっています。販促担当が「5分で煮える」と書きたければ、選んだ後に手で足します。

1つ目の理由は、規則の点検を機械で行えることです。 required と additionalProperties: false で項目を固定するので、見出しと説明文と根拠が必ず別の項目で返ります。 点検の処理は、次の規則を当てます。

2つ目は、custom_id で依頼表の行に戻せることです。 バッチの出力の行の順番は、入力の順番と一致しないことがあるとされています。順番に頼らず、custom_id で依頼表の行と結果を結びます。

3つ目は、needs_info が仕入担当への返事になることです。 「どんな料理に合うかが分かると案が増やせる」といった一言を、翌週の特長メモの書き方の改善に回します。

システムへ連携する

比較の価格の判定は、次の規則で行います。 価格表示ガイドラインの目安を、売価の履歴で計算できる形にしたものです。

載せない商品は、特売の売価だけを載せます。 「当店通常価格」の欄は、テンプレートの側で空けたまま印刷します。載せたいという要望があっても、判定を覆す経路は作りません。

売価はすべて税込で差し込みます。 国税庁の説明では、消費者に対してあらかじめ価格を表示する場合は税込価格を表示する必要があり、値札や店頭表示、チラシなど、どのような媒体かを問わないとされています。売価マスタの税込の列だけを使います。

人が確認する

1. 販促担当が、商品ごとに案を1つ選ぶ … 言葉を直すのは自由です。ただし、直した後の文言にも同じ点検をもう一度当てます
2. 「案なし」の商品は、販促担当が作る … 数は多くありませんが、メモが薄い商品に集中します。 仕入担当にメモの書き足しを頼むのが先です
3. 課長が「比較の価格あり」の商品を確かめる … 判定の根拠になった日数を一覧で見ます
4. 課長が「根拠の資料が要る」の語を含む案を確かめる … 資料があれば通し、無ければ外します

1番目の「直した後にもう一度点検」を省かないでください。 選んだ案に担当者が「最安値に挑戦」と足せば、AIの案を点検した意味がなくなります。 選択用の表で文言を直すと、その行の点検がもう一度走るようにしておきます。

課長が見る一覧は、2つの区分だけに絞ります。 「比較の価格あり」と「根拠の資料が要る語を含む」です。120枚すべてを課長が流し読みしていた頃より、見る枚数は大きく減りますが、見る1枚の重さは増えます。

目標は、480枚をならして1枚3分です。 選ぶだけで済む枚数が大半で、案なしの商品と課長の確認に時間がかかります。選ぶときは、3つの案を声に出して読み比べると早く決まります。 売場で目に入るのは見出しの数文字なので、読んで引っかかる案から外していきます。

例外に対処する

上の2行は、Batch API を使う以上いつか起きます。 どちらも、custom_id で依頼表の行に戻せる作りにしておけば、困ることはありません。

記録を残す

• 依頼表の締め時点の写し（週ごと）
• 送った .jsonl と、バッチの出力・エラーのファイル
• 規則の点検で外した案と、外した理由
• 比較の価格の判定に使った日数（販売日数、その売価の日数、最後の日）と判定の結果
• 販促担当が選んだ案、直した文言、課長の確認の記録
• 各店へ配ったPOPの差し込みの値
• 商品ごとの、3つの案のうちどれが選ばれたか（切り口別の採用の数）

4行目は、後から問われたときの答えになります。 「当店通常価格」に根拠はあったのかと聞かれたとき、その週に何日分の履歴で、どう判定したかを示せることが大切です。 判定の記録は、POPを外した後も残しておきます。

最後の行は、指示を直す材料になります。 「手軽さ」の案がほとんど選ばれないなら、その切り口をやめて別の切り口を指定します。