茶饮/餐饮行业示例
本文是外卖 / 即时零售行业的场景化模板用法示例,用于帮助餐饮、咖啡茶饮、即时零售类开发者快速理解:在豆包对话中,不同点单环节该选用哪个卡片模板、如何配置。注意:本文不是完整的 PRD 文档,仅覆盖典型场景下的模板选型与配置建议,实际接入时请结合自身业务字段与「卡片模板说明」中的完整属性表设计。
一、整体思路
一次完整的外卖点单,通常会经历「问吃什么 → 挑商品 → 确认下单 → 售后(追踪 / 取消)」的链路。用户的每一句话都对应一个业务环节,而每个环节都有最合适的卡片模板来承载。开发者要做的,就是按场景选模板,再按业务把字段填进去。
外卖场景的一大特点是「意图跨度大」:既有「附近有什么好喝的」这类模糊探索,也有「点一杯生椰拿铁送到公司」这类一句话直达下单。选型时要先判断用户处在链路的哪一步,再决定用推荐类卡还是订单类卡。所有模板均来自 @doubao-dev/template,选型与属性细节请以「卡片模板说明」为准。
场景与模板速查
二、分场景用法说明
场景 1:模糊推荐 / 条件搜索 —— 信息卡 ContentCard
适用:用户没有明确商品,而是问「最近有什么新品」「附近有什么好喝的美式」「30 块以内推荐几款」这类探索型需求,需要以「商品 / 门店 + 关键信息」的列表形式给出推荐,并支持直接进入下单。
推荐用法:
- 用
ContentCard的列表能力,每条对应一个推荐商品或门店。 thumbnail传商品图片;title传商品名,subtitle传规格、价格、门店距离等关键信息(可分行)。- 列表项右侧
action配「下单」按钮({ type: 'button' }),点击用sendMessage让模型直接推进下单(如「要这款」),把「推荐 → 下单」在一张卡内闭环。 - 条件搜索结果建议在服务端做好分组或排序(如「便宜快送 / 精品好喝」),再用多条列表项呈现,避免一次给太多。
- 标题栏「查看更多」可保留,点击跳转应用插件完整列表页承接更细的筛选。

场景 2:门店选择 —— 信息卡 ContentCard
适用:用户指定了商品或品牌,但同一品牌附近有多家门店(如「在 BrewNow 中关村那家店买杯拿铁」「附近哪家 BrewNow 还在营业」),需要先让用户在若干候选门店里挑一家,再进入下单。此环节把「门店 + 关键信息」以列表形式给出,并支持一键锁定门店继续下单。
推荐用法:
- 用
ContentCard的items承载候选门店,每条对应一家店:title传门店名,subtitle传距离、营业时间、地址等关键信息(可分行);thumbnail可传门店 / 品牌图标。 - 列表项右侧
action配「选这家」按钮,点击用sendMessage回传选中门店(如「就选这家」),让模型锁定门店并推进到确认订单卡。 - 门店较多时,用
header.actionText配「更多门店」,点击openFullPage跳转应用插件完整门店列表页承接更细筛选。 - 门店列表数据更新频繁,务必用门店 ID 作
key,不要用数组下标,避免选择错位。 - 建议服务端按距离排序,优先展示最近且在营业的门店,减少用户比对成本。

场景 3:一句话下单 / 历史复购 —— 确认订单卡 CheckoutCard
适用:交易前的核对环节,包括一句话下单(「点一杯生椰拿铁送到公司」)、基于历史记忆复购(「昨天那杯再来一杯」)。这些环节都需要展示商品 + 提单信息 + 费用明细 + 支付按钮,统一用 CheckoutCard。
推荐用法:
productItems配置商品:单杯用 1 条,多杯 / 代购用多条,每条复用商品摘要字段(title、spec、imageSrc、price、quantity等),spec里写「大杯 / 少糖 / 去冰」这类规格。infoItems配置提单信息:收货地址、预计送达时间、配送 / 自取方式等。- 费用区用
feeItems/discountText/totalPrice展开明细:商品优惠、运费、打包费、合计。 - 底部
footer.primaryActionButton定义「立即支付」→ 打开收银台;footer.secondaryActionButton定义「修改」→ 跳转应用插件订单编辑全页。 - 历史复购场景直接复用历史订单的商品与规格填充
productItems,减少用户确认成本。

场景 4:点单过程中修改 —— 确认订单卡 CheckoutCard
适用:用户在下单流程中临时改地址、改规格、加减商品(「把地址改成家里」「换成大杯」「再加一杯」)。此环节复用 CheckoutCard,以「差量更新后的新预估单」重新出卡。
推荐用法:
- 修改后由服务端重新试算,生成新的预估单,再用
CheckoutCard渲染最新状态,让用户对照确认。 - 在
infoItems中同步更新变化项(如新的配送地址、调整后的送达时间),必要时可在文案侧提示「配送费不变,预计送达调整为 35 分钟」。 - 费用明细随修改实时更新,底部仍保留「立即支付」/「修改」双按钮,保证用户可继续调整或直接支付。

场景 5:下单信息缺失 / 追问补全 —— 确认订单卡 CheckoutCard(缺地址态)
适用:一句话下单时,用户想要的商品已经明确(「豆包,给我点一杯 BrewNow 的生椰拿铁」),但下单必需信息缺失——最典型的是没有收货地址。此时不能直接支付,需要用 CheckoutCard 先把已确认的商品与费用亮出来,再把缺失项转成「去补全」的动作,引导用户补齐后继续。
推荐用法:
- 商品与费用照常渲染:productItems 传已选商品:生椰拿铁、规格、数量、price;feeItems / totalPrice 展示费用明细,让用户先确认「点的是对的」。
- 把缺失信息态显式化:地址未知时,infoItems 中收货地址项留空或提示「未填写」,同时底部主按钮从「立即支付」替换为「新增收货地址」(footer.primaryActionButton),点击用 openFullPage 跳转应用插件地址填写页。
- 补全后回到对话继续:地址填好后由服务端重新试算,再出一张完整的 CheckoutCard(主按钮恢复为「立即支付」),形成「缺信息 → 补全 → 支付」的闭环。可叠加智能追问:若识别到附近有更近门店,可在卡片下方用文本或 AskHumanCard 追问「最近门店距离你只有 512 米,需要给你改成自取订单吗?」,把「补地址」与「改自取」两条路径都递给用户。

场景 6:需要用户主动选择 / 确认 —— 问询卡 AskHumanCard
适用:流程推进中出现需要用户拍板的岔路口,如「附近门店更近,要不要改成自取」「有多款相近商品,选哪款」「确认取消这单吗」,用包裹在回答气泡内的 AskHumanCard 让用户点选。
推荐用法:
items配置选项列表,每项用text描述选项(如具体商品、外送 / 自取、确认 / 取消),点选后回传给模型继续推进。- 用
items[].showArrow('left'/'right'/'none')控制箭头样式;可增加「跳过」「自己去应用插件选」等固定入口。 - 问询卡适合作为链路中的「岔路口」,与上面几张推荐卡、订单卡配合使用,而非承载完整信息。

三、开发提示
- 一个 Widget 对应一张卡片:
render直接返回模板组件。 - 列表项传稳定 key:商品 / 门店列表数据更新频繁,务必用商品 ID 等稳定值作
key,不要用数组下标。 - 图片传可访问 URL:商品图、门店 logo 放入
src/assets后静态import再传入。 - 点击事件按需选型:推进对话(下单、改点、确认)用
sendMessage,进入编辑 / 支付等复杂操作用openFullPage。 - 推荐与下单尽量在卡内闭环:外卖用户决策快,推荐卡列表项直接带下单入口,可显著缩短「看到 → 下单」路径。
- 本文仅示范选型与配置思路,完整属性、字段类型与代码示例请查阅 「卡片模板说明」 对应章节及 Widget 模板库。