项目整体架构与核心功能

GoGo 智能差旅助手（gogo-agent） 是一个基于 多 Agent 协作架构 的企业级差旅管理系统，通过 AI 智能体串起「差旅申请 → 审批 → 行程规划 → 交通/酒店预订 → 报销」的全链路自动化流程。 - 语言/JDK：Java 21 - 版本：1.0.0-SNAPSHOT - Agent 框架：AgentScope 1.0.12（ReAct 模式 + Hook 生命周期 + Tool/Skill/MCP 统一编排）（目前是基于1.0的，后面会改造成2.0） - 交互模式：SSE 流式推送 + Human-in-the-Loop

整体架构

分层视图

请求主流程（对话一次的旅程）

多智能体架构

技术栈

后端

前端

外部能力（Skill / MCP / RAG）

• Skill Shell：tuniu-cli（⭐推荐，整合机票/酒店/门票/火车/邮轮/度假）、flight-manager、flyai、rolling-go-hotel、reimbursement
• MCP：weather-mcp（阿里云网关）、orizn-visa-mcp（stdio 子进程）
• RAG 知识库（3 个 Knowledge Bean，直出为 Spring Bean 供 Agent 链式注入）：
• attractionKnowledge — 景点（tourist_attraction.xlsx，GENERIC + AGENTIC）
• corporateTravelPolicyKnowledge — 差旅政策（business_travel_policy.docx，AGENTIC）
• corporateTravelGuidelinesKnowledge — 差旅指南（business_travel_guidelines.docx，AGENTIC）

模块划分

核心功能点

多 Agent 协作（8 个 ReActAgent + 2 个轻量 LLM 服务）

三层意图识别（L1 → L2 → L3，命中即短路）

配套 查询重写条件触发 + 单意图直跳 两项优化： - L1/L2 命中 → 完全跳过 QueryRewritingAgent（省一次 LLM） - 单意图 + 高置信 + 命中子智能体白名单 → 直跳子 Agent（省一次 MasterAgent 路由，节省 1–3s） - 三层结果统一为 IntentRecognitionResult（标注来源 RULE/VECTOR/LLM 与置信度），下游零改动

Hook 生命周期能力（13 个）

• 进度可视化：ProgressNotifierHook 通过 SSE 实时推送 message / thinking / progress / travel_data / plan_update / user_interaction / agent-switch …
• 持久化：SessionPersistenceHook、ActiveAgentPersistenceHook（会话续跑）、BookingPersistenceHook（tuniu 下单结果自动落库，对 LLM 透明）
• 优雅中断：AgentExecutionRegistryHook + Redis Pub/Sub 广播，支持集群跨节点停止
• 稳定性：ToolCircuitBreakerHook（熔断/半开/关闭三态 + 指数退避 + 显式关闭工具组，Redis 共享状态）
• 多租户隔离：RghUserIsolationHook + RghTokenStore 隔离 RGH 登录态；FlightApiKeyHook / TuniuApiKeyHook 动态注入 API Key
• Token 成本优化：CliResultCompressHook（MCP/CLI 结果去重压缩）+ SkillContentCollapseHook（历史技能正文折叠）
• 上下文：DynamicTimeInjectionHook 动态注入当前时间

工具矩阵（14 个 @Tool 类）

• 通用：UserInteractionTools（Human-in-the-Loop）、PolicyTools、DestinationLiveTools、QueryUserInfoTools、InfoQueryTools、ApiKeyTools
• 差旅单：TravelOrderReadTools / WriteTools / CloneItineraryTools / TravelOrderConflictTools
• 规划：ItineraryReviewTools、RoundtripPlannerTool（往返方案对比：去×住×返组合 / 时间价格归一化 / policy 软约束 / 偏好分合成 / 输出 4 类代表方案）
• 预订：BookingReadTools
• 报销：ReimbursementTools

外部能力集成

• Skill Shell（5 个）：tuniu-cli⭐（整合机票/酒店/门票/火车/邮轮/度假）、flight-manager、flyai、rolling-go-hotel、reimbursement
• MCP（2 个）：weather-mcp（Streamable HTTP）、orizn-visa-mcp（stdio 子进程；工具白名单降 token）
• RAG（3 个 Knowledge Bean）：attractionKnowledge / corporateTravelPolicyKnowledge / corporateTravelGuidelinesKnowledge；InfoAgent 采用 RAG 通道（语义问答）+ PolicyTools 通道（精确身份绑定） 双通道决策
• 百炼长期记忆：MasterAgent / ItineraryPlanAgent 启用 AGENT_CONTROL 模式，系统自动注册 record_to_memory / retrieve_from_memory；配请求级 TravelPreferenceMemoryCache 避免重复 LLM 调用

差旅业务能力

• 差旅政策合规：4 职级区间 × 3 城市等级 = 12 条规则，覆盖机票舱位 / 火车席别 / 酒店限额 / 星级 / 餐补 / 交通补贴 / 审批阈值 / 提前预订天数
• 行程冲突检测：TravelOrderConflictTools 检测同员工时间重叠（同城重复 / 跨城物理不可能）+ 跨城通行合理性，输出 HIGH/MEDIUM/LOW 三级
• 行程智能优化：RoundtripPlannerTool 双轨评分（LLM 偏好软判断 + 工具硬指标加权融合），多目标权衡输出 4 类代表方案
• 外部预订统一落库：booking_record 统一存储机票/酒店/火车/门票/邮轮/度假，含内外部单号与状态；按 userId 租户隔离查询

交互与前端能力

• SSE 流式协议 事件：message / thinking / progress / travel_data / plan_update / user_interaction / suggestions / agent-switch / interrupted / done
• Human-in-the-Loop：UserInteractionTools 支持 text / select / multi_select / confirm / form / date / number 等 UI 类型；工具暂停→前端表单→用户提交→Agent Resume
• 时间轴对话展示：前端按执行顺序渲染，思考/进度/结果混排
• 搜索结果卡片：多数据源（tuniu / flight-manager / flyai / rolling-go-hotel）经 TravelDataNormalizer 归一化为统一卡片模型

基础设施能力

• 集群部署：Redis Pub/Sub 广播中断、Redis 共享熔断状态、agentscope_session 表跨节点会话续跑
• 鉴权：Sa-Token（Redis Jackson 持久化，30 天 Token，随机 128 位）
• ThreadLocal 传播：TransmittableThreadLocal 解决 Reactor 线程切换的上下文丢失
• 全链路脱敏：SensitiveMasker（houbb sensitive）覆盖日志 Converter 与前端响应，覆盖手机号 / 身份证 / 银行卡 / 邮箱 / API Key / 密钥键值对

数据模型（11 张核心表）