← 返回首頁
技術架構與 API/MCP 對接規格書
給工程團隊與技術合作方的版本
文件版本 V1.0 | 系統定位:Room AI Agent Platform | 核心 Agent Runtime:Hermes Agent
一、總體架構(六層)
| 層 | 名稱 | 內容 | 主權 |
| L1 | 使用者入口 | 房間 AI App / Web / 行動裝置 / 房間 IoT,自然語言互動 | 平台方 |
| L2 | 平台核心 | 身份主權、權限主權、商業規則、Billing、Agent Registry | 平台方 |
| L3 | Model Router | 依任務難度/資料敏感度/GPU 狀態自動選模型,前端無需感知 | 平台方 |
| L4 | Agent Engine | Hermes、Claude、GPT、自研 Agent 並存互換;負責理解任務→規劃→呼叫 MCP→執行→回報 | 可替換 |
| L5 | MCP Gateway | AI 世界的「海關」:身分、Agent、User、工具、權限、資料等級、讀寫、金額、人工批准;每次 Tool Call 留稽核軌跡 | 平台方 |
| L6 | 資料層 | 統一 User ID、三家廠商共同資料血脈、五級資料分類、即時/每日/異地備份 | 平台方 |
二、四個不能混在一起的權力
- 資料主權 → Data Layer(Agent 不得持有)
- 系統能力 → MCP/API Layer(透過 Gateway 受控暴露)
- 使用者介面 → App/Web(平台自有)
- 商業治理 → Platform Core(方向盤永遠在平台手上)
Hermes 定位為 Agent Execution Engine(第七個核心),是「引擎」不是「方向盤」。
三、資料權限五級
| 等級 | 範圍 | Agent 存取規則 |
| D1 公開 | 公開資料 | 可直接讀 |
| D2 會員 | 一般會員資料 | 經使用者 Session 授權讀 |
| D3 企業 | ERP/營運資料 | 企業授權管理者核定 |
| D4 敏感 | 財務、醫療、信用 | 只讀最小必要+逐次 Gateway 驗證 |
| D5 核心機密 | 身份證、完整醫療紀錄 | Agent 一律不可直連,僅經人工批准流程 |
四、高風險操作(不得由 Agent 自動完成)
- 金錢轉移/大額付款
- 刪除資料
- 修改核心會員身份或權限
- 醫療高風險決策
- 合約簽署
- 系統管理員權限提升
Agent 只能提案:「已找到付款資訊,金額 NT$X,是否確認?」→ 使用者確認 → 才執行。
五、對接方式
- API:Hermes 提供 OpenAI-compatible HTTP endpoint(run/status/events/approval/stop),前端與語言無關。
- MCP:同時支援本地 stdio 與遠端 HTTP MCP Server,Header 身份驗證,per-server tool filtering。
- MCP 反向:Hermes 自身可作為 MCP Server(hermes mcp serve),供其他 Agent 調用——支撐 A2A 跨公司協作。
- Tool Naming:平台工具統一命名標準,第一期 10~20 個 MCP Tools 於附件定義。
六、多雲與不中斷
- Cloud Agnostic/多雲可移轉;任何單一雲端不得成為不可替代依賴。
- GPU 位置對 Agent 透明,由 AI Compute Router 分配(AWS/自建/Room 端側)。
- 跨雲備援:同一 User ID、同一份資料,Cloud A 故障時於 B 環境恢復,使用者無感。
- RTO/RPO 標準由平台治理機制共同訂定(附件四)。
七、安全架構
- 每一次工具呼叫重新驗證,不因「Agent 已登入」自動放行。
- Multi-Tenant 資料隔離;三家公司共用血脈、各自隔離(Vendor Isolation)。
- API 安全:mTLS(高敏感)、API Key(服務對服務);禁止明文 Token/硬編碼密碼/共用管理帳號;統一 Secret Management。
- Observability:全鏈路 Trace ID;成本控制:每次 Agent Run 建立 Cost Report。
八、分期落地
| 階段 | 目標 | 範圍 |
| Phase 1 | 證明「一句話 → 自動完成多步驟任務」 | 房間 AI+2~3 個系統 POC |
| Phase 2 | 商業平台 | 三家廠商接入共同資料血脈 |
| Phase 3 | AI 生態平台 | 跨公司 Agent、A2A、Agent Registry 開放 |