酷特海外订单采购生产进度
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-order-progress-purchase-progress。
技能介绍
要解决什么问题
海外运营侧经常需要核对单笔订单在采购与生产环节走到哪一步,而不是只看订单列表里的汇总状态。若由 Agent 自行拼 URL、猜 path 参数或改写 base_url,很容易打到错误环境或漏传 orderId,返回结果也无法与平台侧对账。
本技能是酷特海外运营平台订单进度链路里的原子接口 skill,只负责 purchase_progress 这一动作:按固定正式环境地址查询指定订单的采购/生产进度,并把接口原始响应交给上层编排。
技能如何工作
- 固定使用 frontmatter 中的正式环境
base_url,调用 GET/order/orden-procurement-progress/getProgress/{orderId},不接受用户输入覆盖域名或根路径。 - 工具参数统一放在嵌套对象
params内:orderId写入params.path;需要登录态时通过params.accessToken生成Authorization: Bearer(值已含Bearer时不重复拼接)。 - 执行器按表选择 HTTP 方法与路径,将
{orderId}从params.path替换进 URL;GET 的查询条件走params.query,额外头信息走params.headers。 - 返回以接口响应为唯一事实来源;若出现认证、权限、参数或业务错误,应把原始错误码与错误信息向上传递,便于聚合 skill 或计划文档继续编排其它原子步骤。
适用边界与注意点
- 用户需求若涉及多接口、多步骤(例如先查订单再查物流),本 skill 只完成本接口,不负责整条业务链路;需由上层 Agent 引用
platform-order-progress等聚合 skill 或按计划文档组合多个原子 skill。 - 最外层 tool arguments 只放
params,不要使用params.xxx这类点号形式的顶层 key。 - 仍为查询类接口,须遵守当前登录态、租户与用户权限;不要根据对话内容补造库存、价格、订单号或物流状态。
使用场景
- 客服接到海外客户催单,需用订单号查询该单当前采购与生产节点再回复
- 跟单员在 ERP 与运营平台对账时,核对单笔订单的生产进度是否与平台接口一致
- Agent 编排订单进度链路时,在拿到 orderId 后调用本接口拉取采购/生产进度原始数据
- 运营复盘某批延期订单,按订单 ID 批量由上层循环调用本 skill 汇总各单进度
适合人员
- 负责酷特海外定制订单跟单、需向客户说明面料采购与车间生产阶段的客服或客户经理
- 对接 kutetailor.com 订单 API、在 Agent 里编排 platform-order-progress 多步骤链路的集成工程师
- 每日用运营后台核对生产状态、希望用自然语言查单笔订单采购进度的海外运营专员
- 编写订单进度聚合 skill 或计划文档、需要固定 purchase_progress 原子调用的平台技能维护者