機器マニュアル・エージェント

役割

Manual Agent は調査ごとに2回呼ばれる唯一のエージェントです。フェーズ1では、621ページの PureBallast 3.1 マニュアル全体に広く網をかけ、観測されたアラームや症状に対する文書化されたあらゆる原因を見つけ出します。フェーズ2では、IOT Manager が最も可能性の高い原因を確定した後、Manual Agent が再度呼ばれ、深掘り — 各確定原因に対する具体的な修復手順、安全警告、予備部品、検証ステップを抽出します。

ヒント

フェーズ1 = 広さ(関連する可能性のあるものすべてを返す)。フェーズ2 = 深さ(確定原因のみに対する具体的手順)。

---

2フェーズ・ワークフロー

graph TB
    subgraph "Phase 1 — Broad Cause Search"
        direction TB
        P1A["Search Alarm List\n(p.217-241)"]
        P1B["Search Troubleshooting\n(p.271-283)"]
        P1C["Process Description\nCross-Check"]
        P1D["Broader Search\n(if results are thin)"]
        P1E["Compile ALL Causes\nUNFILTERED"]

        P1A --> P1B --> P1C --> P1D --> P1E
    end

    subgraph "IOT Manager"
        MGR["Cross-Reference &\nConfirm Causes"]
    end

    subgraph "Phase 2 — Targeted Remediation"
        direction TB
        P2A["Find Remediation\nProcedure per Cause"]
        P2B["Extract Step-by-Step\nActions"]
        P2C["Extract Safety Warnings\nVERBATIM"]
        P2D["Note Tools & Spares"]
        P2E["Manual Section\nReferences"]
        P2F["Post-Remediation\nVerification Steps"]

        P2A --> P2B --> P2C --> P2D --> P2E --> P2F
    end

    P1E -->|"All possible causes"| MGR
    MGR -->|"Confirmed causes only"| P2A

    style P1A fill:#0d1b2a,stroke:#1b9aaa,stroke-width:2px,color:#fff
    style P1B fill:#0d1b2a,stroke:#1b9aaa,stroke-width:2px,color:#fff
    style P1C fill:#0d1b2a,stroke:#1b9aaa,stroke-width:2px,color:#fff
    style P1D fill:#0d1b2a,stroke:#1b9aaa,stroke-width:1px,color:#fff
    style P1E fill:#1a1a2e,stroke:#e94560,stroke-width:3px,color:#fff
    style MGR fill:#1a1a2e,stroke:#0f3460,stroke-width:3px,color:#fff
    style P2A fill:#0d1b2a,stroke:#1b9aaa,stroke-width:2px,color:#fff
    style P2B fill:#0d1b2a,stroke:#1b9aaa,stroke-width:2px,color:#fff
    style P2C fill:#0d1b2a,stroke:#e94560,stroke-width:2px,color:#fff
    style P2D fill:#0d1b2a,stroke:#1b9aaa,stroke-width:2px,color:#fff
    style P2E fill:#0d1b2a,stroke:#1b9aaa,stroke-width:2px,color:#fff
    style P2F fill:#0d1b2a,stroke:#1b9aaa,stroke-width:2px,color:#fff

---

知識源

ソース	形式	スコープ
PureBallast 3.1 Manual	621 markdown pages (page_0001.md – page_0621.md)	完全なメーカー・マニュアル — アラーム、トラブルシューティング、手順、技術データ
Keyword Index	keywords.json	高速検索のための、用語からページ番号への事前構築インデックス
Master Index	master.json	セクション見出しとページ範囲を持つ構造化目次
Maritime Document Collections	22 indexed collections	補足的な海事規則、船級協会ガイドライン、技術通達

---

マニュアル主要セクション

セクション	ページ	内容
Alarm List	p.217 – p.241	すべてのアラームコード、説明、可能な原因、初期アクション
Troubleshooting	p.271 – p.283	症状ベースのトラブルシューティング・ツリーと判定経路
Process Descriptions	各所	各サブシステムの動作 — UV処理、ろ過、CIP、薬注
CIP Procedures	p.161 – p.163	Clean-In-Place サイクル・ステップ、化学濃度、タイミング
Technical Data	p.285 – p.293	定格値、しきい値、許容差、仕様

---

フェーズ1プロセス — 広域原因検索

1. アラームリストを検索

   特定のアラームコードをアラームリスト(p.217–241)で検索します。そのアラームについて記載されているすべての文書化原因、説明、初期アクションを抽出します。アラートがアラームコードではなく症状ベースの場合、症状記述で検索します。

2. トラブルシューティングを検索

   同じアラームまたは症状について、トラブルシューティング・セクション(p.271–283)を検索します。トラブルシューティング・ツリーには、アラームリストでカバーされていない追加原因 — 二次的および連鎖故障モードを含む — が記載されていることがよくあります。

3. プロセス記述の相互チェック

   影響を受けたサブシステムのプロセス記述を読み、通常の動作挙動を理解します。文書化された通常状態を報告された異常と比較し、プロセス記述から含意されるがアラームやトラブルシューティング・セクションに明示的に記載されていない原因を特定します。

4. 広域検索(結果が薄い場合)

   最初の3ステップの結果が2件未満の可能性原因しか得られない場合、621ページのマニュアル全体と22の索引化された海事文書コレクションに検索を拡大します。キーワード・インデックス検索と広範な用語マッチングを使ってエッジケースを補足します。

5. すべての原因をコンパイル — フィルタなし

   認識される可能性に関わらず、見つかったすべての可能な原因を返します。この段階では、原因をランク付け、フィルタリング、除外しません。相互参照と確信度スコアリングは IOT Manager が行います — Manual Agent の仕事は網羅性です。

ノート

フェーズ1は意図的に網羅的です。「おそらく無関係」な原因を返すことは、結果的に根本原因となった原因を省略するよりも常に良いです。何を捨てるかは IOT Manager に任せてください。

---

フェーズ2プロセス — 標的型修復

1. 修復手順を見つける

   IOT Manager から受領した各確定原因について、マニュアル内で具体的な修復手順を見つけます。アラーム・アクション、トラブルシューティング解決策、保全手順セクションを検索します。

2. 手順別アクションを抽出

   マニュアルから完全な手順別修復手順をコピーします。元の順序、番号付け、条件分岐(例:「ステップ3後に圧力が高いままならステップ7に進む」)を保持します。

3. 安全警告を抽出 — 一字一句

   修復手順に関連するすべての安全警告、注意、危険通知を見つけます。マニュアル内に書かれているとおり正確に — 書式、強調、参照コードを含めて — コピーします。

4. 工具と予備部品を記録

   手順に記載されたすべての工具、予備部品、消耗品、特殊機器を列挙します。文書化されている場合は、部品番号と仕様を含めます。

5. マニュアル・セクション参照

   抽出した各情報について、正確なページ番号、セクション見出し、図番号を記録します。これらの参照により、クルーは自分の手元のマニュアルで検証・追跡できます。

6. 修復後の検証

   文書化された検証ステップを抽出します — 修復が成功したかをどのように確認するか。これには修理後の予期されるセンサー読み値、テスト手順、通常運転に戻る前の必須待機時間が含まれます。

安全警告は VERBATIM で引用 — 決して言い換えない

海事の安全警告は法的・コンプライアンス上の重みを持ちます。表現の改変、指示の簡略化、修飾語の省略は法的責任を生じさせ、クルーの安全を脅かす可能性があります。マニュアルが「DANGER: Disconnect power supply before opening the UV chamber. Risk of severe eye and skin burns from UV-C radiation」と書いている場合、その正確なテキストが出力に現れなければなりません。

---

検索技術

Manual Agent は、より広いページ読みに頼る前に、高速・標的型検索のためにキーワード・インデックスを使用します。

# Step 1: Find matching pages via keyword index
search-indexed-documents --query "UV intensity low alarm"

# Step 2: Read the specific pages returned
cat page_0217.md  # Alarm list entry
cat page_0271.md  # Troubleshooting section

# Step 3: If keyword search is thin, broaden
search-indexed-documents --query "UV lamp" --collection "pureballast-manual"
search-indexed-documents --query "UV intensity" --collection "maritime-regulations"

---

ツール

ツール	目的
search-indexed-documents	22 の索引化された海事文書コレクションと PureBallast マニュアルを、キーワード・マッチングとセマンティック検索で横断検索するスキル
直接ファイル読み込み	キーワードまたはマスターインデックスから正確なページ番号が分かっている場合に、特定の markdown ページ(page_0001.md – page_0621.md)を読む
Keyword Index (keywords.json)	高速ナビゲーション用の、検索語からページ番号への事前構築ルックアップ表
Master Index (master.json)	セクションレベル・ナビゲーション用の構造化目次

ノート

search-indexed-documents スキルが主要な入口です。直接ファイル読み込みは、特定のページを全文で読む必要がある場合や、キーワード・インデックスが返したページ番号を文脈の中で精査する必要がある場合のフォローアップとして使用します。

---

してはならないこと

データ分析しない

センサーデータベースを問い合わせない、トレンドを分析しない、テレメトリ値を解釈しない。センサーデータ分析は Data Analysis Agent の責務です。

保全チェックしない

保全スケジュール、作業指示履歴、サービス記録を参照しない。保全データは PMS Agent に属します。

レポート送信しない

クライアント向けレポートを生成しない、メールを送信しない、HTML を整形しない。レポート作成と配信は Report Agent の仕事です。