訪日客向けの館内案内とメニューを多言語にして、原文の更新に訳を追随させる

処理の起点を決める

原文台帳を5分ごとに見に行く、時間主導型のトリガーを使います。 Apps Script のインストール可能なトリガーには、時間主導型のほか、開いたとき、編集されたとき、構造が変わったときなどがあります。時間主導型は、1分ごとから月に1回まで指定できます。

編集トリガーを使わないことには理由があります。 公式ドキュメントには、「スクリプトの実行とAPIリクエストはトリガーを動かさない」と書かれています。この構成では Make がスプレッドシートへ書き込むため、編集トリガーにすると、その書き込みでは何も起きません。 閲覧モードやコメントモードで開いているときも動きません。

トリガーは、作った人のアカウントの権限で動き、別のアカウントからは見えません。 個人のアカウントで作ると、その人が異動したときに誰も直せなくなります。 失敗したときのメールも、その人にしか届きません。

入力データを集める

質を決めるのは「行番号」と「原文ハッシュ」です。 掲示物を1枚の塊として持つと、1文字直しただけで全文が stale になります。1行ずつ持てば、変わった行の訳だけを作り直せます。

用語集は、この構成で最初に作るものです。 観光庁のガイドラインでも、「共通で使用する固有名詞の対訳語一覧を作成し、関係者間で表記を統一することが望ましい」とされ、業種固有の用語は「さらに詳細に対訳語を定めていくことが望ましい」とされています。訳語の決め方も同じガイドラインに合わせられ、普通名詞部分を含む固有名詞は表音と表意を組み合わせるとされて Mt. Fuji が、対訳が無い普通名詞は括弧に表意を入れる形で Chawan (Tea bowl) が例示されています。

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

原文台帳、用語集、訳台帳はいずれもスプレッドシートです。Apps Script からシート全体を一度に読み、配列として処理します。 1行ずつ読むと、トリガーの実行時間に収まりません。

読むのは4つです。 原文台帳の原文ハッシュ（前の版との突合に使い、違えば stale を立てる）、訳台帳の「参照した原文ハッシュ」、原文に対する文字列照合で得た用語集の当たり、掲示物マスタの文字数上限です。

用語集は、日本語の表記が長い語から先に当てます。 「大浴場」より先に「浴場」を当てると「大」だけが残り、別の語として扱われます。

そして、用語集をまるごとAIへ渡さないでください。 長いコンテキストの公式ドキュメントでは、「渡す必要のないトークンであれば、渡さないほうがよい」とされ、取り出す対象が複数あると性能が落ちること、長い入力は応答までの時間を延ばすことが挙げられています。当たった十数語だけを渡します。

AIへ渡す前に整形する

1. 原文の正規化 … 全角と半角、連続する空白、改行をそろえます。見た目だけの差でハッシュが変わらないようにするためです
2. ハッシュ化 … 正規化した原文の行ごとにハッシュを取り、原文台帳の列に書きます
3. 差分の検出 … 訳台帳の「参照した原文ハッシュ」と比べ、違えば stale を立てます
4. 用語集の当たりの抽出 … 長い語から順に照合し、当たった語と4言語の訳語を取り出します
5. 前の版の訳の引き当て … ハッシュが変わっていない行は前の版の訳をそのまま使い、AIへ渡しません
6. 掲示物の種類の判定 … マスタから種類を読み、対象言語と確認の厚みを決めます
7. 文字数上限の取得 … 枠ごとの上限を読み、文字数比の判定に使います

3番目で日時を使わないでください。 更新日時で比べると、訳を手で直した行は原文より新しくなり、古い訳が「新しい」と判定されます。 訳を直す作業は日常的なので、日時での比較は必ず破綻します。ハッシュなら、訳をいくら直しても参照した原文の版は変わりません。

1番目を飛ばすと、stale が毎日大量に立ちます。 貼り付けた文字は見た目が同じでも空白や改行が違うことがあり、正規化しないと、直していない行まで要更新になります。

AIに処理させる

訳し戻しが、この構成の点検の土台です。 訳し戻した日本語と元の原文を機械で比べ、数値・時刻・金額・アレルギー品目が一致しているかを見ます。 文意まで機械では見ません。そこは人が見ます。

曖昧な原文の報告は、訳の質より運用に効きます。 「本日は営業しておりません」は、期間が書かれていないと訳が決まりません。無理に1つに決めさせるより、原文を直してもらうほうが早く終わります。

アレルギー品目の行と、掲示可かどうかの行が、この題材に固有の線引きです。 品目は増やすことも減らすこともさせず、掲示の可否もAIに言わせません。

指示内容を固定する

訳の生成は、言語ごとに1回ずつ呼びます。

あなたは宿泊施設の掲示物を多言語化する担当者です。
日本語の原文を、指定された言語に訳してください。

【訳す言語】{target_lang}（en / zh-Hans / zh-Hant / ko のいずれか）
【掲示物の種類】{doc_type}
【原文】行番号付きで渡します。行の数と順番を変えないでください。
{source_lines}
【必ず使う訳語】原文にこの日本語が含まれる場合、訳語は必ずこの語にしてください。
{glossary_hits}
【前の版の訳】原文が変わっていない行は、この訳をそのまま返してください。
{previous_translation}
【枠の文字数上限】{max_chars}（超えても短くしないでください）

【厳守事項】
- 数値、時刻、金額、単位は原文のとおりに写してください。
  通貨を換算する、時刻を12時間表記に直すことをしないでください。
- 原文に無い情報を足さず、原文にある情報を省かないでください。
  特にアレルギーの品目名と禁止・注意を促す文は、1つも落とさないでください。
- 「必ず使う訳語」にある語を、別の語に言い換えないでください。
  文脈に合わないと感じた場合も、ambiguous に理由を書いてください。
- 用語集に無い固有名詞（施設名、料理名、設備名）は、訳したうえで
  new_terms に日本語と訳語を書き出してください。
- 意味が2通りに取れる原文は訳を1つに決めず、ambiguous に行番号と理由を書いてください。
- 原文が空の行は、訳も空にしてください。行を詰めないでください。
- 枠の文字数上限を超えた行は over_limit に行番号を書いてください。

「言い換えずに理由を書く」を明記しないと、用語集を守りません。 文脈に合わない訳語を渡されたとき、何も言わなければ自然なほうへ直します。直してよいかは、用語集を決めた人が判断することです。 勝手に短くさせないのも同じで、削られたのが注意書きでも誰も気づきません。

訳し戻しは、別の呼び出しにします。

次の文を日本語に訳してください。これは訳文の点検に使います。

【言語】{target_lang}
【訳文】{translated_lines}

【厳守事項】
- 書かれていることだけを訳し、元の日本語を推測して補わないでください。
- 数値、時刻、金額、単位は、訳文に書かれているとおりに写してください。
- 訳文に無い語を足さず、訳文にある語を落とさないでください。
- 日本語として不自然でも、訳文の語順と語のまま訳してください。
- 行番号と行数を変えないでください。

この呼び出しに原文を渡さないでください。 渡すと原文をなぞった日本語が返り、どんな訳文でも点検を通ります。 訳し戻しが意味を持つのは、訳文だけを見て日本語に戻したときだけです。

役割の固定には system_instruction を使い、generation_config の temperature を低く置きます。 さらに store を false にして、前のやり取りを引き継がない形で呼びます。 前の掲示物の言い回しが混ざるのを防ぐためです。

出力形式を固定する

訳の生成は、次のスキーマで構造化して受け取ります。

"response_format": {
  "type": "text",
  "mime_type": "application/json",
  "schema": {
    "type": "object",
    "properties": {
      "doc_id": { "type": "string" },
      "target_lang": { "type": "string",
        "enum": ["en", "zh-Hans", "zh-Hant", "ko"] },
      "lines": { "type": "array", "items": { "type": "object",
        "properties": {
          "line_no": { "type": "integer" },
          "text": { "type": "string" },
          "reused": { "type": "boolean" },
          "glossary_applied": { "type": "array", "items": { "type": "string" } }
        },
        "required": ["line_no", "text", "reused"] } },
      "new_terms": { "type": "array", "items": { "type": "object",
        "properties": { "ja": { "type": "string" },
                        "translated": { "type": "string" } } } },
      "ambiguous": { "type": "array", "items": { "type": "object",
        "properties": { "line_no": { "type": "integer" },
                        "reason": { "type": "string" } } } },
      "over_limit": { "type": "array", "items": { "type": "integer" } }
    },
    "required": ["doc_id", "target_lang", "lines"],
    "additionalProperties": false
  }
}

target_lang を enum にしているのは、分類として扱うためです。 自由文で返させると zh-CN や Chinese (Simplified) が混ざり、突合が外れます。

glossary_applied は、用語集が当たったかを機械で確かめるために返させます。 指定した語と一致し、かつ訳文に含まれているかを見ます。中国語と韓国語は文字列の一致で足りますが、英語は語形が変わるため、小文字にそろえた部分一致で見ます。

reused は、前の版の訳をそのまま返した印です。 true の行は訳し戻しの点検を省けます。改訂30点のうち本当に変わる行は一部で、ここを省くほど呼び出しが減ります。

訳台帳は、次の列で持ちます。 掲示物IDと行番号と言語（原文台帳と突き合わせる鍵）、訳文、参照した原文ハッシュ、状態（stale ／ review ／ ready ／ posted）、点検結果とその理由、確認者と確認日時（二重確認なら2名ぶん）、掲示日。

状態と掲示日を分けて持つのが要点です。 ready は確認が済んだという意味で、壁に貼られたという意味ではありません。 混ぜると、確認だけ終わって掲示されていない訳が見えなくなります。

システムへ連携する

Make を挟むのは、呼び出しの組み立てを台帳の処理から切り離すためです。 対象言語が4つの掲示物と2つの掲示物が混ざり、掲示物ごとに何回呼ぶかが変わります。 Apps Script に書くと、言語を足すたびにコードを直すことになります。デザインソフトへは自動で流し込みません。 レイアウトは枠ごとの事情があり、自動化の効果より事故の危険が上回ります。

人が確認する

確認の厚みを、掲示物の種類で2段に分けます。

2人目は、訳文そのものを読むのではありません。 訳し戻した日本語と原文を並べ、数値と品目と注意の言い回しが同じ意味かだけを見ます。 4言語の読み手をそろえる必要はありません。

禁止・注意を促す掲示は、この4種類に入れていません。 観光庁のガイドラインでは、これは「直ちに禁止・注意事項を理解できるよう、見た目の分かりやすさが重視される情報」とされ、ピクトグラムを積極的に活用することが望ましいとされています。禁煙や立入禁止は、文章の訳を増やすより図記号で出すほうが確実です。

例外に対処する

トリガーに関わる2行は、訳の質ではなく仕組みの側の不具合です。 どちらも「何も起きていないのに正常に見える」型なので、stale の件数を毎週数えて気づくようにします。 掲示物の差し替えだけは台帳では解けません。壁に貼られたかは館内を見ないと分からず、掲示日を人が入れる運用を続けられるかで、この仕組みが生きるかが決まります。

記録を残す

• 原文の版ごとの全文と、そのときの原文ハッシュ
• AIへ渡した指定と、返ってきた訳文、new_terms、ambiguous、over_limit の全文
• 訳し戻した日本語と、機械の点検の結果（外れた項目と理由）
• 人が訳を直した記録 … どの行を、どう直したか。二重確認の場合は2名ぶん
• 用語集の変更履歴 … いつ、誰が、どの語をどう決めたか
• 掲示日と、そのとき掲示した訳文の版

用語集の変更履歴を残すのは、訳語が後から変わるためです。 「大浴場」の訳を変えると、過去に掲示した全部の掲示物が古い語のままになります。 履歴があれば、いつ以降を作り直せばよいかが決まります。

人が直した記録は、用語集を育てる材料です。 繰り返し直されている語を月に一度洗い出して用語集へ足します。