施設運用は、資産、アラート、作業指示、現場点検、エネルギー記録、施設分析、証拠パックをレビューするための共通 AI ツール面を使います。
Agent ワークフローまたはバックエンド連携が、利用可能なツールとレビュー経路を把握する必要がある場合に使用します。
ツール層
| 層 | 主な利用者 | アクセス境界 | 出力 |
|---|
/mcp/base/ MCP tools | Agent クライアント、copilot、ワークフローオーケストレーター | base.read、base.compute.run、選択的な base.action.write scope | 資産コンテキスト、文書、状態サマリー、データ品質、分析出力、アクションドラフト |
/api/v1/ai/* backend proxy | 施設運用 UI とバックエンドサービス | 製品サービス認証とテナント権限 | エネルギー分析、設備知識、ナレッジグラフレビュー、根因と影響サマリー |
/ai/* AI Engine endpoints | 施設、SmartFM、エネルギー、FMS ワークフロー | 製品サービス認証とワークフロー権限 | エネルギープロファイル、ベンチマーク、Advisor chat、VAV 診断、チラー効率、作業指示テキスト抽出、シミュレーション結果 |
/api/v1/* module APIs | 施設運用 UI とバックエンド連携 | 製品 RBAC scope | 作業指示、worker タスク、点検、read model、資産センター、モデル資産、energy、FMS、ESG、Green Mark 証拠 |
MCP endpoint と scope
| Endpoint | Scope | 用途 |
|---|
/mcp/base/ | base.read | 資産コンテキスト、設備状態、文書、connector 状態、コンプライアンスファイル、ワークフロータスク、action plan 履歴を読み取ります。 |
/mcp/base/ | base.compute.run | 承認済みの energy、spatial、forecast、anomaly、simulation、optimization、report generation を実行します。 |
/mcp/base/ | base.action.write | 責任者が提案を承認した後に作業指示ドラフトを作成します。 |
初期 Agent ワークフローは読み取り専用から開始します。承認、監査、ロールバックの扱いが決まった後に書き込み scope を追加します。
MCP ツールマップ
| 領域 | 主なツール |
|---|
| 運用コンテキストと証拠 | get_equipment_status, get_equipment_documents, search_documents, query_knowledge, get_action_plan_history, get_pending_tasks, get_compliance_documents |
| データと connector readiness | list_connectors, check_data_quality, troubleshoot_connector, import_data |
| 施設分析 | calculate_emissions, analyze_spare_parts, forecast_timeseries, detect_anomaly, generate_report |
| 空間レビュー | analyze_spatial_anomaly, compare_zones, recommend_sensor_placement, find_path |
| アクションドラフト | create_work_order |
create_work_order は、正しい write scope があり、オペレーターがアクション文、オーナー、場所、資産、優先度、証拠参照を承認した後に使用します。
AI Engine とバックエンド proxy
| Endpoint | 目的 | 準備する入力 | レビューする出力 |
|---|
/api/v1/ai/energy/analyze, /ai/energy/analyze | 施設または設備のエネルギー値を分析します。 | メーター mapping、時間窓、資産コンテキスト、運用スケジュール、天候または負荷コンテキスト。 | 異常メモ、提案、炭素推定、証拠参照。 |
/api/v1/ai/energy/profile, /ai/energy/profile | 設備エネルギープロファイルを作成します。 | 設備 ID、最近の値、基準期間、設備種別、運転モード。 | プロファイル、典型範囲、異常指標、推奨確認。 |
/ai/advisor/chat | 施設管理アシスタント会話を実行します。 | 質問、テナント、資産またはアラート、証拠断片。 | 回答ドラフト、ツール利用履歴、欠けている証拠、次の確認。 |
/api/v1/ai/graph/root-cause | ナレッジグラフから根因候補をレビューします。 | アラート、資産、関連システム、点検結果、作業記録。 | 根因候補と根拠パス。 |
/ai/hvacops/vav/diagnostics/summary | VAV 診断状態をまとめます。 | VAV 値、設定値、風量、温度、時間窓。 | 診断サマリー、影響ゾーン、エンジニアリング確認。 |
/ai/hvacops/chiller/efficiency | チラー効率をレビューします。 | チラー負荷、COP、外気条件、運転状態、設備メタデータ。 | 効率サマリー、比較メモ、運用レビュー入力。 |
推奨ツールシーケンス
| シーン | 推奨経路 |
|---|
| 日常運用トリアージ | list_connectors -> check_data_quality -> get_equipment_status -> 文書検索 -> generate_report |
| アラートから作業指示 | get_equipment_status -> query_knowledge -> get_action_plan_history -> 根因レビューまたは Advisor -> 承認後に作業指示 |
| エネルギーと ESG レビュー | list_connectors -> check_data_quality -> /ai/energy/profile または /ai/energy/analyze -> calculate_emissions -> report |
| Green Mark 証拠準備 | compliance documents -> expiring documents -> document search -> data quality -> evidence pack |
| FMS 診断レビュー | equipment status -> equipment documents -> knowledge query -> VAV または chiller diagnosis -> maintenance summary |
データ要件
- 安定した tenant、site、floor、zone、space、equipment ID。
- BMS、CMMS、点検、メーター、ESG、証拠システムの source-system ID。
- タイムスタンプ付きのセンサー値、メーター値、アラート、点検記録、作業指示更新。
- ソース鮮度と DFS 品質メモ。
- 設備マニュアル、SOP、図面、保全記録、コンプライアンス証拠。
- メーター単位、炭素係数、料金前提、天候コンテキスト、運用スケジュール。
- 空間コンテキストが必要な場合の model asset と twin-model binding ID。
出力レビュー
- tenant、site、asset、meter、source-system ID が見える。
- ソースデータを使う場合は connector 状態と鮮度が含まれる。
- 作業指示と点検記録に owner、status、timestamp、audit reference がある。
- energy と carbon 出力に assumptions、time window、unit、source mapping がある。
- Green Mark または ESG 証拠は、承認前は内部レビューに留める。
- アクションドラフトは承認済み作業指示と分けて扱う。
関連ドキュメント