空间智能体：整体架构概览

文档版本：v1.0
更新日期：2026-06-04
定位：项目顶层架构总览，定义三大 Agent 体系的分工与边界。

---

1. 三大 Agent 体系

① Chatbot MAS（对话式多智能体系统）

入口：统一的对话界面（Web/小程序）。
路由中枢：Master Agent，负责 L1 意图识别、分发、上下文管理。
子 Agent：均为"分支意图"，经由 Master Agent 路由调用。

子 Agent	能力	状态
SA_Reservation	会议室预定、查询、修改、取消	✅ 进行中
SA_Device_Control	环境调节、设备开关、模式切换	✅ 进行中
FA_Ticket	工单自动建单（多模态报修）	✅ 进行中
Data_Query	动态数据查询（→ ChatBI）	🔜 规划
QA_Chat	闲聊问答、静态知识 RAG	🆕 本期新增

详见：Master Agent 设计

② 独立后台 Agent（非对话触发）

以下 Agent 不经过 Master Agent 路由，由业务系统或定时任务独立触发。

Agent	触发方式	说明	文档
SA_Prep（智能整备）	定时/日程事件驱动	会前自动预测时长并控制空调预热预冷，后台静默执行	SA_主动整备_Agent设计
FA_Diagnosis（一键诊断）	工单系统按钮触发	嵌入工单详情页，用户点击后触发 RAG 故障诊断	FA_机电守护者_业务设计

---

2. 架构边界与交互原则

┌─────────────────────────────────────────────────────┐
│                 用户交互入口                          │
│    Web / 小程序 / 企业微信                           │
└──────────┬──────────────────────────┬────────────────┘
           │ 对话                     │ 按钮/推送
           ▼                         ▼
   ┌───────────────┐       ┌──────────────────┐
   │  Chatbot MAS  │       │   独立后台 Agent  │
   │  (Master 路由) │       │   (自主触发)      │
   └───────────────┘       └──────────────────┘

2.1 交互方式划分

维度	Chatbot MAS	独立后台 Agent
触发方式	用户对话输入	定时/事件/业务按钮
路由方式	Master Agent L1 分发	自主触发，无路由层
交互模式	多轮对话	后台执行 / 单次调用
代表 Agent	SA_Reservation, SA_IoT, QA, Data, FA_Ticket	SA_Prep, FA_Diagnosis

2.2 跨体系数据共享

• 跨域记忆：独立后台 Agent 的执行结果可通过消息通道推送给用户，但不共享 Chatbot MAS 的对话上下文。
• 权限校验：Chatbot MAS 走 Master Agent 前置权限校验；独立后台 Agent 由业务系统自行鉴权。
• 知识库：所有 Agent 共享同一套 KB RAG 知识库（设备手册、SOP 等）。

---

3. 文档导航

所属体系	文档	说明
Chatbot MAS	Master Agent 设计	L1 意图识别、路由协议、记忆管理
Chatbot MAS	SA_空间预约_Agent设计	会议室预定子 Agent
Chatbot MAS	SA_设备控制_Agent设计	设备控制子 Agent
Chatbot MAS	QA_闲聊对话_Agent设计	闲聊问答子 Agent
Chatbot MAS	FA_设备协同官_业务流程设计	工单建单子 Agent
独立后台	SA_主动整备_Agent设计	智能整备 Agent
独立后台	FA_机电守护者_业务设计	一键诊断 Agent
公共	权限体系设计	两段式权限校验