套餐详情
工具名称
get_combo
MCP Endpoint
tools/call · get_combo
分类
商品与套餐
做什么
获取指定套餐的完整信息,包括各商品组的选品规则及每组内可选商品的完整规格和客制化选项。
Agent 在发现阶段获得 item_type=combo 的条目后调用此工具。
每个客制化 option 及 sub_option 同样会返回 default_num、min_num、max_num。
下单字段同单品:SKU 传 spec_id,客制化层传 option_id(两级结构传子级)。
硬约束
本接口的 item_id 必须来自与本次调用相同 biz_type 的
list_products 结果,禁止跨 biz_type 复用。
入参
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| biz_type | 'pickup' | 'delivery' | 是 | 履约方式,必须与 item_id 获取时一致。 |
| item_id | string | 是 | 来自 list_products 的 item_type=combo 条目。 |
| store_id | string | 是 | 门店 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 → 3、combo_v2 → 0、combo_v3 → 5。