こんにゃくの製造所が、スーパーの各店から届く発注のメールを Apps Script で集め、Gemini で品目・数量を抜き出して翌日の製造の数量表を作る
スーパーの各店から届くこんにゃくの発注のメールを Apps Script で集め、Gemini で品目・数量・単位を抜き出します。スクリプトが個数に直して店ごとの最新の発注にそろえ、締めの後に翌日の製造の数量表を作ります。
- 生成AI
- ChatGPT/Claude/Gemini
- 連携・自動化
- Google Apps Script/Python
- 対象業界
- 商社/製造
- 対象部門
- 生産
- 対象業務
- データ入力・転記/集計・分析
- 主な課題
- 入力作業が多い/期限・対応漏れが起きる/確認ミスが多い
- AIで行う処理
- 抽出
- 主な効果
- 入力漏れ削減/対応スピード向上/工数削減
- 導入難易度
- ★★☆☆☆
- 実装レベル
- 半自動化
- 費用感
- API連携(中)
- 人間の確認
- 条件付き
01導入前 / 導入後の業務フロー
- 受注用の Gmail に届いた発注のメールを1通ずつ開く
- 本文を読み、品目の呼び方を自社の品目に当て、数量と単位を拾う
- 集計の表の店の行に、品目ごとの数を写す。ケースで書かれたものは袋に直す
- 訂正のメールが届いたら、前の発注の行を探して書き換える
- 14時の締めの後、品目ごとに合計し、予備を足して製造の数量表と店ごとの仕分けの表を作る
- 自動受注用の Gmail で、店のアドレスからのメールにフィルタで「発注」のラベルが付く
- 自動Google Apps Script が10分おきに動き、「発注」のラベルのメールのうち、まだ処理していないメッセージを拾う
- 自動本文の引用と署名を落として Gemini API に渡し、新規・訂正・取消の別、品目の書き方、数量、単位、納品日の書き方を抜き出させる
- 自動スクリプトが品目の台帳で品目を当て、入数で袋に直し、店と納品日ごとに受注の表を置き換える
- 自動締めの時刻を過ぎた最初の実行で、翌日の製造の数量表と店ごとの仕分けの表を作り、メールの届いていない店と要確認の行を一覧にする
- 人担当が要確認の行と、届いていない店を片づける
- 人製造の数量表に予備を確かめ、製造の責任者に渡す
各工程の詳しい説明を読む
- 受注用の Gmail に届いた発注のメールを1通ずつ開く
- 本文を読み、品目の呼び方を自社の品目に当て、数量と単位を拾う
- 集計の表の店の行に、品目ごとの数を写す。ケースで書かれたものは袋に直す
- 訂正のメールが届いたら、前の発注の行を探して書き換える
- 14時の締めの後、品目ごとに合計し、予備を足して製造の数量表と店ごとの仕分けの表を作る
(a)品目の呼び方と単位が店ごとに違う。 「黒板 2」が2袋か2ケースか。2番目の判断は、その店の担当者の癖を知っている受注の担当にしかできません。
(b)訂正のメールの反映漏れ。 訂正は件名に「訂正」と書かれることもあれば、前のメールへの返信で「追加でお願いします」とだけ書かれることもあります。追加なのか置き換えなのかを読み違えると、数が倍になるか、足りなくなります。
(c)締めの直後に集計が集中する。 48店のメールの半分ほどは締めの前の1時間に届きます。14時から製造の数量表を出すまでの1時間は、受注の担当が他の電話に出られません。
(d)届いていない店に気づくのが遅れる。 毎日発注のある店からメールが来ていないことに、集計の表を埋め終わるまで気づきません。 締めの後に気づいて電話をかけると、店の担当者が帰っていることがあります。
- 【自動】 受注用の Gmail で、店のアドレスからのメールにフィルタで「発注」のラベルが付く
- 【自動】 Google Apps Script が10分おきに動き、「発注」のラベルのメールのうち、まだ処理していないメッセージを拾う
- 【自動】 本文の引用と署名を落として Gemini API に渡し、新規・訂正・取消の別、品目の書き方、数量、単位、納品日の書き方を抜き出させる
- 【自動】 スクリプトが品目の台帳で品目を当て、入数で袋に直し、店と納品日ごとに受注の表を置き換える
- 【自動】 締めの時刻を過ぎた最初の実行で、翌日の製造の数量表と店ごとの仕分けの表を作り、メールの届いていない店と要確認の行を一覧にする
- 【人】 担当が要確認の行と、届いていない店を片づける
- 【人】 製造の数量表に予備を確かめ、製造の責任者に渡す
6番目で担当が見るのは、要確認の行だけです。 品目が当たらない、単位が決まらない、追加か置き換えかが読めない、納品日が違う。そうでない行は、受注の表を流し見るだけで済みます。
5番目で「届いていない店」を出すのが、この構成のもう一つの役目です。 店の一覧に「毎日発注のある店」の印を付けておき、締めの1時間前の実行で、まだ届いていない店を担当に知らせます。 店の担当者がいるうちに電話できます。
02今回想定するシステム構成
各店の担当者の発注のメール(本文) ▼ Gmail のフィルタで「発注」のラベル 受注用の Gmail(Google Workspace) ▼【トリガー】10分おきの時間主導のトリガー Google Apps Script ├── 処理済みのメッセージの ID の表 ├── 引用・署名を落とす ▼ Gemini API(Interactions API・構造化出力・store=false) │ 新規/訂正/取消、品目の書き方、数量、単位、納品日の書き方 ▼ Google Apps Script ── 品目の台帳で品目を当てる、入数で袋に直す、店ごとに置き換える ▼ 受注の表 → 締めの後に:製造の数量表・店ごとの仕分けの表・届いていない店 ▼ 【担当が要確認の行を片づけ、製造の責任者に渡す】
| 役割 | 想定する製品 | 代替候補 |
|---|---|---|
| 実行環境 | Google Apps Script(メールの拾い上げ、品目の当てはめ、置き換え、数量表の作成) | Python |
| 生成AI | Gemini API(新規・訂正・取消の別と、品目・数量・単位・納品日の抜き出し) | Claude API、OpenAI API |
| 台帳 | 品目の台帳・店の一覧・受注の表・数量表(スプレッドシート) | - |
新しく足すのは、スクリプトと、品目の台帳の「よくある書き方」の列と、店の一覧の2つの列だけです。 受注の表と数量表はいまの集計の表を分けて使います。
つなぎは Google Apps Script にします。 メールは Gmail に、台帳と表はスプレッドシートにあり、どちらも同じ Google Workspace の中です。ただし公式の説明で挙がっている設置型のトリガーに、Gmail にメールが届いたことを起点にするものは無いので、時間主導のトリガーで10分おきに探します。
Gemini API には、Interactions API で依頼します。 公式の説明では、宛先は https://generativelanguage.googleapis.com/v1beta/interactions で、model と input を送ります。Google Apps Script からは UrlFetchApp で同じ形の JSON を送ります。 公式の例は x-goog-api-key と Api-Revision のヘッダーを付けているので、それに合わせます。
依頼には store=false を付けます。 公式の説明では、Interactions API は既定でやり取りを保存し、有料の枠で55日、無料の枠で1日保持されます。 store=false を付ければ保存されません。発注の数は店の売れ行きそのものなので、残す場所は自社の表だけにします。
03どうやって実装するのか
処理の起点を決める
10分おきの時間主導のトリガーを起点にします。 公式の説明では、時間主導のトリガーは最短で1分おきに動かせます。発注は締めの14時に向けて集まるので、7時から15時のあいだだけ処理し、それ以外の時刻は何もせずに終えます。
締めの後の数量表は、時刻を決めた日次のトリガーでは作りません。 公式の説明では、毎日9時に動かすと決めたトリガーは9時から10時のあいだの時刻に動くとされています。14時に決めても、15時近くに動くことがあります。 代わりに10分おきの実行の中で「14時を過ぎていて、その日の数量表がまだ無い」ことを確かめ、最初に当てはまった実行で数量表を作ります。
実行の時間の上限に気をつけます。 公式の上限では、1回の実行は6分まで、トリガーで動いた実行の合計は Google Workspace で1日6時間、個人のアカウントで1日90分です。10分おきに8時間動かすと1日48回で、1回あたり数十秒に収まれば Workspace の上限には遠く届きません。 1回の実行で処理するメッセージは20通までにし、残りは次の実行に回します。
失敗したときは、公式の説明どおり失敗の要約がメールで届きます。 締めの前に止まると気づくのが遅れるので、受注の表の上に「最後に処理した時刻」を出し、30分以上空いたら担当が気づけるようにします。
入力データを集める
| データ | 中身 | 取得元 |
|---|---|---|
| 発注のメール | 差出人、受け取った日時、件名、本文 | Gmail(「発注」のラベル) |
| 店の一覧 | 店のコード、差出人のアドレス、毎日発注のある店か、単位なしのときの決まり | 店の一覧のシート(スクリプトが読む) |
| 品目の台帳 | 品目コード、正式な名前、よくある書き方、1ケースの入数 | 品目の台帳のシート(書き方の一覧だけ AI に渡す) |
| 処理済みのメッセージ | 処理したメッセージの ID と、結果 | 処理済みの表(スクリプトが読む) |
質を決めるのは、品目の台帳の「よくある書き方」の列です。 「黒板」「板こん黒」「生いも」を「板こんにゃく(黒)」に、「玉こん」「玉」を「玉こんにゃく」に当てる表を、受注の担当がこの3か月のメールから書き出します。AI には品目の正式な名前と書き方の一覧だけを渡し、入数は渡しません。 入数を持たせると、ケースを袋に直したくなるからです。
店の一覧の「単位なしのときの決まり」は、店と相談して決めた店だけに入れます。 「この店は数字だけならケース」と確かめた店です。決まりの無い店で単位が無ければ、要確認にします。
店はアドレスで決めます。 本文の署名の店名は、チェーン名だけだったり略称だったりします。店の一覧に無いアドレスからのメールは、AI に渡さず要確認にします。
データの取得方法を決める
| 取るもの | どこから | どう取るか |
|---|---|---|
| 未処理のメッセージ | Gmail | GmailApp.search に「発注」のラベルと直近2日の条件で、件数を区切って探し、スレッドのメッセージを並べる |
| 本文・差出人・日時・ID | 各メッセージ | getPlainBody・getFrom・getDate・getId |
| 添付の有無 | 各メッセージ | getAttachments に includeInlineImages: false を渡して数える |
| 店・品目の情報 | 店の一覧・品目の台帳 | スプレッドシートを読む |
処理済みかどうかは、スレッドのラベルではなく、メッセージの ID で見ます。 訂正は前のメールへの返信で届くことが多く、同じスレッドに新しいメッセージが加わります。 スレッドに「処理済み」のラベルを付けて飛ばすと、返信の訂正を落とします。スクリプトはスレッドの中のメッセージを1通ずつ見て、処理済みの表に ID が無いものだけを処理します。
検索は件数を区切って呼びます。 公式の説明では、件数を区切らない search は、スレッドの合計が大きすぎると失敗するとされ、区切った呼び方を勧めています。 直近2日に絞った条件で、50スレッドずつ探します。
添付は数えるだけにします。 公式の説明では、getAttachments は既定で本文に埋め込まれた画像も返します。署名のロゴを添付と数えないよう、埋め込みの画像を除く設定で数えます。 発注書の添付があるメールは、本文を処理したうえで要確認にします。
AIへ渡す前に整形する
- 引用を落とす … 「>」で始まる行と、「〜 wrote:」「〜のメッセージ:」以下を落とします。公式の説明は
getPlainBodyが引用を含むかを書いていないので、実際の訂正のメールで落ちることを確かめます - 署名を落とす … 店の一覧に店ごとの署名の書き出し(「--」や店名の行)を持たせ、それより下を落とします
- 連絡先を渡さない … 差出人のアドレスは店を決めるのに使い、AI には渡しません
- 受け取った日時を添える … 本文に「明日」「明後日」とあるときのため、受け取った日付だけを渡します
- 空のメールを飛ばす … 引用と署名を落として何も残らなければ、AI に渡さず「お礼・連絡のみ」として処理済みにします
1番目を省かないでください。 返信で届く訂正の本文の下には、前の発注がそのまま残っています。引用を落とさないと、前の発注の品目がもう一度抜き出され、置き換えの後の数が元に戻ります。
AIに処理させる
させるのは、1通のメールについて、新規・訂正・取消の別と、品目ごとの行を書かれたとおりに抜き出すことだけです。
| 抜き出す項目 | 抜き出し方 | 書かれていないときの扱い |
|---|---|---|
| メールの種類 | new(新規)/replace(訂正で全体を差し替え)/add(追加)/cancel(取消)/other | 決められなければ unclear |
| 品目 | 品目の正式な名前のどれか | 当たらなければ unknown と原文 |
| 数量 | 書かれた数 | 無ければ null |
| 単位 | 袋・個・ケース | 数だけなら none |
| 行の動き | その品目を「この数にする」か「この数を足す」か「無しにする」か | 決められなければ unclear |
| 納品日の書き方 | 書かれた日付か「明後日」などの原文 | 無ければ空 |
いちばん大事なのは、メールの種類と行の動きを分けることです。 「しらたき20を30に」は行の動きが「この数にする」、「玉こん5追加」は「この数を足す」、「刺身こんは無しで」は「無しにする」です。1通の訂正の中に3つが混ざることがあります。
| させないこと | 理由 |
|---|---|
| ケースから袋への換算 | 入数は台帳にある。AI に持たせない |
| 前の発注との差し引き | 前の発注は受注の表にある。置き換えはスクリプトが行う |
| 単位の推し量り | 店ごとの決まりは店の一覧にある |
| 納品日の日付への読み替え | 受け取った日と納品の決まりからスクリプトが出す |
| 製造の数・予備の計算 | 数量表の式と担当が決める |
2行目は、この構成の要です。 訂正のメールだけを渡された AI は、前の発注を知りません。「30に」を「10増やす」と書き換えさせようとすると、前の数を推し量ります。 AI は書かれた動きを返すだけにし、前の数との突き合わせは受注の表を持つスクリプトが行います。
指示内容を固定する
依頼の system_instruction に、次の文を入れます。
あなたはこんにゃくの製造所の受注の担当で、スーパーの店から届いた発注のメールを整理する立場です。
渡された本文と品目の一覧だけを見て、決めた項目を書かれたとおりに抜き出してください。
推測で埋めないでください。
【メールの種類(mail_type)】
- new ......... その日の発注を初めて送ってきたもの
- replace ..... 前に送った発注を、全体として差し替えるもの(「こちらに差し替え」など)
- add ......... 前の発注に品目や数を足すもの(「追加で」など)
- cancel ...... 前の発注を取り消すもの
- other ....... 発注の品目が無いもの(お礼、連絡、問い合わせ)
- unclear ..... 上のどれか決められないもの
【品目ごとの行(lines)の動き(action)】
- set ... その品目を「この数」にする(「30に」「30でお願いします」)
- add ... その品目に「この数」を足す(「5追加」)
- remove ... その品目を無しにする(「無しで」「キャンセル」)
- unclear ... 決められない
【厳守事項】
- 品目は一覧の正式な名前だけを使ってください。一覧の「よくある書き方」に当たるものは
正式な名前にしてください。当たらなければ item を unknown とし、raw_item に原文を写してください。
- 数量は書かれた数を、単位は書かれたとおりに入れてください。
数だけで単位が無いときは unit を none にしてください。単位を推し量らないでください。
- ケースを袋に直したり、入数を掛けたりしないでください。
- 前の発注の数を推し量って、差し引きや合計をしないでください。
「30に」は action を set、qty を 30 にするだけです。
- 納品日は、書かれた日付か言葉(「明後日」「20日着」)を delivery_text にそのまま写してください。
日付に直さないでください。
- 引用された過去のメールの品目は、行にしないでください。
- 製造できるか、在庫があるかは書かないでください。
【品目の一覧】{item_list}
【受け取った日付】{received_date}
【本文】{body}
「前の発注の数を推し量らない」を例つきで書くのは、AI がいちばん気を回すところだからです。 「しらたき、30にしてください」とだけあると、AI は「前は20だったので10追加」と書きたくなります。例を1つ添えると、set と qty だけを返します。
温度の設定は付けません。 公式の説明では、Gemini 4 と Gemini 3.6 以降のモデルは temperature などの独自の値を無視し、非推奨の警告を返すとされ、依頼から外すよう勧めています。
出力形式を固定する
構造化出力は response_format で指定します。 公式の説明では、type を text、mime_type を application/json にして、schema に JSON Schema を渡します。返ってくる形は次のとおりです。
{
"mail_type": "add",
"delivery_text": "明後日",
"lines": [
{ "item": "しらたき", "raw_item": "しらたき", "qty": 30, "unit": "none", "action": "set" },
{ "item": "玉こんにゃく", "raw_item": "玉こん", "qty": 5, "unit": "袋", "action": "add" },
{ "item": "刺身こんにゃく", "raw_item": "刺身こん", "qty": null, "unit": "none", "action": "remove" }
],
"notes": "朝の便でお願いします"
}
mail_type・unit・action は enum にし、qty は0以上の整数(minimum 0)か null にします。 公式の説明では、数値の minimum/maximum は守られ、null は型の並びに "null" を足して表し、文字列の minLength/maxLength は外されます。公式の説明は、構文として正しい JSON でも値はアプリの側で確かめるよう求めています。 スクリプトで品目が一覧にあるか、数が常識の範囲(1店1品目で200袋まで、など)かを確かめます。
応答の文は、公式のテキスト生成のページの例に沿って、応答の steps の最後の要素の content から読みます。 読めなかったときはメッセージを要確認にします。
1つ目の理由は、置き換えの決まりを機械で当てられることです。 スクリプトは受注の表の「店×納品日」の行を、次の決まりで更新します。
mail_type | 受注の表の動き |
|---|---|
new | その店のその納品日の行を作る(すでにあれば要確認) |
replace | その店のその納品日の行を、このメールの行でまるごと置き換える |
add | 行ごとに action を当てる(set は上書き、add は足す、remove は0) |
cancel | その店のその納品日の行をすべて0にし、取消の印を付ける |
unclear・other | 受注の表を変えず、要確認または処理済み |
2つ目は、単位を空のまま受け取れることです。 unit が none の行は、店の一覧に決まりがある店だけスクリプトがその単位を当て、無い店は要確認にします。 入数を掛けるのはその後です。
3つ目は、raw_item に原文が残ることです。 unknown の行は原文で担当が品目を決め、その書き方を品目の台帳の「よくある書き方」に足せます。
システムへ連携する
| つなぎ先 | 方式 | 内容 |
|---|---|---|
| Gmail | GmailApp.search・getMessagesForThreads | 「発注」のラベルのメッセージを拾う |
| Gemini API | UrlFetchApp(POST、muteHttpExceptions) | 種類と品目ごとの行の抜き出し |
| 受注の表 | スプレッドシート | 店×納品日×品目の数を置き換える |
| 数量表・仕分けの表 | スプレッドシート | 締めの後に品目ごとの合計と店ごとの数を出す |
| 処理済みの表 | スプレッドシート | メッセージの ID、種類、結果、処理の時刻 |
UrlFetchApp には muteHttpExceptions を付けます。 公式の説明では、既定では失敗の応答で例外が投げられ、true にすると応答を受け取れます。例外で実行が止まると、同じ回の残りのメッセージも処理されません。 応答の番号を見て、失敗したメッセージだけを処理済みにせず次の回に回します。
数量表は品目ごとに、受注の表の合計の袋数と、予備の率を掛けた数を並べます。 予備の率は製造の責任者が品目ごとに決めた値を台帳に持ち、AI もスクリプトも決めません。 店ごとの仕分けの表は、翌々日の朝の積み込みに使います。
店へのメールは出しません。 訂正の受け付けの返事や、届いていない店への連絡は、担当が電話かメールで行います。
人が確認する
担当が見るのは、要確認の行と、届いていない店と、締めの後の数量表です。
- 締めの1時間前に、届いていない店を見る … 毎日発注のある店でまだ届いていない店に電話します
- 要確認の行を片づける … 品目の
unknown、単位の決まらない行、unclearのメール、同じ店のnewの重複、店の一覧に無いアドレス、添付のあるメール - 納品日の違う行を見る …
delivery_textが通常の納品日と違う行は、スクリプトが要確認にします。特売の前倒しなどは担当が店に確かめます - 数量表を確かめて渡す … 品目ごとの合計を前の週の同じ曜日と見比べ、大きく違う品目は受注の表の店の行をたどります
4番目で前の週と見比べるのは、取り違えに気づくためです。 ケースと袋の取り違えは、品目の合計が普段の数倍になって表れます。
目標は、1,200件をならして1件1分です。 要確認の行を含むメールが1割前後という想定で、それより多い月は、品目の台帳の「よくある書き方」か、店の一覧の単位の決まりが足りていません。
例外に対処する
| 起きること | 対応 |
|---|---|
| 数だけで単位が無く、店の決まりも無い | 要確認。店に単位を確かめ、決まりにできれば店の一覧に入れる |
| 品目が台帳に当たらない | unknown と原文で要確認。新しい品目の相談のこともある |
| 追加か置き換えか読めない | unclear。受注の表を変えずに要確認 |
| 締めの後に訂正が届く | スクリプトは受注の表を更新するが、数量表は作り直さず「締め後の訂正」として担当に出す |
| 店の一覧に無いアドレス | AI に渡さず要確認。店の担当者が個人のアドレスで送ったことが多い |
| 発注書の添付だけで本文が空 | 「添付のみ」として要確認。担当が添付を見て受注の表に入れる |
| Gemini API が失敗の応答を返す | 処理済みにせず次の回に回す。3回続けて失敗したら要確認 |
| 1回の実行の時間が長くなる | 1回20通までで切り、残りは次の回 |
| 同じメールが二度処理される | 処理済みの表の ID で防ぐ |
4行目の「締め後の訂正」を数量表に自動で反映しないのは、製造の段取りがすでに動いているからです。 受けるかどうかは担当が決め、受けるなら製造の責任者に直接伝えます。
記録を残す
- 元のメール(「発注」のラベル付きで Gmail に残る)
- 処理済みの表(メッセージの ID、種類、AI の出力の全項目、処理の時刻、結果)
- 受注の表の変更の記録(どのメッセージで、どの行の数が、いくつからいくつに変わったか)
- 担当が要確認で決めた品目・単位と、その理由
- 日ごとの数量表と、渡した時刻
unknownになった品目の原文と、単位が決まらなかった店ごとの件数
3つ目の変更の記録は、店から「頼んだ数と違う」と言われたときの根拠になります。 どのメールのどの行で数が変わったかを追えれば、読み違いがこちらにあったのか、店のメールの書き方にあったのかを、店と一緒に確かめられます。
04実装レベルの3段階
最小構成では件数がさばけません。確かめるための段階です。 半自動化で、1件4分が1分になり、この段階が本記事の想定です。 担当に残るのは、要確認の行と届いていない店の片づけと、数量表の確かめです。 本格構成は、販売管理と原料の発注をどう持っているかしだいです。 表で回しているなら、半自動化で止めてかまいません。段階を飛ばさないでください。 半自動化で unknown と単位の決まらない店を1か月数えると、台帳と店の一覧のどこを足せばよいかが先に分かります。
05工数削減シミュレーション
導入後 1,200件 × 1分 ÷ 60 = 20 時間/月
自社条件で導入効果を整理したい方へ
このユースケースを自社に当てはめた場合の前提値と削減見込みを、業務ヒアリングをもとに整理します。
06向いている企業・向いていない企業
- 板こんにゃく・しらたき・玉こんにゃく・刺身こんにゃくなどを作り、地域のスーパーの数十店に毎日納めている製造所。各店の担当者が発注をメールの本文で送ってきて、受注の担当が1通ずつ読んで集計の表に写し、翌日の製造の数を出している場合。品目の呼び方と単位が店ごとに違い、訂正のメールが後から届く場合。Google Workspace の Gmail とスプレッドシートを使っている場合。
- スーパーの本部と EDI でつながり、発注が品目コードと数量で届く場合。納める店が数店で、電話や FAX で足りる場合。発注の大半が各チェーンの決まった書式の添付ファイルで届く場合(この構成は本文を読みます)。なお、製造の数に上乗せする予備の量、欠品のときにどの店を減らすか、店への連絡は担当と製造の責任者が決めるもので、この構成は代替しません。
07最小構成で試す方法
- 先月の発注のメールから30通を選ぶ(うち数通は、訂正・追加・取消のメールと、単位の無いメールを入れる)
- その30通について、担当が受注の表に何を書き、どう置き換えたかを拾う
- 店名と担当者名を消し、手元の AI サービスの画面に1通ずつ貼る
- 第7章の指示と品目の一覧を一緒に貼り、種類と品目ごとの行を出させる
- 出てきた行を、当時の受注の表と見比べる
30通は必ずやってください。 スクリプトを書く前に、「前の発注の数を推し量らないか」と「単位を決めつけないか」を確かめます。
| 出てきた内容 | 判断 |
|---|---|
| 当時の受注の表と同じ動きが出た | スクリプトを書く段階に進む |
| 「30に」を差し引きで返した | 指示の例を足せば直る。構成は有効 |
品目がほとんど unknown になる | 品目の台帳の「よくある書き方」が先。 AI の問題ではない |
08実装時につまずきやすいポイント
| 問題 | 対策 |
|---|---|
| 訂正を新しい発注として足す | mail_type と action を分け、置き換えはスクリプトが行う |
| 返信の訂正を落とす | スレッドのラベルではなく、メッセージの ID で処理済みを見る |
| 引用された前の発注がもう一度入る | 前処理で引用を落とし、指示でも禁じる |
| 単位の無い数をケースか袋に決めつける | none で返させ、店の一覧の決まりだけを当てる |
| 「30に」を差し引きで返す | 指示に例を添える |
| 数量表が締めの1時間後に出る | 日次のトリガーではなく、10分おきの実行の中で時刻を見る |
| 1回の実行が6分を超える | 1回20通で切る |
| 署名のロゴを添付と数える | 埋め込みの画像を除いて数える |
上の3行が、この構成の失敗のほとんどです。 どれも「訂正」をどう扱うかから起きます。種類は AI、置き換えはスクリプト、処理済みはメッセージの ID。 この3つの分担を守れるかで、運用に乗るかが決まります。
09セキュリティ・AIガバナンス上の注意点
この構成で扱うデータ: 各店の担当者の名前とメールアドレス、店ごと品目ごとの毎日の発注の数(店の売れ行きそのもの)、そして特売の予定などの書き込みです。
- 連絡先を AI に渡さない … 差出人のアドレスは店を決めるのに使い、本文の署名は落とします
store=falseを付ける … 既定ではやり取りが有料の枠で55日保存されます。発注の数を Gemini の側に残しません- 有料の枠で使う … 無料の枠では入力が製品の改善に使われ、人が読むことがあります
- API のキーをスクリプトの本文に書かない … スクリプトのプロパティに置き、スクリプトを編集できる人を絞ります
- 店へのメールを自動で出さない … 訂正の受け付けや欠品の連絡は担当が行います
- チェーンの間で数を見せない … 数量表は品目ごとの合計、仕分けの表は店ごとです。別のチェーンの担当者に、他のチェーンの数が渡らないようにします
誤りが起きた場合のリスクは、作りすぎて捨てることと、足りずに欠品させることの2つです。 日配品のこんにゃくは、作りすぎた分を翌週に回せません。前者はケースと袋の取り違えから、後者は訂正の反映漏れから起きます。どちらも「単位は書かれたとおり、訂正は置き換えの決まりで」で防げるので、そこだけは設計で守ります。
10まず何から始めるか
1週目:台帳と店の一覧に列を足す
品目の台帳に「よくある書き方」の列を足し、この3か月のメールに出てきた呼び方を書き出します。店の一覧に、差出人のアドレス、毎日発注のある店か、単位なしのときの決まりの列を足します。単位の決まりは店に確かめた店だけ入れます。
2週目:30通で試す
先月のメールから30通を選び、手元の AI サービスに貼り付けて種類と品目ごとの行を出させます。訂正のメールで前の数を推し量っていないか、単位を決めつけていないかを最優先で見ます。
3週目:スクリプトで抜き出しまで作る
Gmail のフィルタで「発注」のラベルを付け、10分おきのスクリプトでメッセージを拾い、Gemini API の抜き出しを処理済みの表に書くところまで作ります。この時点では受注の表を更新せず、抜き出しの結果だけを担当の集計と見比べます。
4週目:置き換えと数量表をつなぐ
置き換えの決まりで受注の表を更新し、締めの後に数量表と仕分けの表を作ります。最初の2週間は担当がこれまでどおり集計し、数量表と見比べます。
2か月目: 担当の集計をやめ、要確認の行の片づけだけにします。届いていない店の知らせを足します。3か月目以降: 1件4分が何分になったかを実測し、unknown の原文を台帳に足し終え、単位の決まらない店が無くなった時点で、この構成は完成です。
11関連ユースケース
12この仕組みを理解するための記事
13技術仕様の確認日・参考情報
| 確認した内容 | 情報源 | 確認日 |
|---|---|---|
Interactions API の宛先が /v1beta/interactions であること。既定でやり取りを保存し(有料55日、無料1日)、store=false で保存しないこと。store=false が background の実行と併用できないこと | Google AI Studio: Interactions API | 2026-11-17 |
構造化出力を response_format(type を text、mime_type を application/json、schema)で指定すること。enum、数値の minimum/maximum が使えること、null を型の並びで表すこと、minLength/maxLength が外されること。値をアプリの側で確かめるよう求めていること。REST の例が x-goog-api-key と Api-Revision のヘッダーを付けていること | Google AI Studio: Structured output | 2026-11-17 |
system_instruction を依頼の最上位に置けること。Gemini 4 と Gemini 3.6 以降が temperature などの値を無視し、外すよう勧めていること。応答の文を steps の最後の要素の content から読む例 | Google AI Studio: Text generation | 2026-11-17 |
| 無料の枠では入力と応答が製品の改善に使われ人が読むことがあり、機密・個人の情報を送らないよう求めていること。有料の枠では製品の改善に使わず、禁止された使い方の検出のために限られた期間記録すること。API の利用が18歳以上であること | Google AI Studio: Gemini API Additional Terms of Service | 2026-11-17 |
GmailApp.search の件数を区切らない呼び方がスレッドの合計が大きいと失敗し、区切った呼び方を勧めていること。getMessagesForThreads・getUserLabelByName・createLabel があること | Google Apps Script: Class GmailApp | 2026-11-17 |
getPlainBody・getFrom・getDate・getId があること。getAttachments が既定で本文に埋め込まれた画像も返し、includeInlineImages で外せること。getPlainBody が引用を含むかの記載が無いこと | Google Apps Script: Class GmailMessage | 2026-11-17 |
| 設置型のトリガーに Gmail の受信を起点にするものが挙がっていないこと。時間主導のトリガーが最短1分おきに動かせ、毎日9時と決めると9時から10時のあいだに動くこと。失敗するとメールで要約が届くこと | Google Apps Script: Installable triggers | 2026-11-17 |
| 1回の実行が6分まで、トリガーの合計の実行時間が個人で1日90分・Workspace で1日6時間、UrlFetchApp の呼び出しが個人で1日2万回・Workspace で1日10万回であること | Google Apps Script: Quotas | 2026-11-17 |
UrlFetchApp.fetch に method・contentType・headers・payload を渡せること。muteHttpExceptions が既定で false で、true にすると失敗の応答でも例外を投げないこと | Google Apps Script: Class UrlFetchApp | 2026-11-17 |
予備の量、欠品のときにどの店を減らすか、締めの後の訂正を受けるか、店への連絡は、受注の担当と製造の責任者が決めてください。 本記事は Google の公式ドキュメントで確認できた範囲だけを扱っています。
実装ステータス:構成例。 公開仕様に基づいて設計した構成であり、当社で実際に構築・検証したものではありません。工数の数値はモデル条件による試算です。
自社の業務に使えるAI活用候補を整理します
このユースケース(UC-3637)についてのご相談はこちらから。
