盆栽の販売店が出品する鉢の写真を Gemini で見て、樹種の候補・樹形・鉢の特徴を読み取り、寸法と価格を人が入れて通販の商品説明の下書きにする

処理の起点を決める

毎日17時に、その日に撮った鉢をまとめて処理します。 撮影は日中に何回かに分けて行うので、撮るたびに動かすと、5枚がそろう前の鉢を処理してしまいます。 夕方にまとめれば、担当者は翌朝に確認の表を開くだけで済みます。

処理の対象は、5枚がそろったフォルダだけにします。 フォルダの中の写真の数を数え、5枚に満たないフォルダは飛ばして、確認の表に「写真が足りない」と書きます。 翌日の撮影で足りない方向を撮り足します。

処理が終わったフォルダには、処理済みの印を付けます。 印を付けるのは結果を確認の表に書き出せたときだけにします。印の無いフォルダが、そのまま未処理の鉢の一覧になります。

入力データを集める

質を決めるのは、写真の撮り方です。 背景が棚場のままだと、後ろの鉢の葉や枝が写り込み、Gemini がそれを手前の鉢の枝として読みます。 撮影台と単色の背景の布を決めておき、5方向の向きと距離を毎回同じにします。

在庫の台帳の樹種の名前は、Gemini には渡しません。 仕入れの記録の樹種を先に見せると、Gemini は写真よりその名前に引っ張られ、候補として返すだけになります。 台帳の名前は、Gemini の候補と並べて確認の表に出し、食い違ったときに担当者が実物を見て決めます。 2つの見立てが独立していることで、取り違えが見つかります。

選択肢の一覧は、店の呼び方で作ります。 樹形なら「直幹・模様木・斜幹・懸崖・半懸崖・文人木・双幹・株立ち・寄せ植え・根上り・石付き・その他」、鉢の形なら「長方・楕円・丸・正方・六角・八角・木瓜・その他」のように、店が通販で使っている呼び方をそのまま選択肢にします。

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

写真は、共有のドライブの管理番号のフォルダから取ります。 Python のプログラムがフォルダの一覧を見て、処理済みの印の無い、5枚そろったフォルダを拾います。写真のファイル名は「正面」「側面」「上」「鉢」「根元」の決まった名前にしておき、どの写真がどの方向かを名前で渡します。

写真の大きさは、送る前にそろえます。 スマートフォンの写真は1枚で数MBあり、5枚をそのまま送ると20MBの上限に近づきます。 長い辺を決まった長さに縮めてJPEGにし、5枚の合計が上限に余裕を持って収まるようにします。公式の案内では、384ピクセル以下の画像は258トークンで、それより大きい画像は768×768のタイルに分けて数えるとされ、Gemini 3 からは画像1枚あたりのトークンの上限を決める media_resolution の設定があります。細かい幹肌や葉の様子を見たい「根元」の写真だけ解像度を上げるかは、試しながら決めます。

HEIC で撮っている場合も、JPEG にそろえます。 HEIC は対応の形式ですが、確認の表や通販の管理画面に同じ写真を使うので、店の中で形式を1つにしておくほうが扱いやすくなります。

やり取りは保存させません。 公式の案内では、Interactions API は既定でやり取りを保存し（有料の枠で55日、無料の枠で1日）、store=false で保存しない動きにできるとされています。1鉢ごとに完結する処理なので、続きのやり取りは要りません。 store=false を付けて送ります。

AIへ渡す前に整形する

1. 5枚がそろっているかを確かめる … 決まった5つの名前のファイルがあるかを見ます
2. 写真の大きさをそろえる … 長い辺を決まった長さに縮め、JPEGにします
3. ピントの甘い写真を拾う … 画像の鮮明さを数値で見て、決まった値を下回る写真は「撮り直し」とします
4. 方向の名前を付けて並べる … 正面・側面・上・鉢・根元の順に、名前と一緒に渡します
5. 季節を添える … 撮影の月を渡します。落葉樹の冬の姿かどうかの手がかりにします

3番目は、Gemini に読めない写真を渡さないためです。 ピントが甘い写真を渡すと、Gemini はぼやけた葉から樹種の候補を出してしまいます。 撮り直しで済むものは、送る前に止めます。

5番目の季節は、樹種の候補の出し方を変えるためです。 冬の落葉樹は葉が無く、枝ぶりと幹肌と芽だけで見分けることになります。 撮影の月を渡し、葉の無い写真では「葉が無いので樹種の確からしさを下げる」よう指示しておきます。

AIに処理させる

させるのは、写真に写っていることを決まった項目と選択肢で返すことと、確かめるべきことを挙げることです。

確からしさを3段階の選択肢で返させるのは、担当者の見る順を決めるためです。 「高い」は候補を実物で確かめるだけ、「低い」と「判断できない」は店主に見てもらう鉢として確認の表の先頭に並べます。

1行目が、いちばん起きやすい失敗です。 盆栽の説明らしい言葉として、Gemini は幹の太さから「樹齢数十年」と書きたがります。通販の説明に樹齢を書くなら、店が仕入れの記録などで確かめた値だけにします。 写真からの見立てを書かせる項目そのものを、出力の形に持たせません。

4行目の「病気や虫が無い」にも、理由があります。 葉の裏や鉢の中は、5枚の写真には写りません。Gemini には「写真で見える範囲で、枯れて見える枝や色の変わった葉があるか」だけを返させ、無いと言い切らせません。 出品の前に、担当者が実物の葉の裏と鉢の表土を見ます。

指示内容を固定する

写真の読み取りの指示：

あなたは盆栽の販売店で、出品する鉢の写真を読み取る補助です。
渡すのは同じ鉢を写した5枚の写真で、それぞれに方向の名前（正面・側面・上・鉢・根元）と
撮影した月が付いています。写真に写っていることだけを、決められた項目で返してください。

【樹種】
- 下の「店で扱う樹種の一覧」から候補を2つまで選び、確からしさを
  「高い」「中くらい」「低い」から選んでください。
- 候補ごとに、写真のどこを見たか（葉の形・葉の付き方・幹肌・芽・花・実）を書いてください。
- 葉が無い、一覧に無い、写真で見分けがつかないときは「判断できない」を選んでください。
  迷ったときに「高い」を選ばないでください。

【樹形・鉢】
- 樹形は「樹形の選択肢」から1つ選んでください。当てはまらなければ「その他」とし、理由を書いてください。
- 鉢の形・色・釉薬の有無・足の数は、それぞれの選択肢から選んでください。
  「鉢」の写真で見えないものは「写真で見えない」を選んでください。

【厳守事項】
- 樹齢、鉢の作家・窯元・産地、高さ・幅・寸法、価格を書かないでください。
  落款や銘が見えても、その読みを書かず「確かめること」に「鉢に銘らしきもの」とだけ書いてください。
- 病気や虫について「無い」と書かないでください。
  写真で見える範囲で、枯れて見える枝や色の変わった葉があるかだけを書いてください。
- 背景や後ろの鉢の葉・枝を、この鉢のものとして扱わないでください。
  写り込みがあれば「確かめること」に書いてください。
- 見どころの候補は、写真で見える特徴だけを3つまで書いてください。

【店で扱う樹種の一覧】{species_list}
【樹形の選択肢】{style_list}
【鉢の選択肢】{pot_list}
【撮影した月】{month}

「迷ったときに高いを選ばない」を明記しないと、確からしさが上に寄ります。 樹種の候補を返すよう頼まれると、Gemini は1つ目の候補を自信のある形で返しがちです。確からしさは、担当者がどの鉢を店主に回すかを決める値なので、低めに出ることを許す指示にします。

商品説明の下書きの指示は、確定した値だけを渡して別に送ります。 写真はもう渡しません。「樹種・樹形・鉢・寸法・見どころは、渡した値だけを使い、無い項目は書かない。樹齢・作家・手入れの効き目を書かない。見出し30字、本文250字」という形で、確定した値の範囲の中で文にさせます。

出力形式を固定する

写真の読み取りは、次の形のJSONで受け取ります。

{
  "lot_no": "B-2026-1123",
  "species_candidates": [
    { "name": "真柏", "confidence": "中くらい",
      "evidence": "鱗片状の葉。幹に白く枯れた部分（舎利）が見える" },
    { "name": "杜松", "confidence": "低い",
      "evidence": "葉の一部が針状に見えるが、写真では判別しにくい" }
  ],
  "style": "模様木",
  "style_reason": "",
  "pot": { "shape": "楕円", "color": "茶", "glaze": "無釉", "feet": "4" },
  "foliage": { "uniform_color": "揃っている", "dead_branches": "写真で見えない" },
  "highlights": ["根元から左へ流れる幹の曲がり", "上から見て枝の段が三段に分かれている"],
  "to_check": ["鉢に銘らしきもの", "側面の写真に後ろの鉢の葉が写り込み"]
}

1つ目の理由は、選択肢の値で返ってくることです。 style や pot.shape は決まった呼び方の中から選ばれるので、担当者が呼び方を考え直す必要がありません。 構造化出力の enum で選択肢を縛ります。

2つ目は、樹種が候補と根拠の組で返ってくることです。 担当者は evidence を読み、実物のその場所（葉の形、幹肌）を見るだけで確定できます。 在庫の台帳の樹種の名前と食い違っていれば、確認の表で並べて目に入ります。

3つ目は、値をプログラムの側で確かめられることです。 公式の案内では、構文として正しいJSONが返っても、値はアプリの側で検証するよう書かれています。また、minLength・maxLength は生成の制約として効かず、サーバーが取り除くとされています。Python の側で、選択肢の外の値、候補が3つ以上、確からしさの抜けを確かめ、外れたものは「再実行」として確認の表に印を付けます。

確認の表は、1鉢1行で次の列を持ちます。 管理番号、写真へのリンク、台帳の樹種、Gemini の候補1と確からしさ、候補2、樹形、鉢の形・色・釉薬・足、見どころの候補、確かめること、担当者が確定した樹種、担当者が測った高さと幅、店主の価格、確定の印です。左がAIの見立て、右が人の確定、という並びにしておくと、どこを人が決めたかが列で分かります。

システムへ連携する

通販サイトとモールへの登録は、この構成から自動では行いません。 下書きを直して登録するのは担当者です。確定の印が付いていない行からは、下書きも作りません。 Python の側で、確定の印と寸法と価格がそろった行だけを2回目の処理に回します。

人が確認する

1. 確からしさの低い鉢から見る … 「低い」「判断できない」の鉢を店主に回します
2. 樹種を実物で確定する … 候補の根拠に書かれた場所（葉・幹肌・芽）を実物で見ます。台帳と食い違うときは特に念入りに見ます
3. 樹形と鉢の項目を直す … 正面の向きで樹形の呼び方が変わる鉢は、店主の決めた正面で見直します
4. 寸法を測り、葉の裏と表土を見る … 高さと幅を物差しで測り、写真に写らない葉の裏と鉢の表土を見ます
5. 下書きの見どころを直す … 店が伝えたい見どころに直し、確定した値と食い違う言葉が無いかを読みます

2番目を省かないでください。 樹種の取り違えは、届いた鉢を見たお客様がいちばん最初に気づく誤りです。 手入れのしかたも樹種で変わるので、取り違えたまま説明に書くと、お客様の手入れまで誤らせます。

3番目の正面の見直しは、盆栽ならではの確認です。 同じ鉢でも、正面を少し回すだけで幹の流れが変わり、模様木に見えたものが斜幹に見えることがあります。 Gemini は渡された「正面」の写真を正面として読むので、札の向きと写真の正面がずれていれば、樹形の値もずれます。 確認の表の写真のリンクを開き、札が正面に写っているかを最初に見ます。

目標は、120鉢をならして1鉢6分です。 確からしさが「高い」で台帳と一致する鉢は3〜4分、店主に回す鉢や撮り直しの鉢は10分以上かかります。

例外に対処する

上から3行目までが大半を占めます。 どれも Gemini の精度の問題ではなく、撮り方と季節の問題です。 撮影台と背景と5方向の決まりを守るほうが、指示を工夫するより効きます。

記録を残す

• 管理番号ごとの5枚の写真と、送ったときの大きさ
• Gemini が返したJSONの全文と、送った日時
• 担当者が確定した樹種・樹形・鉢の値と、Gemini の候補と違ったところ
• 測った寸法と、店主の価格
• 商品説明の下書きと、担当者が直した最後の文
• 撮り直しになった鉢と、その理由

3つ目の「候補と違ったところ」は、指示と選択肢の一覧を直す材料になります。 同じ樹種の組み合わせでいつも取り違えるなら、指示に見分けの手がかりを書き足すか、その樹種は最初から店主に回す決まりにします。