このガイドは、施設、キャンパス、工場、ユーティリティエリア向けの AI Agent ワークフローを構築するためのものです。DataMesh Inspector が利用するデジタルツインと運用記録を同じ文脈として使い、アセット状態の確認、アラーム理解、点検準備、作業指示ドラフトの作成を支援します。
前提条件
| 要件 | 詳細 |
|---|
| アセットコンテキスト | FactVerse Platform のアセット階層、サイト、フロア、エリア、設備 ID、担当チーム、権限境界。 |
| 運用記録 | Inspector のアラーム、点検メモ、作業指示、チェックリスト、メーター値、現場フィードバック。 |
| データパイプライン | DFS または顧客側コネクタが提供する信号タイムスタンプ、品質フラグ、ソースシステム参照。 |
| 空間コンテキスト | アセットの位置と周辺システムを確認するための Designer シーンまたは Inspector 可視化。 |
| アクセス制御 | ワークフローに必要な最小 endpoint と scope を持つ API key。 |
Endpoint と scope
/mcp/base/ から開始します。
| Scope | 用途 |
|---|
base.read | アセットコンテキスト、文書、状態、履歴記録、関連エビデンスを読み取ります。 |
base.compute.run | エネルギー計算、ルール評価、運用サマリー生成など承認済み分析を実行します。 |
base.action.write | オペレーター承認後にアクションドラフトを作成または更新します。 |
最初のバージョンは読み取り専用にします。顧客側で承認経路と監査記録が定義された後に、書き込み scope を追加します。
ワークフロー手順
- 運用境界を設定する：テナント、サイト、エリア、アセット群、対象期間、オペレーターの役割を確認します。
- アセットを解決する：ユーザー要求を Platform のアセット ID に対応付け、該当する Inspector 記録を確認します。
- エビデンスを収集する：現在状態、最近のアラーム、点検、作業指示、文書、ソースタイムスタンプを取得します。
- 空間コンテキストを使う：Designer または Inspector シーンでアセット位置を確認し、影響を受ける可能性がある周辺設備を確認します。
- サマリーを作成する：確認済み事実、考えられる原因、不足エビデンス、推奨される次の確認を分けて記述します。
- アクションをドラフトする：書き込み scope と人による承認がある場合に限り、点検または作業指示ドラフトを作成します。
- 結果を記録する：承認済みアクション、オペレーターメモ、修正内容を保存し、次回以降のワークフローに活用します。
推奨出力構造
| セクション | 内容 |
|---|
| 運用サマリー | サイト、アセット、現在状態、重要度、未解決アラーム、ソースの鮮度。 |
| エビデンス | 回答に使った信号、点検記録、作業指示、文書、シーン参照。 |
| 不足データ | 期待されるが利用できない信号、文書、記録。 |
| 推奨確認 | 現場確認、安全確認、周辺設備確認、文書レビュー。 |
| アクションドラフト | 担当者、場所、影響アセット、理由を含む作業指示または点検ドラフト。 |
よくある失敗
| 症状 | 主な原因 | 対応 |
|---|
| アセットを解決できない | Platform、Inspector、ソースシステムで名称が一致していない | サイト、場所、設備 ID を確認し、確定後に対応表を更新します。 |
| サマリーに最近の活動が入らない | ソースパイプラインが古い、またはタイムスタンプが見えない | 利用可能な最新タイムスタンプを表示し、データ鮮度の確認を回します。 |
| アラーム文脈が広すぎる | 対象アセットまたは期間が広すぎる | サイト、システム、重要度、時間範囲で絞り込みます。 |
| 作業指示ドラフトがブロックされる | 書き込み scope または承認ポリシーがない | 運用システムへ書き込まず、ドラフト内容をレビュー用に返します。 |
検証チェックリスト
- 実行時ディスカバリで期待する
/mcp/base/ ツールが見える。
- 回答にアセット ID、ソースタイムスタンプ、作業記録参照が含まれる。
- エビデンスが不完全な場合の制限が明確に示される。
- アクションドラフトと承認済みアクションが分離されている。
- 完了した作業結果が今後のワークフロー改善に使える形で記録されている。