航空行业示例
本文是航空行业的场景化模板用法示例,用于帮助航司 / 航旅类开发者快速理解:在豆包对话中,不同业务环节该如何选用卡片模板、如何配置。注意:本文不是完整的 PRD 文档,仅覆盖典型场景下的模板选型与配置建议,实际接入时请结合自身业务字段与「卡片模板说明」中的完整属性表进行设计。
整体思路
一次完整的机票交易,大体看会经历「查航班 → 看详情 → 下单 → 售后(改签 / 退票)」的链路。用户的每一句话都对应一个业务环节,而每个环节都有最合适的卡片模板来承载。开发者要做的,就是按场景选模板,用组件做一些拼装,再按业务把字段填进去。
下面先给出航空行业各环节与推荐模板的对应关系,再逐个场景说明推荐用法。所有模板均来自 @doubao-dev/template,选型与属性细节请以「卡片模板说明」为准。
场景与模板速查
分场景用法说明
场景 1:航班检索 —— 交通列表卡 TransitCard
适用:用户查航班、比时刻,需要一次性看到多班航班的时间、价格与预订入口。无论是「检索列表」(多班并列)还是「检索详情」(聚焦某一班),都用 TransitCard 承载,它是为交通票务信息定制的卡型。
推荐用法:
items传入航班列表,会全量展示(模板不做「最多 4 条」截断),建议在服务端按用户意图控制条数,避免一次给太多。- 每条用
departureMain/arrivalMain传起降时间,departureSub/arrivalSub传机场航站楼,arrivalDayOffset标注跨天(如 +1)。 transferTop/transferBottom展示飞行时长、中转信息;price区域传票价,可叠加划线价、折扣标签。- 列表项操作区配「预订」按钮,点击事件建议用
sendMessage(向模型发「订这班」)或openFullPage(打开应用插件航班详情 / 收银台)。 - 标题栏「查看更多」建议保留,点击跳转应用插件列表页,承接更完整的筛选。


场景 2:低价 / 目的地推荐 —— 信息卡 ContentCard
适用:用户没有明确航班,而是问「最近哪里飞便宜」「端午去哪机票划算」这类探索型需求,需要以「目的地 + 价格区间」的形式给出推荐。
推荐用法:
- 用
ContentCard的列表能力,每条对应一个低价目的地。 thumbnail传目的地城市图片,增强吸引力;title传城市名,subtitle传价格区间与日期区间(建议 2 行)。- 列表项通常不放操作按钮,让用户点整卡或点标题栏「查看更多」进入应用插件低价榜单页(可带城市参数)。
- 若希望引导继续对话,可在标题右侧箭头绑定点击事件,向模型追问「XX 这条航线具体有哪些航班」。

场景 3:舱位 / 权益比选 —— 价格操作卡 PriceActionCard
适用:用户已锁定某一班,需要在经济舱 / 公务舱 / 不同折扣权益之间比选,重点是「多组价格 + 各自的后续操作」。
推荐用法:
items配置价格列表,每条最多展示前 2 行infoRows,用于写行李额、退改规则、折扣等关键权益。- 价格区域可叠加营销标签(如「4.2 折」「含 20KG 托运」)。
- 每条右侧的
actionText配「预订这班」,点击用sendMessage让模型直接推进下单;actionText为空则不展示该行按钮。 - 底部
footer可放「查看全部舱位」次操作,跳转应用插件完整舱位页。

场景 4:下单 / 改签 / 退票确认 —— 确认订单卡 CheckoutCard
适用:交易前的核对环节,包括首次下单、改签确认、退票确认。这些环节都需要展示行程摘要、提单人信息、费用明细和确认操作,统一使用 CheckoutCard。
推荐用法:
productItems配置行程摘要:单程用 1 项,往返用 2 项;改签可用「原行程」「新行程」两项并列,退票场景展示待退行程。- 每项用
title展示出发地与目的地,用spec展示时间、航司、航班号和舱位;可用tagText标记「去程」「返程」「原」「新」,并用showChevron={false}控制是否进入详情页。 infoItems展示提单信息(乘机人、证件号、手机号),并按下单、改签、退票环节填写对应乘客。feeItems展开费用明细:下单展示票价、机建燃油和优惠,改签展示差价,退票展示退款明细;合计使用totalLabel和totalPrice。- 底部按钮使用
footer.primaryActionButton和footer.secondaryActionButton:下单 / 改签的主按钮打开收银台,退票的主按钮触发退票流程;次按钮可跳转订单信息修改页。


场景 5:改签 / 退票结果反馈 —— 信息卡 ContentCard
适用:售后动作完成后,用户回来问「改签完成了吗」「退款到账了吗」,需要一张轻量卡片反馈状态。
推荐用法:
- 用
ContentCard单条即可,title传状态(如「改签成功」「退款已到账」),subtitle传新航班信息或退款金额与到账时间。 - 左侧缩略图通常不放;标题右侧箭头一般不跳转。
- 操作区放「改签明细」/「退款明细」按钮,点击打开应用插件对应详情页。


场景 6:需要用户主动选择 —— 问询卡 AskHumanCard
适用:流程推进中出现多个等价选项、必须由用户拍板时(如「有 3 班时刻相近的航班,选哪班」「选经济舱还是超级经济舱」),用包裹在回答气泡内的 AskHumanCard 让用户点选。
推荐用法:
items配置选项列表,每项用text描述选项(如具体航班 / 舱位),点选后回传给模型继续推进。- 用
items[].showArrow('left'/'right'/'none')控制箭头样式;可增加「跳过」「自己去应用插件选」等固定入口。 - 问询卡适合作为链路中的「岔路口」,与上面几张交易卡配合使用,而非承载完整信息。
开发提示
- 一个 Widget 对应一张卡片:
render直接返回模板组件。 - 图片传可访问 URL:航司 logo、目的地图片放入
src/assets后静态import再传入。 - 点击事件按需选型:推进对话用
sendMessage,进入编辑等复杂操作用openFullPage,支付使用专用支付组件和接口。 - 本文仅示范选型与配置思路,完整属性、字段类型与代码示例请查阅 「卡片模板说明」 对应章节及 Widget 模板库。