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

技能描述

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

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

技能概述

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

技能能力

核心能力

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

触发条件

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

🚄 北京南 → 上海虹桥（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个车次

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

🚄 G1 北京南 → 上海虹桥
📅 出发：3月15日 09:00 | 到达：3月15日 13:28
⏱️ 历时：4时28分

| 座位类型 | 价格 | 余票 |
|:---:|---:|:---:|
| 二等座 | ¥553 | 有票 |
| 一等座 | ¥933 | 5张 |
| 商务座 | ¥1748 | 无票 |

💡 回复座位类型预订，如二等座

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

✅ 订单创建成功！

🚄 G1 北京南 → 上海虹桥
📅 出发：3月15日 09:00
🎫 座位：二等座
💰 价格：¥553
👤 乘车人：张三

🔗 立即支付
🔗 查看订单详情

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

对接信息

基础配置

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

通用请求规则

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

核心接口列表

一、查询类接口

二、订单类接口

三、收银台支付

枚举值说明

座位类型 (seat_type)

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

订单状态 (order_status)

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

响应规则

成功响应

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

失败响应

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