train assistant — trAIn 助手

分贝通火车预订助手 (fb-trAIn-技能) 技能描述

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

⚠️ 【重要约束】

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

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

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

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

返回车次列表，使用表格形式展示 默认展示5个车次，用户可选择继续查看更多 展示格式示例： 🚄 北京南 → 上海虹桥（3月15日）

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

必须调用 scripts/fb_trAIn_API.py 中的 获取_trAIn_detAIl() 函数 展示各座位类型的价格和余票 展示格式示例： 🚄 G1 北京南 → 上海虹桥 📅 出发：3月15日 09:00 | 到达：3月15日 13:28 ⏱️ 历时：4时28分

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

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

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

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

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

取消订单：支持填写取消原因 查询订单详情：展示订单完整信息 对接信息 基础配置 环境：线上环境 核心域名：https://openAPIv2.fenbeitong.com X-应用-Id：688c927d2cf90c6f0595571d（所有接口统一使用此应用-Id） Content-Type：应用/json 通用请求规则 所有POST请求，参数为JSON格式 日期格式：yyyy-MM-dd 时间格式：HH:mm 核心接口列表 一、查询类接口 接口名称 接口地址 核心用途 必选参数 火车票搜索 /openAPI/travel/trAIn/搜索_列出/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/创建/v1 创建火车票订单 trAIn_no, travel_date, seat_type, passenger_信息, contact_信息 取消订单 /openAPI/travel/trAIn/order/cancel/v1 取消已创建的订单 order_id 三、收银台支付 接口名称 接口地址 核心用途 收银台支付 https://应用-gate.fenbeitong.com/business/trAIn/open/push/redirect?orderId={order_id}&is技能=true&type=0 引导用户完成支付 查看订单详情 https://应用-gate.fenbeitong.com/business/trAIn/open/push/redirect?orderId={order_id}&is技能=true&type=1 查看订单详情 枚举值说明 座位类型 (seat_type) 9：商务座 1：一等座 2：二等座 3：软卧 4：硬卧 5：软座 6：硬座 7：无座 订单状态 (order_状态) 1：待支付 2：已支付 3：出票中 4：已出票 5：已取消 6：退票中 7：已退票 响应规则 成功响应 { "code": 0, "msg": "成功", "data": {} }

失败响应 { "code": 500, "msg": "错误信息", "data": {} }