学校・塾の授業の録画と板書の写真から、欠席した生徒と復習のための要点ノートと確認問題を作り、教員の確認を経て配る

処理の起点を決める

トリガーは毎晩22時の定時の処理です。 校内のサーバーか総務の端末で、OS の定時の実行の機能から Python の処理を動かします。その日の授業の一覧から「作る」と指定された行を取り出し、1件ずつ処理します。

授業の直後には動かしません。 録画の書き出しと保存先への転送に時間がかかり、録画が保存先に置かれたことを確かめてから処理する必要があるからです。 夜にまとめて動かせば、翌朝の教員の確認に間に合います。

授業の一覧は、毎朝の時間割から作ります。 時間割の書き出しから「日付・時限・教室・教科・担当・単元」の行を作り、出欠の記録から欠席者がいた授業に「候補」の印を付けます。教員は、印の付いた行と、自分で作りたい行の「作る」の欄にチェックを入れます。 チェックの締め切りは21時です。

入力データを集める

質を決めるのは、板書の写真と「その時間の目標」の1行です。 録画だけでは、教員の説明の何が中心だったかをAIが選ぶことになります。目標の1行があれば、その目標に沿って要点を選ばせられます。 板書の写真が無ければ、式や図の書き起こしは録画の荒い映像に頼ることになります。

用語の一覧は、表記をそろえるために持ちます。 「アボガドロ定数」か「アボガドロ数」か、教科書の表記と違う言葉で要点が書かれると、生徒が教科書と照らすときに迷います。

生徒の名簿は渡しません。 要点ノートに生徒の名前は要りません。録画の中で生徒の名前が呼ばれても、出力に書かないよう指示します。

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

録画は Files API にアップロードし、処理が終わるのを待ってから呼び出します。 公式の例でも、アップロードしたファイルの状態が ACTIVE になるまで数秒おきに確かめてから使っています。ACTIVE になる前に呼ぶと失敗します。

板書の写真は画像として別に渡します。 1回の呼び出しの入力に、録画のファイルと画像を並べられます。板書の写真は、録画の映像より細かく読めるので、式と図の書き起こしは写真を優先させます。

夜間の処理の流れは、次のとおりです。

for 授業 in 授業の一覧で「作る」かつ「未処理」の行:
    録画 = 保存先から 授業.日付_時限_教室.mp4 を探す
    なければ 一覧に「録画なし」と書いて次へ
    f = Files API にアップロード
    f の状態が ACTIVE になるまで5秒おきに確かめる（30分で打ち切り）
    写真 = 授業のフォルダの画像（最大3枚）
    応答 = Gemini API を呼ぶ（入力：録画 f ＋ 写真 ＋ 指示、
                              録画の開始と終了の秒数、response_format にスキーマ）
    JSON を検証し、保存先の「下書き」フォルダに授業IDの名前で置く
    Files API の f を削除する
    一覧に「下書きあり」と書く

最後から2行目の削除を忘れないでください。 48時間で消えるとはいえ、生徒が写る録画を必要以上に外部に置かないためです。失敗したときも、例外の処理の中で削除します。

授業の前後の休み時間は切り落とします。 動画の処理の設定で、開始と終了の位置を秒で指定できます。チャイムの時刻から、授業の始まりと終わりの秒数を決めて渡します。 休み時間の雑談が要点に入るのを防ぎ、トークンも減ります。

AIへ渡す前に整形する

1. ファイルの確認 … 録画が mp4 で、時間が授業の長さに近いことを確かめます。途中で切れた録画は「録画不完全」で止めます
2. 板書の写真の確認 … 形式が PNG、JPEG、WEBP、HEIC、HEIF のどれかであることを確かめます。写真が無い授業は、「板書の写真なし」として録画だけで進めます
3. 切り出しの位置 … 時間割のチャイムの時刻から、開始と終了の秒数を決めます
4. 用語の一覧の選択 … 教科と学年で、渡す用語を絞ります
5. アップロードと待機 … Files API にアップロードし、使える状態になるまで待ちます

1番目を省かないでください。 カメラの容量の不足や停電で録画が途中で切れると、後半の説明が無いまま、前半だけの要点ノートができます。 そのまま配ると、生徒は後半の内容を知らずに終わります。

media_resolution は low を指定します。 公式の案内では、高い解像度は細かい文字や小さな部分を読む力を上げるとされていますが、1秒あたりのトークンが約3倍になります。細かい文字は板書の写真で補うので、録画は流れと説明を読むことに使います。

AIに処理させる

させるのは、要点、用語、板書の書き起こし、確認問題、聞き取れなかった箇所の5つです。

確認問題は、教員の説明の範囲から作らせます。 授業で触れていない発展の内容から問題を作ると、欠席した生徒は録画を見ても解けません。 各問題に、根拠にした説明の時刻を付けさせます。

1行目は、学校と塾で事情が違います。 著作権法第35条は、学校その他の教育機関で、授業の過程で使うために必要な限度で公表された著作物を複製・公衆送信できるとしていますが、営利を目的として設置されているものは除かれています。 塾ではこの規定に頼れません。学校でも、要点ノートに教科書の文章を長く写すことはさせません。

指示内容を固定する

あなたは中学校・高等学校の教員の補助として、授業の録画から、
欠席した生徒と復習したい生徒のための要点ノートの下書きを作る立場です。
渡すもの：授業の録画、板書の写真、授業の情報、用語の一覧。

【授業の情報】{subject}／{grade}／単元：{unit}
【この時間の目標】{goal}
【用語の一覧】{terms}

【作るもの】
1. 要点（3〜6個）
   - この時間の目標に沿って選んでください。
   - 各要点に、録画の中でその説明が始まる時刻を MM:SS で付けてください。
   - 時刻が分からない場合は空にしてください。推測で付けないでください。
2. 用語（授業で新しく出たもの）
   - 用語の一覧にある表記にそろえてください。
3. 板書の書き起こし
   - 板書の写真を優先して読んでください。読めない箇所は「読めない」と書いてください。
   - 式は、写真にあるとおりに書き写してください。
4. 確認問題（3問）
   - 授業で説明された内容だけから作ってください。
   - 各問題に、解答、短い解説、根拠にした説明の時刻を付けてください。
5. 聞き取れなかった箇所
   - 音声が不明瞭な箇所、生徒の声と重なった箇所の時刻を挙げてください。

【厳守事項】
- 授業で説明されていない内容を、補足として書き足さないでください。
- 教科書や問題集の文章・問題を、そのまま書き写さないでください。
  確認問題は、説明を確かめるための問題を新しく作ってください。
- 生徒の名前、生徒の発言の内容は書かないでください。
- 教員の説明が誤っていると思っても、直さずにそのまま要点にしてください。
  気になる箇所は check_points に時刻と理由を書いてください。
- 授業の前後の休み時間の会話は使わないでください。

「教員の説明が誤っていると思っても直さない」を入れているのは、AIの「親切」を止めるためです。 何も言わないと、AIは自分の知識で説明を「正しく」書き換えます。直された要点は、もう教員の授業ではありません。 気になる箇所は印を付けて教員に返させ、直すかどうかは教員が決めます。

「時刻が分からなければ空」も同じです。 それらしい時刻が付いていると、生徒はそこから録画を見ます。外れた時刻は、時刻が無いより生徒を迷わせます。

出力形式を固定する

次の形のJSONで受け取ります。 Gemini API の構造化出力では、response_format に mime_type: "application/json" と JSON Schema を渡します。key_points は minItems: 3・maxItems: 6、questions は3問に固定します。公式の案内では、値はアプリケーションの側で必ず検証するようにとされています。

{
  "lesson_id": "",
  "key_points": [ { "point": "", "start": "MM:SS" } ],
  "terms": [ { "term": "", "explanation": "" } ],
  "board": [ { "content": "", "readable": true } ],
  "questions": [ { "question": "", "answer": "", "explanation": "", "source": "MM:SS" } ],
  "unclear": [ { "at": "MM:SS", "reason": "" } ],
  "check_points": [ { "at": "MM:SS", "reason": "" } ]
}

1つ目の理由は、Python の側で検証できることです。

2つ目は、学校の書式のドキュメントに流し込めることです。 Apps Script が JSON を読み、見出し、要点（時刻は録画のリンクにする）、用語、板書、確認問題、解答を書式どおりに並べます。教員が直すのはドキュメントの上で、JSON を触る必要はありません。

3つ目は、check_points と unclear を教員の確認の入り口にできることです。 ドキュメントの冒頭にこの2つを並べ、教員は先にそこを見ます。

システムへ連携する

Google Classroom への配布は自動にしません。 第5章で書いたとおり、配る先は教員が決めます。配布の操作は1件1分程度で、自動にする利点より、誤配の危険のほうが大きいからです。

承認したドキュメントは、単元ごとのフォルダに移します。 翌年に同じ単元を教える教員が、前の年の要点ノートと録画を探せるようにします。

人が確認する

翌朝、担当の教員がドキュメントを開きます。 確認の順番は決めておきます。

1. check_points と unclear を見る … 説明の誤りの疑いや、聞き取れなかった箇所です。録画のその時刻を開いて確かめます
2. 要点を読む … 目標に沿っているか、説明が取り違えられていないかを見ます
3. 確認問題を解く … 教員が自分で解き、解答と解説が合っているかを確かめます。根拠の時刻を開き、説明した内容で解けるかを見ます
4. 板書を見る … 「読めない」の箇所を埋めます
5. 承認する … 一覧の「承認」にチェックを入れます

3番目を省かないでください。 AIの作る問題は、解答が誤っていたり、説明していない前提が要ったりすることがあります。誤った解答の付いた問題は、欠席した生徒に誤りを覚えさせます。

直した箇所には、ドキュメントの提案の機能を使うと後で数えられます。 教員が要点を書き換えた、問題を差し替えた、時刻を直した、のどれが多いかが分かれば、指示のどこを直すべきかがはっきりします。 慣れてきたら、提案のまま承認する運用でも構いません。

目標は1件9分です。 check_points と unclear が少ない授業なら数分で済み、多い授業は録画を何か所も開くので長くなります。

例外に対処する

5行目は、教室のマイクの問題です。 教室の後ろのカメラだけで録ると、教員が黒板を向いて話した声が拾えません。 教卓にマイクを置くと、要点の質が大きく変わります。

記録を残す

• 録画と板書の写真の原本（校内の保存先。保存の期間は学校の規程に合わせる）
• 渡した指示の全文と、返ってきたJSONの全文
• AIの下書きのドキュメントと、教員が承認した版（ドキュメントの版の履歴で差が分かる）
• 承認した教員と日時、配布した先
• 教科ごとの check_points と unclear の数の推移

下書きと承認した版の差を残すのは、指示を直すためです。 教員が毎回同じ種類の直しをしているなら、指示か用語の一覧に足すべきことがあります。

Files API へのアップロードと削除の記録も残します。 授業IDごとに、アップロードした日時、削除した日時、削除に失敗したかどうかを一覧に書きます。削除に失敗した行が残っていれば、翌朝に総務が手で削除します。 生徒が写る録画が、いつからいつまで外部にあったかを後から説明できるようにするためです。