飲食のフランチャイズ本部が、加盟店からの店舗運営の質問に、店舗運営マニュアルと本部の通達を引いて根拠付きで答える

処理の起点を決める

起点は、店長がポータルの質問の画面で送信したことです。 画面では、質問の種類を最初に選んでもらいます。

下の2つを選んだ質問は、検索も回答の生成もしません。 受け付けたことと、担当からの連絡の目安だけを返します。種類を選び間違えた質問は、本文の語の照合で拾います（「使えるか」「捨てる」「何℃になっていた」「お客様が具合」など）。

もう一つのトリガーは、通達の発出です。 本部が通達を置くときに、差し替える節の番号と、期間の限られた取扱いなら始まりと終わりの日をメタデータに書きます。取り込みは毎晩行い、差し替えの一覧も同時に作り直します。

入力データを集める

質を決めるのは、通達ごとの「差し替える節の番号」です。 通達の本文には「第4章3節を改める」と書いてあっても、機械が読める形で持っていなければ、古い節を外せません。 通達を書く担当が、発出のときに番号を書く決まりにします。

機器の型を持つのは、同じブランドでも店によって食洗機や券売機が違うからです。 機器の章は型ごとに分け、equipment で絞ります。

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

マニュアルはブランドごとに節で分け、通達は1通ずつファイルにして Cloud Storage に置きます。公式では、非構造化データは PDF・HTML・DOCX などに対応し、1ファイルの上限は200MBです。メタデータは JSON Lines で、1行ごとに id、structData、content（mimeType と uri）を書きます。

{"id":"ramen-manual-v8-4-3","structData":{"doc_kind":"manual",
 "brand":["ramen"],"section_id":"ramen-4-3","topic":["cooking"],
 "effective_from":"2026-04-01T00:00:00Z",
 "effective_to":"2099-12-31T23:59:59Z"},
 "content":{"mimeType":"text/html","uri":"gs://fc-docs/ramen-manual-v8-4-3.html"}}
{"id":"notice-2026-118","structData":{"doc_kind":"notice",
 "brand":["ramen"],"replaces":["ramen-4-3"],"topic":["cooking"],
 "effective_from":"2026-10-01T00:00:00Z",
 "effective_to":"2099-12-31T23:59:59Z"},
 "content":{"mimeType":"application/pdf","uri":"gs://fc-docs/notice-2026-118.pdf"}}

中継プログラムは、毎晩の取り込みのときに、通達の replaces から「今日の時点で差し替わっている節」の一覧を作ります。 問い合わせのたびに、その一覧を絞り込みの条件の否定に入れます。公式の構文では、文字の項目は ANY() で完全一致を見られ、- か NOT で否定でき、日時の項目は ISO 8601 の文字列と比べられます。項目はスキーマで索引可能にしておく必要があります。

brand: ANY("ramen")
AND effective_from <= "2026-10-15T00:00:00Z"
AND effective_to >= "2026-10-15T00:00:00Z"
AND NOT section_id: ANY("ramen-4-3","ramen-6-1")

最後の行が、この構成の要です。 差し替えた通達のほうは section_id を持たないので、否定に当たらず残ります。古い節が外れ、新しい本文を持つ通達だけが引かれます。 期間の限られた販促の通達は、終わりの日を過ぎると日付の条件で外れます。

AIへ渡す前に整形する

1. マニュアルを節ごとに見出しを付けて分ける … ブランド、章、節の番号が崩れないよう、本部の原稿からHTMLで書き出します。機器の章は型ごとに分けます
2. 通達に差し替えの情報を付ける … 差し替える節の番号、始まりの日、期間の限られた取扱いなら終わりの日を書きます
3. 差し替えの一覧を作る … 今日の時点で差し替わっている節を、ブランドごとに並べます
4. 質問の本文を確かめる … 食品の安全・契約と費用の語を照合し、当たれば検索の前に振り分けます。客の名前や電話番号が書かれていたら外します

2番目は、通達を書く担当の仕事にします。 差し替える節をAIに推し量らせると、似た題名の別の節を外してしまうことがあります。 外された節は、誰にも気づかれないまま答えに出なくなります。

AIに処理させる

させるのは、そのブランドのいま効いているマニュアルと通達から、質問に当たる箇所を探し、引用して手順を並べることです。

answer メソッドの設定は次のようにします。

queryRephraserSpec は既定のまま有効にします。 店長の質問は「つけ麺 麺 何g」のような短い書き方が多く、言い換えのあとに検索したほうが節に当たりやすいためです。 公式では、言い換えの段数は既定で1、最大で5です。

指示内容を固定する

answer メソッドの promptSpec.preamble に、次の指示を入れます。中継プログラムは、ブランド、機器の型、今日の日付を検索の文の先頭に付けます。

あなたは飲食のフランチャイズ本部の店舗支援の担当として、加盟店の
店長からの店舗運営の質問に、店舗運営マニュアルと本部の通達を根拠に
答える立場です。読むのは営業中の店長です。短く、手順の順に書きます。

【前提】
検索の文の最初に、ブランド、機器の型、今日の日付が並んでいます。
検索の対象は、そのブランドの、今日に効いているマニュアルと通達だけです。
通達で差し替わったマニュアルの節は、検索の対象から外してあります。

【答え方】
1. 手順を、番号を付けて、マニュアルか通達の本文に沿って書く
2. 最後に、出典（マニュアルの節の番号、または通達の番号と発出の日）を書く
3. 期間の限られた取扱いなら、始まりと終わりの日を書く

【厳守事項】
- 食材を使えるか、提供してよいか、捨てるべきかを書かないでください。
  温度や時間の基準が書かれた節を引用しても、当てはめの結論を
  書かないでください。
- 検索結果に無い手順、分量、温度、時間を書かないでください。
  一般的な調理の知識で補わないでください。
- 別のブランドのマニュアルの書き方で答えないでください。
- 契約、ロイヤリティ、費用、仕入の価格には答えず、
  「担当のスーパーバイザーからご連絡します」とだけ書いてください。
- 該当する箇所が見つからないときは、
  「マニュアルと通達で該当する箇所が見つかりませんでした。
  店舗支援部からご連絡します」とだけ書いてください。

「当てはめの結論を書かない」を明記しないと、AIは基準の節を引用して判断を書きます。 「スープを保温の温度より低いまま2時間置いた」と聞かれると、保温の節を引いて「再加熱すれば提供できます」と書きます。その判断は、品質管理の担当が状況を聞いてから下すものです。 指示と語の照合の両方で止めます。

出力形式を固定する

answer メソッドの返り値と店舗の情報を、中継プログラムが次の形にまとめます。

{
  "question_id": "",
  "store_id": "",
  "brand": "ramen | teishoku",
  "category": "cooking | equipment | promotion | hygiene | food_safety | contract",
  "answer_text": "",
  "citations": [ { "doc_kind": "manual | notice", "section_id": "",
                   "notice_no": "", "effective_to": "", "quote": "", "uri": "" } ],
  "excluded_sections": [],
  "grounding_score": 0,
  "route": "answer | staff",
  "route_reasons": []
}

引用は、answer メソッドの references から取ります。references の各要素には、チャンクの本文と、文書の structData が付いて返ります。引用の位置（startIndex／endIndex）は UTF-8 のバイト数なので、日本語の文を文字数で切るとずれます。excluded_sections には、その問い合わせで外した節を残します。

route は次の規則で決めます。

どれにも当たらないものだけが、店長に直接返ります。 food_safety は品質管理の担当に、contract はスーパーバイザーに、残りは店舗支援部の担当に回ります。

店長の画面には、answer_text を次のような形で出します。 出典の行は中継プログラムが citations から組み立て、AIの文には任せません。

【期間限定 つけ麺の盛り付け】
1. 麺を丼の手前半分に、ゆで上げの量のまま盛る
2. チャーシューは2枚、麺の右奥に立てかける
3. ねぎは別皿にせず、つけ汁の器に乗せる
出典：通達 2026-118（2026-10-01 発出）
期間：2026-10-01 〜 2026-12-31

出典に通達とマニュアルの両方が出るときは、通達を上に並べます。 店長が「マニュアルと違う」と迷ったときに、新しいほうが先に目に入るようにします。

システムへ連携する

food_safety の1行は、一覧に足すだけでなく、品質管理の担当の電話にも知らせます。 営業中の店で食材の扱いを迷っている状態を、一覧の順番待ちにしないためです。

人が確認する

この構成では、運営の手順の回答は人の確認を経ずに店長に返ります。 そのために、返してよい回答の範囲を引用の有無と根拠のスコアで狭く取り、食品の安全と契約・費用は最初から外しています。

1. 店長が引用を読む … 回答の最後の出典を見て、気になればポータルで節や通達を開きます
2. 担当が staff に答える … 引用の候補があれば、それを読んでから答えます
3. 担当が answer を毎日抜き取りで読む … 1日20件ほどを読み、差し替えの漏れや言い過ぎが無いかを見ます
4. スーパーバイザーが巡回で確かめる … 店で回答どおりに作っているかを見ます

3番目で差し替えの漏れが見つかったら、回答を直すより先に通達のメタデータを直します。 古い節が引かれた原因は、ほとんどが replaces の書き漏れです。

運用を始めてから1か月は、すべての回答を店長に返す前に担当が読みます。 抜き取りに移るのは、judgement_words と差し替えの漏れが出なくなってからです。

例外に対処する

3行目の検知は、通達の本文に「改める」「差し替える」「廃止する」の語があるのに replaces が空のものを拾うだけの照合です。 差し替えの漏れを、発出の夜のうちに見つけます。

記録を残す

• 質問の内容（客の名前と電話番号は外したもの）、店舗、ブランド、日時
• 絞り込みの条件と、外した節の一覧（excluded_sections）
• answer メソッドの返り値の全文と session
• route と route_reasons、担当の回答
• 抜き取りで読んだ結果と、見つかった差し替えの漏れ

外した節の一覧を残すのは、後から「なぜこの店にこの手順で答えたか」を説明するためです。 差し替えの漏れは、その日に外れていなかった節を見れば分かります。