観光協会の案内所の職員が、観光施設・交通・イベントの資料を引き、窓口で聞かれた質問に根拠つきで答える

処理の起点を決める

起点は、職員が窓口の端末に質問を入れて送ることです。 端末の画面には、質問の欄、来訪の日（既定は今日）、起点（既定は案内所。駅の東口、城の大手門など、よく聞かれる起点を選べる）を置きます。電話の質問も、職員が同じ画面に入れます。

もう一つのトリガーは、情報の更新です。

協会のサイトのお知らせは、載せた直後に再クロールを依頼します。 公式では、高度なインデックス登録のデータストアで recrawlUris を呼ぶと、指定したページを取り直します。呼び出しは1つのプロジェクトで1日20回まで、1回に1万ページまでで、24時間で打ち切られます。台風の日の臨時休館のように1日に何度も更新するお知らせは、数回分をまとめて依頼します。

入力データを集める

質を決めるのは、施設の一覧の「最後に確かめた日」と「確かめた方法」です。 加盟施設の届け出、職員の電話、施設の公式サイト。画面には営業時間と並べて必ず出し、確かめてから90日を過ぎたものには印を付けます。

加盟の有無は一覧に持たせますが、検索の並びには使いません。 一覧の列として持つのは、更新の依頼を誰に出すかを決めるためです。

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

施設とイベントの一覧は、表計算から毎晩 JSON に書き出して、構造化データとして取り込みます。 位置の項目は、緯度と経度の組にします。公式では、取り込むデータが緯度と経度の数を持つ組か住所の文字列なら geolocation として検出され、検出を切るとただの組として扱われます。住所の文字列で持つと位置の解釈が揺れるので、緯度と経度で持たせ、スキーマで型を決めておきます。

{"id":"fac-0412","name":"甘味処 さくら","category":["cafe","sweets"],
 "location":{"latitude":34.6851,"longitude":135.8048},
 "open_time":"10:00-17:00（L.O.16:30）","closed_days":"水曜（祝日の場合は翌日）",
 "closed_from":"2026-12-29T00:00:00+09:00","closed_to":"2027-01-03T23:59:59+09:00",
 "languages":["en"],"checked_date":"2026-09-20T00:00:00+09:00","checked_by":"phone"}

公式では、絞り込みや並べ替えに使う項目は索引可能（indexable）にする必要があり、索引可能にできる項目は50個まで、検索結果で返す（retrievable）項目も50個までです。

施設を探すときは、search メソッドに次のような絞り込みを付けます。 公式の構文では、位置の項目に GEO_DISTANCE(緯度, 経度, メートル) を書け、日時の項目を ISO 8601 の文字列と比べられ、NOT で否定できます。

location: GEO_DISTANCE(34.6828, 135.8020, 1200)
AND category: ANY("cafe","sweets")
AND NOT (closed_from <= "2026-10-15T12:00:00+09:00"
         AND closed_to >= "2026-10-15T12:00:00+09:00")

「歩いて15分」は、中継プログラムが1,200メートルに置き換えます。 直線の距離なので、川や線路で回り道になる場所は実際より近く出ます。画面には「直線の距離」と書きます。

search メソッドは一覧の項目をそのまま返すので、施設の行はAIの文を通りません。 返す項目は、名前、営業時間、定休日、臨時の休業の期間、外国語の対応、最後に確かめた日と方法に絞り、retrievable にしておきます。

定休日の曜日は、絞り込みではなく画面で見せます。 「水曜（祝日の場合は翌日）」のような書き方は、項目で正しく表すのが難しいからです。来訪の日の曜日と祝日を画面の上に出し、職員が定休日の欄と見比べます。

資料のアプリは、answer メソッドで呼びます。 交通事業者の案内とパンフレットはPDFのまま非構造化データとして、協会のサイトはウェブサイトのデータストアとして入れます。サイトのデータストアには、検索結果のページのような動的な URL を最初から除外します。 公式は、除外し忘れると索引が膨らんで費用が増え、その分は返金されないと注意しています。

AIへ渡す前に整形する

1. 質問を振り分ける … 「近く」「開いている」「おすすめの店」など施設の種類を探す言葉なら一覧の検索、「バス」「電車」「規制」「何時まで」など交通とイベントの言葉なら資料の答えにします。両方の言葉があれば両方を呼びます
2. 起点と距離を数にする … 起点の名前を緯度・経度に、「歩いて◯分」を1分80メートルでメートルに直します
3. 来訪の日を付ける … 資料の答えの質問文の先頭に、来訪の日と曜日を付けます
4. 終わった資料を外す … 対象の期間が過ぎた交通事業者の案内は、毎晩の取り込みの前に保管用のフォルダに移し、データストアから消します
5. 協会のサイトの robots.txt を確かめる … 公式は、robots.txt で Google のクローラーを止めていると取り込めないので、許可するよう求めています

4番目で、終わった臨時便の案内を消すのは、去年の同じ祭りの案内が引かれるのを防ぐためです。 毎年同じ名前のイベントは、資料の文面もよく似ています。期間で絞る代わりに、期間が過ぎたものを置かない運用にします。

AIに処理させる

AIに文を作らせるのは、資料から答える質問だけです。 施設を探す質問では、AIは使いません。

2つ目は、JNTOの外国人観光案内所の認定の区分にも関わります。 JNTOの説明では、観光案内を専業としないパートナー施設についても「公平・中立な立場で地域の案内を提供」することが基準に挙がっています。案内所の答えに「おすすめ」を入れるかどうかは職員が決め、AIの下書きには入れません。

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

指示内容を固定する

answer メソッドの promptSpec.preamble に、次の指示を入れます。中継プログラムは、来訪の日、曜日、起点を質問の文の先頭に付けます。

あなたは観光協会の観光案内所で、職員が旅行者の質問に答えるための
下書きを作る立場です。読むのは職員で、旅行者に伝える前に必ず
根拠の資料を確かめます。

【前提】
質問の文の最初に、来訪の日、曜日、起点が書かれています。
検索の対象は、交通事業者の案内、協会のパンフレット、協会の
サイトのお知らせです。

【答え方】
1. 質問に当たる時刻・乗り場・規制の範囲を、資料の文のまま引用する
2. 引用ごとに、出どころ（交通事業者／協会のお知らせ／パンフレット）
   と、発行日または掲載日を書く
3. 資料の対象の期間と来訪の日が重なるかを書く。重ならなければ
   「来訪の日の情報は見つかりませんでした」と書く
4. 天候や混雑で変わると資料に書かれていれば、その文を引用する
5. 以上を、職員が窓口で読み上げやすい、短い文にまとめる

【厳守事項】
- 時刻や料金を計算したり、資料に無い便を推定したりしないでください。
- 施設や店をおすすめしないでください。
- 資料に無い行き方、乗り換えを書かないでください。
- 当日の運行や開館を「平常どおり」「問題なく」と書かないでください。
- 去年の同じイベントの資料しか見つからないときは、
  その資料の年を書き、今年の情報ではないと書いてください。
- 根拠が見つからないときは、
  「資料で確認できませんでした」とだけ書いてください。

「去年の資料しか見つからないとき」を明記しないと、AIは去年の時刻を今年のものとして答えます。 前処理で終わった資料を外していても、外し忘れは起きます。年を書かせておけば、職員が読んで気づけます。

出力形式を固定する

中継プログラムが、2つの道の結果を次の形にまとめます。

{
  "query_id": "",
  "visit_date": "",
  "origin": "",
  "route": "facility | document | both",
  "facilities": [
    { "id": "", "name": "", "distance_m": 0, "open_time": "", "closed_days": "",
      "closed_today": false, "languages": [], "checked_date": "", "checked_by": "",
      "stale": false }
  ],
  "answer": { "text": "", "citations": [ { "source_kind": "operator | association | pamphlet",
              "title": "", "published_date": "", "quote": "", "uri": "" } ],
              "skipped": "" },
  "flags": []
}

施設の並びは、distance_m の小さい順だけです。 search メソッドの返り値に含まれる位置から、中継プログラムが起点からの直線の距離を計算して並べ直します。検索の関連度の順は使いません。 並べ方が職員から説明できる形にするためです。

stale は、checked_date から90日を過ぎたものに立てます。 画面ではその行の色を変え、「最後に確かめた日」を目立たせます。

システムへ連携する

情報の報告は、そのまま一覧を直しません。 担当の職員が施設に確かめてから表計算を直し、checked_date と checked_by を書きます。

人が確認する

旅行者に伝えるのはいつも職員で、当日の情報は事業者の発表で確かめます。

1. 日付と出どころを見る … 一覧の「最後に確かめた日」、下書きの発行日・掲載日を見ます
2. same_day_check は事業者の発表を確かめる … 交通事業者の運行情報、施設のお知らせを開きます
3. 英語で伝えるときも、日本語の下書きの数字で伝える … 時刻や料金は、引用の数字を見ながら伝えます

1. stale の施設は電話で確かめるか、そう伝える … 時間があれば施設に電話し、無ければ「◯月◯日時点の情報です」と添えて伝えます

2番目は、繁忙期ほど省かれがちです。 列ができていても、臨時便と規制だけは確かめてから伝えます。

臨時の職員には、最初の1週間、ベテランが隣で画面の読み方を教えます。 見るのは答えの文ではなく、出どころと日付の欄です。ここを読む癖がつけば、ベテランと同じ根拠で答えられるようになります。

例外に対処する

記録を残す

• 質問、来訪の日、起点、振り分けの結果
• search メソッドの絞り込みの条件と、返った施設の一覧
• answer メソッドの返り値の全文（answerText、citations、answerSkippedReasons）
• flags、職員が押した「情報が違う」の報告と、その後の修正
• 質問の言葉の集計（多く聞かれる施設の種類・イベント・交通）

最後の行は、パンフレットとサイトを直す材料になります。 同じ質問が毎日来るなら、案内所の掲示かサイトのお知らせで先に答えられます。

「情報が違う」の報告は、施設ごとの件数を月に一度数えます。 同じ施設の報告が続くなら、その施設との更新の連絡の取り方を見直します。加盟施設なら届け出の様式、非加盟の施設なら職員が確かめる周期を決め直します。