酷特海外发货地址列表
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-shipping-manage-shipping-address-list。
技能介绍
要解决什么问题
在海外运营平台做发货、选仓或对接物流前,业务侧往往要先拿到当前租户可用的发货地址列表。若由 Agent 直接拼 HTTP,容易踩坑:正式环境域名被用户输入改掉、accessToken 与 Authorization 头拼接不一致,以及 Query 参数命名与平台契约不一致。
本技能是最小颗粒度接口封装,只负责一个动作:shipping_address_list。
技能如何工作
- 固定请求:
GEThttps://www.kutetailor.com/api/shipping/shipping-address(base_url来自技能 frontmatter,不接受覆盖)。 - 工具参数统一放在嵌套对象
params中:Query 写入params.query(类型ShippingAddress),Path 用params.path,Body 用params.body,额外 Header 用params.headers。 - 登录态:使用
params.accessToken生成Authorization: Bearer <token>;若传入值已含Bearer,不再重复拼接。 - 返回以接口响应为准,类型为分页结构
IPage;认证、权限、参数或业务错误时,应把原始错误码与错误信息交给上层 Agent,不要自行编造地址或物流状态。
适用边界
- 仅覆盖「发货地址列表」查询;创建地址、改默认仓、下单发货等需组合同聚合域
platform-shipping-manage下的其他原子 skill 或按计划文档编排。 - 仍需遵守当前登录态、租户与用户权限;多步骤流程中,本 skill 只完成本接口并把关键字段交给后续步骤。
使用场景
- 海外运营 Agent 在创建发货单前,先拉取当前租户可用的发货地址分页列表供用户选择
- 客服处理跨境订单时,需核对系统里已配置的发货仓/发货地址是否与用户描述一致
- 编排 platform-shipping-manage 多步流程时,把本接口返回的地址 ID 传给后续下单或物流 skill
- 对接 kutetailor.com 正式环境时,按 ShippingAddress 查询条件筛选某一类发货地址记录
适合人员
- 负责酷特海外运营平台发货配置、需在对话里快速核对地址清单的运营专员
- 把 platform-shipping-manage 拆成原子 skill 编排的上层 Agent 或自动化方案设计者
- 对接 kutetailor.com 发货域接口、要统一 accessToken 与 Query 契约的后端集成工程师
- 在发货前必须确认「从哪个地址发出」的跨境履约/仓储协同人员