专星送算价
工具名称
calculate_delivery_price
MCP Endpoint
tools/call · calculate_delivery_price
分类
算价与下单
做什么
MCP 专星送算价 —— 用户询问外卖价格时使用。
必须在 create_delivery_order 前调用,用于返回外卖场景的算价结果。
调用前置
- 用户身份从请求头
x-customer-id、x-user-id获取。 - 配送场景下,必须先调用
list_delivery_addresses, 并从用户选择的地址记录中获取store_id/latitude/longitude等字段,禁止自行拼接。 delivery_provider优先从地址delivery_type取,取不到默认传1(蜂鸟)。
入参
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| store_id | string | 是 | 门店 ID,从用户选中地址的 store_items[].store_id 取。 |
| latitude | string | 是 | 纬度,从用户选中地址取。 |
| longitude | string | 是 | 经度,从用户选中地址取。 |
| delivery_provider | integer | 是 | 配送商:1-蜂鸟、2-美团、3-顺丰、4-达达。 |
| item_list | ItemInput[] | 是 | 商品列表,字段映射规则与啡快算价一致;客制化必须包含默认配料与用户显式选择项。 |
| combo_group_info | ComboGroup[] | 否 | 套餐场景使用;activity_id = get_combo.item_id,group_id 由 agent 生成 UUID。 |
| coupon_list | string[] | 否 | 优惠券 ID 列表;可基于上一次算价的 can_use_coupon 重新试算。 |
套餐组装规则
combo_group_info[*].activity_id=get_combo.item_id;item_list[*].activity_id与所属组保持一致;combo_group_info[*].group_id由 agent 显式生成 UUID,并同步写入item_list[*].group_id;group_type映射:fixcombo → 3、combo_v2 → 0、combo_v3 → 5;item_type与group_type一一对应,不可根据名称猜测。
券二次试算
若响应中 can_use_coupon 不为空,应提示用户有可用优惠券;
用户选择后,将 can_use_coupon.coupon_id 放入下一次算价的 coupon_list 中重新试算。