> 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.

# 航空行业示例

:::info 提示

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


:::

## 整体思路

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

下面先给出航空行业各环节与推荐模板的对应关系，再逐个场景说明推荐用法。所有模板均来自 `@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`（打开应用插件航班详情 / 收银台）。
- 标题栏「查看更多」建议保留，点击跳转应用插件列表页，承接更完整的筛选。


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

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

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

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

**推荐用法**:

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


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

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

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

**推荐用法**:

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


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

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

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

**推荐用法**:

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


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

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

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

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

**推荐用法**:

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


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

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

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

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

**推荐用法**:

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

## 开发提示

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