Rail Ticket Helper

分贝通火车预订助手，实时查询火车票、展示车次列表、预订火车票、查看订单、取消订单。Invoke when user wants to search trains, book train tickets, check train orders, or cancel train bookings.

分贝通火车预订助手 (fb-train-skill)

技能描述

分贝通火车预订助手，实时查询火车票、展示车次列表、预订火车票、查看订单、取消订单。

---

⚠️ 【重要约束】

• 必须调用 scripts/fb_train_api.py 中的函数获取数据
• 禁止自行编造车次信息、价格或余票
• 接口返回什么数据就展示什么，不要修改

---

技能概述

基于分贝通火车OpenAPI开发的自动化对接技能，支持火车票搜索、预订、取消、查询等全流程操作，适配国内火车票预订场景。

技能能力

核心能力

1. 火车票搜索：按出发站、到达站、日期查询车次列表
2. 车次详情查询：获取指定车次座位类型、价格、余票等信息
3. 预订火车票：创建火车票订单
4. 订单管理：查询订单详情、取消订单
5. 收银台支付：获取支付链接，引导用户完成支付

触发条件

1. 火车票搜索：当用户输入「火车票/订火车票/查火车票/高铁/动车」+ 出发地/目的地/日期信息时，必须调用 scripts/fb_train_api.py 中的 search_train_list() 函数

   • 返回车次列表，使用表格形式展示
   • 默认展示5个车次，用户可选择继续查看更多
   • 展示格式示例：

     🚄 北京南 → 上海虹桥（3月15日）
     
     | 序号 | 车次 | 出发时间 | 到达时间 | 历时 | 二等座 | 一等座 | 商务座 |
     |:---:|:---|:---:|:---:|:---:|:---:|:---:|:---:|
     | 1 | G1 | 09:00 | 13:28 | 4时28分 | ¥553 | ¥933 | ¥1748 |
     | 2 | G3 | 14:00 | 18:28 | 4时28分 | ¥553 | ¥933 | ¥1748 |
     
     💡 回复"序号"查看车次详情，如"1"查看第1个车次
     

2. 查看车次详情（序号）：用户回复"序号"查看车次座位详情

   • 必须调用 scripts/fb_train_api.py 中的 get_train_detail() 函数
   • 展示各座位类型的价格和余票
   • 展示格式示例：

     🚄 G1 北京南 → 上海虹桥
     📅 出发：3月15日 09:00 | 到达：3月15日 13:28
     ⏱️ 历时：4时28分
     
     | 座位类型 | 价格 | 余票 |
     |:---:|---:|:---:|
     | 二等座 | ¥553 | 有票 |
     | 一等座 | ¥933 | 5张 |
     | 商务座 | ¥1748 | 无票 |
     
     💡 回复"座位类型"预订，如"二等座"
     

3. 订单创建：用户选择座位类型后创建订单

   • 收集乘车人信息：姓名、身份证号、手机号
   • 调用创建订单接口，返回订单ID
   • 订单创建成功的展示内容：

     ✅ 订单创建成功！
     
     🚄 G1 北京南 → 上海虹桥
     📅 出发：3月15日 09:00
     🎫 座位：二等座
     💰 价格：¥553
     👤 乘车人：张三
     
     🔗 [立即支付](https://app-gate.fenbeitong.com/business/train/open/push/redirect?orderId={order_id}&isSkill=true&type=0)
     🔗 [查看订单详情](https://app-gate.fenbeitong.com/business/train/open/push/redirect?orderId={order_id}&isSkill=true&type=1)
     

4. 订单操作：用户发起取消/查询（需提供订单ID）

   • 取消订单：支持填写取消原因
   • 查询订单详情：展示订单完整信息

对接信息

基础配置

• 环境：线上环境
• 核心域名：https://openapiv2.fenbeitong.com
• X-App-Id：688c927d2cf90c6f0595571d（所有接口统一使用此App-Id）
• Content-Type：application/json

通用请求规则

1. 所有POST请求，参数为JSON格式
2. 日期格式：yyyy-MM-dd
3. 时间格式：HH:mm

核心接口列表

一、查询类接口

接口名称	接口地址	核心用途	必选参数
火车票搜索	/openapi/travel/train/search_list/v1	按出发站/到达站/日期查车次	from_station, to_station, travel_date
车次详情	/openapi/travel/train/detail/v1	查车次座位类型/价格/余票	train_no, travel_date
订单详情查询	/openapi/travel/train/order/detail/v1	查订单状态/信息	order_id

二、订单类接口

接口名称	接口地址	核心用途	必选参数
火车票下单	/openapi/travel/train/order/create/v1	创建火车票订单	train_no, travel_date, seat_type, passenger_info, contact_info
取消订单	/openapi/travel/train/order/cancel/v1	取消已创建的订单	order_id

三、收银台支付

接口名称	接口地址	核心用途
收银台支付	https://app-gate.fenbeitong.com/business/train/open/push/redirect?orderId={order_id}&isSkill=true&type=0	引导用户完成支付
查看订单详情	https://app-gate.fenbeitong.com/business/train/open/push/redirect?orderId={order_id}&isSkill=true&type=1	查看订单详情

枚举值说明

座位类型 (seat_type)

• 9：商务座
• 1：一等座
• 2：二等座
• 3：软卧
• 4：硬卧
• 5：软座
• 6：硬座
• 7：无座

订单状态 (order_status)

• 1：待支付
• 2：已支付
• 3：出票中
• 4：已出票
• 5：已取消
• 6：退票中
• 7：已退票

响应规则

成功响应

{
  "code": 0,
  "msg": "success",
  "data": {}
}

失败响应

{
  "code": 500,
  "msg": "错误信息",
  "data": {}
}