云灵汐技术架构底座

Agent托管平台 · 工作台体系 · MCP工具桥 · 统一业务服务层

2026-09-02 v2.0 基于:中云AI工程化架构方案(9.2会议)+ 云灵汐业务线拆分报告
一、架构总览矩阵

架构以Agent托管平台为核心(非C端),工作台体系为组织赋能,MCP工具桥对接内外系统,统一业务服务层承载旅游业务逻辑。

层级定位核心能力来源建设策略
用户层多端接入C端对话界面 / B端工作台 / 供应链端 / 第三方系统M1+M2C端对话为主,B端工作台为主,非传统页面导航
Agent托管平台架构核心全链路Agent · SOP管理流 · 自学习成长 · 工作中枢M1+M31:1复刻现有成熟体系(非新建)
工作台体系组织赋能个人工作台(端侧隔离) / 组织工作台(业务隔离) / 云端协作工作区M3个人与组织严格数据隔离,共享能力层
MCP工具桥能力中间件erp.* / ec.* / order.* / fin.* / ext.* MCP工具M4+云灵汐Gateway统一鉴权,工具调用级权限
统一业务服务层旅游业务逻辑线路·资源·计调·订单·财务·分销·结算云灵汐MCP原生建设,非yudao二开,Agent即UI
第三方只读层外部对接景区票务·分销商系统·闸机·旅行社ERPM4仅查询不改,CLI协议,加装网关不替换硬件
与v1的根本区别:v1以C端对话为架构主轴,Agent和业务服务层只是C端的支撑——这是错的。真实架构以Agent托管平台为绝对核心,C端只是众多接入入口之一。工作台体系(个人/组织/协作)是与C端并列的另一接入形态,面向B端和内部运营。
二、技术架构总图

六层架构:用户层→Agent托管平台→工作台体系→MCP工具桥→统一业务服务层→第三方只读层。Agent托管平台是整个架构的核心引擎。

云灵汐技术架构总图
用户层(多端接入,非只有C端) C端游客(对话界面) B端工作台 供应链端 第三方系统直连 管理后台 Agent托管平台(架构核心 · 1:1复刻现有成熟体系) 全链路Agent能力意图理解→工具编排→执行 SOP管理流数字员工·唯一ID·可回溯 自学习成长体系使用越久幻觉越少 工作中枢工作树·工作流·超范围指令拦截 工作台体系(个人/组织/协作 · 数据严格隔离) 个人工作台端侧隔离·生活与工作分离 组织工作台按业务隔离·可分配合作方 云端协作工作区(Multica式)任务协同·成员协同·知识沉淀·实时协作 MCP工具桥(Gateway统一鉴权 · 工具调用级权限校验) erp.* ec.* order.* fin.* user.* ext.*(第三方只读adapter) 统一业务服务层(自建 · MCP原生 · 非yudao · Agent即UI) 线路管理route 资源管理resource+stock 计调管理dispatch 订单管理order+state 财务管理settlement 分销管理distributor 供应商管理supplier 第三方只读层(不改造 · 仅查询 · CLI协议 · 加装网关不替换硬件) 景区票务系统 分销商系统 旅行社ERP 闸机(加装存储/通讯模块) Agent托管平台是整个架构的核心引擎 C端对话只是接入入口之一,B端工作台是同等重要的另一接入形态 工作台体系与Agent平台共享:自学习·SOP管理流·工作树·去飞书化 业务服务层通过MCP工具暴露能力,Agent是唯一操作入口,无传统管理后台 第三方系统:仅查询不改,加装网关不替换硬件,合同约束接口范围
三、Agent托管平台 · 架构总览

Agent托管平台是整个云灵汐架构的核心引擎,不是C端的附属支撑。1:1复刻现有成熟全链路Agent体系,非新建。四大能力模块为所有接入端共享。

Agent托管平台内部架构
接入端(所有端共享同一Agent平台) C端游客对话 B端工作台 供应链端 第三方系统 管理后台 Agent托管平台核心(四大能力模块) ① 全链路Agent能力 意图理解 → 任务拆解 → 工具编排 → 执行 → 结果生成 · 多轮对话上下文管理 · 工具调用编排(支持并行/串行/条件分支) · 用户记忆与偏好持久化(千人千面基础) ② SOP管理流(数字员工) 唯一ID · 触发即生成 · 可回溯 · 无限扩展 · 双轨SOP:固化通用SOP + 自编排自定义SOP · SOP触发:Agent自动识别→执行→验证闭环 · SOP沉淀:对话/手绘拍照→AI自动蒸馏为结构化SOP ③ 自学习成长体系 使用越久幻觉越少 · 数字员工自进化 · 用户反馈循环:纠错→记忆→下次避免 · 业务知识蒸馏:历史资料→知识图谱 · SOP自动优化:执行频率→自动提炼最佳实践 ④ 工作中枢 工作树 · 工作流 · 超范围指令拦截 · 工作树:任务分解为子任务树,逐节点执行 · 超范围拦截:Agent超出SOP授权范围时自动拦截 · 去飞书化:替代会议/推送/任务,年底前完成 输出(通过MCP工具桥调用业务服务层/第三方只读层) MCP工具调用(erp.*/ec.*/order.*/fin.*) ext.* 只读对接(景区/分销商/闸机) 四大能力模块共享给所有接入端——C端用全链路Agent,B端用SOP+工作中枢,供应链用SOP+自学习
关键设计决策:Agent平台不是为C端定制的——它是所有端的共享引擎。C端游客调全链路Agent下单,B端运营调SOP管理流排团,供应链调自学习体系优化采购。同一个平台,不同的能力组合,不同的工作台呈现。
四、全链路Agent能力 · 详细设计

从用户输入意图到工具执行再到结果返回的完整链路。支持多轮对话、并行工具调用、条件分支编排。

能力拆解

能力说明输入输出
意图理解解析用户自然语言,识别业务意图(订线路/查库存/排团/结算)用户文本/语音结构化意图(action+entities)
任务拆解将复杂意图拆为子任务树,标注依赖关系和执行顺序结构化意图任务DAG(有向无环图)
工具编排按任务DAG编排MCP工具调用,支持并行/串行/条件分支任务DAG工具调用序列+参数
执行调度通过MCP Gateway调用工具,处理超时/重试/降级工具调用序列工具执行结果
结果生成将工具结果合成为用户可理解的回复(文字/卡片/看板)工具执行结果气泡/卡片/HTML报告
记忆持久化保存对话上下文、用户偏好、执行历史,支撑千人千面对话+执行记录用户记忆库更新

工具编排模式

模式适用场景示例图示
串行有依赖关系的工具链route-search → order-create → paymentA→B→C
并行无依赖的独立查询同时查景区票务+酒店库存+大巴可用A+B+C → 合并
条件分支根据中间结果决定下一步查库存→有货→下单 / 无货→推荐替代A→(条件)→B或C
循环重试资源竞争场景占位失败→等待→重试(最多3次)A→(失败)→A
SOP审批挂起写操作需审批route-create→SOP挂起→审批通过→继续执行A→(SOP)→暂停→B
五、SOP管理流 · 数字员工

SOP是Agent托管平台的核心能力之一,不是简单的审批流。SOP定义"数字员工"的工作方式——唯一ID、触发即生成、可回溯、无限扩展。

SOP管理流生命周期
① SOP创建 业务侧编写(非交付侧) 对话/手绘拍照→AI蒸馏 分配唯一ID ② SOP触发 Agent识别意图→匹配SOP 或用户手动触发 触发即生成执行实例 ③ SOP执行 按SOP步骤编排工具 每步可触发MCP工具 超范围指令→拦截 ④ SOP验证 执行结果→验证规则 通过→完成 不通过→回退/人工介入 双轨SOP机制 固化通用SOP:业务侧编写,系统预置,不可随意修改 自编排SOP:用户对话生成,AI蒸馏,可迭代优化 自学习闭环:SOP执行频率→自动提炼最佳实践→优化SOP 执行N次→统计成功/失败率 对比变体→提炼最优路径 生成SOP优化建议 业务侧审核确认 回流优化 红线:交付团队禁止编写业务SOP(需求固化后无法修改) SOP由业务侧全权负责输出,交付侧仅负责工程化落地和工具支持
SOP与权限的关系:SOP管理流是Agent平台的第二层权限控制——MCP Gateway做工具级权限校验(能不能调这个工具),SOP管理流做流程级权限控制(调了之后按什么流程执行)。写操作默认触发SOP,SOP定义了谁审批、审批超时策略、审批拒绝后的回退路径。
六、自学习成长体系

Agent使用越久幻觉越少。通过用户反馈循环、业务知识蒸馏、SOP自动优化三个机制实现数字员工自进化。

三大自学习机制

机制原理数据来源输出
用户反馈循环用户纠错→记录→下次类似场景自动避免同类错误用户对话中的纠正/否定/修改用户级记忆库更新(千人千面)
业务知识蒸馏历史资料(合同/需求/采购单)→结构化知识图谱→Agent可检索历史文档归集(M8任务③)组织级知识库(工作台共享)
SOP自动优化统计SOP执行频率和成功率→对比变体→提炼最优路径→建议优化SOP执行记录+AuditLogSOP优化建议(需业务侧审核)

知识沉淀层级

层级存储位置数据类型示例
L1 用户记忆端侧(个人工作台)偏好/历史/纠错记录"用户上次去三亚选了亲子线"→下次优先推荐亲子
L2 组织知识云端(组织工作台)SOP/业务规则/最佳实践"景区包票SOP v3"→所有包票Agent共享
L3 行业知识云端(全局)目的地/线路/资源百科"黄果树景区运营时间/票价/联系方式"→全平台共享
L4 工具知识MCP Server元数据工具定义/参数/返回格式"erp.route-search参数:destination,date,people"→Agent自动学习
"使用越久幻觉越少"的技术实现:不是模型本身变聪明了,而是检索增强——L1~L4四层知识库随使用不断积累,Agent每次回答前先检索相关知识,用知识库事实约束模型生成,减少幻觉。新用户只有L4工具知识,幻觉率正常;老用户L1~L3丰富,幻觉率显著下降。
七、工作中枢

工作树+工作流+超范围指令拦截。工作中枢是Agent执行复杂任务时的调度引擎——将意图分解为工作树,逐节点执行,超出SOP授权范围时自动拦截。

工作树模型

概念说明示例
工作树复杂任务分解为树形结构,根节点是用户意图,叶节点是工具调用根:"安排下周三黄果树15人团" → 子1:查资源 → 子2:排计调 → 子3:发通知
工作节点树中每个节点,有状态(pending/running/done/failed/blocked)子2:排计调 → running → done
工作流节点间的执行顺序和依赖关系,支持并行/串行/条件子1和子3并行,子2依赖子1完成
超范围拦截Agent执行时超出SOP授权范围→自动拦截→需人工授权或SOP审批Agent试图修改景区票务系统数据→拦截(ext.*只读)

去飞书化路径

飞书功能替代方案时间备注
飞书会议工作台内Agent协作会议年底前对话驱动,Agent自动纪要
飞书推送工作台气泡通知年底前SOP触发→气泡推送
飞书任务工作树节点任务年底前Agent分配→执行→验证闭环
飞书文档知识库+AI蒸馏年底前历史资料→知识图谱
八、工作台体系 · 架构总览

工作台是B端和内部运营的核心交互形态,与C端对话并列。个人工作台与组织工作台严格数据隔离,共享Agent平台能力层。云端协作工作区提供Multica式实时协作。

工作台体系架构
工作台入口(千人千面) 打开即对话,侧边栏自定义,与C端共享Agent能力 数据隔离 数据隔离 个人工作台 个人事务 · 生活与工作分离 · 数据存本地端侧,不与组织数据混用 · 个人记忆/偏好/日历/待办 · 可关联组织工作台(只读组织数据) · 离线可用,端侧推理 组织工作台 按业务隔离 · 可对外分配合作方 · 云端处理(脱敏后),多角色共享 · 按业务线隔离:景区包票/旅行社集采/共创 · 可分配给合作方使用(权限受限) · 经营数据/计调排团/财务结算看板 共享能力层(两种工作台共用,来自Agent托管平台) 自学习成长体系数字员工自进化 SOP管理流唯一ID·可回溯 工作树超范围指令拦截 去飞书化替代会议/推送/任务,年底前 云端协作工作区(Multica式) 任务协同 · 成员协同 · 知识沉淀 · 实时协作 跨组织协作 任务分配与追踪 实时编辑与评论 知识沉淀共享 个人工作台与组织工作台数据严格隔离,但共享Agent平台四大能力 云端协作工作区是组织工作台的延伸——跨组织、跨业务线的实时协作空间
九、个人工作台

个人事务处理入口,数据端侧存储,与组织数据严格隔离。生活与工作分离,离线可用。

核心能力

能力说明数据存储
个人记忆用户偏好/历史行为/纠错记录,支撑千人千面端侧SQLite(不上云)
个人日历个人日程管理,可与组织日历只读关联端侧,同步到云端脱敏摘要
个人待办从工作树节点同步的个人任务端侧,与组织工作台同步状态
AI助手个人级AI对话,使用全链路Agent能力对话记录端侧,Agent记忆L1层
知识收藏个人收藏的SOP/线路/资源信息端侧,引用组织知识库(只读)
数据隔离原则:个人工作台的数据永远不上传组织云端。当个人AI助手需要调用组织级工具时(如查库存),通过MCP Gateway以个人身份发起请求,Gateway返回脱敏结果,个人端侧只缓存结果摘要。
十、组织工作台

按业务线隔离的组织级工作台,多角色共享,云端处理。可对外分配给合作方使用。包含四个预建看板(高频场景需要可视化)。

业务线隔离

业务线工作台形态核心角色预建看板
景区包票采购→分销→回款全流程采购员/分销商/财务采购看板/回款看板
旅行社集采需求整合→资源采购→打包交付计调/采购/财务计调排团看板
文旅共创产品共创→生产→分成产品经理/合作方产品看板/分成看板
电商分销商品上架→分销→结算运营/分销商资源库存矩阵
综合管理组织级经营数据管理层经营数据仪表盘 + 财务结算报表

四个预建看板(L4界面)

看板使用者核心内容数据来源
计调排团看板计调员团期日历/资源锁定状态/导游分配/车辆调度dispatch表+resource_lock表+团期表
资源库存矩阵采购/运营各景区/酒店/大巴的实时库存+预订占用+可用余量resource表+stock表+order占用
财务结算报表财务应收/应付/已结/未结/团期结算明细settlement表+order表+supplier表
经营数据仪表盘管理层GMV/订单量/转化率/利润率/业务线对比order表+settlement表聚合
看板不是管理后台:四个看板是数据可视化,不是CRUD操作页面。看板的数据来自MCP工具调用(Agent拉取),操作仍通过对话完成("把这个团期的导游换成张三"→Agent调dispatch-update工具)。看板提供入口:点击看板上的团期→自动填充对话上下文→Agent接手。
十一、云端协作工作区(Multica式)

Multica式云端协作工作区——跨组织、跨业务线的实时协作空间。任务协同、成员协同、知识沉淀一体化。是组织工作台的延伸,不是独立系统。

协作工作区架构
协作工作区(云端 · 实时 · 跨组织) 一个工作区 = 一个项目/业务线/临时任务 任务协同 · 任务创建:对话/工作树节点 · 任务分配:自动或手动指派 · 任务追踪:状态/进度/阻塞 · 任务看板:Kanban视图 · 任务依赖:前置/后置关系 · Agent辅助:自动拆解/提醒 · 闭环验证:完成→验证→归档 替代:飞书任务/Teambition 成员协同 · 成员管理:邀请/角色/权限 · 实时在线状态:谁在看/谁在编辑 · 实时评论:@提及/气泡回复 · 协作编辑:多人同时编辑文档 · 消息流:工作区内对话流 · 通知推送:工作台气泡 · 跨组织:合作方可加入 替代:飞书群/Slack/钉钉 知识沉淀 · 自动归档:任务完成后自动归档 · 知识图谱:关联实体/概念 · SOP蒸馏:对话→结构化SOP · 最佳实践:高频路径自动提炼 · 全文检索:跨工作区搜索 · 版本管理:文档历史版本 · Agent记忆:沉淀到L2组织知识 替代:飞书文档/Notion/Confluence Agent深度集成 Agent作为工作区成员参与:自动拆任务/自动写纪要/自动蒸馏SOP/自动提醒阻塞/@Agent提问 协作工作区是组织工作台的能力延伸,不是独立系统——工作区数据回流到组织知识库,任务回流到工作树

协作工作区与Agent的协作模式

模式触发Agent行为人类行为
Agent主导用户说"帮我安排下周排团"拆任务→分配→执行→追踪→汇报审核结果/调整/确认
人主导Agent辅助用户手动创建任务提供数据/建议/自动填充/提醒决策/编辑/推进
Agent观察学习用户在协作中操作记录操作路径→蒸馏为SOP建议正常工作(无感)
Agent主动介入检测到阻塞/超时/冲突推送提醒→建议解决方案→等待人类决策决策/授权/拒绝
十二、核心ER图

旅游业务核心实体关系:供应商→资源→线路(=商品)→团期→订单→计调→结算。ERP与电商共享同一套实体模型,通过品类区分。

核心业务实体关系图
Supplier 供应商 景区/酒店/车队 Resource 资源 门票/房/车/餐 Stock 库存 日维度余量 Route 线路 =商品(品类区分) RouteResource 线路-资源关联 Departure 团期 日期+价格+库存 Order 订单 状态机驱动 Dispatch 计调单 导游+车+餐分配 ResourceLock 资源锁定 防超卖核心 Settlement 结算单 应收/应付 Distributor 分销商 渠道+佣金率 Merchant 商户 供应商入驻 Product 电商商品 Route的电商视图 1:N 1:N N:M 1:N 1:N 1:1 1:N N:1 渠道 电商视图 ERP实体 核心 交易 订单 计调 库存/电商
Route = Product:线路(Route)和电商商品(Product)是同一个实体的不同视图——Route面向ERP侧(计调/资源),Product面向电商侧(上架/分销)。通过category字段区分:线路团、单项门票、酒店套餐、文创产品。不需要两套系统。
十三、实体字段定义

核心实体的关键字段定义,含防超卖约束。

Supplier(供应商)

字段类型必填说明
supplier_idBIGINT PK是雪花ID
nameVARCHAR(100)是供应商名称
typeENUM是SCENIC(景区)/HOTEL(酒店)/CAR(车队)/RESTAURANT(餐厅)/CULTURAL(文创)
contact_nameVARCHAR(50)是联系人
contact_phoneVARCHAR(20)是联系电话
settlement_cycleENUM是WEEKLY/MONTHLY/QUARTERLY
statusENUM是ACTIVE/SUSPENDED/BLACKLISTED

Resource(资源)+ Stock(库存)+ 防超卖约束

字段类型必填说明
Resource
resource_idBIGINT PK是雪花ID
supplier_idBIGINT FK是所属供应商
nameVARCHAR(100)是资源名称
typeENUM是TICKET(门票)/ROOM(房间)/VEHICLE(车位)/MEAL(餐位)
base_priceDECIMAL(10,2)是基础采购价
Stock
stock_idBIGINT PK是雪花ID
resource_idBIGINT FK是资源ID
dateDATE是日期(日维度)
total_countINT是总库存
booked_countINT是已预订数(防超卖核心)
防超卖SQL约束:UPDATE stock SET booked_count = booked_count + ? WHERE stock_id = ? AND booked_count + ? <= total_count — 原子递增+条件检查,行锁保证并发安全。返回影响行数=0则超卖,Agent自动重试或推荐替代。

Route(线路=商品)/ Departure(团期)/ Order(订单)

字段类型必填说明
Route
route_idBIGINT PK是雪花ID
nameVARCHAR(200)是线路名称
categoryENUM是GROUP_TOUR(跟团)/TICKET_ONLY(门票)/HOTEL_PKG(酒景)/CULTURAL(文创)
statusENUM是DRAFT/PENDING_REVIEW/ON_SALE/OFF_SHELF
Departure
departure_idBIGINT PK是雪花ID
route_idBIGINT FK是所属线路
start_dateDATE是出发日期
priceDECIMAL(10,2)是出团价格
Order
order_idBIGINT PK是雪花ID
departure_idBIGINT FK是团期ID
user_idBIGINT FK是下单用户(含分销商代下单)
people_countINT是人数
total_amountDECIMAL(12,2)是订单总额
statusENUM是PENDING_PAY/PAID/DISPATCHED/DEPARTED/COMPLETED/CANCELLED/REFUNDED

Dispatch(计调)/ ResourceLock(资源锁定)/ Settlement(结算)

字段类型必填说明
Dispatch
dispatch_idBIGINT PK是计调单ID
order_idBIGINT FK是关联订单
guide_idBIGINT否导游ID
vehicle_idBIGINT否车辆ID
statusENUM是PENDING/ASSIGNED/CONFIRMED/COMPLETED
ResourceLock
lock_idBIGINT PK是锁定ID
stock_idBIGINT FK是库存ID
order_idBIGINT FK是订单ID
countINT是锁定数量
expires_atDATETIME是锁定过期时间(支付超时自动释放)
Settlement
settlement_idBIGINT PK是结算单ID
typeENUM是RECEIVABLE(应收)/PAYABLE(应付)
counterparty_idBIGINT是对手方ID(供应商或分销商)
amountDECIMAL(12,2)是结算金额
statusENUM是PENDING/CONFIRMED/PAID/CLOSED
十四、时序图 · 线路创建到商品上架

从运营人员对话创建线路到电商商品上架的完整链路,含SOP审批。

线路创建→审核→上架 时序图
运营人员 Agent MCP Gateway SOP审批流 业务服务层 ① "创建新线路:黄果树2日游" ② erp.route-create(params) ③ 写操作→触发SOP审批 ④ 推送审批通知→工作台气泡 ⑤ 运营审批通过 ⑥ SOP通过→Gateway继续执行 ⑦ route-create写入数据库 ⑧ route_id返回 ⑨ 自动关联资源(erp.resource-query) ⑩ 创建团期(erp.departure-create) ⑪ 创建电商商品(ec.product-create) ⑫ product_id返回 ⑬ 状态→ON_SALE ⑭ 全部成功 ⑮ 气泡:"线路已上架" ⑯ AuditLog记录全链路
十五、时序图 · 订单全链路

从搜索线路到支付发团结算的完整订单链路,含防超卖原子操作和自动计调。

订单全链路时序图
用户/Agent Gateway 业务服务层 DB(MySQL) 支付网关 计调模块 ① erp.route-search("黄果树") ② 权限校验→查询 ③ SELECT route+departure ④ 线路列表 ⑤ order-create(departure_id,5人) ⑥ 创建订单(PENDING_PAY) ⑦ 原子占位(防超卖) ⑧ lock_id返回 ⑨ 跳转支付 ⑩ 支付成功回调 ⑪ order.status→PAID ⑫ 自动触发计调 ⑬ 计调单创建→分配导游/车 ⑭ 锁定资源(resource-lock) ⑮ order.status→DISPATCHED ⑯ 气泡:"已排团,导游张三" ⑰ 发团日→status→DEPARTED ⑱ 行程结束→自动生成结算单 ⑲ 应付供应商+应收分销商 ⑳ 气泡推送结算报表
十六、时序图 · Agent对话下单

C端用户通过自然语言对话完成下单全流程,无页面跳转。

Agent对话下单三阶段时序图
用户 Agent(全链路) 用户记忆(L1) MCP工具桥 业务服务层 阶段一:意图理解 ① "下周带家人去三亚" ② 读取用户记忆(偏好/历史) ③ 上次亲子游/偏好海岛 ④ "找到3条亲子海岛线,推荐A" 阶段二:对话内下单 ⑤ "就A线路,3大1小" ⑥ order-create(departure_id,4人) ⑦ 原子占位+创建订单 ⑧ order_id+支付链接 ⑨ 气泡卡片(含支付按钮) 阶段三:支付后自动编排 ⑩ 支付完成回调 ⑪ 自动编排(dispatch+lock+notify) ⑫ 计调+锁资源+通知供应商 ⑬ "已排团,导游张三,6/15出发" ⑭ 更新用户记忆(本次偏好)
十七、MCP工具清单

8个域32个工具。Gateway统一鉴权,工具调用级权限校验。写操作默认触发SOP审批。

erp.* — 旅游ERP能力域

工具名读写功能SOP角色限制
erp.route-search读搜索线路(支持目的地/日期/人数/价格过滤)—全部
erp.route-create写创建线路需审批运营+
erp.resource-query读查询资源库存—全部
erp.resource-lock写锁定资源(防超卖原子操作)—系统+计调
erp.dispatch-create写创建计调单(分配导游/车/餐)需审批计调+
erp.dispatch-query读查询计调状态—全部
erp.departure-create写创建团期需审批运营+
erp.supplier-query读查询供应商信息—采购+运营

ec.* — 电商能力域

工具名读写功能SOP角色限制
ec.product-search读搜索电商商品(面向分销商/C端)—全部
ec.product-create写从Route创建电商商品需审批运营+
ec.distributor-query读查询分销商信息—运营+管理
ec.merchant-audit写商户入驻审核需审批管理

order.* / fin.* / user.* / ext.* / sop.* / collab.*

域工具名读写功能备注
order.*order-create写创建订单(含原子占位)触发库存锁定
order-query读查询订单状态数据隔离:分销商只看自己
order-cancel写取消订单(释放锁定)需SOP(超时策略)
order-pay写支付回调处理触发自动计调
fin.*settlement-query读查询结算单数据隔离:按对手方
settlement-create写生成结算单系统自动+人工补录
fin.supplier-settle写供应商结算确认需SOP
user.*user-memory读写用户记忆读写(L1端侧)千人千面基础
user-preference读写用户偏好管理端侧存储
ext.*ext.scenic-query读景区票务系统只读查询CLI协议,不改造
ext.distributor-query读分销商系统只读查询CLI协议
ext.gate-query读闸机数据查询加装网关
sop.*sop-create写创建SOP业务侧编写
sop-trigger写触发SOP执行Agent自动/手动
sop-query读查询SOP状态含执行记录
collab.*collab-task-create写协作工作区创建任务工作树节点同步
collab-task-query读查询任务状态跨工作区
collab-notify写协作通知推送工作台气泡
v2新增工具域:sop.*(SOP管理流工具化)、collab.*(协作工作区工具化)。这两个域直接对应Agent平台的SOP管理流能力和云端协作工作区——Agent通过MCP工具调用SOP和协作能力,而非硬编码。
十八、MCP Server架构

Gateway统一鉴权→工具路由→业务模块/第三方adapter→统一数据库。所有工具调用记录AuditLog。

MCP Server内部架构
Agent托管平台 MCP Gateway身份验证 → 权限校验 → SOP触发判断 → 工具路由 → AuditLog ERP模块route/resource/dispatch EC模块product/distributor Order+Fin模块order/settlement ext.* AdapterCLI→景区/分销商/闸机(只读) SOP管理流模块SOP触发/执行/验证/自优化 协作工作区模块任务协同/成员协同/知识沉淀 统一MySQL(业务数据+AuditLog+SOP+协作) AuditLog(全量审计) Gateway是唯一鉴权入口——所有工具调用必须经过Gateway,无直连业务模块
十九、界面分级策略

对话为主交互但不唯一。C端四级界面策略,B端工作台含预建看板。无传统管理后台导航体系。

级别形态适用场景使用者示例
L1纯文字回复简单查询、状态确认C端/B端"你的订单已支付,6/15出发"
L2气泡卡片商品推荐、订单卡片、资源信息C端/B端线路卡片(图+价+日期+按钮)
L3Agent按需渲染复杂结构数据、报表、对比C端/B端多线路对比表、结算明细表
L4预建看板高频固定场景(仅4个)B端计调排团看板/资源库存/财务结算/经营仪表盘
L4看板的设计原则:看板是数据可视化,不是CRUD页面。数据来自Agent调用MCP工具拉取,操作通过对话完成。看板上的元素可点击→自动填充对话上下文→Agent接手处理。这保证了"对话即界面"的一致性,同时满足高频场景的可视化需求。
二十、场景对照表

12个典型场景的界面级别标注。

#场景界面级别使用者交互方式
1搜索线路L2C端对话→气泡卡片列表
2下单支付L2C端对话→订单卡片→支付跳转
3查订单状态L1C端对话→纯文字回复
4线路对比L3C端对话→Agent渲染对比表
5创建线路L1B端运营工作台对话→SOP审批→文字确认
6排团调度L4B端计调计调排团看板+对话操作
7查资源库存L4B端采购资源库存矩阵+对话查询
8财务结算L4B端财务财务结算报表+对话确认
9经营数据L4B端管理经营数据仪表盘+对话提问
10商户入驻审核L1B端管理工作台对话→SOP审批→通知
11第三方数据查询L3B端对话→ext.*→Agent渲染HTML报告
12协作排期L3B端协作工作区→任务看板+对话
二十一、权限架构总览

五层管控:身份认证→角色→工具权限→数据隔离→Agent身份代理。非传统RBAC页面级,而是MCP工具调用级。

五层权限架构
L1 身份认证(JWT+Refresh Token · 飞书OAuth/手机验证码) L2 角色绑定(User→Role · 10角色 · 支持一人多角色) L3 工具权限(Role→ToolPermission · erp.*/ec.*/order.*/fin.*/ext.*/sop.*/collab.*) L4 数据隔离(DataScope · distributor_id/supplier_id/org_id自动注入WHERE条件) L5 Agent身份代理(Agent携带user_id+role调用Gateway · 超范围→工作中枢拦截) 每次工具调用:L1验证Token → L2取角色 → L3查工具权限 → L4注入数据范围 → L5执行
二十二、角色×工具权限矩阵

10个角色×8个工具域的权限矩阵。R=读,W=写,SOP=写但需SOP审批,—=无权限。

角色erp.*ec.*order.*fin.*user.*ext.*sop.*collab.*
C端游客RRW(自己)—RW———
分销商RRW(自己)R(自己)RW——R
供应商R(自己)—R(自己)R(自己)RW——R
运营专员RW+SOPRW+SOPRRRRRRW
计调员RW+SOPRRRRRRRW
采购员RW+SOPRRR(自己)RRRRW
财务专员RRRRW+SOPR—RR
商户—R(自己)R(自己)R(自己)RW——R
管理层RRRRRRRWRW
系统管理员RWRWRWRWRWRWRWRW
SOP是权限的第二道防线:第一道是Gateway的工具级权限(能不能调),第二道是SOP管理流(调了之后按什么流程执行)。写操作即使有权限也默认触发SOP审批——除非角色是系统管理员(绕过SOP,但全量审计)。
二十三、权限校验时序图

Agent调用MCP工具时的完整权限校验链路。

权限校验+SOP审批 完整时序
用户 Agent Gateway 权限模块 SOP+业务层 ① "帮我创建一条新线路" ② erp.route-create(+user_id+token) ③ 验证Token→取role ④ role=运营 → 有erp.route-create权限 ⑤ DataScope注入(org_id=XXX) ⑥ 写操作→触发SOP审批 ⑦ 推送审批通知→工作台气泡 ⑧ 审批通过 ⑨ SOP通过→Gateway继续 ⑩ 执行route-create(带DataScope) ⑪ route_id返回 ⑫ AuditLog记录(user,tool,params,result) ⑬ 成功 ⑭ "线路已创建,ID:xxx"
二十四、产品线逻辑

三条核心业务线+电商分销,均通过MCP工具桥调用统一业务服务层。

业务线一:景区包票(贸易差价)

环节MCP工具链路工作台/界面SOP
采购erp.supplier-query → erp.resource-query → erp.resource-lock采购看板(L4)采购单需审批
分销ec.product-create → ec.distributor-query组织工作台上架需审批
回款fin.settlement-create → fin.supplier-settle回款看板(L4)结算需审批

业务线二:旅行社集采(整合分销)

环节MCP工具链路工作台/界面SOP
需求整合erp.route-search → order-query(批量)协作工作区—
资源采购erp.resource-query → erp.resource-lock(批量)资源库存矩阵(L4)大批量需审批
打包交付erp.dispatch-create → erp.route-create计调排团看板(L4)计调需审批

业务线三:文旅产品共创(联合生产分成)

环节MCP工具链路工作台/界面SOP
产品共创collab.task-create → erp.route-create协作工作区共创方案需审批
生产管理erp.resource-lock → erp.dispatch-create组织工作台—
分成结算fin.settlement-create → fin.supplier-settle财务结算报表(L4)分成需审批
二十五、部署架构

Docker Compose内网部署,普通办公电脑可运行。无需外网,模型走内部服务节点。

组件清单

组件镜像端口说明
Agent平台ylx-agent:latest8080全链路Agent+SOP+自学习+工作中枢
MCP Gatewayylx-mcp-gw:latest8081统一鉴权+工具路由+AuditLog
业务服务层ylx-biz:latest8082erp/ec/order/fin 模块
MySQLmysql:8.03306统一数据库(业务+审计+SOP+协作)
Redisredis:76379缓存+分布式锁+会话
ext.* Adapterylx-ext-adapter:latest8083第三方系统CLI协议适配
前端(工作台)ylx-workbench:latest3000B端工作台+预建看板
前端(C端)ylx-chat:latest3001C端对话界面

部署约束

硬约束
  • ① 无需外网——模型调用走内部服务节点(DeepSeek Flash v4 / GLM 5.2)
  • ② 普通办公电脑可运行(能运行WorkBuddy即满足要求)
  • ③ 3个工作日内完成基础环境部署+可视化演示
  • ④ ext.* Adapter与第三方系统在同一内网段
二十六、验收用例

架构底座核心验收用例,覆盖C端、B端工作台、Agent平台、SOP、协作工作区。

编号用例优先级验收标准对应模块
TC-01线路创建到上架P0工作台对话→SOP审批→审核通过→自动创建电商商品→上架SOP管理流+MCP工具
TC-02订单全链路P0搜线路→下单→原子占位→支付→自动计调→锁定资源→发团→结算时序图十五+ER图
TC-03Agent对话下单P0用户说"下周带家人去三亚"→意图理解→读记忆→搜线路→气泡→下单→支付时序图十六+全链路Agent
TC-04SOP审批流P0写操作→SOP触发→工作台气泡通知→审批通过→继续执行 / 拒绝→终止SOP管理流(五)
TC-05权限校验P0分销商调erp.route-create→Gateway拦截→Agent返回"无权限"权限架构(二十一)
TC-06数据隔离P1分销商查订单→只返回自己的;供应商查资源→只返回自己的权限架构L4
TC-07计调排团看板P0计调员打开工作台→看板显示团期日历+资源锁定→点击团期→对话填充上下文组织工作台(十)+L4看板
TC-08个人工作台隔离P1个人工作台数据端侧存储→组织工作台不可见→关联组织数据为只读个人工作台(九)
TC-09协作工作区P1创建协作工作区→邀请成员→分配任务→Agent辅助→知识沉淀协作工作区(十一)
TC-10SOP自优化P2SOP执行N次→统计成功率→对比变体→生成优化建议→业务侧审核自学习体系(六)+SOP(五)
TC-11超范围拦截P0Agent试图调ext.*修改第三方数据→工作中枢拦截→需人工授权工作中枢(七)
TC-12第三方只读对接P1ext.scenic-query→查询景区票务→返回数据→Agent渲染HTML报告→不修改原系统MCP ext.*(十七)
二十七、问题闭环与退出条件

架构底座阶段的遗留问题、退出条件和进入下一阶段的前提。

遗留问题

#问题状态说明
1MCP工具清单v1确认待确认8域32工具需与Agent平台团队对齐
2SOP审批流定义待确认哪些写操作需SOP、审批人、超时策略
3第三方对接协议待启动景区票务/分销商API文档待获取
4预建看板字段待确认4个L4看板的字段和使用频率需业务确认
5协作工作区边界待确认与组织工作台的功能边界、数据回流机制

退出条件

架构底座 → 详细设计
  • ① MCP工具清单v1对齐(问题1闭环)
  • ② SOP审批流定义确认(问题2闭环)
  • ③ ER模型经技术评审通过
  • ④ 权限矩阵经业务确认
  • ⑤ 验收用例TC-01~TC-05评审通过
详细设计 → 开发
  • ① 每个MCP工具有输入/输出/错误码定义
  • ② 数据库DDL产出
  • ③ Agent平台四大能力模块详细设计
  • ④ 工作台+协作工作区原型评审通过