智慧工地：空间可视化与 Agent 业务集成

背景问题

光伏、储能 EPC 工地的业务数据分散在多个系统中，需要把工地空间状态与造价、巡检、审批等业务流程整合到统一入口。本案例覆盖其中两条能力线：3D 空间可视化平台与多 Agent 业务平台。

约束

• 客户工程信息不公开，对外呈现架构取舍与演示内容。
• 演示数据为真实映射与 mock 的混合体：Agent 清单与知识库条目为实际映射，runs/capabilities/chat/search/asr 等为演示数据。
• 3D 平台与 Agent 平台按两条并行能力线建设与呈现。

架构

能力线 A：3D 空间平台       能力线 B：Agent 平台
SitePulse 3D 前端          AgentScope 2.0.5 leader / sub-agent
  ├─ 场景可视化与操作         ├─ 编排器 / BPM 适配 / 巡检
  └─ 资产加载（含 fallback）  ├─ 平台身份 / 知识库访问策略 / 工作区沙箱
                            └─ 子 Agent：造价、天气（其余待接数据）
（两线并行建设，集成串联持续推进）

关键决策与取舍

• 框架选型：基于 AgentScope 原生 leader / sub-agent 结构接入业务编排，工程精力放在边界设计与集成上。
• 知识库共享边界：以平台身份做只读共享，不跨属主共享凭据；合成施工记录库被明确排除在共享范围外。
• 幂等与高危审批：设计了幂等键与高危操作审批流（改动清单文档为待对齐草稿），作为设计风险与验证计划呈现，不写成已线上闭环。
• 事件通道：SSE 推送需要区分"端点连通"与"真实事件产出"两个层次，演示端按两者分别标注。

异常与降级策略

• 需处理 SSE 事件通道不可达的场景，通过静态快照展示保持界面可用。
• 3D 资产加载失败时按 fallback 内容展示。

结果

• 演示端可运行：Agent 清单与知识库为实际映射，其余接口为演示数据，文档内分层标注。
• 配套测试骨架覆盖认证、BPM 异步、平台身份、状态隔离、挂起审批与工作区沙箱等场景。

编排演示