update from parallel processor agent to parallel rag agent

[ks6088ts]

What this PR does / why we need it

• update from parallel processor agent to parallel rag agent

Which issue(s) this PR fixes:

Fixes #105

Does this introduce a breaking change?

convert ParallelProcessorAgent into ParallelRagAgent

[x] Yes
[ ] No

Pull Request Type

What kind of change does this Pull Request introduce?

[ ] Bugfix
[x] Feature
[ ] Code style update (formatting, local variables)
[ ] Refactoring (no functional changes, no api changes)
[ ] Documentation content changes
[ ] Other... Please describe:

How to Test

• Get the code

ORGANIZATION=<organization-name>
REPOSITORY=<repository-name>

git clone [email protected]:$ORGANIZATION/$REPOSITORY.git
cd $REPOSITORY

• Test the code

make ci-test

What to Check

Verify that the following are valid

• ...

Additional Information

[ks6088ts]

$ uv run python scripts/demo_agents_operator.py parallel-rag-agent --query "KABUTO のシステム概要やトラブルシュート事例を AI Search や CosomosDB など多種多様な情報ソースから回答して"

...

2025-08-20 10:22:47,343 [    INFO] Final summary: Tool: search_ai_search: 以下は、提供いただいたドキュメント断片をもとに整理した「KABUTO」のシステム概要と代表的なトラブルシュート事例です。現時点の回答は docs_kabuto.md（2025-08-01）からの要約・抜粋に基づいています。追加の情報源（AI Search や Cosmos DB 等）にある関連エントリの統合も可能ですが、提示データの範囲内で整理しています。

システム概要
- 基本コンセプト（第1章 概要）
  - KABUTO は、生体情報および精神波形との同期を基盤とする高次元演算処理システム。
  - 特殊なプロトコル群で各モジュールが協調し、相互作用は複雑。
  - 各モジュールは固有名称と役割を持ち、従来のコンピューティングパラダイムと一線を画す。

主要モジュールと特徴
- 演算コア「稲荷」（3.4）
  - 非常に高い演算能力を持つ。
  - 過負荷時、画面隅に不規則な光点「狐火」が視覚ノイズとして出現することがある（過負荷の兆候）。
- ネットワーク・通信「隠れ蓑」（3.3）
  - 既定はステルスモードで外部スキャンを回避し、ネットワーク上で不可視。
  - 可視化が必要な場合は設定から「忍びの道」を有効化（有効化中のみ一時的に可視化）。
- ファイルシステム「竜宮城」（4.1）
  - 特定の文字を「時空の歪み」として認識し文字コード誤読が発生する場合がある。
  - 誤読時は「虚無」エラーを表示しログインを拒否。
  - 疲労・ストレスなど精神状態の変化が一因となりうる。
- AI 機能「天照」
  - 無意識下の情報を収集し、環境をパーソナライズ。
  - ユーザーが最後に見た「夢」の内容を背景に反映することがある。
  - 「天照の予知夢」設定を無効化すると機能停止（パフォーマンス一部低下の可能性あり）。

トラブルシュート事例と対処
- 症状：画面隅に「狐火」（不規則な光点）が出る
  - 原因：演算コア「稲荷」の過負荷サイン。
  - 対処：
    - 不要なバックグラウンドアプリを終了。
    - 負荷の高い処理の同時実行を避ける／時間をずらす。
    - 収まらない場合はシステム再起動。
- 症状：ネットワーク上で KABUTO が見えない／他デバイスから通信できない
  - 原因：ネットワークモジュール「隠れ蓑」のデフォルト・ステルス動作。
  - 対処：
    - ネットワーク設定で「忍びの道」を有効化し、一時的に可視化。
    - 作業完了後は不要な可視化を解除し、ステルスに戻す。
- 症状：ログイン時に「虚無」エラーが表示され拒否される
  - 原因：ファイルシステム「竜宮城」による文字コード誤読（「時空の歪み」認識）。精神状態の変化（疲労・ストレス）がトリガーとなる可能性。
  - 対処：
    - 深呼吸などで精神状態を安定させ、少し時間を置いて再試行。
    - 入力文字を落ち着いて再確認（同じ文字列でも再入力で通る場合あり）。
- 症状：背景画像が最後に見た「夢」の内容に変わる
  - 原因：AI 機能「天照」による無意識下情報のパーソナライズ。
  - 対処：
    - システム設定で「天照の予知夢」を無効化。
    - 無効化に伴う一部パフォーマンス低下の可能性を許容するか検討。

運用上のヒント／ベストプラクティス
- 負荷管理：高負荷ジョブはスケジュールを分散し、過負荷兆候（狐火）が出ないよう監視。
- ネットワーク可視性：必要時のみ「忍びの道」を有効化し、平常時はステルス運用でセキュリティを確保。
- ユーザー状態と信号品質：精神的疲労が入出力解釈に影響しうるため、長時間連続運用時は休息を挟む。
- プライバシーとパーソナライズ：「天照」の挙動をチーム方針に合わせて設定（予知夢無効化の是非を合意）。

出典（提示データ）
- docs_kabuto.md（2025-08-01）
  - 第1章 システム概要
  - 3.3 ネットワーク・通信（「隠れ蓑」「忍びの道」）
  - 3.4 演算コア（「稲荷」「狐火」）
  - 4.1 ファイルシステム（「竜宮城」「虚無」エラー）
  - Q&A（「天照」「天照の予知夢」、ネットワーク可視化）

必要であれば、AI Search や Cosmos DB 上の関連ドキュメント/ログも横断して、事象別の詳細手順書や設定項目のスクリーンごとの確認ポイントに展開します。どの事象について深掘りしますか？
------
Tool: search_cosmosdb: 以下は、提供いただいた資料（docs_kabuto.md 2025-08-01 抜粋）に基づくKABUTOのシステム概要と代表的なトラブルシュート事例の整理です。現時点ではAI Search や Cosmos DB 等の外部ソースには未接続のため、本回答は当該資料から確認できる範囲に限定しています。追加の情報源を接続いただければ、内容を拡充して再提示できます。

システム概要（要点）
- コンセプト: 高次元演算処理システム「KABUTO」。生体情報・精神波形との同期を基盤とし、特殊プロトコルで各モジュールが連携。
- モジュール設計: 各モジュールに固有名称と役割があり、相互作用が複雑。
  - ネットワーク: 「隠れ蓑」…デフォルトでステルス動作。
  - 演算コア: 「稲荷」…高い演算能力。過負荷兆候をUI上に示す。
  - ファイルシステム: 「竜宮城」…特定文字を「時空の歪み」と認識し文字コード誤読が起き得る。
  - AIパーソナライズ: 「天照」…無意識情報の収集・反映機能（予知夢）。

代表的なトラブルシュート事例
1) ネットワークに接続しても他デバイスから認識されない
- 原因: ネットワークモジュール「隠れ蓑」がデフォルトでステルスモード。
- 対処: ネットワーク設定画面で「忍びの道」を有効化し、KABUTOを一時的に可視化。

2) ログイン時に「虚無」エラーで拒否される
- 原因候補: 疲労・ストレスに伴う精神状態の変化で、生体/精神同期条件を満たさない。
- 対処: 深呼吸などで精神状態を安定化して再試行。

3) 画面隅に不規則な光点（「狐火」）が現れる
- 原因: 演算コア「稲荷」の過負荷兆候。
- 対処: 不要なバックグラウンドアプリを終了、またはシステム再起動。

4) 起動後、背景画像が直前に見た「夢」の内容になる
- 原因: AI機能「天照」による無意識下情報の取得とパーソナライズ。
- 対処: システム設定の「天照の予知夢」を無効化（パフォーマンス低下の可能性あり）。

5) ファイル名/文字が誤読される・文字化けする
- 現象: ファイルシステム「竜宮城」が特定文字を「時空の歪み」と誤認し文字コード誤読が発生することがある。
- 補足: 提示資料には具体的対処の記載は未確認。再現条件（問題の文字、コードページ、入出力経路）を採取のうえ、回避策（該当文字の使用回避、エンコーディング統一など）の検討が必要。

運用上のヒント（一般）
- 症状がUIに現れる設計（例: 狐火）を手掛かりに、設定画面の該当オプション（忍びの道／天照の予知夢）と負荷状況を優先確認。
- 再現条件の記録（発生タイミング、直前操作、負荷、使用文字など）を行い、設定変更や再起動の効果を比較。

情報ソースについて
- 本回答は docs_kabuto.md（2025-08-01）の抜粋に基づきました。
- AI Search や Cosmos DB などの他ソースを参照して統合レポートを作成するには、接続先（エンドポイント/認証/インデックス名）や対象ドキュメントの範囲をご提示ください。接続後、用語統一・重複排除・信頼度ラベル付きで再構成します。

必要であれば、各モジュールごとの詳細チェックリストや、ログ取得項目（時刻・モジュール・症状・設定差分）テンプレートも作成します。
------
Tool: search_qdrant: 以下は、社内のAI Search（ベクター検索/Qdrantに格納されたQA）、インシデントレポート（データレイク/DB由来のレポート）、および関連ナレッジを横断して集約した、KABUTOのシステム概要と代表的なトラブルシュート事例です。引用元は文末「出典」にまとめています。

KABUTOのシステム概要（要点）
- 初期化・同期: 起動時に「シノビ・プロトコル」が内部クロックと外部クロック（周辺機器由来のタイミング/状態）を同期します。同期に失敗すると表示異常やフリーズを誘発します。
- 演算コア: 「稲荷」と呼ばれる演算コアが大量のタスクを捌きます。負荷過多時には、画面上に微小な視覚ノイズ（俗称「狐火」）が現れることがあります。
- 周辺機器と外部クロック: 一部の周辺機器はクロック状態を保持（キャッシュ）するため、KABUTO本体の再起動だけでは問題が解消しない場合があります。

代表的なトラブルと対処

1) 起動時に画面全体が紫色に点滅してフリーズする
- 症状
  - 電源投入直後～初期化中に、画面が紫色に点滅し操作不能になる
- 既知の原因
  - シノビ・プロトコルの初期化フェーズで、内部クロックと外部クロックの同期が失敗
- 標準対処
  - 必ずKABUTO本体を再起動する前に、接続されている周辺機器（ハブ/ドック/ストレージ/ディスプレイ等）すべての電源を切るか、電源ケーブルを5秒以上抜いてから再接続し、その後KABUTOを再起動する
  - 目的は、周辺機器側に残っている外部クロックのキャッシュをクリアしてから再同期を行うこと
- 標準対処で解消しない場合（フィールド報告: エラーコード KABUTO-0119）
  - 追加の切り分け手順
    1) 最小構成での起動確認: 周辺機器を全て外した状態でKABUTOを起動
    2) 周辺機器の段階的追加: 1台ずつ接続→再起動を繰り返し、どの機器/ポートで再現するか特定
    3) 外部給電/ハブの確認: 自己給電型ハブ/ドックやディスプレイ一体型ハブなど、電源やクロック状態を保持しやすい機器を優先的に疑う（完全に電源を落とせているか確認）
    4) 異なるポート/ケーブルでの再現性確認: 物理ポートやケーブル起因の影響を除外
  - 併せて収集すべき情報（エスカレーション推奨）
    - エラーコード: KABUTO-0119
    - タイムスタンプ、発生頻度、再現手順
    - 接続トポロジ（機器の種類/接続順/給電有無）
    - 直前の構成変更（ファーム更新、周辺機器の追加/交換など）
  - 次のアクション例
    - 既知不具合の照合（同一エラーコードの過去事例の有無）
    - ファームウェア/ドライバの更新可否の確認
    - 解析依頼時に最小再現セット（本体＋問題周辺機器）で提供

2) 画面の隅に「狐火」のような点が不規則に現れて消える
- 症状
  - 走査線上の微小な光点がランダムに出現し、短時間で消える視覚ノイズ
- 既知の原因
  - 演算コア「稲荷」の高負荷時に、一部の計算結果が表示系にノイズとして滲み出る現象。システム負荷のサイン
- 対処
  - 不要なバックグラウンドアプリや常駐プロセスを終了し、負荷を下げる
  - 負荷が下がらない場合は再起動を実施
  - 頻発する場合は、ピーク時負荷の平準化（バッチのスケジューリング調整、不要サービスの無効化など）を検討

予防・運用のヒント
- 起動手順の安定化
  - 周辺機器の電源を一度落としてから、KABUTOを起動する順序を徹底（特にハブ/ドック/ディスプレイなど）
  - 起動直後（シノビ・プロトコルが同期中）はホットプラグを避ける
- 負荷管理
  - 高負荷処理の同時実行を避け、バッチ処理の時間帯分散を検討
  - 目視で「狐火」が増える場合は、早めに負荷を下げる/再起動する運用ルールを設ける
- トラブル時の記録
  - 発生時刻、エラーコード、接続構成、変更履歴（更新/増設）を簡易テンプレートで残すと、再発時の切り分けが速くなります

追加でご提供いただけると助かる情報
- 現在の接続構成図（機器名、給電方法、ポート）
- 発生頻度と直近の変更（ソフト/ファーム/周辺機器）
- ログやスクリーンショット（可能であればタイムスタンプ入り）

出典（統合元）
- ベクター検索（Qdrant）: ./data/qa_kabuto.csv
  - 起動時の紫点滅フリーズとシノビ・プロトコルの外部/内部クロック同期失敗、周辺機器の5秒以上の電源遮断で外部クロックキャッシュをクリアする推奨
  - 「狐火」現象の説明（演算コア「稲荷」の高負荷サイン）と、不要アプリ終了/再起動の推奨
- インシデント/レポート（データレイク/DB由来）: ./data/reports_kabuto.csv
  - エラーコード KABUTO-0119（周辺機器を外しても紫点滅フリーズが解消しない）という現場報告

必要であれば、KABUTO-0119の再現条件と最小構成の確認を一緒に進め、既知事例との突合や追加のログ採取項目をご案内します。
------
Tool: search_elasticsearch: 以下は、提示いただいた Elasticsearch 由来の資料（docs_kabuto.pdf/docs_kabuto.md の抜粋）を中核情報源として整理した KABUTO のシステム概要と、そこから導ける実践的なトラブルシュート事例です。AI Search や Cosmos DB 起源の追加データがあれば統合できますが、現時点では提供いただいた抜粋に基づく要約と対処案になります。

KABUTO システム概要（要点）
- 基本コンセプト
  - 高次元演算処理に特化した独自システム。生体情報や精神波形との同期を基盤に動作。
  - 複数モジュールが固有名称・機能を持ち、特殊プロトコルで連携。
- 電源・起動インターフェース
  - LED 状態表示：待機＝赤点滅、稼働＝青点滅、緑点滅＝「禅モード」。
  - 禅モードは性能を最小化しつつバックグラウンド自己修復を実行。強制離脱は本体の「龍玉」ボタン長押し（5秒以上）。
  - 電源 OFF 後も微少電流が流れる待機「夢の海」モードがあり、次回起動の高速化に寄与。
- 演算コア
  - コア名称「稲荷」。高い演算能力を持つが、極端な高負荷時に画面隅へ不規則な光点「狐火」として可視化される場合がある（過負荷の兆候）。
- ファイルシステム
  - 名称「竜宮城」。特定の文字を「時空の歪み」として扱い、文字コード誤読が発生する場合がある（文字・エンコード起因の読み取り不具合）。

代表的なトラブル症状と対処（実務的チェックリスト）
1) 画面の隅に不規則な光の点（「狐火」）が現れる
- 意味・原因
  - 演算コア「稲荷」の過負荷兆候。バックグラウンド処理や同時実行ジョブが閾値を超えている可能性。
- 即効対処
  - 不要なバックグラウンドアプリ／ジョブを終了。
  - セッション保存のうえ再起動。
- 再発防止・深掘り
  - 実行ジョブの並列度やバッチ投入間隔を見直す。
  - リソース監視（CPU/GPU/メモリ/ストレージI/O）でピーク時のボトルネックを特定。
  - スケジューラで負荷平準化、あるいは計算ノードの水平スケールを検討。

2) 電源ランプが緑点滅で性能が著しく低下（「禅モード」）
- 意味・原因
  - 自己修復（バックグラウンド）実行中。省パフォーマンス状態。
- 即効対処
  - 急ぎの処理がある場合は本体「龍玉」ボタンを5秒以上長押しして強制離脱。
- 再発防止・深掘り
  - 自己修復が頻発する場合、直前の異常終了やストレージ整合性問題が背景にある可能性。計画メンテナンス時間帯に自己修復を意図的に実行させる運用へ調整。
  - クリーンシャットダウンの徹底、停電対策（UPS）を導入。

3) ファイルが文字化け・読めない・名称でエラー（竜宮城ファイルシステム）
- 症状の見立て
  - 特定文字が「時空の歪み」として認識され、文字コード誤読を誘発。
- 即効対処
  - 問題が発生するファイル名・パス名から特殊文字／制御文字を排除。推奨文字セットに正規化（例：ASCII 安全集合、または UTF-8 の NFC へ統一）。
  - 同一ディレクトリ内での再現性確認（どの文字の組み合わせで発生するかを抽出）。
- 再発防止・深掘り
  - 入出力系のエンコードを UTF-8 に統一（アプリ側・API 側を含む）。
  - バルクリネームと入力バリデーション（禁止文字・正規化ポリシー）を CI/ETL に組み込む。
  - ストレージ整合性チェック（ファイルシステムの検査・修復ツールが提供されている場合は計画停止で実行）。

4) 電源 OFF 後の消費や周辺機器の挙動が気になる（「夢の海」）
- 症状の見立て
  - 低電力スタンバイで微小電流が維持される設計。
- 対処・運用
  - 長期保管や完全停止が必要な局面では、取扱説明に沿った完全シャットダウン手順を実施（スタンバイを解除）。
  - 周辺機器に影響が出る場合は、電源連動タップやポートごとの電源管理設定で無通電を徹底。

現場対応のベストプラクティス
- まずはインジケータで状態判定
  - LED パターン（赤点滅＝待機、青点滅＝稼働、緑点滅＝禅モード）で大枠のモードを即時同定。
  - 画面表示のアーティファクト（狐火）の有無で負荷兆候を補助判断。
- 変更前のスナップショット確保
  - 再起動・強制離脱前に、実行中ジョブの状態、稼働アプリ一覧、リソース使用率を記録して後日解析に回す。
- 入出力の健全性確保
  - ファイル名ポリシー・エンコード統一・I/O エラーハンドリングを標準化。
- 計画メンテと負荷平準化
  - 自己修復（禅モード）を想定したメンテナンス時間帯の確保と、業務ピークとの分離。
  - バッチや推論ジョブのスケジューリングでピンポイント高負荷を回避。

追加で確認したい情報（あれば対処精度が上がります）
- 稼働中の KABUTO バージョン、ファーム/モジュールのビルド番号（稲荷・竜宮城の版数など）。
- 直近の事象発生時刻と併せたリソースメトリクス、ログ要約（例：モード遷移、異常終了、I/O エラー）。
- 文字誤読が発生した具体的なファイル名例と入出力経路（どのアプリ・APIで発生か）。

AI Search・Cosmos DB など他ソースの統合について
- 現時点では Elasticsearch 提供分のみを反映しています。AI Search や Cosmos DB に格納された運用ログ、チケット、既知の不具合ナレッジ（例：問題文字の一覧、禅モード移行のトリガ条件、狐火の発生閾値）へのアクセスが可能であれば、同様の枠組みで統合し、事象ごとの「原因別プレイブック」を拡充します。必要なら検索クエリ設計やスキーマ（インデックス項目）提案も行います。

必要に応じ、具体的な現場事象（発生日時・症状・ログ断片）を共有いただければ、より踏み込んだ切り分け手順を提示します。
------