For AI agents: the complete documentation index is available at /apps-plugin/docs/llms.txt, the full documentation bundle is available at /apps-plugin/docs/llms-full.txt, and this page is available as Markdown at /apps-plugin/docs/industry-examples/aviation.md.

航空行业示例

提示

本文是航空行业的场景化模板用法示例,用于帮助航司 / 航旅类开发者快速理解:在豆包对话中,不同业务环节该如何选用卡片模板、如何配置。注意:本文不是完整的 PRD 文档,仅覆盖典型场景下的模板选型与配置建议,实际接入时请结合自身业务字段与「卡片模板说明」中的完整属性表进行设计。

整体思路

一次完整的机票交易,大体看会经历「查航班 → 看详情 → 下单 → 售后(改签 / 退票)」的链路。用户的每一句话都对应一个业务环节,而每个环节都有最合适的卡片模板来承载。开发者要做的,就是按场景选模板,用组件做一些拼装,再按业务把字段填进去。

下面先给出航空行业各环节与推荐模板的对应关系,再逐个场景说明推荐用法。所有模板均来自 @doubao-dev/template,选型与属性细节请以「卡片模板说明」为准。

场景与模板速查

业务环节典型 Query推荐模板
航班检索(列表 / 详情)「明天去上海最早的飞机几点?」交通列表卡 - TransitCard
低价 / 目的地推荐「最近哪里飞便宜?」信息卡 - ContentCard
舱位 / 权益比选「订 7:50 那班,看看不同舱位」价格操作卡 - PriceActionCard
下单确认「就订这班」确认订单卡 - CheckoutCard
改签 / 退票确认「帮我改签 / 退票」确认订单卡 - CheckoutCard
改签 / 退票结果反馈「改签完成了吗?」信息卡 - ContentCard
需用户主动选择「有好几班,选哪班?」问询卡 - AskHumanCard

分场景用法说明

场景 1:航班检索 —— 交通列表卡 TransitCard

适用:用户查航班、比时刻,需要一次性看到多班航班的时间、价格与预订入口。无论是「检索列表」(多班并列)还是「检索详情」(聚焦某一班),都用 TransitCard 承载,它是为交通票务信息定制的卡型。

推荐用法:

  • items 传入航班列表,会全量展示(模板不做「最多 4 条」截断),建议在服务端按用户意图控制条数,避免一次给太多。
  • 每条用 departureMain / arrivalMain 传起降时间,departureSub / arrivalSub 传机场航站楼,arrivalDayOffset 标注跨天(如 +1)。
  • transferTop / transferBottom 展示飞行时长、中转信息;price 区域传票价,可叠加划线价、折扣标签。
  • 列表项操作区配「预订」按钮,点击事件建议用 sendMessage(向模型发「订这班」)或 openFullPage(打开应用插件航班详情 / 收银台)。
  • 标题栏「查看更多」建议保留,点击跳转应用插件列表页,承接更完整的筛选。

这张图是航空行业航班检索场景里的交通列表卡TransitCard示例界面。界面中展示了东航MU5357这班航班,6月19日周六从浦东T2机场20:50出发,23:50到达胶东T2机场,票价为200元,明确标注这班航班的行李额度为20kg。列表项设有「预订」按钮,点击该按钮符合上下文提及的交互要求,可用于向模型发送订班指令或打开应用插件对应页面,界面还搭配了相关航旅服务的查看入口,整体呈现了符合场景用法的航班检索卡片样式。

图片展示的是豆包AI助手在航班检索场景下的交通列表卡界面。界面显示浦东至大兴(PKX)9点前有好几班航班,如东航MU5357、国航CA8322等,分别在06:50、07:50、08:15起飞,对应到达时间及票价。列表项操作区有「预订」按钮,点击可向模型发「订这班」或打开航班详情/收银台。标题栏「查看更多」可跳转应用插件列表页。该图与上下文介绍的航班检索用法说明相契合,直观呈现了交通列表卡的样式及功能。

场景 2:低价 / 目的地推荐 —— 信息卡 ContentCard

适用:用户没有明确航班,而是问「最近哪里飞便宜」「端午去哪机票划算」这类探索型需求,需要以「目的地 + 价格区间」的形式给出推荐。

推荐用法:

  • 用 ContentCard 的列表能力,每条对应一个低价目的地。
  • thumbnail 传目的地城市图片,增强吸引力;title 传城市名,subtitle 传价格区间与日期区间(建议 2 行)。
  • 列表项通常不放操作按钮,让用户点整卡或点标题栏「查看更多」进入应用插件低价榜单页(可带城市参数)。
  • 若希望引导继续对话,可在标题右侧箭头绑定点击事件,向模型追问「XX 这条航线具体有哪些航班」。

图片展示的是一个航空行业示例中低价/目的地推荐的场景,呈现了上海出发的端午国内低价航班信息。上方显示时间为9:41,有“豆包”标识及“内容由AI生成”说明。下方有“端午节去哪里机票便宜?”的蓝色按钮。中间部分列出上海至青岛、南昌的航班价格,如上海 - 青岛单程200 - 350元,上海 - 南昌300 - 400元,并标注淡季价、端午波动小等信息。该图片与上下文介绍的低价/目的地推荐信息卡功能相契合,直观呈现了其展示内容。

场景 3:舱位 / 权益比选 —— 价格操作卡 PriceActionCard

适用:用户已锁定某一班,需要在经济舱 / 公务舱 / 不同折扣权益之间比选,重点是「多组价格 + 各自的后续操作」。

推荐用法:

  • items 配置价格列表,每条最多展示前 2 行 infoRows,用于写行李额、退改规则、折扣等关键权益。
  • 价格区域可叠加营销标签(如「4.2 折」「含 20KG 托运」)。
  • 每条右侧的 actionText 配「预订这班」,点击用 sendMessage 让模型直接推进下单;actionText 为空则不展示该行按钮。
  • 底部 footer 可放「查看全部舱位」次操作,跳转应用插件完整舱位页。

图片展示的是豆包AI助手在航空行业低价/目的地推荐场景下的信息卡ContentCard界面。界面显示了三款经济舱机票信息,价格分别为366元、380元、366元,均含免费托运20kg行李额,退改改282起。每款机票右侧均有“预订”按钮,底部有“查看全部”按钮。底部还提示如需换成公务舱或超级经济舱可直接告知。该图片直观呈现了文档中介绍的低价/目的地推荐信息卡的推荐用法,与上下文内容相契合。

场景 4:下单 / 改签 / 退票确认 —— 确认订单卡 CheckoutCard

适用:交易前的核对环节,包括首次下单、改签确认、退票确认。这些环节都需要展示行程摘要、提单人信息、费用明细和确认操作,统一使用 CheckoutCard。

推荐用法:

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

图片展示的是豆包 AI 在航空行业改签确认场景中使用确认订单卡 CheckoutCard 的效果。内容显示原航班和新航班信息、乘机人证件与联系方式、改签费用明细及合计金额,底部提供“确认支付”按钮。

图片展示的是豆包 AI 在航空行业下单确认场景中使用确认订单卡 CheckoutCard 的效果。内容显示航班行程、票价与机建燃油费用及合计金额,底部提供“修改订单信息”和“立即支付”按钮。

场景 5:改签 / 退票结果反馈 —— 信息卡 ContentCard

适用:售后动作完成后,用户回来问「改签完成了吗」「退款到账了吗」,需要一张轻量卡片反馈状态。

推荐用法:

  • 用 ContentCard 单条即可,title 传状态(如「改签成功」「退款已到账」),subtitle 传新航班信息或退款金额与到账时间。
  • 左侧缩略图通常不放;标题右侧箭头一般不跳转。
  • 操作区放「改签明细」/「退款明细」按钮,点击打开应用插件对应详情页。

图片展示的是豆包AI在航空行业改签/退票结果反馈场景中使用信息卡ContentCard的示例。界面显示时间为9:41,上方有豆包标识及“内容由AI生成”字样。主体内容为6月24日上海浦东T2飞往三亚的机票退票成功通知,退款将在48小时内退回到原账户,并附有航班信息。下方有“退票明细”按钮,以及分享、语音、点赞、转发等操作图标。该图片与上下文紧密相关,直观呈现了信息卡在改签/退票结果反馈场景中的应用效果。

图片展示的是豆包AI在航空行业改签/退票结果反馈场景中,使用信息卡ContentCard的示例。用户询问改签机票是否通过,豆包AI回复称6月24日飞往三亚的机票正在改签中,一般3小时左右航司会处理完毕。下方显示了改签航班信息,包括上海浦东T2 - 三亚凤凰T2,6月24日17:50 - 20:10,共1张,实付670元。该图片与上下文紧密相关,直观呈现了信息卡在该场景下的应用效果。

场景 6:需要用户主动选择 —— 问询卡 AskHumanCard

适用:流程推进中出现多个等价选项、必须由用户拍板时(如「有 3 班时刻相近的航班,选哪班」「选经济舱还是超级经济舱」),用包裹在回答气泡内的 AskHumanCard 让用户点选。

推荐用法:

  • items 配置选项列表,每项用 text 描述选项(如具体航班 / 舱位),点选后回传给模型继续推进。
  • 用 items[].showArrow('left' / 'right' / 'none')控制箭头样式;可增加「跳过」「自己去应用插件选」等固定入口。
  • 问询卡适合作为链路中的「岔路口」,与上面几张交易卡配合使用,而非承载完整信息。

开发提示

  • 一个 Widget 对应一张卡片:render 直接返回模板组件。
  • 图片传可访问 URL:航司 logo、目的地图片放入 src/assets 后静态 import 再传入。
  • 点击事件按需选型:推进对话用 sendMessage,进入编辑等复杂操作用 openFullPage,支付使用专用支付组件和接口。
  • 本文仅示范选型与配置思路,完整属性、字段类型与代码示例请查阅 「卡片模板说明」 对应章节及 Widget 模板库。