工場の保全担当が設備の警報コードの意味と復旧・部品交換の手順を、その機種の取扱説明書と過去の保全記録から根拠付きで探す

処理の起点を決める

起点は、保全担当が設備のQRコードを読み、警報の番号を入れたことです。 QRコードには設備番号だけを入れておきます。機種を人に選ばせないのは、第3章の（c）の取り違えを、入力の段階でなくすためです。

もう一つのトリガーは、文書と保全記録の更新です。 新しい設備の導入、制御装置の更新、メーカーからの技術資料の受け取りがあったら、保全課の担当が文書を置き、対象の機種を書きます。保全記録は毎晩書き出して取り込みます。

入力データを集める

質を決めるのは、設備台帳の「該当する文書の番号」の列です。 機種名だけで文書を引くと、型番の末尾が違う別の機種の文書が当たります。設備ごとに、どの取扱説明書・どの部品表が当てはまるかを、保全課が一度だけ確かめて書きます。

保全記録は「実際の原因」の欄が埋まっているものだけを取り込みます。 「リセットして復帰」とだけ書かれた記録は、次の人の役に立たないうえ、リセットで済むという誤った印象だけを回答に持ち込みます。

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

文書は1冊ずつ、保全記録は1件ずつファイルにして Cloud Storage に置きます。公式では、非構造化データは TXT・JSON・Markdown・PDF・HTML・DOCX・PPTX・XLSX・XLSM に対応し、1ファイルの上限は200MBです。メタデータは JSON Lines で、1行ごとに id、structData、content（mimeType と uri）を書きます。

{"id":"man-imm-a200-r3","structData":{"doc_kind":"manual",
 "maker":"MK-07","models":["A200","A200S"],
 "controllers":["CT-5"],"revision":"第3版","lang":"ja"},
 "content":{"mimeType":"application/pdf",
 "uri":"gs://equip-docs/man-imm-a200-r3.pdf"}}

問い合わせのたびに、中継プログラムが設備台帳から絞り込みの条件を作ります。 公式の構文では、文字の項目は ANY() に並べた値のどれかと完全に一致するかを見られ、AND／OR で組み合わせられます。

(models: ANY("A200S") AND controllers: ANY("CT-5"))
OR equipment_id: ANY("EQ-1-0412")

機種と制御装置の両方で絞るのは、同じ機種でも制御装置の更新で警報の番号が変わるからです。 保全記録は同じ設備のものを含めます。項目はスキーマで索引可能にしておかないと絞り込みに使えません。

AIへ渡す前に整形する

1. 文書に対象の機種と制御装置を付ける … 表紙と「適用機種」の頁から書きます。1冊が複数の機種にまたがるなら全部並べます
2. 設備台帳に文書の番号を書く … 設備ごとに、当てはまる取扱説明書・部品表を保全課が確かめて書きます
3. スキャンした文書の読み取りを確かめる … 古い紙の説明書は、警報の一覧の頁だけでも、読み取った文字を担当が目で確かめます
4. 保全記録を整える … 「実際の原因」が空の記録を外し、作業者の名前を外します
5. 工程と警告の文の目録を作る … 警報ごとの処置の頁について、工程の数と、警告・注意の囲みの文を書き出しておきます
6. 英語の説明書に印を付ける … lang を en にし、回答で原文を併記するようにします

5番目の目録は、第5章の4番目の照合に使います。 回答に入った工程が目録より少なければ、落ちた工程があるということです。 目録は、警報の多い設備から作ります。

3番目を省くと、警報の番号そのものが読み違えられます。 スキャンの「8」と「6」、「0」と「D」の読み違いは、別の警報の頁を引く原因になります。

AIに処理させる

させるのは、その設備に当てはまる文書と保全記録から該当箇所を探し、警報の意味・手順・部品・過去の対応を引用して並べることです。

手順の要約を禁じるのは、短い回答ほど危ないからです。 「熱電対のコネクタを挿し直す」は、説明書では「ヒータの電源を切る」「温度が下がるのを待つ」の後の工程です。要約すると、最後の工程だけが残ります。

過去の対応は、説明書の手順の後に置きます。 保全記録の「実際の原因」は役に立ちますが、そこに書かれた処置は、そのときの担当が説明書の手順のどこから始めたかまでは書いていません。過去の対応を手順の代わりに読むと、準備の工程を飛ばした作業がくり返されます。 回答では説明書の手順を先に出し、過去の対応は「どこを疑うか」の手がかりとして後に並べます。

answer メソッドの設定は次のようにします。

指示内容を固定する

answer メソッドの preamble に、次の指示を入れます。

あなたは工場の保全課の担当として、設備に警報が出たときに、
その設備の取扱説明書・保全マニュアル・部品表と過去の保全記録から
該当箇所を示す立場です。読むのは設備の前にいる保全担当です。

【前提】
検索の文の最初に、設備番号、メーカー、機種、制御装置、警報の番号が
並んでいます。検索の対象は、その設備に当てはまる文書と、
同じ機種・同じ設備の保全記録だけです。

【答え方】次の順に並べてください。
1. 警報の意味：警報の一覧の行を、番号・表示文・原因・処置のまま写す
2. 安全上の注意：手順の頁にある警告・注意の文を、原文のまま全部写す
3. 手順：復旧・点検・交換の手順を、番号の順に全部写す
4. 部品：部品表の品番・名称・図の番号を写す
5. 過去の対応：同じ設備・同じ警報の保全記録の日付、処置、実際の原因
それぞれに文書の名前と頁を付けてください。

【厳守事項】
- 手順を要約したり、工程をまとめたり、省いたりしないでください。
- 警告・注意の文を言い換えたり、短くしたりしないでください。
- 検索結果に無い文書、別の機種の文書で答えないでください。
- 品番は部品表に書かれたとおりに写し、推測で書かないでください。
- 作業してよいか、運転を続けてよいかを判断しないでください。
- 説明書に「販売店・メーカーに連絡」とあれば、そのまま写してください。
- 英語の文書は、原文を写したうえで日本語の訳を添えてください。
  安全上の注意は原文を先に置いてください。
- 該当する記述が見つからないときは、
  「この設備の文書に該当する記述は見つかりませんでした」
  とだけ書いてください。

「販売店・メーカーに連絡」をそのまま写させるのは、保全担当が手を出してはいけない警報があるからです。 制御装置の内部の異常や、安全回路の故障の警報には、説明書が自分で直さず連絡するよう書いていることがあります。AIが気を利かせて処置を補うと、その一文が消えます。

出力形式を固定する

answer メソッドの返り値と照合の結果を、中継プログラムが次の形にまとめます。

{
  "inquiry_id": "",
  "equipment_id": "",
  "model": "",
  "controller": "",
  "alarm_code": "",
  "meaning": { "quote": "", "doc": "", "page": "" },
  "safety_notes": [ { "quote": "", "doc": "", "page": "", "restored": false } ],
  "steps": [ { "no": 1, "quote": "", "doc": "", "page": "" } ],
  "parts": [ { "part_no": "", "name": "", "in_parts_list": true, "stock": 0, "location": "" } ],
  "history": [ { "date": "", "action": "", "root_cause": "" } ],
  "flags": []
}

restored は、AIの回答に無く、目録から中継プログラムが補った警告の文に true を付けます。補った文があることは、画面の一番上に表示します。

flags は次の規則で立てます。

JSONにする理由は、照合をプログラムで行うためです。 文章の回答だけでは、工程が全部入っているか、品番が部品表にあるかを機械で数えられません。steps を工程ごとの要素にしておけば、目録の工程の数とそのまま比べられます。

システムへ連携する

タブレットの画面では、引用ごとに元のPDFの該当頁へのリンクを付けます。 公式では、データストアに画像があれば answer メソッドが回答に画像を返すことができ、引用を求めれば参照にも画像が返るとされていますが、図は元の頁で見るほうが確実です。

設備の制御装置と保全管理の仕組みには書き込みません。 復旧の操作も保全記録の入力も人が行います。

人が確認する

この構成では、回答はすべて保全担当が読みます。 回答をもとに作業するかを決めるのは、設備の前にいる保全担当です。

1. flags を先に見る … safety_restored と vendor_call があれば、その表示を最初に読みます
2. 引用元の頁を開く … 手順は回答の文ではなく、リンク先の頁で確かめます
3. 運転を止めてから作業する … 手順に運転の停止や錠の掛け方があれば、そのとおりにします
4. 保全記録に実際の原因を入力する … 説明書の原因と違っていたら、そのことを書きます

2番目を省かないでください。 回答の手順は引用ですが、読み取りや取り込みの誤りで、頁の内容と違っている可能性は残ります。 作業の根拠は元の頁に置きます。

運用を始めて1か月は、保全課のリーダーが毎日、前日の問い合わせから10件を選び、引用が正しい頁を指しているかを確かめます。

例外に対処する

4行目で品番を消すのは、存在しない品番で予備品を探したり、発注したりしないためです。

10行目の技術資料は、説明書より新しい手順です。 メーカーが不具合の対策として手順や部品を変えると、技術資料だけが届き、説明書は改訂されないことがあります。説明書の手順を先に出すと、直されたはずの手順で作業することになります。 技術資料を取り込むときは、どの警報・どの手順を置き換えるものかをメタデータに書いておきます。

記録を残す

• 問い合わせの内容（設備番号、警報の番号・表示文、状況）、保全担当、日時
• answer メソッドへの要求（絞り込みの条件、preamble の版）と返り値の全文
• 照合の結果（flags、補った警告の文、部品表との照合）
• 保全担当が開いた引用元の頁（開かずに閉じた回答も記録する）
• 引用した文書の版と、目録の版
• 後日入力された保全記録との対応（問い合わせの番号で結ぶ）

最後の行は、回答が役に立ったかを測るためです。 回答の処置と実際の処置が違う警報が続くなら、説明書と現場の実態がずれています。 保全記録を整えて取り込むほど、次の回答が実態に近づきます。