施設園芸の農業法人がハウスごとに手書きする温度・湿度・灌水の記録を読み取り、日ごとの表にそろえて、管理の目安を外れた日と温度計の戻し忘れを拾う

処理の起点を決める

Google Apps Script の時間主導のトリガーで、15分ごとに共有フォルダを見に行きます。 公式の説明では、インストール型のトリガーとして挙げられているのは、開いたとき・編集・変更・フォームの送信・カレンダーの予定と、時間主導のトリガーで、ドライブにファイルが作られたことをきっかけにするものはありません。 時間で起動して、新しいファイルを探す形にします。

公式の説明では、時間主導のトリガーは毎分から月1回までの間隔で動かせ、時刻は少しずらされることがあるとされ、インストール型のトリガーは作った人のアカウントで動くとされています。担当者の異動で止まらないよう、法人の業務用のアカウントで作ります。

撮るのは毎夕です。 週の終わりにまとめて撮ると、(b)の気づきの遅れが残ります。同じ記録表を毎日撮ることになるので、取り込むのはその日の列だけにします。 処理が終わった画像は処理済みのフォルダへ移し、移すのは成功したときだけにします。

入力データを集める

質を決めるのは、管理の目安の一覧です。 栽培の責任者が経験で持っている見方を、品目と生育の段階ごとの数字にします。ここが(d)の「責任者の頭の中」を外に出す作業で、AIの仕組みとは関係なく価値があります。

ハウスの一覧に「測る道具」を持つのは、戻し忘れの照合のためです。 機器の画面から写す棟では、針の戻し忘れは起きません。温度計の棟だけに、戻し忘れの照合を当てます。

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

読み取りは、Apps Script から Form Parser のプロセッサの API を呼び、画像を渡すだけです。返ってくる Document から、表と上の欄と信頼度を取り出します。

公式の説明では、text が認識されたテキストの唯一の元で、ほかの欄は startIndex と endIndex でその位置を指すとされ、表は headerRows と bodyRows に分かれるとされています。この記録表では、見出しの行に曜日が、本体の各行の1列目に項目の名前が並びます。 行と列の両方に見出しがある表です。

値の空いた欄には気を配ります。 公式の説明では、値の空いたキーと値のペアは確実には読めないとされています。週の始まりの日付が空欄だと上の欄ごと返ってこないことがあり、その場合は列の日付が決まらないので、記録表ごと確認待ちにします。

Apps Script の割り当ての上限にも気を配ります。公式の説明では、1回の実行の時間は6分まで、トリガーの合計の実行時間は Google Workspace のアカウントで1日6時間までとされています。12枚なら1回の起動で収まりますが、撮り直しが重なる日に備え、1回で処理する枚数を決めておきます。

AIへ渡す前に整形する

1. 画像の向きと傾き … スマートフォンで斜めに撮った画像を、紙の四隅で補正します
2. 解像度 … 公式の説明では、スキャンは最低200dpi、300dpi以上で一般に最良の結果とされています。1枚に63欄あるので、欄が小さくならないよう紙全体を大きく撮ります
3. ファイルの形式と大きさ … JPEG で保存し、オンラインの処理の要求の上限の40MBと、画像の40メガピクセルの上限に収めます
4. ハウスの確認 … 上の欄のハウスの番号を、ハウスの一覧と照らします
5. その日の列の決定 … 撮影の日時と週の始まりの日付から、取り込むべき曜日の列を決めます
6. 重複の検知 … 同じハウス・同じ日で二度撮ったものは、新しいほうだけを使います

5番目を前処理に置くのが、この構成の要点です。 生成AIに「その日の列を写して」と頼む前に、どの曜日の列が対象かをプログラムが決めて渡します。 撮影が日付をまたいだ夜や、前日の書き忘れを翌日に書き足した場合は、撮影の日時だけで決めず、前日の列が空いているかも見て、2列を取り込む候補にします。

AIに処理させる

生成AIにさせるのは2つだけです。 表の行を項目に、列を曜日に対応づけることと、指定された曜日の列の値を文字のまま写すことです。

行と列の対応づけを生成AIにさせるのは、作業者が列を書き間違えるからです。 水曜の値を木曜の列に書いた、項目の名前の欄に略字を書き込んだ、といった紙の上のずれを、見出しの文字から決め直します。

2行目がいちばん起きやすい失敗です。 最低気温の欄だけが空いていると、生成AIは前日の値や最高気温から見て「ありそうな値」を入れます。入れた瞬間に記入漏れが消え、その値が目安の照合にまで使われます。

指示内容を固定する

あなたは施設園芸の農業法人の事務の担当で、ハウスの環境の記録表の読み取り結果から、
指定された曜日の列の値を写す係です。
OCRが返した表と上の欄だけを見てください。推測で埋めないでください。

【項目】
max_temp（最高気温）、min_temp（最低気温）、humidity（朝の湿度）、
irrigation_count（灌水の回数）、irrigation_amount（灌水の量）、
vent（換気窓）、heater（暖房）、weather（天候）、memo（メモ）

【厳守事項】
- 本体の各行がどの項目に当たるかを row_map に、
  見出しの各列がどの曜日に当たるかを col_map に書いてください。
  決められないものは unknown にしてください。
- 値を写すのは、target_weekday に指定された曜日の列だけです。
  ほかの列の値を写さないでください。
- セルの文字をそのまま写してください。数字を計算しないでください。
  小数点や桁を補わないでください。
- 「○」「×」「開」「閉」「晴」などの記号や文字は、書かれたとおりに写してください。
- 読めないセルは空にし、unreadable_cells に入れてください。
  前日の列、ほかの項目、ありそうな値で埋めないでください。
- 空いているセルは空のまま写してください。空いている理由を書かないでください。
- 日付を計算しないでください。気温や湿度が良いか悪いかを書かないでください。

【OCRの表】{tables}
【上の欄】{form_fields}
【target_weekday】{weekday}

「ほかの列の値を写さない」を明記しているのは、生成AIが親切に表全体を写すからです。 毎夕同じ紙を読むので、全列を写させると、確定済みの前の日の値を毎回上書きする経路ができます。 前の日の列は、照合のときに Apps Script が台帳の値と見比べるだけにします。

出力形式を固定する

次の形のJSONで受け取ります。

{
  "image_id": "",
  "header": {
    "house_no": "",
    "crop": "",
    "week_start_raw": "",
    "writer": ""
  },
  "row_map": [ { "row_index": 0, "field": "max_temp | min_temp | humidity | irrigation_count | irrigation_amount | vent | heater | weather | memo | unknown" } ],
  "col_map": [ { "column_index": 1, "weekday": "mon | tue | wed | thu | fri | sat | sun | unknown" } ],
  "target_weekday": "mon | tue | wed | thu | fri | sat | sun",
  "values": {
    "max_temp": "", "min_temp": "", "humidity": "",
    "irrigation_count": "", "irrigation_amount": "",
    "vent": "", "heater": "", "weather": "", "memo": ""
  },
  "unreadable_cells": [ { "field": "" } ]
}

週の始まりの日付を week_start_raw という文字列で受けるのは、書き方がばらばらだからです。 「10/13」「10月13日」「R8.10.13」と書かれ、年の無いものもあります。Apps Script の側で、撮影の日時に最も近い月曜として解釈し、解釈できなければ記録表ごと確認待ちにします。

Claude の構造化出力は、output_config.format に type: "json_schema" で JSON スキーマを渡して有効にし、オブジェクトには additionalProperties: false が必要とされています。 数値の minimum・maximum は対応していないとされているので、値の範囲はスキーマではなく Apps Script で確かめます。

後段の照合は、この出力に対して決まりで行います。

5行目の戻し忘れの照合は、目安の照合より先に行います。 戻し忘れの日の値で目安を見ると、実際には起きていない「暑すぎた日」や「冷えすぎた日」が一覧に載ります。 戻し忘れの候補になった日は、目安の照合から外して確認待ちに入れます。

システムへ連携する

台帳へ自動で書き込むのは、照合で印が1つも付かなかった日だけです。 印の付いた日は、確認待ちの一覧で人が直してから書き込みます。管理の目安の一覧と生育の段階の表には書き込みません。 目安を変えるのは栽培の責任者で、表を直すのも人です。

目安を外れた日の一覧は、毎朝の始業の前に作ります。 責任者が朝の見回りの前に開けるよう、外れた項目と値と前後2日の値を並べ、画像へのリンクを付けます。

人が確認する

人が見るのは、確認待ちの一覧に入った日の、印の付いた欄だけです。

1. 日付が決まらない記録表を先に見る … 週の始まりの日付を画像で読み、書き足します
2. 戻し忘れの候補を作業者に聞く … 針を戻したかを聞き、戻し忘れなら「その日の値は無効」と記録します。前日と同じ値を、本当の値として残しません
3. 記入漏れと数字の疑いを直す … 画像と並べて直し、書かれていなければ作業者に聞きます
4. 目安を外れた日を責任者が見る … 毎朝の一覧で、ハウスに行って管理を直すかを決めます

2番目で「無効」と記録するのが、(c)への答えです。 温度計の値は翌日には読み直せないので、分からなかったことを分からなかったとして残すほうが、台帳の値として正しくなります。

目標は、360件をならして1件1.5分です。 印の無い日は人が開かず、印の付いた日は画像を開いて直すので数分かかります。責任者が一覧を見る時間も、この中に含めています。

例外に対処する

5行目を先に作っておくと、確認待ちが減ります。 片付けのハウスの記録表は全欄が空いていて、それがすべて記入漏れとして並ぶと、本当の書き忘れが埋もれます。

記録を残す

• 記録表の画像と、撮影の日時・撮った人
• OCR が返した Document の全文（text、formFields、tables、信頼度）
• 生成AIの出力（行と列の対応づけ、写した値）
• 照合の結果と、そのとき使った管理の目安の一覧と生育の段階の版
• 人が直した記録と、「無効」とした日の記録
• 毎朝の目安を外れた日の一覧と、責任者が見た印

管理の目安の版を残すのは、目安を毎作見直すからです。 次の作付けの前に、前の作の外れた日と出来を見比べて目安を直します。当時の目安が残っていないと、外れたのが管理の問題か目安の問題かを比べられません。

「無効」とした日の記録は、温度計の扱いを見直す材料になります。 同じ棟や同じ曜日に戻し忘れが続くなら、夕方の見回りの順番か、温度計の置き場所に理由があります。作業者を責める材料にせず、手順を直すために使います。