KuteSmart 物流发货地址查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-shipping-query-shipping-address。
技能介绍
解决的问题
跨系统协同时,发货地址数据往往被拆散在物流查询、仓储管理、财务结算等多个后台系统。运维人员需要在页面之间来回切换,人工定位承运商的揽收地址、联系人和联系方式。上层 Agent 如果自行对接接口,每新增一条业务链路都要重写一遍请求脚本,维护成本高且容易出错。
技能如何工作
这个技能是最小颗粒度的原子接口,只负责一件事:调用 shipping_address 接口。
- 固定请求地址:
GET https://www.kutetailor.com/api/shipping/shipping-address/getShippingAddress - 参数传递:Query 参数为
shippingCode,通过params.query传入,最外层只放params对象,不使用params.xxx这类点号顶层 key - 登录态接口使用
params.accessToken生成Authorization: Bearer,如果传入值已含 Bearer 前缀则不重复拼接 - 执行器使用 frontmatter 中的固定正式环境地址,不接受用户输入覆盖
base_url - 返回的关键字段直接交给上层 Agent,由聚合 skill
platform-shipping-query按计划文档编排后续步骤
适用边界与注意点
- 这是原子 skill,只完成本接口调用,不负责完整业务链路,需要组合时由上层 Agent 聚合多个原子 skill
- 虽然是查询类接口,仍需遵守当前登录态、租户和用户权限约束
- 返回结果必须以接口响应为事实来源,不补造库存、价格、订单号、优惠金额或物流状态
- 接口返回认证、权限、参数或业务错误时,把原始错误码和错误信息原样传给上层 Agent,不要自行吞掉或改写
使用场景
- 物流运营排查某批次货件揽收异常,用 shippingCode 调该接口拿到发货地址,核对与承运商系统是否一致。
- 上层 Agent 按聚合 skill 计划编排物流链路,执行到发货地址这一步时调本接口,把结果交给后续步骤。
- 客服收到客户询问"货从哪个仓发出",用 shippingCode 查询发货地址后给出准确答复,不凭经验猜测。
适合人员
- 海外仓物流运营,需要在排查揽收异常时快速获取承运商发货地址,确认揽收点信息。
- 搭建物流自动化 Agent 的工程师,需要把地址查询拆成原子接口嵌入聚合 skill 编排流程。
- 客服主管,需要核实客户关于发货仓库和揽收地点的咨询,给出有据可查的答复。
- 跨境平台运营,需要在处理售后争议时调取发货地址信息,作为责任判定的依据。