# 参赛项目名称 星络 Xinglo —— 基于阿里云百炼与 Spring AI Alibaba 的智能旅行助手 ## 团队 / 作者与奖品领取人 - **团队名称:** 星络 Xinglo - **主要提交人 GitHub ID:** 849860605 - **其他成员:** 无,个人独立开发 ## 旅行场景与目标用户 面向自由行、周末旅行、亲子游及个性化出行用户,解决旅行攻略分散、规划耗时、行程难以调整、机票酒店价格查询繁琐等问题。 用户通过自然语言描述目的地、时间、预算和偏好,即可完成从旅行方案生成、交通住宿查询到行程管理的完整流程。 ## 我做了什么 开发了「星络 Xinglo」,一款以 AI Agent 为核心的旅行规划与生活助手,MVP 已部署至阿里云服务器。 **核心功能:** 1. **AI 智能规划:** 自然语言输入需求,生成需求卡、三套候选方案及完整的每日行程。 2. **动态行程调整:** 支持替换景点、重新安排某一天、保留已预约或已游览地点,支持行程版本管理和撤销。 3. **多平台旅行查询:** 集成飞猪 FlyAI、携程问道、美团、途牛等旅行服务能力,支持机票、酒店及相关价格信息查询。 4. **旅行工具协同:** 结合高德 MCP、天气服务及美食查询,实现景点定位、路线规划、交通费用估算和餐厅推荐。 5. **行程执行管理:** 支持旅行日程保存、提醒推送、iPhone 日历订阅及高德导航。 6. **实时交互:** 支持 SSE 流式响应、多轮对话、模型切换及工具调用。 **创新点:** 不仅生成静态旅行攻略,还将 AI 行程规划、多平台信息查询、局部修改和实际出行管理整合到同一个交互流程中。 ## 百炼使用说明(必填) - **百炼能力 / 模型:** 阿里云百炼 DashScope,项目默认配置通义千问 qwen-turbo(意图路由)、qwen-plus(技能执行)、qwen-max(复杂规划)、qwen-vl-plus(视觉理解)。 - **调用方式:** Spring AI Alibaba 集成 DashScope,通过百炼 API 调用模型;使用 Spring AI Alibaba Graph 组织 AI Agent 工作流。 - **使用环节与输入输出:** - 输入:用户自然语言旅行需求、预算、出发时间、兴趣偏好及外部工具查询结果。 - 处理:识别意图、路由至旅行技能、调用地图/天气/旅行服务工具、整合信息、生成旅行计划。 - 输出:旅行候选方案、每日详细行程、交通住宿建议及自然语言回答。 - **Skill 名称:** Travel(旅行规划)、Food(美食推荐)、Schedule(日程管理)。 - **其他工具 / 技术栈:** Java 21、Spring Boot 3.5、Spring AI Alibaba、Spring AI、Maven、PostgreSQL、Redis、uni-app、Vue 3、TypeScript、Docker、高德 MCP、飞猪 FlyAI、携程问道、阿里云服务器。 ## 效果展示 展示星络实际运行界面: 1. AI 对话首页及旅行需求输入 2. 三套候选方案生成与完整行程展示 3. 行程局部调整与版本管理 4. 飞猪等平台的机票、酒店查询结果 5. 地图路线、交通费用及日程提醒 **实际运行截图:** 在此粘贴项目运行截图或演示视频。 <img width="3496" height="1940" alt="Image" src="https://github.com/user-attachments/assets/a75b0a93-9a44-4c09-b0f2-5c00bed86a20" /> <img width="3474" height="2510" alt="Image" src="https://github.com/user-attachments/assets/19294283-d703-4314-b017-4e1396645948" /> <img width="2070" height="1650" alt="Image" src="https://github.com/user-attachments/assets/3d133e19-f602-4370-8efe-8766c6d4ff49" /> <img width="3040" height="1974" alt="Image" src="https://github.com/user-attachments/assets/cbf982c7-b9df-4dcd-9cc3-77783f3e42ab" /> <img width="3518" height="1962" alt="Image" src="https://github.com/user-attachments/assets/c3971474-19a1-4751-acf5-599ac7c7afe6" /> <img width="3444" height="2127" alt="Image" src="https://github.com/user-attachments/assets/e0f59dea-4e32-47d9-83b6-0ba16f4c43fa" /> <img width="3496" height="1974" alt="Image" src="https://github.com/user-attachments/assets/6677a21d-de51-4ae4-8540-2836939b68f6" /> <img width="3512" height="3767" alt="Image" src="https://github.com/user-attachments/assets/224ccdef-34d2-47f3-8ed1-725aff1b8759" /> ## 项目链接与复现方式 **GitHub 仓库:** https://github.com/849860605/life-assistant **项目状态:** MVP 已上线,支持 Web/H5 使用及邮箱注册。 **本地复现:** 1. 克隆仓库并安装 JDK 21、Maven、Node.js 和 Docker。 2. 复制 `.env.example` 为 `.env`,配置百炼 DashScope API Key。 3. 启动 PostgreSQL 和 Redis。 4. 执行 `mvn -pl life-api -am spring-boot:run` 启动后端。 5. 进入 `life-web`,执行 `npm install && npm run dev:h5`。 6. 打开 `http://localhost:5173`,登录后输入旅行需求即可体验。 具体环境配置及测试方式见仓库 README。 ## 踩坑记录(可选) **1. 旅行生成耗时较长:** 将需求确认、候选方案生成与完整行程拆分,结合 SSE 流式输出优化体验。 **2. AI 容易重新生成整个行程:** 设计局部修改、地点保留、版本管理与撤销机制。 **3. 第三方旅行接口不稳定:** 针对查询额度不足、机票尚未开售等情况增加错误处理和友好提示,避免 AI 编造价格。 **4. 地图 MCP 连接不稳定:** 将高德 MCP 连接调整为 Streamable HTTP,改进连接恢复机制。 **5. AI 意图识别准确性:** 构建旅行、日程、美食等路由评测用例,项目走查记录中 77 条路由测试全部通过。
Activity