门店可售商品列表
工具名称
list_products
MCP Endpoint
tools/call · list_products
分类
商品与套餐
做什么
获取指定门店当前可供点单的商品列表。后端已按当前接入方的渠道配置过滤不支持的商品, 并过滤掉不可售商品,返回结果均为当前可点单的有效商品。
建议缓存
建议 Agent 在会话开始时调用一次并缓存(建议 30 分钟),避免反复调用造成上下文膨胀。
履约方式说明
biz_type 参数决定返回的商品范围,pickup(到店自取)与 delivery(外卖配送)
的可售商品可能不同,Agent 应根据用户当前场景传入正确值。
硬约束:item_id 不可跨 biz_type 复用
本接口返回的 item_id 仅保证在本次调用所用的 biz_type 下可进入后续
get_product / 算价 / 下单链路。禁止将 biz_type=pickup 返回的 item_id
用于后续 biz_type=delivery 工具,反之亦然。
入参
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| biz_type | 'pickup' | 'delivery' | 是 | 履约方式:pickup(到店自取)/ delivery(外卖配送)。 |
| store_id | string | 是 | 门店 ID,来自 search_stores。 |
| reservation | boolean | 否 | true=隔日预约商品;false/不传=当天可下单商品。 |
出参要点
返回的每个条目带 item_type,常见取值:
product— 单品,可直接调用get_product取规格与客制化。combo/fixcombo— 套餐,需调用get_combo展开。