SuperAPI AI 工具集

duffel

部署与运维

查看项目

更新于 10-16 03:42

技能介绍

用途:该技能用于通过 Duffel 完成面向用户的航班搜索、比价、预订、支付、订单管理与已订航班票价监控。使用前需先阅读 /opt/hatch/skills/booking/SKILL.md 及相关参考文件,其中定义发现、隐私、展示和承诺规则。

主要能力:命令行公开接口包括 search、seat-options、validate-booking、book、booking-status、cancellation-quote、cancel-booking。搜索支持单程、往返、多城市、乘客组合、排序、直飞或转机限制、指定航司等;比价搜索建议使用 --limit 300。预订流程为:完整行程与乘客组合搜索、展示 3–6 个精选报价、可选座位、收集乘客信息、反复运行 validate-booking 直至 ready_to_book: true、选择返回的 Stripe Link 支付方式、以同一报价和座位调用一次 book。成功后报告承运人确认号/PNR 及出票状态。

票价监控:对已订航班创建跟踪任务,需收集准确行程、乘客组合、舱位或票价族、含行李、经停方式、实付总价、币种及已知退改费用,将最小机器可读状态存入 ~/workspace/goals/<goal-slug>/hidden_files/travel/flight.json,并以 flight-price-<goal-slug> 标识创建每日 cron 任务,每次仅运行一次搜索,仅在定价范围完全匹配时比较并计算净节省。

限制:不得编造标识符、调用未记录端点或向用户暴露 off_、ord_、ore_ 等 ID;不得展示 Duffel 命令;不得索取支付卡或账户凭据。搜索须直接输出到独立临时 JSON 文件,不可通过 head 或解析器管道截断。缺失事实应标为“not stated”,退款与可改签按三值处理。两岁以下婴儿独立占座的情况无法可靠预订,应引导至航司。搜索结果仅为实时快照,不能当作持续价格监控循环。零结果仅表示已扫描库存无匹配。分类依据其航班搜索、预订与订单管理用途归入通用与其它。