酷特海外平台 C 端收货地址查询
将以下提示词粘贴到你的 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 维护者