酷特海外运营发货地址列表
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-shipping-manage-address-list。
技能介绍
要解决什么问题
在海外运营平台做发货管理时,订单、面单、承运商对接往往都依赖统一的地址信息列表:仓库地址、收件人模板、平台维护的可选发货地址等。若 agent 直接拼 HTTP,容易搞错正式环境域名、把 query 参数摊平成顶层 tool 字段,或在 Bearer 头里重复加前缀。本技能把「拉取地址列表」这一动作收成单一原子接口,方便上层按聚合 skill 或计划文档与其它发货步骤串联。
技能如何工作
- 固定环境:执行器使用 frontmatter 中的正式环境
base_url(GET https://www.kutetailor.com/api/shipping/address),不接受用户输入覆盖。 - 统一入参:tool 最外层只放
params;Path 进params.path,筛选条件进params.query,Body 进params.body,额外 Header 进params.headers。 - 登录态:通过
params.accessToken生成Authorization: Bearer;若传入值已含Bearer则不再拼接。 - 动作:
address_list对应 GET/address,按 query 筛选,返回 List 形态的地址信息;结果以接口响应为准,不补造库存、订单号或物流状态。
适用边界与注意点
本 skill 只负责 address_list 一步。用户若要完整发货链路(创建运单、改状态、打印等),需由上层 agent 编排多个原子 skill。接口若返回认证、权限、参数或业务错误,应把原始错误码与错误信息交给上层处理,而不是在本地臆测业务结果。
使用场景
- 用户要在酷特海外运营平台核对可选发货地址,agent 需按 query 条件调用 GET /address 拉列表
- 编排 platform-shipping-manage 链路时,在创建运单前先执行 address_list 获取平台地址主数据
- 客服或运营问「当前系统里有哪些仓库/发货地址」,需带 accessToken 查询正式环境接口
- 上层计划只缺地址枚举一步:由本 skill 完成 address_list,把 List 返回交给后续 skill 选址
适合人员
- 负责酷特/kutetailor 海外发货配置、需在对话里快速核对平台地址库的运营同事
- 把 platform-shipping-manage 拆成原子 skill 对接、要正确嵌套 params 与 Bearer 头的集成工程师
- 编写发货类 agent 计划文档、需在「选地址」环节固定调用正式环境 address_list 的 agent 设计者
- 处理跨境订单异常时、需先拉取地址信息列表再比对订单收件/发货地址的客服或履约专员