Travel Itinerary

travel-itinerary — 智能行程规划

定位： P1 技能。上游依赖 travel-knowledge（旅游资源知识库），下游交付 feishu-doc（飞书文档）。输入需求描述，产出完整行程方案。

触发条件

核心工作流（7 步）

Step 0 — 图片识别（可选前置）

📌 2026-05-28 新增：minimax understand_image 已确认可用。

当用户发送景区/美食/路牌照片时，先调用图片理解：

mcp_minimax_mcp_understand_image(
  prompt="识别这张图片中的地点/景点/美食/标识，给出名称、位置、简要信息和游玩建议。如果是景区照片，请判断具体是哪个景点。",
  image_source="<图片URL或本地路径>"
)

识别结果注入 Step 3 的目的地信息池，用于后续行程规划。

Step 1 — 解析需求 + CRM 画像查询

子步骤 1a：从用户输入中提取结构化参数

偏好 → 行程风格映射：

子步骤 1b：查询 CRM 画像（如果用户提供了姓名）

📌 2026-05-28 新增：对接「贵州之客 CRM 客户画像」多维表格。

当用户提到客户姓名时，查询 CRM 获取历史偏好：

lark-cli base +record-search --base-token Wi1HbLBJZa8oWSsUmakcM3k3n5e \
  --table-id tblloIwP9YAo64Dv \
  --json '{"keyword":"<客户姓名>","search_fields":["客户姓名"]}' \
  --as bot

⚠️ +record-search 使用 keyword 搜索模式（非 Open API 的 filter/conditions 格式）。如需结构化筛选，使用 +record-list + 视图过滤。

CRM → 行程参数自动填充：

如果 CRM 中无此客户 → 跳过此步骤，使用默认参数。规划完成后提示"是否存入 CRM"。

Step 2 — 并行查询天气（weather + amap MCP）

BEFORE 规划具体路线，必须先拉取气象数据。 按日期间隔选择工具：

天气影响规则（自动应用）：

Step 3 — 搜索目的地信息 + 查询知识库（minimax + travel-knowledge）

子步骤 3a：先查知识库存量

🏔️ 自有基地快速通道：当目的地为贵州之客三大自有基地（笃山天坑/犀牛洞/马鞭田白水河桨板）时，Agent 已具备完整基地知识（位置/体验类型/装备/时长/安全要求），跳过知识库查询和 web_search，直接从 Step 4 POI 定位开始。非自有基地或混合行程仍需走完整搜索流程。

调用 travel-knowledge 技能 → 搜索已有攻略/景点信息
  如命中 → 直接使用，标注"来自知识库（采集日期：YYYY-MM-DD）"
  如未命中或过期 → 进入 web_search

子步骤 3b：minimax web_search（交叉验证）

第1轮：景点基础信息
  → "{destination} 旅游攻略 2026 必去景点 门票价格"
  → "{destination} 最新开放时间 注意事项"

第2轮：时效性信息（交叉验证）
  → "{destination} 近期景区公告 道路状况"
  → "{destination} 游玩攻略 避坑指南"

第3轮（可选）：深度内容
  → "{destination} 当地美食推荐 特色体验"
  → "{destination} 民族文化 非遗体验"

⚠️ minimax web_search 降级路径：当返回 login fail / API Error 时，不阻塞流程，自动切换到：

1. mcp_amap_maps_text_search + maps_search_detail 获取 POI 结构化信息（名称/地址/评分/开放时间）
2. 结合 Agent 训练数据中的目的地常识补充景点描述
3. 在输出文档中标注「建议地接团队核实最新门票价格和开放时间」

提取结构化信息：

• 景点名称、评级（5A/4A）、参考游玩时长
• 门票价格、开放时间、最佳游览时段
• 特色体验项目（探洞/桨板/民俗表演）
• 餐饮推荐（本地人常去、人均消费）
• 住宿区域建议
• ⚠️ 近期注意事项（修路/闭园/限制）

Step 4 — POI 定位 + 路线规划（amap MCP）

子步骤 4a：地理编码

对每个景点/酒店执行：
  mcp_amap_maps_geo（地址 → 经纬度）

子步骤 4b：周边搜索

对每个核心景点执行：
  mcp_amap_maps_search_around
    - 附近餐厅（type=餐饮）
    - 附近酒店（type=酒店）
    - 附近停车场、卫生间、加油站

子步骤 4c：路线规划

Day N 内移动：
  景点A → 景点B：mcp_amap_maps_direction_driving（包车/自驾）
  或 mcp_amap_maps_direction_transit_integrated（公交方案）
  或 mcp_amap_maps_direction_walking（景区内步行）

记录每段：

• 距离（km）、预估耗时（分钟）
• 路线摘要（途经主要道路）
• 同时提供备选方案（更快 / 风景更好）

子步骤 4d：路况判断（降级方案）

⚠️ 2026-05-30 实测：当前 Web 服务 Key 无交通路况 API 权限（返回 INVALID_PARAMS）。企业版 Key 可开通。

当前降级方案：

• 贵州山路默认预留 +25-35% 时间缓冲（非 +20-30%）
• LLM 根据常识判断：旅游旺季/节假日 → 热门路段拥堵概率↑
• 地接版「风险点位标注」中用文字描述路况风险（弯道多/窄路/落石路段），不依赖实时数据

子步骤 4e：高德 APP 联动（专属地图 + 导航唤端 + 打车唤端）

✅ 2026-05-30 确认：当前 amap MCP 配置 url: "https://mcp.amap.com/mcp?key=..." 为 MCP 2.0（Streamable HTTP），以下 3 个工具已注册可用。

完成路线规划后，针对每个 POI 和每段行程生成高德 APP 唤端链接：

专属地图生成： 将整日行程（POI 列表 + 时段描述）导入高德 APP 生成私有地图。 导航唤端： 每个目的地生成 amapuri:// 一键导航链接。 打车唤端： 景点间生成高德打车唤端链接（origin → destination）。

这些链接嵌入 Step 7 客户版文档，游客在手机端点击即可跳转高德 APP。

Step 5 — LLM 智能规划与优化

📌 用户批注要求："考虑采用 LLM 进行规划或者优化"，而非引入 OR-Tools。

将 Step 2-4 的所有数据（天气、景点、路线）传入 LLM 推理，产出优化后的日程：

LLM 优化目标：

1. 天气适配 — 雨天日安排室内/交通；晴天抓紧户外观景
2. 时间合理 — 每天游玩时间 6-8 小时，含午餐休息
3. 空间聚合 — 同方向景点归到同一天，减少绕路
4. 节奏控制 — 高强度日（多景点/长距离）与放松日交替
5. 偏好满足 — 根据用户偏好标签优先安排对应活动类型

⚠️ 不依赖 OR-Tools，由 LLM 在语义层面完成排序优化。

Step 6 — 费用预估

输出费用汇总表： 明细 + 小计 + 总计（元/人）

Step 7 — 生成双版文档

使用 feishu-doc 技能创建飞书文档，归档至知识库「方案计划」节点。

A. 客户版（面向游客）

结构：

1. 📌 行程概览卡片（目的地/天数/人数/日期/预算）
2. 🌤️ 天气预报总览（每日图标+温度+AQI）
3. 🗺️ 每日详细行程（时间轴格式：08:30 出发 → 09:00 抵达 → 12:00 午餐 → ...）
4. 🍜 美食推荐（每天 2-3 家）
5. 💰 费用明细表
6. 🎒 行前准备清单（证件/衣物/装备/药品）
7. 📞 紧急联系与实用贴士

B. 地接版（面向导游/地接团队）

在客户版基础上追加：

1. 🚌 交通执行明细（每段路线+距离+预估时间+备选方案对照表）
2. 📞 供应商联系清单（酒店/餐厅/车队/景区 — 由地接团队填写）
3. 🧾 物资清单（团队物资+客户物资+应急物资）
4. ⚠️ 风险点位标注（天气风险/路况风险/体能要求）
5. ⏱️ 时间缓冲表（每段预留缓冲时间 + 雨天备选方案）

MCP 工具调用映射

📌 当前 amap MCP 配置为 MCP 2.0（Streamable HTTP url: "https://mcp.amap.com/mcp?key=..."），全部 13 个 amap 工具均已注册。若将来降级到 MCP 1.0（uvx stdio），3 个 schema 工具（专属地图/导航/打车）将不可用。

输出规范

文档命名规则

贵州之客_行程方案_{destination}_{days}天{dates}_v{version}

示例：贵州之客_行程方案_荔波_3天0615-0617_v1

知识库归档

• 分类：方案计划（node_token: KVPTwrbOKiQMUkkUPlscaEKfnUd，space_id: 7643710721485753535）
• 创建文档：lark-cli docs +create --title "..." --content "@./file.md" --parent-token KVPTwrbOKiQMUkkUPlscaEKfnUd --as bot
• 每次规划产出独立文档
• 修订时在原文档上 +update --command append

质量检查清单

• 天气数据已拉取且日期匹配？
• 搜索信息已交叉验证（≥2 次搜索）？
• 每段路线有距离和预估耗时？
• 每日游玩时间 ≤ 8 小时？
• 雨天方案已标注备选？
• 费用表有明细+小计+总计？
• 客户版和地接版均已生成？
• 文档已归档至知识库？

已实现的能力（来自 MCP 矩阵）

待完善的能力

预设参数（贵州之客默认值）

已知 MCP 工具名称（供 Agent 直接调用）

天气查询（weather MCP — Streamable HTTP，工具名由 provider 动态注册）：
  七天预报      — 未来 7 日天气/温度/风力/AQI
  15日预报      — 未来 15 日趋势（逐小时温/湿/风/紫外线/降水概率）
  实况天气      — 当前温湿度/风力/能见度
  分钟级降水    — 未来 2 小时降水预测（分钟粒度）
  历史天气      — 指定日期历史记录
  景区天气      — 目的地景区专属预报
  空气质量      — AQI/PM2.5/PM10
  查询方式：city 名称 / lat,lng 坐标 / IP 地址
  备选：mcp_amap_maps_weather

地理服务（amap MCP 2.0 — 全部 13 个工具已注册）：
  mcp_amap_maps_geo              — 地址→经纬度
  mcp_amap_maps_regeocode        — 坐标→地址
  mcp_amap_maps_text_search      — 关键词 POI 搜索（返回 pois 键，非 results）
  mcp_amap_maps_search_around    — 周边 POI 搜索（返回 pois 键，非 results）
  mcp_amap_maps_search_detail    — POI 详情（电话/评分/照片）
  mcp_amap_maps_direction_driving        — 驾车路线
  mcp_amap_maps_direction_walking        — 步行路线（响应嵌套在 route 下）
  mcp_amap_maps_direction_bicycling      — 骑行路线
  mcp_amap_maps_direction_transit_integrated — 公交路线
  mcp_amap_maps_distance          — 距离测量
  mcp_amap_maps_schema_personal_map — 专属地图（返回纯文本 amapuri://）
  mcp_amap_maps_schema_navi       — 导航唤端（返回纯文本 amapuri://）
  mcp_amap_maps_schema_take_taxi  — 打车唤端（返回纯文本 amapuri://）

资讯搜索（minimax）：
  mcp_minimax_mcp_web_search  — 联网搜索

文档生成（feishu-doc 技能）：
  加载 feishu-doc 技能 → 使用 lark-cli docs +create

陷阱与注意事项

1. 天气必须在规划前拉取 — 不能先排路线再看天气，会导致晴天安排室内、雨天安排户外的逻辑错误
2. 搜索必须交叉验证 — 单一搜索结果可能存在过时信息，至少 2 次搜索比对
3. amap POI 类型参数 — 中文类型名（"餐饮"/"酒店"/"景点"），非英文
4. 路线距离 ≠ 实际耗时 — 贵州山路多，预留 +25-35% 缓冲（非 +20-30%）。2026-06-02 实测：贵阳→安龙 S57 六安高速段经 20+ 座隧洞（灯草塘/老桥坡/牛角山/红枫湖/大扁山/东苗冲/小坡村/羊湾/黄果树/鸡公背/关岭一号二号/八角岩/尾纳/九头坡/猴子坡/新桥/李子树/上关/纳拜/大块榜/革老寨/营盘坡/袁家林/花江/山林湾/贞丰/江家湾/犀牛洞/笃山），隧道群限速+频繁变道显著增加实际通行时间。乡道末段如笃山镇至天坑为土路，雨季需额外 +15min。
5. 门票价格会变动 — 搜索结果注明年份/季节，避免使用淡季价格作为旺季参考
6. 地接版需要供应商信息 — 酒店电话/车队联系人等需地接团队后续填写，LLM 仅生成空白模板
7. 跨天行程注意住宿连续性 — 避免 Day N 住宿点离 Day N+1 第一站太远
8. 专属地图/唤端链接 — 当前 amap MCP 为 MCP 2.0（Streamable HTTP url: "https://mcp.amap.com/mcp?key=..."），15 个工具已确认可用（2026-05-30 实测 tools/list 返回全部 15 工具含 3 个 schema）。注意：MCP 端点偶发 500（2026-05-28 日志记录），重启 gateway 后重试即可。若将来降级到 MCP 1.0 则 schema 工具不可用。
9. 模板 XML 标签 — itinerary-template.md 使用的 <callout>、<grid>、<table> 等 Lark XML 标签经 2026-05-30 实测确认可由 lark-cli docs +create 直接渲染。注意：emoji 属性会被 API 自动标准化（如 📌 → pushpin），width-ratio 会被转为百分比整数（如 0.5 → 50），不影响视觉效果。
10. MCP 2.0 响应格式不统一 — maps_text_search 和 maps_around_search 用 pois 键（非 results）；maps_regeocode 和 maps_weather 是扁平结构（无 results 包装）；maps_direction_walking 嵌套在 route 下；Schema 唤端工具返回纯文本 URI（非 JSON）。详见 native-mcp 技能 references/amap-mcp-response-formats.md。
11. minimax web_search 降级路径 — 当 minimax MCP 的 web_search 返回 login fail / API Error 时（认证过期或 Key 未配置），不阻塞规划流程。降级方案：① amap maps_text_search + maps_search_detail 获取 POI 信息（名称/地址/评分/开放时间/门票）；② LLM 常识补充目的地景点描述；③ 在输出文档中标注「建议地接团队核实门票价格和最新开放时间」。此降级路径已 2026-06-02 实战验证可行。