Starbucks星巴克 MCP 开放平台

套餐详情

工具名称
get_combo
MCP Endpoint
tools/call · get_combo
分类
商品与套餐

做什么

获取指定套餐的完整信息,包括各商品组的选品规则及每组内可选商品的完整规格和客制化选项。 Agent 在发现阶段获得 item_type=combo 的条目后调用此工具。

每个客制化 optionsub_option 同样会返回 default_nummin_nummax_num

下单字段同单品:SKU 传 spec_id,客制化层传 option_id(两级结构传子级)。

硬约束

本接口的 item_id 必须来自与本次调用相同 biz_typelist_products 结果,禁止跨 biz_type 复用。

入参

参数类型必填说明
biz_type'pickup' | 'delivery'履约方式,必须与 item_id 获取时一致。
item_idstring来自 list_products 的 item_type=combo 条目。
store_idstring门店 ID。

与算价 / 下单的衔接

get_combo.item_id 在后续算价 / 下单中要:

  • 作为 combo_group_info[*].activity_id 与每个套餐内商品 item_list[*].activity_id
  • 由 Agent 显式生成一个 UUID 同时写入 combo_group_info[*].group_id 与对应商品的 item_list[*].group_id
  • 组类型映射:fixcombo → 3combo_v2 → 0combo_v3 → 5