試験と観察で撮った写真から、所見の下書きと撮り直しが要る写真を出す

処理の起点を決める

共有フォルダに写真が保存されたときを起点にします。

撮影の直後に処理が走ることが、この構成の要です。 不備の検出は、その場で撮り直せる時点で伝えなければ意味がありません。顕微鏡のPCから自動で同期されるフォルダを使ってください。

理想は、撮影から5分以内に結果が返ることです。 研究員がまだ試料を手元に持っている間に「スケールが写っていません」と伝われば、撮り直せます。

もう1つの起点として、試験の終了時があります。 その試験で撮った写真をまとめて処理し、報告書に載せる候補を提示します。 ここは急ぎません。夜間の処理で構いません。

再処理の入口も用意してください。 所見の型を更新したときに、過去の写真を処理し直せる形にしてください。

過去の写真の一括処理は、最初に1回だけ行います。 直近1年分を処理して、比較の土台を作ります。枚数が多いため、費用を見積もってから実行してください。

入力データを集める

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

所見の型が、この構成の質を決めます。 自由に書かせると、人による違いがそのまま残ります。次の形で持ってください。

「使う語彙」の列が、表現をそろえます。 4〜5段階の決まった語から選ばせることで、人による違いがなくなります。「微細な」「わずかな」「軽微な」が混在する状態を解消できます。

「程度の目安」を数値で書いてください。 「部分的」がどれくらいかを人によって違う感覚で判断されると、語彙をそろえた意味がありません。

「書いてはいけないこと」の列が、この構成では特に重要です。 所見は観察の記述であって、原因の推定ではありません。「腐食による変色」と書くと、それがそのまま報告書の結論になってしまいます。

撮影の基準も、次の形で整理してください。

「確認すること」が、不備の検出の基準になります。 これを書かないと、何を不備とするかが決まりません。

過去の写真： 同じ試料・同じ部位のものを紐づけます。ファイル名の規則がそろっていないと紐づきません。 この構成を入れる前に、命名の規則を決めてください。

過去の所見： 表現をそろえる材料になります。直近1年の報告書から、所見の文を100件ほど抜き出してください。 良い例として渡します。

AIへ渡す前に整形する

1. 画像の形式の確認 … JPEG、PNG、GIF、WebP のいずれかにします。顕微鏡のソフトが独自形式で出す場合は変換が要ります
2. 寸法の調整 … 1リクエストに20枚を超える画像を含めるなら、各辺を2000ピクセル以下に縮小します。 縮小するとスケールバーの目盛りが読めなくなることがあるため、縮小前に読み取るか、20枚以下に分けるかを選びます
3. Files API へのアップロード … 比較に使う画像は、アップロードして file_id で参照します
4. 試験の情報の紐づけ … ファイル名か、撮影の記録様式から試料名と条件を取ります
5. 過去の写真の取得 … 同じ試料・同じ部位の直近2回分を取ります
6. ラベルの付与 … 複数枚を渡すとき、それぞれの前に「Image 1: 今回の断面」のような短いラベルを置きます

2の寸法の調整には、この構成に特有の悩みがあります。 縮小すると、スケールバーの目盛りや微細な欠陥が見えなくなります。一方、縮小しないと20枚を超えるリクエストで上限に触れます。

対処は2つです。 1つは、1回のリクエストに渡す画像を、今回1枚と過去2枚の計3枚に絞ること。 もう1つは、細部を見る用に切り出した部分画像を別に渡すこと。 前者を基本にしてください。

Claude は画像を28×28ピクセルの区画（視覚トークン）で見ます。 画像のコストは ⌈幅/28⌉ × ⌈高さ/28⌉ の視覚トークンになります。モデルごとに最大の解像度が決まっており、それを超える画像は処理前に縮小されます。 縮小されると文字が読みにくくなるため、あらかじめ適切な大きさに調整しておくほうが確実です。

AIに処理させる

2つの工程に分けます。

（1）撮影の不備の検出

（2）所見の下書き

合否も原因も判定させません。 「不合格」「密着不良が原因」といった記述を禁じてください。

数値も出させません。 「膜厚は約12マイクロメートル」「ピットの深さは0.3ミリメートル」といった値を生成AIに出させないでください。測定は測定装置と画像解析のソフトで行います。

個数も数えさせないでください。 公式の説明でも、物体の個数について「おおよその数は示せるが、常に正確とは限らない。特に小さな物体が多数ある場合は精度が落ちる」とされています。ピットの個数を数えさせる使い方は避けてください。

指示内容を固定する

あなたは材料の試験・観察の記録を支援する担当者です。
写真に見えている状態を、所見の型に沿って記述することが役割です。

【厳守事項】
- 合否を判定しないでください。
  「合格」「不合格」「基準を満たす」と書かないでください。
- 原因を推定しないでください。
  「腐食による」「密着不良が原因」「熱処理の不足と考えられる」と書かないでください。
  見えている状態だけを書いてください。
- 数値を出さないでください。
  膜厚、深さ、面積、粒径などの値を書かないでください。
  測定は測定装置で行います。
- 個数を数えないでください。
  「ピットが12個」と書かないでください。
  「複数のピットが認められる」までにとどめてください。
- 下の「所見の型」の語彙だけを使ってください。
  型にない表現で書かないでください。
- 位置は、観察面を基準に書いてください。
  「左下約2割」「中央付近」のように、割合か位置で示してください。
- 写真から判断できないことは「この写真からは判断できない」と書いてください。
  推測で補わないでください。
- 撮影の不備は、下の「撮影の基準」に照らして判定してください。
  一般的な写真の良し悪しで判定しないでください。
- 前回の写真と比べるときは、撮影の条件（倍率・照明・角度）が
  同じかどうかを先に確かめてください。
  条件が違う場合、違いが状態の変化によるものか撮影によるものかは
  判断できないと明記してください。
- 人物が写っている場合、その人が誰かを述べないでください。

【試験の情報（試料名 / 材質 / 処理条件 / 試験条件 / 経過時間）】
{test_info}

【撮影の情報（種類 / 倍率 / 照明 / 部位）】
{shot_info}

【所見の型（観察の項目 / 見る順序 / 使う語彙 / 程度の目安 / 書き方の例 / 書いてはいけないこと）】
{observation_template}

【撮影の基準（種類 / 必須 / 確認すること）】
{shooting_standard}

【過去の所見の例（良い書き方の見本）】
{past_observations}

Image 1: 今回の写真
Image 2: 前回の同じ部位（撮影日 {prev_date}）
Image 3: 前々回の同じ部位（撮影日 {prev2_date}）

「原因を推定しない」の指示が、この構成でもっとも重要です。 所見に原因が書かれると、それが報告書の考察へそのまま流れます。考察は研究員が、他の測定結果と合わせて行うものです。

「数値を出さない」も妥協できません。 生成AIが出した「約12マイクロメートル」が報告書に載ると、測定していない数値が測定結果として扱われます。

「個数を数えない」の指示は、公式の説明に基づくものです。 個数の推定は正確とは限らず、小さな物体が多数あるときは特に外れます。 ピットや介在物の数は、画像解析のソフトで数えてください。

「撮影の条件が同じかを先に確かめる」の指示は、比較の場面で効きます。 倍率が違う写真を並べて「進行している」と書かれると、誤った結論になります。

「人物が誰かを述べない」の指示も入れてください。 公式の説明で、画像に写った人物の名前を挙げることには対応しておらず、求められても応じないとされています。試験の写真に手元が写ることがあるため、明記しておくほうが安全です。

出力形式を固定する

{
  "photo_id": "",
  "file_name": "",
  "test_id": "",
  "sample_name": "",
  "shot_type": "appearance | cross_section | surface | wear_track",
  "magnification": "",
  "defects_in_shot": [
    { "type": "focus | exposure | scale_missing | label_missing | framing | lighting", "detail": "", "severity": "high | low" }
  ],
  "retake_required": false,
  "observations": [
    {
      "item": "",
      "term": "",
      "location": "",
      "sentence": "",
      "confidence": "high | medium | low",
      "not_determinable": false
    }
  ],
  "comparison": {
    "conditions_match": true,
    "condition_note": "",
    "changes": [ { "item": "", "direction": "increased | decreased | unchanged | undeterminable", "sentence": "" } ]
  },
  "recommended_for_report": false,
  "recommendation_reason": "",
  "notes_for_researcher": []
}

Claude API で出力をスキーマに沿わせるには、output_config の format に json_schema を指定します。 古い output_format は非推奨です。

スキーマには制約があります。 required と additionalProperties: false は使えますが、minimum / maximum / minLength / maxLength といった数値・文字列の制約は使えません。 enum は文字列・数値・真偽値・null に限られます。再帰的なスキーマにも対応していません。

最初にスキーマを使うときは、文法のコンパイルに時間がかかります。 結果は24時間キャッシュされますが、スキーマの構造やツールの構成を変えるとキャッシュが無効になります。 所見の型を頻繁に変える運用では、この待ち時間が出ることを踏まえてください。

retake_required が、この構成でいちばん早く効くフィールドです。 撮り直しが要ると分かれば、その場で撮り直せます。

confidence を所見ごとに持たせている点が実務では重要です。 「変色が認められる」の確からしさと、「微細な割れが認められる」の確からしさは違います。低い所見は研究員が必ず確かめます。

conditions_match を比較の中に置いている理由があります。 撮影の条件が違えば、比較の結論は出せません。false のときは changes を undeterminable にして、条件の違いを condition_note に書きます。

not_determinable のフラグも要ります。 「断面の樹脂に気泡があって、その部分は判断できない」という状態を表せます。

システムへ連携する

報告書への自動反映は行いません。

撮り直しの通知だけは、急いで届けてください。 撮影から時間が経つと、試料が処分されたり状態が変わったりします。Teams への通知は、この1点に限って即時にしてください。

所見の自動記録はしません。 研究員が確認して、電子実験ノートへ記録します。AIが書いた文がそのまま記録に残ると、確認されないまま報告書へ流れます。

ファイル名の整形は自動で構いません。 試料名・条件・部位・倍率の規則に沿って付け直します。ここは判断が要らない機械的な処理です。

画像は処理後に残りません。 公式の説明では、アップロードした画像はリクエストの処理の間だけ保持され、処理後に自動的に削除されるとされています。自社の記録としては、共有フォルダの原本を保管してください。

人が確認する

研究員の確認は必ず残します。

確認を速くするための設計が効きます。

• 写真と所見の下書きを並べて表示する
• confidence が低い所見に印を付ける
• 前回・前々回の写真を並べて表示する
• 所見の型の語彙を選択肢として出す（直すときに使う）
• 直した内容を記録する

4つ目が効きます。 研究員が所見を直すとき、自由入力だと型から外れた表現に戻ります。語彙を選択肢で出せば、直しても表現がそろいます。

5つ目は、この構成を育てる材料になります。 どの項目で、どう直されているかが分かれば、所見の型か指示を直せます。

「判断」の記述は、研究員が書き足します。 所見が「観察面の左下約2割に褐色の変色が認められる」なら、その意味（試験条件との関係、次に何を見るか）は研究員が書きます。 この構成は、そこへ至る前の整理までです。

例外に対処する

最後の項目は、明確に線を引いてください。 公式の説明でも、一般的な医療画像の分析はできるが、CTやMRIのような複雑な診断画像の解釈を想定した設計ではなく、出力を専門的な医療上の助言や診断の代わりとみなすべきではないとされています。非破壊検査の合否判定など、資格や認定に基づく判断にも使わないでください。

記録を残す

この記録は、所見の型と撮影の基準を育てる材料になります。

• 処理した写真と、そのときの試験の情報
• 検出した撮影の不備と、撮り直しの有無
• 所見の下書きと、研究員が直した後の文
• confidence と、直された頻度の関係
• 比較の結果と、撮影の条件の一致・不一致
• 報告書に載せる候補と、実際に載った写真
• 所見の型に足した語彙

「下書きと直した後の文」を必ず両方残してください。 どこが直されているかが、この構成の改善点そのものです。特定の観察の項目で毎回直されているなら、その項目の語彙か目安に問題があります。

「confidence と直された頻度の関係」も見てください。 high なのに毎回直されているなら、確からしさの判定が当てになりません。その場合は、すべての所見を人が見る扱いに変えてください。

試験の写真には、未公開の技術情報が含まれます。 試料の形状、処理の条件、内部の構造。外部のAIサービスへ渡してよいかを、知財部と確認してください。

保存期間は、試験記録の保存期間に合わせてください。 顧客へ提出した試験結果の根拠となる写真は、長期の保存が求められることがあります。