海外平台商品指定币种价格查询
将以下提示词粘贴到你的 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 与其它原子接口的平台能力维护者