运行时依赖
安装命令
点击复制技能文档
航班价格图表 嵌入一个交互式的航班价格趋势可视化组件,当 AI 响应包含航班推荐且确认了 OD(起点-终点)对时。 ⚠️ 使用前必需配置 本 skill 需要 SerpAPI Key 才能获取实时航班价格数据。 如果用户尚未配置 SerpAPI Key,请先引导用户完成以下步骤: 注册 SerpAPI 账号:访问 https://serpapi.com/users/sign_up 免费注册 获取 API Key:登录后在 Dashboard 中复制你的 API Key 配置项目:复制 price/config.example.json 为 price/config.json 将 API Key 填入 config.json 中的 serpapi.apiKey 字段 重启服务器使配置生效 💡 SerpAPI 提供免费额度,足够个人使用。配置完成后即可获取真实的航班价格趋势数据。
快速开始 检测航班推荐:当 AI 输出包含航班搜索结果且有具体的起点和终点 获取价格数据:调用价格趋势 API 并传入 OD 对 渲染组件:在响应末尾嵌入 PriceChart 组件
组件 API PriceChart 组件
数据结构 priceHistory - 60 天价格历史:[ { date: "2026-03-01", price: 1299 }, { date: "2026-03-02", price: 1350 }, // ... 最多 60 天 ] analysis - 价格分析对象:{ min: 1199, // 最低价格 max: 1899, // 最高价格 average: 1450, // 平均价格 pctDiff: -12, // 与平均价格的百分比差 level: "low", // "low" | "mid" | "high" trend: "falling" // "falling" | "rising" | "stable" } destination - 目的地信息:{ code: "TYO", // 机场/城市代码 name: "Tokyo" // 城市名称 }
使用场景
- 航班搜索结果后
- 价格查询响应
- 购买/等待推荐
与 flyai 集成 使用 flyai 进行航班搜索: 调用 flyai search-flight 获取航班结果 从搜索参数中提取 OD 对 调用价格趋势 API 并传入 OD 对 在航班卡片后追加 PriceChart 组件
视觉设计 颜色编码 低价格:绿色 (#16A571) - 低于平均价格 中等价格:灰色 (#666666) - 接近平均价格 高价格:红色 (#E54D4D) - 高于平均价格 品牌:紫色 (#6666FF) - 图表线 图表功能 交互式悬停/点击以查看每日价格 虚线显示平均价格 当前价格突出显示 最小/最大/平均统计数据在底部 60 天日期范围
数据来源注意 快速设置真实数据 默认情况下,价格趋势使用模拟数据(仅用于演示/开发)。 要启用真实价格数据,请配置您的 SerpAPI Key: 在 https://serpapi.com/users/sign_up 获取 API Key 将其添加到 price/config.json 中:{ "serpapi": { "apiKey": "your-key-here" } } 重启服务器 请参阅 references/configure-serpapi.md 以获取详细的设置指南。
数据流 之前:用户查询 → 模拟数据生成器 → 估算价格 之后:用户查询 → SerpAPI → 真实价格 → 自动收集和存储置信度 随着数据的积累,AI 响应应指示置信度: 数据天数 置信度 AI 免责声明 < 7 天 低 "价格数据为估算值,仅供参考" 7-29 天 中 "根据部分真实价格数据..." 30+ 天 高 "根据积累的真实价格数据..."
参考 组件文档 PriceChart references/price-chart-component.md 数据 API references/price-api.md 分析逻辑 references/price-analysis.md 数据来源 references/data-sources.md
示例输出 根据您的搜索,以下是前往东京的最佳航班: [航班卡片组件]
价格分析
当前价格比平均价格低 12%。 [价格趋势图组件]推荐:购买 ✅
- 当前价格:¥1,299
- 历史平均价格:¥1,450
- 您节省:¥151