Agent HQ Demo — 零售分析執行階段

Agent HQ Demo — 零售分析執行階段 由 Archify 產生的架構圖。 參會者 · 瀏覽器 · 架構元件 參會者 瀏覽器 聊天介面 · Blazor WASM · 靜態 JS · 本機開發電腦 聊天介面 Blazor WASM · 靜態 JS 零售 API · ASP.NET Core · FastAPI · 本機開發電腦 零售 API ASP.NET Core · FastAPI RetailAnalyticsService · EF Core · SQLModel · 本機開發電腦 RetailAnalyticsService EF Core · SQLModel CopilotChatService · 單例 · SSE 串流 · 本機開發電腦 CopilotChatService 單例 · SSE 串流 GitHub Copilot CLI · Copilot SDK · JSON-RPC · 本機開發電腦 GitHub Copilot CLI Copilot SDK · JSON-RPC 模型 · claude-haiku-4.5 · gpt-5 · 架構元件 模型 claude-haiku-4.5 · gpt-5 retail.db · SQLite · 啟動時植入種子資料 · 本機開發電腦 retail.db SQLite · 啟動時植入種子資料 retail-analytics MCP · stdio · 五個只讀工具 · 本機開發電腦 · mode=ro retail-analytics MCP stdio · 五個只讀工具 mode=ro localhost POST /api/chat 查詢 + 種子資料 讀取 / 寫入 提示詞 + 模型 ID CreateSession 串流對話輪次 透過 stdio 發起工具呼叫 僅限 SELECT 本機開發電腦 圖例 前端 後端 資料庫 雲服務 安全性 外部系統

聊天請求路徑

  • • 聊天介面將提示詞 POST 到 /api/chat
  • • CopilotChatService 以 SSE 形式串流傳回增量
  • • 兩條學習路線使用相同的 camelCase JSON 介面規格

兩條學習路線，同一架構

  • • .NET：API 使用 :5050，Blazor WebAssembly 宿主使用 :5051
  • • Python：FastAPI 在 :5070 上同時提供 API 和介面
  • • 每條學習路線都包含相互對應的領域測試和 SDK 實作練習

模型的最小權限

  • • 應用程式透過 RetailAnalyticsService 進行讀寫
  • • 模型只能看到五個只讀 MCP 工具，絕不會接觸原始 SQL
  • • SQLite mode=ro 在驅動程式層拒絕寫入，而不僅是在程式碼層阻止