优惠券钱包冻结金额查询

要解决什么问题

在优惠券运营链路中，经常需要确认某张优惠券会员当前的冻结金额——比如风控审核、资金对账、营销活动预算核销等场景。如果手动查询或在分散的后台页面查找，不仅效率低，还容易因为登录态切换、参数遗漏导致结果不一致。这个技能把「查询优惠券冻结金额」这一单一接口动作封装成原子能力，让 Agent 能直接调用，无需人工介入。

技能如何工作

这个技能只承担一个动作：调用正式环境的查询接口，拿到冻结金额并返回结果。核心流程如下：

• 固定地址调用：接口地址已固化在技能配置中，执行时直接使用正式环境 URL，不接受用户输入覆盖
• 参数封装：所有调用参数统一放在 params 对象里，查询参数 couponMemberId 通过 URL Query 传递
• 登录态处理：调用方传入的 params.accessToken 会被转换为 Authorization: Bearer 头，如果已包含 Bearer 前缀则不会重复拼接
• 结果返回：接口响应是唯一事实来源，不会补造任何金额或状态字段

适用边界与注意点

• 这是最小颗粒度接口技能，只完成单次查询。如果需要先查用户、再查优惠券、最后算冻结金额的完整链路，需要由上层 Agent 编排多个原子技能
• 返回结果严格依赖登录态、租户和用户权限，调用前需确保当前凭证有查询权限
• 如果接口返回认证失败、参数错误或业务异常，技能会原样传递错误码和信息，不会做二次封装或猜测