酷特海外发货地址查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-shipping-manage-address-one。
技能介绍
要解决什么问题
在海外运营平台做发货管理时,订单、面单或仓库侧往往已经持有地址主键,但界面或其它系统还需要拉取完整的地址明细(收件人、国家/地区、邮编等)。若 agent 直接拼 HTTP 请求,容易搞错正式环境域名、Query 参数命名,或在多步链路里把本步当成「整单发货流程」来臆造字段。
本技能是 platform-shipping-manage 聚合能力里的原子接口,只负责 address_one:按地址 id 查询一条地址记录。
技能如何工作
- 固定走正式环境:
GEThttps://www.kutetailor.com/api/shipping/address/selectOne(base_url来自 skill frontmatter,不可被用户输入覆盖)。 - 工具参数统一放在嵌套对象
params里:Query 写入params.query(本接口需要id),登录态用params.accessToken生成Authorization: Bearer …(值里已有Bearer则不再重复拼接)。 - 返回以接口
AddressVO为准;认证、权限、参数或业务错误时,应把原始错误码与信息交给上层 agent,而不是本地补造库存、价格、订单号或物流状态。
适用边界
- 仅需单条地址查询时使用;完整发货链路(创建运单、改址、批量查询等)需由上层 agent 按聚合 skill 或计划文档编排其它原子 skill。
- 仍受当前租户、用户权限与登录态约束;多接口步骤时,本 skill 只完成本步调用并把关键字段交给后续 skill。
使用场景
- 订单或运单里只有地址 id,需要在创建面单前拉取完整收件地址字段
- 海外运营平台 agent 编排发货链路时,本步仅按 id 调用 selectOne 并把 AddressVO 交给下一步
- 客服核对用户已保存地址时,持有地址主键需查询 kutetailor 正式环境单条记录
- 对接 kutetailor 发货接口的集成脚本,在仅有 addressId 时补全地址明细再写回业务系统
适合人员
- 在 kutetailor 海外运营后台处理订单发货、常凭地址 id 查明细的运营或物流同事
- 为酷特发货管理聚合 skill 编排多接口步骤,需要嵌入 address_one 原子的 agent 开发
- 对接 https://www.kutetailor.com 发货 API、实现按 id 查地址的后端或自动化工程师
- 构建跨境发货助手时,只负责单条地址查询、错误需原样上抛给上层 agent 的集成维护者