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/tea-and-dining.md.

茶饮/餐饮行业示例

提示

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

一、整体思路

一次完整的外卖点单,通常会经历「问吃什么 → 挑商品 → 确认下单 → 售后(追踪 / 取消)」的链路。用户的每一句话都对应一个业务环节,而每个环节都有最合适的卡片模板来承载。开发者要做的,就是按场景选模板,再按业务把字段填进去。

外卖场景的一大特点是「意图跨度大」:既有「附近有什么好喝的」这类模糊探索,也有「点一杯生椰拿铁送到公司」这类一句话直达下单。选型时要先判断用户处在链路的哪一步,再决定用推荐类卡还是订单类卡。所有模板均来自 @doubao-dev/template,选型与属性细节请以「卡片模板说明」为准。

场景与模板速查

业务环节典型 Query推荐模板
模糊推荐 / 条件搜索「附近有什么好喝的咖啡外卖?」信息卡 - ContentCard
门店选择「在 BrewNow 中关村那家店买杯拿铁?」
一句话下单 / 历史复购「点一杯生椰拿铁送到公司」确认订单卡 - CheckoutCard
订单追踪 / 取消结果「我的外卖到哪了?」信息卡 - ContentCard
需用户主动选择 / 确认「要不要改成自取?」问询卡 - AskHumanCard

二、分场景用法说明

场景 1:模糊推荐 / 条件搜索 —— 信息卡 ContentCard

适用:用户没有明确商品,而是问「最近有什么新品」「附近有什么好喝的美式」「30 块以内推荐几款」这类探索型需求,需要以「商品 / 门店 + 关键信息」的列表形式给出推荐,并支持直接进入下单。

推荐用法:

  • 用 ContentCard 的列表能力,每条对应一个推荐商品或门店。
  • thumbnail 传商品图片;title 传商品名,subtitle 传规格、价格、门店距离等关键信息(可分行)。
  • 列表项右侧 action 配「下单」按钮({ type: 'button' }),点击用 sendMessage 让模型直接推进下单(如「要这款」),把「推荐 → 下单」在一张卡内闭环。
  • 条件搜索结果建议在服务端做好分组或排序(如「便宜快送 / 精品好喝」),再用多条列表项呈现,避免一次给太多。
  • 标题栏「查看更多」可保留,点击跳转应用插件完整列表页承接更细的筛选。

图片展示的是BrewNow饮品推荐界面。上方显示“BrewNow最近有什么新品”,下方文字介绍2026年5月新品,含价格、口味、值不值得点等信息,如冰美式10 - 15元,新用户有券,配送超快。列表项右侧有“下单”按钮,点击可推进下单。图片下方还有“进店”“深度思考”“深入研究”“AI生图”“拍题”等功能选项。该图与文档中“模糊推荐/条件搜索——信息卡ContentCard”场景下,列表项右侧“下单”按钮点击用sendMessage推进下单的内容相关。

场景 2:门店选择 —— 信息卡 ContentCard

适用:用户指定了商品或品牌,但同一品牌附近有多家门店(如「在 BrewNow 中关村那家店买杯拿铁」「附近哪家 BrewNow 还在营业」),需要先让用户在若干候选门店里挑一家,再进入下单。此环节把「门店 + 关键信息」以列表形式给出,并支持一键锁定门店继续下单。

推荐用法:

  • 用 ContentCard 的 items 承载候选门店,每条对应一家店:title 传门店名,subtitle 传距离、营业时间、地址等关键信息(可分行);thumbnail 可传门店 / 品牌图标。
  • 列表项右侧 action 配「选这家」按钮,点击用 sendMessage 回传选中门店(如「就选这家」),让模型锁定门店并推进到确认订单卡。
  • 门店较多时,用 header.actionText 配「更多门店」,点击 openFullPage 跳转应用插件完整门店列表页承接更细筛选。
  • 门店列表数据更新频繁,务必用门店 ID 作 key,不要用数组下标,避免选择错位。
  • 建议服务端按距离排序,优先展示最近且在营业的门店,减少用户比对成本。

图片展示的是茶饮/餐饮行业门店选择场景中信息卡ContentCard的示例界面。界面显示“豆包”品牌,时间为9:41,有信号、Wi - Fi图标及电池电量显示。上方有“帮我下单一杯杨浦 BrewNow 的冰美式,自提”的蓝色输入框。下方列出杨浦多家BrewNow门店,如保辉国际大厦店、国华国际广场店、君庭广场店等,每家门店显示距离、营业时间及地址,右侧有“选这家”按钮。此图与上下文介绍的门店选择用法说明相契合,直观呈现了门店信息展示及用户操作选择的场景。

场景 3:一句话下单 / 历史复购 —— 确认订单卡 CheckoutCard

适用:交易前的核对环节,包括一句话下单(「点一杯生椰拿铁送到公司」)、基于历史记忆复购(「昨天那杯再来一杯」)。这些环节都需要展示商品 + 提单信息 + 费用明细 + 支付按钮,统一用 CheckoutCard。

推荐用法:

  • productItems 配置商品:单杯用 1 条,多杯 / 代购用多条,每条复用商品摘要字段(title、spec、imageSrc、price、quantity 等),spec 里写「大杯 / 少糖 / 去冰」这类规格。
  • infoItems 配置提单信息:收货地址、预计送达时间、配送 / 自取方式等。
  • 费用区用 feeItems / discountText / totalPrice 展开明细:商品优惠、运费、打包费、合计。
  • 底部 footer.primaryActionButton 定义「立即支付」→ 打开收银台;footer.secondaryActionButton 定义「修改」→ 跳转应用插件订单编辑全页。
  • 历史复购场景直接复用历史订单的商品与规格填充 productItems,减少用户确认成本。

这张图片展示的是茶饮/餐饮行业历史复购场景下的确认订单卡界面,对应文档中提及的CheckoutCard示例。界面内的商品区复用了BrewNow咖啡历史下单的生椰拿铁商品信息,包含规格、优惠后价格、数量。费用区通过feeItems类字段展开明细,标注了共优惠、运费、打包费和合计金额。底部设置了两个核心操作按钮,蓝色的primaryActionButton为「立即支付」,作用是打开收银台,黑色的secondaryActionButton为「修改」,作用是跳转订单编辑全页,还额外显示了店铺距离及是否自取的相关提示,方便用户完成下单操作。

场景 4:点单过程中修改 —— 确认订单卡 CheckoutCard

适用:用户在下单流程中临时改地址、改规格、加减商品(「把地址改成家里」「换成大杯」「再加一杯」)。此环节复用 CheckoutCard,以「差量更新后的新预估单」重新出卡。

推荐用法:

  • 修改后由服务端重新试算,生成新的预估单,再用 CheckoutCard 渲染最新状态,让用户对照确认。
  • 在 infoItems 中同步更新变化项(如新的配送地址、调整后的送达时间),必要时可在文案侧提示「配送费不变,预计送达调整为 35 分钟」。
  • 费用明细随修改实时更新,底部仍保留「立即支付」/「修改」双按钮,保证用户可继续调整或直接支付。

图片展示的是豆包AI在茶饮/餐饮行业点单过程中修改确认订单卡的示例。用户要求点一杯BrewNow的生椰拿铁,AI回复已选好咖啡,可直接支付或修改信息。画面中显示了BrewNow咖啡的生椰拿铁商品信息,有修改收货地址和立即支付按钮。底部提示BrewNow咖啡最近门店距离用户512米,询问是否改成自取订单。该图与上下文介绍的分场景用法说明中,点单过程中修改确认订单卡的推荐用法相契合。

场景 5:下单信息缺失 / 追问补全 —— 确认订单卡 CheckoutCard(缺地址态)

适用:一句话下单时,用户想要的商品已经明确(「豆包,给我点一杯 BrewNow 的生椰拿铁」),但下单必需信息缺失——最典型的是没有收货地址。此时不能直接支付,需要用 CheckoutCard 先把已确认的商品与费用亮出来,再把缺失项转成「去补全」的动作,引导用户补齐后继续。

推荐用法:

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

这是一张茶饮行业相关的对话界面对话截图,上方是用户向名为“豆包”的助手请求购买BrewNow的生椰拿铁,中间部分显示生椰拿铁的商品信息:单价5.8元、规格为1份大杯意式冰饮,配料默认甜度、PLC吸管,下方有蓝色的“新增收货地址”按钮,同时对话栏提示“BrewNow咖啡最近门店距离你只有512米,需要给你改成自取订单吗?”,该截图对应下单信息缺失时的场景,体现了引导用户补全地址或切换自取的交互流程。

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

适用:流程推进中出现需要用户拍板的岔路口,如「附近门店更近,要不要改成自取」「有多款相近商品,选哪款」「确认取消这单吗」,用包裹在回答气泡内的 AskHumanCard 让用户点选。

推荐用法:

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

图片展示的是BrewNow咖啡饮品推荐界面。上方显示“BrewNow最近有什么新品”,下方介绍BrewNow最新新品,含价格、口味、值不值得点等信息,如小青桔美式、小青桔冰茶、龙井美式等。底部有“需要我帮你选一款吗?”的提示,以及“来杯销量最高的”“来杯咖啡因最少的”“来杯最便宜的”三个选项。该图片与上下文介绍的问询卡AskHumanCard用法相关,展示了其在饮品推荐场景中的应用。

三、开发提示

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