技能介绍

解决的问题

在订单执行链路中，海外运营团队常需要确认某笔订单当前的采购与生产阶段，以便安排后续发运、客服沟通或供应链协调。传统做法依赖人工登录后台、多页面跳转或导出报表，效率低且容易遗漏关键进度更新。本技能将“查询采购/生产进度”这一动作封装成可被上层 Agent 调用的最小接口单元，直接对接平台固定端点，返回结构化进度数据，避免在多个系统间来回切换。

如何工作

技能的核心是 GET https://www.kutetailor.com/api/order/order/orden-procurement-progress/getProgress/{orderId} 这个端点。调用时，执行器会读取 frontmatter 中固定的正式环境地址，不接受用户输入覆盖 base_url。路径参数 orderId 通过 params.path 传入；若调用需要登录态，则从 params.accessToken 提取 token，并组装为 Authorization: Bearer 头，如果传入值已包含 Bearer 则不会重复拼接。对于查询或计算类接口，返回结果严格以接口响应为事实来源，不会额外补造库存、价格、订单号或物流状态。

当接口返回认证失败、权限不足、参数错误或业务错误时，技能会原样将错误码与错误信息透传给上层 Agent，便于后续定位。

适用边界与注意点

该技能是最小颗粒度的原子接口技能，只负责一个平台接口动作 purchase_progress。如果业务需要串联多个步骤（例如先查订单详情、再查生产进度、再查物流），应由上层 Agent 或聚合技能按计划编排多个原子技能完成，而不是在此技能内实现。此外，它仅面向需要查询采购/生产进度的场景；对于数据写入、状态变更等操作，应使用其他对应技能。使用时请确保传入的 orderId 与当前登录态、租户及用户权限匹配，否则接口可能返回业务错误。