Agent Skills
返回列表
酷特海外平台 C 端收货地址查询

酷特海外平台 C 端收货地址查询

企业运营 更新于 2026.08.30

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

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

技能介绍

要解决什么问题

在海外电商或定制业务里,结账、改址、客服核对订单时,都需要拿到当前登录 C 端用户已保存的收货地址。若让 Agent 自行拼 URL、猜 Header 或混用测试/正式环境,很容易出权限错误或脏数据。

本技能只做一件事:按平台契约调用 address_list,返回接口真实响应,供上层 Agent 与「购物车」「下单」等其它原子 skill 串联。

技能如何工作

  • 固定正式环境:使用 frontmatter 中的 base_url,不接受用户输入覆盖;对应动作为 GET /c_address/getAddressList。
  • 统一参数形态:tool 参数只放在嵌套对象 params 里;登录态通过 params.accessToken 生成 Authorization: Bearer(值里已有 Bearer 则不再重复拼接)。
  • 职责边界:仅完成本接口 HTTP 调用;若用户意图涉及多步(例如先登录再查址再改购物车),由上层按聚合 skill platform-cart-address 或计划文档编排其它 skill。
  • 结果约定:以接口返回为唯一事实来源,不补造地址、默认项或库存类字段;认证、权限、参数或业务错误时,把原始错误码与信息交给上层处理。

适用边界与注意点

这是查询类、需登录态的最小颗粒度接口 skill。Path / Query / Body 分别写入 params.path、params.query、params.body;本接口以 Header 鉴权为主。组合完整业务链路时,请勿在本 skill 内硬编码后续下单或改址逻辑。

使用场景

  • 客服处理改址工单时,需用已登录会员的 token 拉取其平台内保存的全部收货地址再核对
  • Agent 编排结账前步骤,调用 `address_list` 获取可选地址列表供用户或下游 skill 选择
  • 排查海外站购物车异常时,对照接口原始返回确认当前账号下是否已有默认或历史地址
  • 在聚合 skill `platform-cart-address` 计划中,作为单独一步只负责查址、不代做改址或下单

适合人员

  • 对接酷特 Kutetailor 会员接口、要把查址动作封装成原子 skill 的后端或集成工程师
  • 用 Agent 辅助海外电商客服,需在持 token 前提下查询 C 端用户收货地址列表的一线支持
  • 维护 `platform-cart-address` 聚合文档、按 action 拆分编排多个平台 API 的 Agent 方案设计人员
  • 构建定制/海外下单助手的开发者,在登录态已就绪后只需可靠调用正式环境 `getAddressList` 的上层 Agent 维护者