酷特海外运营发货地址查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-shipping-query-shipping-address。
技能介绍
要解决什么问题
在海外运营平台里处理物流、对账或客服工单时,经常需要把 发货单号(shippingCode)对应成可读的 发货地址。手工在后台翻页既慢,也容易和 API 返回不一致。本技能只做一件事:在已登录前提下,调用酷特正式环境的固定 GET 接口,把平台返回的地址字段原样交给上层 agent。
技能如何工作
这是 最小颗粒度 的原子 skill,对应聚合能力 platform-shipping-query 中的 shipping_address action。
- 固定请求:
GET https://www.kutetailor.com/api/shipping/shipping-address/getShippingAddress - 查询参数:通过
params.query传入shippingCode - 鉴权:
params.accessToken生成Authorization: Bearer …(若已含Bearer则不重复拼接) - 参数结构:最外层仅
params;Path / Query / Body / 额外 Header 分别写入params.path、params.query、params.body、params.headers - base_url 不可被用户输入覆盖,执行器以 frontmatter 中的正式环境地址为准
返回必须以接口响应为事实来源;认证、权限、参数或业务错误时,应把原始错误码与错误信息向上传递,便于编排其它 skill 继续处理。
适用边界与注意点
- 仅覆盖「获取发货地址信息」这一步;若用户还需要轨迹、运费、库存等多接口链路,需由上层 agent 按聚合 skill 或计划文档编排多个原子 skill。
- 仍为 登录态、租户与用户权限 下的查询类接口;无 token 或权限不足时不会「补造」地址或物流状态。
- 不要臆造库存、价格、订单号、优惠金额等与本接口无关的字段。
使用场景
- 客服收到客户提供的 shippingCode,需要在酷特海外运营后台核对对应发货地址再回复
- 对账时要把某笔发货单的 shippingCode 解析成完整收货地址写入内部工单
- 上层 agent 编排物流链路时,先按 shippingCode 拉取发货地址再交给后续轨迹或运费 skill
- 运营在处理跨境发货异常时,需用发货单号查询系统登记的发货地址是否与客诉一致
适合人员
- 海外运营客服:客诉里只有发货单号,需快速查到系统内发货地址再对外说明
- 跨境物流协调:多单并行时要把 shippingCode 对应地址整理给仓库或承运商
- 搭建酷特物流查询 agent 的集成工程师:需要原子 skill 只负责 getShippingAddress 一步
- 企业运营中台维护:在聚合 skill 里编排 shipping_address 与其它 shipping 接口