Agent Skills
返回列表
酷特海外运营物流单列表

酷特海外运营物流单列表

企业运营 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-shipping-query-shipping-list。

技能介绍

要解决什么问题

在海外运营平台里核对发货进度、对账或排查异常时,往往需要按条件拉取物流单列表,而不是单条详情。若由 agent 临时拼 URL、分页字段和鉴权头,容易把 base_url 写错、把 Query 与 Body 混用,或在 Bearer 上重复拼接前缀。

本技能是 shipping_list 这一原子动作:在固定正式环境上发起 GET https://www.kutetailor.com/api/shipping/shipping,用 ShippingVO 与分页参数查询,返回平台定义的 IPage 结构。

技能如何工作

  • 只执行表中的 shipping_list 动作;完整链路(例如先登录再查列表)由上层 agent 编排其它 skill。
  • 调用参数统一放在嵌套 params 里:Query 写入 params.query,Path 写入 params.path;登录态用 params.accessToken 生成 Authorization: Bearer,若已含 Bearer 则不再拼接。
  • 执行器必须使用 frontmatter 中的正式环境地址,不接受用户输入覆盖 base_url。
  • 返回以接口响应为准:不补造库存、价格、订单号、优惠或物流状态;认证、权限、参数或业务错误时,应把原始错误码与信息交给上层处理。

适用边界

  • 需求若包含多个接口步骤,本 skill 只完成列表查询并把关键字段交给后续步骤。
  • 仍受当前登录态、租户与用户权限约束;查询类接口同样可能因权限不足而失败。

使用场景

  • 客服 agent 在已拿到 accessToken 后,按 ShippingVO 条件分页调用 GET /shipping,核对某批次出库对应的物流单号与状态。
  • 对账脚本由上层 agent 编排登录与本 skill,只负责拉取 IPage 物流单列表,再把运单号交给详情或轨迹 skill。
  • 运营同学用自然语言描述「某时间段、某状态」的发货记录,由 agent 把条件写入 params.query 并请求正式环境列表接口。
  • 排查「列表有单但详情查不到」时,先固定用 frontmatter 正式地址查 shipping_list,避免误用测试域或自造分页结果。

适合人员

  • 负责酷特海外运营对账、需通过 agent 按条件分页导出物流单列表的运营专员
  • 把 platform-shipping-query 拆成原子 skill 编排、只需封装 shipping_list 的集成工程师
  • 在工单系统里接 Kutesmart 正式环境、替坐席查发货列表的后端或自动化维护者
  • 编写多步发货查询计划文档、要求列表结果原样回传错误码的上层 agent 维护者