Agent Skills
返回列表
KuteSmart 指定币种价格查询

KuteSmart 指定币种价格查询

企业运营 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-product-detail-product-price。

技能介绍

要解决的问题

海外运营平台的商品详情链路里,价格和库存是分开维护、分开返回的两类字段,而价格又和币种强绑定:同一个商品在不同市场可能以不同币种定价。下游服务或前端拿到商品 ID 后,如果只知道默认币种的价格,就没法完成指定市场的展示、比价或结算校验。

这个技能只解决其中一个具体动作:给定 productId 和 currency,从正式环境接口取回该商品在指定币种下的价格。它是最小颗粒度的原子 skill,不负责商品主数据、库存校验、优惠计算或物流状态,这些由上层 agent 按聚合 skill(platform-product-detail)或计划文档编排其他原子 skill 完成。

核心能力与关键步骤

  • 固定调用地址:GET https://www.kutetailor.com/api/product/product-price/{productId}/{currency},URL 中的 {productId} 与 {currency} 是 Path 参数,执行时从 params.path 替换。
  • 参数封装:tool arguments 统一使用嵌套的 params 对象,最外层只放 params,不要写成 params.xxx 这类点号顶层 key;Path 参数写入 params.path,Query 参数写入 params.query,JSON Body 写入 params.body,额外 Header 写入 params.headers。
  • 认证方式:登录态接口用 params.accessToken 生成 Authorization: Bearer;如果传入值已含 Bearer,不要重复拼接。
  • 返回处理:返回结果必须以接口响应为事实来源,不补造库存、价格、订单号、优惠金额或物流状态;接口返回认证、权限、参数或业务错误时,把原始错误码和错误信息原样传给上层 agent。

适用边界与注意点

  • 只覆盖“查询指定币种价格”这一个接口动作,不能独立构成完整的商品详情链路。
  • base_url 固定在 frontmatter 中,执行器不接受用户输入覆盖。
  • 虽然是查询类接口,仍需遵守当前登录态、租户和用户权限约束。
  • POST/PUT 默认发送 JSON body;如果上层接口网关另有约定,以网关契约为准。
  • 若用户需求涉及多个接口步骤,本 skill 只完成自己的调用,并把关键返回字段交给后续 skill。

使用场景

  • 跨境电商运营配置多国站点时,输入商品ID与目标币种,调用接口获取该商品在指定海外市场的准确展示价格。
  • 财务人员核对多币种账单前,传入商品ID与结算币种,拉取系统记录的指定币种价格以完成账实核对工作。
  • 后端工程师构建商品详情服务时,将商品ID与地区币种作为参数,调用此接口获取该币种的最新价格数据。
  • 数据分析团队处理多市场报表时,针对特定商品ID和目标币种发起查询,以补充报表中缺失的折算价格字段。

适合人员

  • 跨境电商运营专员:需要在多国站点配置商品时,快速获取不同币种下的准确展示价格。
  • 后端开发工程师:正在开发商品详情聚合服务,需要调用原子接口获取指定币种的实时价格数据。
  • 财务对账专员:负责核对多币种销售账单,需要按商品和结算币种查询系统内记录的准确价格。
  • 海外市场数据分析员:在处理多国销售报表时,需要批量拉取特定商品在不同币种下的价格以完善数据。