メインコンテンツまでスキップ

アーキテクチャ

PlantPulse AI が何で構成され、なぜそのように分かれているのかを説明します。ポート一覧はサービスポートマップ、インストール手順はインストールにあります。

全体構成​

                        브라우저 (HTTPS · SSE)
                               │
                    ┌──────────▼──────────┐
                    │  plantpulse-proxy   │  ← 사용자 접점 (80 · 443, 콘솔 HTTPS 5960)
                    │  Host 로 뒷단을 고른다 │
                    └───┬──────────────┬──┘
           admin.* · 5960│              │그 외
     (평문 5959 는 직결) ▼              ▼
              ┌──────────────┐   ┌──────────────────────────────────┐
              │  관리 콘솔    │   │  코파일럿 (묻기·제안·자동화)       │
              │ admin-web    │   │  에이전트 루프 · 도구 호출          │
              │  + admin-api │   └───┬────┬────┬────┬────┬───────┬──┘
              └──────────────┘       │    │    │    │    │       │
                                     ▼    ▼    ▼    ▼    ▼       ▼
                                   시계열  RAG  문서  비전  디지털  모델
                                   인사이트     이해        스레드  게이트웨이
                                     │     │     │          │       │
                                     ▼     ▼     ▼          ▼       ▼
                                   추론  LightRAG docling    전용     vLLM
                                   서버  +Qdrant            Neo4j   임베딩·리랭커
                                        +Neo4j

ユーザーが触れる入口はプロキシです。 コパイロット(質問・提案・自動化)も管理コンソールも各 API も、すべてその背後にあります — ファイアウォール・TLS・監査を一箇所にまとめるためです。例外は管理コンソールの平文入口(5959)で、社内網から IP で接続する運用者のためにコンソールコンテナへ直接つながります → サービスポートマップ

七つの系統に分かれています​

各系統は関門(API)と重量級のワーカーが対になっています。関門は軽量でポリシーを持ち、ワーカーは GPU を使います。この分離により、ワーカーを別の機器へ移したり台数を増やしたりしても関門のアドレスは変わりません。

系統関門ワーカー役割
チャットコパイロット—人が使う画面(質問・提案・自動化)・エージェントループ・ツール呼び出し・SSE ストリーミング
時系列インサイト API推論サーバー異常検知・予測 (TSPulse · TTM)
文書検索RAG APILightRAGインデックス作成・ハイブリッド検索
文書理解文書理解 APIdoclingPDF・表・数式を markdown へ
ビジョンビジョン APILLM エンジン(vLLM 直結)・docling計器読み取り・欠陥検査・OCR
モデルLiteLLMvLLM・埋め込み・リランカーチャット・管理コンソール・外部呼び出しのモデル窓口
デジタルスレッドデジタルスレッド API専用 Neo4j外部システム(MES・SCM・ERP・PLM・QM)コネクタ登録簿・工場グラフのミラー・設備タイムライン
デジタルスレッドは GPU を使いません

2026.10 でスタックに標準搭載された系統です。Platform の設備・タグ台帳とイベント、外部システムが提供する作業指示・部品・人員を参照のみ集約し、一つのグラフ(ミラー)としてつなぎます。運用者は管理コンソールのデジタルスレッドレーンでコネクタを接続し、質問と自動化は thread_ ツールで設備タイムラインと接続を読み取ります — コパイロットに専用画面はなく、能力だけが増えます → デジタルスレッド

管理コンソールは何も判定しません

管理コンソールの画面(admin-web)は静的ファイルであり、ログイン判定と状態集計は背後の admin-api が行います。認証の正本は一箇所だけという意味です。

クエリ一件が処理される順序​

「3라인 압축기 요즘 어때?」
   │
   ① 이름을 ID 로 바꾼다              search_domains        (플랫폼 통합 MCP)
   ② 무엇을 볼지 고른다                — 에이전트가 도구를 고른다
   ③ 데이터를 가져온다                 insight_analyze_asset · get_tag_history …
   ④ 필요하면 문서·사진을 더 본다        rag_search · vision_inspect
   ⑤ 모아서 답을 만든다                LiteLLM ─▶ Aura
   │
   └─▶ SSE 로 한 글자씩 화면에 흘린다

②–④ は一度で終わりません。 エージェントはツールの結果を見て次のツールを選ぶことを繰り返します — 「なぜ応答が遅いのか」の答えがこれであり、「なぜツールを有効にしておく必要があるのか」の答えでもあります。

🔴 無効のツールはエージェントから見えません。 何が最初から有効で何が無効かは → MCP ツールマップ

モデル — 呼び名は四つです​

モデルゲートウェイ(LiteLLM)は OpenAI 互換 API で社内モデルを公開します。呼び名は四つだけです。

呼び名接続先実際のモデル
aura-lite社内 LLM エンジンAura (既定 Aura-Lite-NVFP4) — テキスト・画像兼用
aura-vision同一エンジン — ビジョン用エイリアス上と同じモデル
aura-embedding-4b埋め込みエンジンAura-Embedding-4B
aura-reranker-0.6bリランカーエンジンAura-Reranker-0.6B
旧名称 gpt-4o · text-embedding-3-large は廃止されました

以前は OpenAI 互換エイリアス(gpt-4o · gpt-4o-mini · text-embedding-3-large · rerank-multilingual-v3.0)で呼んでいました。現在は互換エイリアスを用意していません — 旧名称で呼ぶとゲートウェイが即座にエラーで拒否します。外部連携スクリプトや設定に旧名称が残っている場合は、上表の名称に変更してください。

aura-vision は «別のビジョンモデル» ではありません

Aura 自体が画像を読み取ります。aura-vision は呼び出す側が意図を名前で示せるようゲートウェイが付けたエイリアスであり、どちらの名前で呼んでも同じエンジンが応答します。

すべての呼び出しがゲートウェイを通るわけではありません

チャット(コパイロット)・管理コンソール・外部から呼ぶ /llm/ はゲートウェイを経由します。LightRAG・ビジョン API・時系列インサイト API は vLLM に直接接続します。そのため、これらはゲートウェイのエイリアス(aura-vision)ではなく vLLM が公開する名称(aura-lite)を使います — 「ゲートウェイのログにビジョン呼び出しが出ない」のは故障ではありません。

Aura はオープンソースのファウンデーションモデルに製造・産業データを追加学習させた自社モデルです → Aura LLM · AI モデル

データの所在​

🔴 AI スタックは自前のデータベースを別途立てません。 リレーショナル・時系列・キャッシュ・オブジェクトはPlatform のものを共用します。 AI 専用として残っているのはグラフ・ベクトルストアだけです。

ストア所有格納内容
PostgreSQLPlatform 共用設定・チャット履歴・文書インデックス状態・コネクタ登録簿 (DB pi のスキーマ co · dt など)
Aster TSDBPlatform 共用時系列センサー値・推論履歴
RedisPlatform 共用キャッシュ・セッション
RustFSPlatform 共用文書・画像
QdrantAI 専用文書埋め込み(ベクトル)
Neo4jAI 専用文書ナレッジグラフ
Neo4j (デジタルスレッド専用)AI 専用工場グラフのミラー — 参照のみ、原本から再生成可能
Neo4j はオントロジーではなく «文書グラフ» です

設備オントロジーは Platform が保持し、統合 MCP で提供します。ここでの Neo4j は文書検索が使うグラフです — 以前はオントロジー専用サービスが別にありましたが、Platform に統合されました。デジタルスレッドのミラーは別インスタンスに置き、互いに混在しないようにしています。

Platform が停止すると AI も停止します

データを共有するということは、Platform がそのまま依存対象であることを意味します。「AI が応答しない」の確認順序は ① Platform が稼働しているか ② モデル(ゲートウェイ・LLM エンジン)が応答するか ③ ツールが有効か です → トラブルシューティング

資産階層は Platform のものに従います​

データツールは ISA-95 / OPC-UA ベースの階層で対象を指定します。

Enterprise ─ Site ─ Area ─ Line ─ Equipment ─ Tag ─ Point
엔터프라이즈 사이트   구역   라인    설비      태그   시계열 값

「3ラインのコンプレッサー」といった表現がこの階層のどのノードを指すのかを特定することが、クエリの最初のステップです。写真・文書ツールはこの階層とは無関係に動作します。

可観測性と閉域網​

構成要素役割
Phoenixエージェントの 1 ターンがどのツールをどの順序で呼んだかを追跡する
DCGMGPU 使用率・温度・メモリ指標
内部レジストリ閉域網でイメージを内部から取得できるようにする

→ モニタリング · 閉域網インストール

関連文書​