動物園の飼育員が動物の様子の変化から、過去の飼育日誌・治療・繁殖の記録を検索し、似た事例と当時の対応を根拠付きで引く

処理の起点を決める

飼育員がタブレットの「様子の変化」の画面で「送信」を押したことを起点にします。 獣舎の前で、気づいたその場で送れば、事務所に戻るころには確認の画面ができています。

検索は、入力1件につき1回、答えを作ります。 答えを見て「去年の同じ時期はどうだったか」と問い直したいときは、確認の画面で問いを足して、同じ会話として続けます。公式ページでは、answer メソッドは前のセッションを引き継いで続けて問うことができるとされています。

毎日の日誌そのものは、トリガーにしません。 日誌には毎日すべての動物の様子が書かれます。全部を検索に流すと、変化の無い日の記述まで答えが作られます。 調べるのは、飼育員が「いつもと違う」と判断して入力したものだけにします。

入力データを集める

質を決めるのは、いちばん下の一覧です。 「タロウ」「タロウ（♂）」「アジアゾウ1号」を、個体の識別の番号（例：EM-003）1つにそろえます。 変化の種類も、「食い落ち」「採食低下」「残餌多い」を「採食の低下」という1つの名前にそろえます。報告の画面は一覧から選ぶ形にし、日誌の古い言葉は一覧の別名に入れます。

個体の台帳には、種のほかに、性別と生年を持たせます。 同じ変化でも、若い個体と高齢の個体では意味が違うことがあります。確認の画面に当時の年齢を並べると、見比べがしやすくなります。

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

日誌は、個体ごとの1日の記述を1つの文書にして入れます。 公式ページでは、非構造のデータのメタデータは JSON Lines（NDJSON）のファイルで、各行に id、structData、Cloud Storage の文書を指す content の uri を持たせるとされています。structData に種・個体・記録の種類・日付・月・変化の種類を入れ、絞り込みに使う項目はスキーマで「インデックス可能」にします。

日誌の1件は、たとえば次の1行の JSON にします。

{"id": "diary-2023-0614-EM-003",
 "structData": {"doc_kind": "diary", "species": "アジアゾウ", "animal_id": "EM-003",
                "sex": "雄", "date": "2023-06-14", "month": 6,
                "change_type": ["採食の低下"], "area": "ゾウ舎", "keeper": "K-12"},
 "content": {"mimeType": "text/plain", "uri": "gs://<bucket>/diary/2023/diary-2023-0614-EM-003.txt"}}

本文のファイルには、その日のその個体の記述をそのまま入れます。 絞り込みは structData、意味での検索は本文で行います。治療と繁殖の記録にも同じ species・animal_id・date を持たせ、3つの記録を同じ条件で絞れるようにします。

手書きの日誌のスキャンの PDF は、レイアウトの解析を有効にして入れます。 公式ページでは、スキャンなど文字として検索できない PDF には、データストアを作るときにレイアウトの解析を有効にすることが勧められています。RAG に使うので、文書の分割（チャンク）も有効にします。手書きの文字がどこまで検索に掛かるかは、自園の日誌で試してから範囲を決めます。 読めない年代の日誌は、検索の対象から外し、確認の画面に「この年代は原本を見る」と出します。

AIへ渡す前に整形する

1. 日誌の分割 … 担当区域の1日の日誌を、個体ごとの記述に分けます。個体の名前と別名の一覧で、どの行がどの個体かを決めます
2. 個体の識別の番号へのそろえ … 名前・別名・旧い呼び名を、台帳の識別の番号に置き換えます
3. 変化の種類のそろえ … 一覧の名前に置き換え、日誌の古い言葉は別名で吸収します
4. 絞り込みの条件の組み立て … 種は完全一致、記録の種類は日誌・治療・繁殖の3つ、個体は「同じ個体」と「同じ種の全個体」の2回に分けて問い合わせます
5. 問い合わせ文の組み立て … 「変化の種類」「様子の文」「いまの季節と月」「個体の年齢」を短い文にします
6. 写真と動画の扱い … 写真と動画は検索に使わず、確認の画面に並べるだけにします

4番目で2回に分けて問い合わせるのは、同じ個体の記録を先に見せるためです。 同じ個体の過去の記録がいちばん効く材料です。同じ個体の記録が見つからないときに、同じ種の別の個体の記録が次の材料になります。 2つの答えを混ぜず、確認の画面でも別の枠に並べます。

絞り込みの条件は、たとえば次のようになります（公式ページの書き方による）。

species: ANY("アジアゾウ") AND animal_id: ANY("EM-003")
AND doc_kind: ANY("diary", "treatment", "breeding")
AND date >= "2006-01-01"

季節の癖を見たいときは、月で絞ります。 公式ページでは、数値の項目は IN で範囲を指定でき、既定では下限を含み、上限を含まないとされています。6月前後を見るなら month: IN(5, 8) で5月から7月になります。

AIに処理させる

answer メソッドにさせるのは、絞り込んだ記録の中から、いまの変化に似た過去の記述を探し、当時の対応とその後の経過を引用付きで短くまとめることです。 原因を言い当てることはさせません。

「経過の記録なし」を書かせるのが、この表でいちばん大事な行です。 日誌には対応だけが書かれ、その後どうなったかが書かれていないことがよくあります。経過が無いまま「同じ対応で戻った」と補われると、根拠の無い安心が生まれます。

指示内容を固定する

answer メソッドでは、回答の口調や詳しさをプロンプトの前置き（preamble）で指定できます。前置きを次のようにします。

あなたは動物園の飼育課の記録係です。飼育員から届いた「様子の変化」について、
検索で見つかった自園の飼育日誌・治療の記録・繁殖の記録だけを根拠に、
次の順で短く答えてください。

1. 似た過去の記述（日付、当時の年齢、様子の文を原文の言葉のまま）
2. そのときの対応（記録に書かれていることだけ）
3. その後の経過（何日で戻ったか、別の変化につながったか）
4. 同じ時期の治療の記録・繁殖の記録があれば、その日付と要点

守ること：
- 原因や病名を推し量らないでください。
- 対応、投薬、麻酔、移動、隔離を勧めないでください。
- 経過が記録に無いときは「経過の記録なし」と書き、補わないでください。
- 検索結果に無いことを書かないでください。見つからなければ「該当なし」としてください。
- 一般的な動物の知識や、別の種の話で補わないでください。
- 体重・量・回数などの数値と単位は、原文の表記のまま写してください。

「経過の記録なし」と書かせる指示を明記しないと、経過が補われます。 対応が書かれていると、生成の側は「その後回復した」と続けがちです。書かれていないことを書かれていないと返させることが、この前置きの要です。

あわせて、answer メソッドの設定を次のようにします。

公式ページでは、filteringLevel を入れなければ支持の度合いによる絞り込みは掛からないとされています。入れ忘れると、支えの弱い答えもそのまま出ます。 支えが足りずに答えが作られなかったときは、応答の answerSkippedReasons にその理由が入ります。

出力形式を固定する

中継プログラムが、answer メソッドの応答を次の形にそろえて確認の画面に渡します。

{
  "report_id": "",
  "animal_id": "",
  "query": "",
  "filter": "",
  "scope": "same_animal | same_species",
  "answer_text": "",
  "support_score": 0.0,
  "citations": [
    { "sentence": "", "doc_kind": "", "date": "", "animal_id": "", "quote": "" }
  ],
  "similar_cases": [
    { "date": "", "age_then": "", "change_type": "", "action": "", "outcome": "", "doc_id": "" }
  ],
  "skipped": false,
  "skipped_reason": ""
}

1つ目の理由は、citations の quote に原文を切り出して持てることです。 公式ページでは、引用の位置（startIndex・endIndex）は文字数ではなく UTF-8 のバイト単位とされています。日本語は1文字が複数のバイトなので、文字数で切り出すと位置がずれます。 中継プログラムで、回答の文をバイト列にしてから切り出します。

2つ目は、scope で同じ個体の答えと同じ種の答えを分けて持てることです。 確認の画面では、同じ個体の答えを上に、同じ種の別の個体の答えを下に、別の枠で並べます。混ぜると、別の個体の経過を、いまの個体の経過のように読んでしまいます。

3つ目は、similar_cases の outcome を空のまま持てることです。 経過の記録が無いものは空で並べ、「経過の記録なし」と画面に出します。 空であることが、そのまま次の記録の書き方を見直す材料になります。

確認の画面は、たとえば次のように並べます。

【様子の変化】アジアゾウ EM-003（雄・32歳）採食の低下／朝の乾草を半分残す
【同じ個体の似た事例】
  2023-06-14（29歳）乾草を残す。青草に切り替え → 4日で戻る … 原文を開く
  2020-06-20（26歳）採食の低下。獣医が口腔内を確認 → 経過の記録なし … 原文を開く
【同じ時期の別の記録】2023-06-16 治療の記録 … 原文を開く
【同じ種の別の個体】（別の枠）2019-07-02 EM-001 … 原文を開く
【支持の度合い】0.xx

同じ個体の事例を年齢つきで並べるのは、見比べの手がかりにするためです。 同じ6月に3回採食が落ちているなら、季節の癖かもしれないと考えるきっかけになります。 そう判断するかどうかは、係長と獣医が決めます。

システムへ連携する

日誌と治療の記録への書き込みは、飼育員と獣医が確かめてから行います。 中継プログラムは下書きを作るまでにします。個体の記録は、動物の一生を通じて読み返される記録です。 確かめられていない文が混ざると、次の担当者がそれを根拠に判断します。

データストアへの記録の出し入れは、飼育課の記録の担当だけが行います。 日誌は週に1回、確定した分をまとめて分割し、メタデータを付けて入れます。個体が死亡したり、他園へ移ったりしても、記録は消しません。同じ種の別の個体の材料として残します。

人が確認する

1. 引用の原文を開いて読む … 答えの文だけで判断しません。当時の記述の前後の日も見ます
2. いまの様子と当時の様子を見比べる … 年齢、季節、群れの状況が当時と同じかを確かめます
3. 同じ個体の事例と同じ種の事例を分けて読む … 別の個体の経過を、いまの個体に当てはめません
4. 相談のメモを作って係長と獣医に上げる … 根拠の記録の箇所をメモに付けます
5. 獣医が診て判断する … 検査や治療に進むかは、ここで決めます

1番目を省かないでください。 答えの文は短くまとめられていて、前後の日の記述が落ちていることがあります。 「4日で戻る」の前日に何があったかは、原文を開けば数十秒で分かります。

目標は、240件をならして1件8分です。 引用の原文を読み、いまと当時を見比べて、相談のメモを作る時間です。探す時間がほぼ無くなり、読む時間と見比べる時間が残ります。

例外に対処する

「検索を待たずに獣医へ」は、画面の上にも常に出しておきます。 倒れている、出血している、呼吸が荒い。こうしたときに記録を調べる必要はありません。この構成は、急がない変化の調べものを短くするものです。

記録を残す

• 様子の変化の入力（個体、変化の種類、様子の文、日時、人）
• 問い合わせ文、絞り込みの条件、answer メソッドの応答の全文（引用、参照、支持の度合い）
• 確認の画面に出した答えと、外した文
• 飼育員の相談のメモ、係長と獣医の判断、参照した過去の記録の箇所
• データストアに記録を入れた日と、その範囲

4つ目が、いまは残っていない記録です。 どの過去の記録を見てどう判断したかが、日誌とひもづいて残ります。次の担当者が同じ変化を見たとき、前回の判断の筋道まで追えます。

5つ目は、答えの検証のために残します。 答えが最近の記録を拾わなかったのは、似ていなかったのか、入れるのが遅れていたのかを、入れた日と並べて確かめられます。 記録の担当は月に1回、外した文と「該当なし」の件数を見て、分割の規則や変化の種類の一覧を直します。