by 运行时依赖
安装命令
点击复制技能文档
AI机票助手
当用户询问航班搜索、舱位查询、机票预订、机票改期或机票退票时，使用此 技能 调用AI机票服务。
运行环境要求
本 技能 通过 python3 执行 HTTP POST 请求调用AI机票服务。运行环境必须提供 python3。
隐私与个人信息（PII）说明
预订功能会将用户提供的个人信息（乘客姓名、手机号、证件号等）通过 HTTP POST 发送至AI机票服务，以完成机票预订。使用本 技能 即表示用户知晓并同意上述 PII 被发送到外部服务。请勿在日志或回复中暴露用户个人信息。
可用工具
重要：下方示例中的参数均为占位，调用时需根据用户当前需求填入实际值（城市、日期、航班号、乘机人、联系方式等），勿直接照抄示例值。
适用场景 按出发/到达城市、日期搜索航班列表 查看指定航班的舱位价格详情 用户确认后创建机票预订订单 查询已创建订单的详细信息 用户确认后改期或退票已创建订单的航班 鉴权流程（必须先完成）
重要：使用任何功能前，用户必须先完成鉴权流程。鉴权成功后获得的 APIKey 会自动保存在用户主目录的 ~/.fbt_auth.json 文件中，新会话会自动沿用。
鉴权步骤 发送验证码：用户提供手机号，系统发送验证码到手机 验证并获取 APIKey：用户输入验证码，验证成功后获得 APIKey 自动注入：后续所有 API 调用会自动携带 APIKey 鉴权命令
- 发送验证码
示例：
python3 scripts/auth.py 发送 13800138000
- 验证并获取 APIKey
示例：
python3 scripts/auth.py 验证 13800138000 123456
- 查看鉴权状态
python3 scripts/auth.py 状态鉴权检查规则
在执行任何航班查询、预订、改期、退票操作前，必须先检查鉴权状态
如果未鉴权或 APIKey 已过期，必须引导用户完成鉴权流程
鉴权成功后，所有 API 调用会自动携带 APIKey，无需手动传递
- 航班搜索 (搜索Flight)
功能：查询国内航班列表
必填参数：
启动_code: 出发城市名称（如 北京、上海、广州）
end_code: 到达城市名称
date: 出发日期（格式 YYYY-MM-DD）
触发词：某地到某地航班、查机票、搜航班、机票价格
执行命令：
python3 scripts/搜索_flights.py <启动_code>
示例：
python3 scripts/搜索_flights.py 北京 上海 2026-03-15
返回结果：航班列表（航班号、航空公司、起降时间、机型、机场、最低价等）
上下文检查规则：
如果用户在当前或之前的消息中已经提供了某个参数，则无需再次询问该参数
只向用户询问尚未提供的参数
如果所有参数都已提供，直接发起请求
展示要求:
必须使用代码块包裹脚本输出的表格
必须展示完整表格
参考"输出格式要求"章节的标准格式
- 舱位详情查询 (搜索Price)
功能：查询特定航班的详细价格信息
必填参数：
启动_code: 出发机场三字码（从 搜索Flight 响应结果中获取）
end_code: 到达机场三字码（从 搜索Flight 响应结果中获取）
date: 出发日期（格式 YYYY-MM-DD）
flight_no: 航班号
触发词：查看航班详情、这个航班的舱位价格
执行命令：
python3 scripts/搜索_price.py <启动_code>
示例：
python3 scripts/搜索_price.py PEK PVG 2026-03-15 CA1501
返回结果：该航班的各舱位价格、折扣、退改签规则等详细信息，并将舱位信息保存到 /tmp/flight_seat_items.json 供下单使用
使用场景：用户先使用航班搜索查询航班列表，从返回的航班列表中选择某个航班后，使用此功能查询该航班的详细价格信息
展示要求:
必须使用代码块包裹脚本输出的表格
必须展示完整表格
参考"输出格式要求"章节的标准格式
- 退改规则和行李额查询 (搜索GuestRule)
功能：查询指定舱位的详细退改签规则和行李额
必填参数：
seat_索引: 舱位编号（从舱位详情查询结果中选择，如 1、2、3）
触发词：退改规则、退票规则、改签规则、这个舱位的退改政策、行李额、客规
执行命令：
python3 scripts/搜索_guest_rule.py
示例：
python3 scripts/搜索_guest_rule.py 1
返回结果：该舱位的退票、改签、行李额等详细规则说明
重要说明：
此功能为可选流程，仅在用户明确询问退改规则时调用
seat_索引 必须来自最近一次舱位详情查询的结果
舱位信息从 /tmp/flight_seat_items.json 文件中读取
如果文件不存在或舱位编号无效，会提示用户先执行舱位详情查询
- 机票下单 (创建Order)
功能：创建机票订单
必填参数：
seat_索引: 舱位编号（从上一步舱位详情查询结果中选择，如 1、2、3）
passenger_name: 乘客姓名
passenger_phone: 乘客手机号
passenger_id: 乘客证件号
触发词：订这个、预订、下单
执行命令：
python3 scripts/创建_order.py
示例：
python3 scripts/创建_order.py 1 "张三" "13800138000" "110101199001011234"
返回结果：订单号、支付链接、订单详情链接等
重要说明：
seat_索引 必须来自最近一次舱位详情查询的结果
舱位信息从 /tmp/flight_seat_items.json 文件中读取
如果文件不存在或舱位编号无效，会提示用户先执行舱位详情查询
必须向用户索取乘客姓名、手机号和证件号，不可使用默认值或跳过
- 订单详情查询 (orderDetAIl)
功能：查询已创建订单的详细信息
必填参数：
order_id: 订单号（从下单接口返回的订单号中获取）
触发词：订单详情、查看订单、查询订单、订单状态
执行命令：
python3 scripts/order_detAIl.py
示例：
python3 scripts/order_detAIl.py 69a677bee4b0252bd532e35c
返回结果：订单的详细信息，包括航班信息、乘客信息、支付状态等
重要说明：
订单号可以从下单接口的返回结果中获取
此功能可用于查询订单的实时状态和详细信息
- 取消订单 (cancelOrder)
功能：取消待支付状态的订单
必填参数：
order_id: 订单号（从下单接口返回的订单号中获取）
触发词：取消订单、不要了、取消这个订单
执行命令：
python3 scripts/cancel_order.py
示例：
python3 scripts/cancel_order.py 69a677bee4b0252bd532e35c
返回结果：取消成功或失败
重要说明：
此功能仅适用于待支付状态的订单
订单号可以从下单接口的返回结果中获取
已支付或已出票的订单无法通过此接口取消，需要使用退票功能
- 改期航班搜索 (endorse搜索Flight)
功能：查询可改期的航班列表
必填参数：
order_id: 订单号（从订单详情或下单接口返回的订单号中获取）
dep_date: 改期日期（格式 YYYY-MM-DD，需要向用户索取）
触发词：改期、改签、换航班、查改期航班
执行命令：
python3 scripts/endorse_搜索_flight.py
示例：
python3 scripts/endorse_搜索_flight.py 69a677bee4b0252bd532e35c 2026-03-20
返回结果：可改期的航班列表（航班号、航空公司、起降时间、机场、最低价等）
重要说明：
订单号可以从订单详情接口获取
改期日期需要向用户索取
此接口会自动从订单详情中提取 flight_no（从 segment信息.flight_no 获取）和 ticket_ids（从 passenger列出[0].productId 获取）
返回的航班列表格式与航班搜索接口一致，方便用户选择
展示要求:
必须使用代码块包裹脚本输出的表格
必须展示完整表格
参考"输出格式要求"章节的标准格式
- 改期舱位详情查询 (endorse搜索Price)
功能：查询指定改期航班的舱位价格详情（改期费、机票差价费等）
必填参数：
order_id: 订单号（从订单详情或下单接口返回的订单号中获取）
dep_date: 改期日期（格式 YYYY-MM-DD，与改期航班搜索时使用的日期一致）
flight_no: 航班号（从改期航班搜索结果中选择）
触发词：查看改期价格、这个航班的改期费、改期舱位详情
执行命令：
python3 scripts/endorse_搜索_price.py
示例：
python3 scripts/endorse_搜索_price.py 69a677bee4b0252bd532e35c 2026-03-20 HU7603
返回结果：该航班的各舱位改期费、机票差价费、预估总改期费等详细信息，并将舱位信息保存到 /tmp/endorse_seat_items.json 供改期下单使用
重要说明：
此接口必须在改期航班搜索之后调用
flight_no 必须来自改期航班搜索返回的航班列表，需要用户选择
此接口会自动从订单详情中提取 ticket_ids（从 passenger列出[0].productId 获取）
展示的改期费用信息包括：改期费、机票差价费、预估总改期费
舱位信息会保存到临时文件供后续改期下单使用
展示要求:
必须使用代码块包裹脚本输出的表格
必须展示完整表格
参考"输出格式要求"章节的标准格式
- 提交改期申请 (endorse应用ly)
功能：提交改期申请，创建改期订单
必填参数：
seat_索引: 舱位编号（从改期舱位详情查询结果中选择，如 1、2、3）
order_id: 原订单号（从订单详情或下单接口返回的订单号中获取）
触发词：确认改期、提交改期申请、改期下单
执行命令：
python3 scripts/endorse_应用ly.py
示例：
python3 scripts/endorse_应用ly.py 1 69a677bee4b0252bd532e35c
返回结果：改期单订单号、支付