Agent Skills
返回列表
海外平台商品指定币种价格查询

海外平台商品指定币种价格查询

企业运营 更新于 2026.08.30

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

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

技能介绍

要解决什么问题

在海外运营场景里,商品详情页往往要按目标市场币种展示价格,而不是单一本币。运营或对接系统需要知道:给定 productId 和 currency,平台当前返回的价格结构是什么。本 skill 只做这一件事——调用正式环境的 product_price 动作,不把库存、促销、物流等其它字段混进结果。

技能如何工作

这是 kutesmart 平台的最小颗粒度接口 skill,对应聚合能力 platform-product-detail 里的 product_price。

  • 固定端点:GET https://www.kutetailor.com/api/product/product-price/{productId}/{currency}(以 frontmatter 的 base_url 为准,调用时不可被用户输入覆盖)。
  • 参数约定:tool 参数统一放在嵌套对象 params 里;Path 变量 productId、currency 写入 params.path;需登录态时在 params.accessToken 传入 token,生成 Authorization: Bearer(若已含 Bearer 则不重复拼接)。
  • 返回原则:以接口原始响应为准;若出现认证、权限、参数或业务错误,应把错误码与错误信息原样交给上层 agent,由编排层决定重试或换 skill。

完整链路(例如先查详情再查价、多币种对比)应由上层 agent 按聚合 skill 或计划文档组合多个原子 skill;本 skill 只负责完成单次价格查询并把关键字段交给后续步骤。

适用边界与注意点

  • 仅覆盖查询指定币种价格,不包含库存数量、SKU 列表或其它详情接口。
  • 仍受当前登录态、租户与用户权限约束;无权限时不会「推断」价格。
  • 属于查询类接口,不要在 skill 层补造库存、订单号、优惠金额或物流状态。

使用场景

  • 海外运营在核对某商品详情页时,已有 productId,需拉取 EUR 或 USD 等指定币种的正式环境标价
  • Agent 编排 platform-product-detail 链路时,在上一步拿到商品 ID 后调用本接口补全当前币种价格字段
  • 对接 kutetailor.com 的集成脚本在发布前,用固定 productId 与 currency 验证登录态下价格接口是否正常
  • 客服或内部工具根据用户提供的商品编号与市场币种,查询平台当前返回的价格结构而非手工查后台

适合人员

  • 负责酷特海外运营平台多币种商品页维护、需与系统标价对齐的运营同学
  • 为上层 Agent 编排 kutetailor 商品详情与价格步骤的后端或自动化工程师
  • 对接正式环境 product-price 路径、需遵守 params 与 Token 契约的 API 集成开发者
  • 在聚合 skill 文档中组合 product_price 与其它原子接口的平台能力维护者