海外运营平台优惠券钱包成品券查询

解决什么问题

在海外运营平台的优惠券钱包里，运营人员经常需要确认某一张已配置完成的成品券到底适用于哪些商品、哪些场景。这类判断通常依赖后端接口返回的券适用规则，而业务方手里往往只有券的 id。如果让 Agent 自己去猜券的适用范围、去拼其他接口的数据，很容易出现臆造库存、价格、优惠金额的情况。本技能把这件事收敛成一个确定性动作：给定券 id，向固定正式环境接口发起一次 GET 查询，拿到成品券的适用信息。

技能如何工作

本技能是最小颗粒度的接口 skill，只负责一个平台接口动作 coupon_finish，不包含业务流程编排。当用户需要查询成品券适用信息时，它按以下步骤工作：

• 组装请求参数：统一使用嵌套的 params 对象承载参数，最外层只放 params，不使用 params.xxx 这类带点号的顶层 key。
• 拼装 HTTP 请求：按接口契约选择方法与路径，当前动作为 GET /coupon/couponFinish，查询参数 id 放入 URL query。
• 处理鉴权：通过 params.accessToken 生成 Authorization: Bearer；若传入值已包含 Bearer 前缀，则不重复拼接。
• 参数归位：params.path 用于路径变量，params.query 用于查询参数，params.body 用于 JSON Body，params.headers 用于额外请求头。
• 返回结果：以接口响应为唯一事实来源，不做任何补全或推测。

适用边界与注意点

• 正式环境地址固定在 frontmatter 的 base_url，调用时不接受用户输入覆盖，避免联调环境或自建站点被误用。
• 当用户需求需要多个接口步骤时，本技能只完成当前接口调用，并把关键返回字段交给上层 Agent 继续编排，自身不做聚合。
• 这是查询或计算类接口，但仍需遵守当前登录态、租户和用户权限。未授权或跨租户访问会被接口拒绝。
• 返回结果不得补造库存、价格、订单号、优惠金额或物流状态。接口未给出的字段一律以缺省或错误形式透传。
• 若接口返回认证、权限、参数或业务错误，需把原始错误码和错误信息原样传给上层 Agent，而不是自行解释或重试吞掉。