Agent Skills
返回列表
FR24 航路国际机票

FR24 航路国际机票

生活服务 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @flightroutes24/fr24-ai-flight 到当前 AI 助手，并确认技能已加载。

技能介绍

解决什么问题

在 Agent 里做国际机票查询，容易卡在三处：自然语言行程要转成结构化搜索条件；查价返回里要区分可展示内容与仅供内部续跑的数据；走到预订时还必须把乘客确认、报价校验和真实下单的顺序锁死。

@flightroutes24/fr24-ai-flight 面向这类接入场景，把解析、查价、改条件重搜、乘客核对、校验与生单拆成一组可执行步骤，让上层对话模型不必直接拼 HTTP 请求。

核心能力与关键步骤

技能按脚本驱动的方式工作：

  • 行程解析：scripts/nl_to_search.py parse --text 把口语化行程整理成可搜索载荷；parse 不消耗演示日配额，先用 userView 与用户对齐行程、日期、人数和舱位。
  • 搜索与展示：确认后调用 scripts/skill_search_client.py search，每条报价都展示 quoteId（报价ID），并附带退改、行李摘要等用户可读信息。
  • 条件调整：用户改口航司或起飞时段时，不能只在旧结果上口头过滤，而是 scripts/nl_to_search.py refine 更新载荷后重新 search；航司写入 preferences.preferredCarrier 并提交服务端。
  • 预订闭环：parse-passengers 回显乘客与联系人；用户确认后 verify --passenger-confirmed；再展示 orderPreview 与 quoteId；用户明确回复「确认生单」后才能 order --user-confirmed。

适用边界与注意点

  • 支持单程和往返，不支持多段缺口程；只配置采购密钥后仍走 POST /ai/shopping，但请求头、签名和密钥校验方式不同。
  • 演示模式按 clientKey 限制每日搜索次数（默认 10，以服务端配置为准）；返回 307901 表示配额用尽，应引导开通采购并配置 APPKEY、签名密钥与 AES 密钥，而不是让用户明天再试。
  • userView、message 是唯一允许写入用户可见材料的来源；agentOnly（含 payload、offerId、traceId）与 .cache 路径不得直接发给用户。
  • 生单是真实订单。两次确认缺一不可，且禁止在对话中代填或展示密钥明文。

使用场景

  • 用户给出出发城市、日期和人数，需要解析行程并搜索当天最低直飞报价，附带退改与行李摘要。
  • 用户对结果不满意并补充航司和中午起飞时段，需要重新搜索，而不是口头筛选旧结果。
  • 用户确认乘客姓名和联系方式后，需要校验报价并展示订单预览，等待明确确认再生单。
  • 演示日搜索次数用完，需要引导用户开通采购并在本机配置 APPKEY、签名和 AES 密钥后继续查价。

适合人员

  • 在客服 Agent 中接入机票查询与下单的后端工程师：希望用脚本固定 parse/search/order 流程，减少手工拼请求。
  • 负责跨境出行助手的产品工程师：需要区分 userView 与 agentOnly，避免把内部字段展示给用户。
  • 管理国际机票采购账号的运营人员：希望演示配额耗尽后引导开通采购并配置本地密钥，而不是让用户明天再试。
  • 做旅行对话机器人的开发者：需要让 Agent 根据用户补充的航司和起飞时段执行 refine 并重新搜索。