Agent Skills
返回列表
1688 供应链采购询盘 API

1688 供应链采购询盘 API

开发编程 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_15292d5a/yjkj-1688-supplychain-api-procurement。

技能介绍

要解决什么问题

在 1688 供应链场景里,找品 + 询盘往往是一次性给出品类、规格、数量、价格带、工厂要求,以及报价、交期、起订量等问题。若把整条链路拆成多个独立工具再手工串联,Agent 容易多跑找品、SKU 匹配或轮询询盘状态,上下文里还会塞进大段 JSON。

本技能把流程收敛为两步:发起找挑询(立刻拿到 instanceId)和查询实例数据(文件模式 + stream_output 透传)。

如何工作

功能一:发起找挑询

当用户给出完整采购与询盘需求、且未提供 instanceId 时,执行 inquiry 命令创建并触发实例。主要参数包括:

  • --requirement / -r:完整需求(找品 + 询盘问题)
  • --questions / -q:可选,能可靠拆出询盘问题时再传;否则整段需求作为唯一问题
  • --purchase-size、--inquiry-item-size、--recall-item-size:数量与召回/询盘规模(未指定时 inquiry/recall 默认 30)
  • --image、--image-url:本地路径或 URL(URL 会先下载再上传纵横平台)

stdout 只返回顶层含 instanceId 的 JSON;技能不会自动查实例、不会轮询询盘是否结束。

功能二:查询实例数据

用户提供 instanceId 或明确要求查某实例时,必须用 --output-mode file。脚本 stdout 只给 outputFile 路径;Agent 需立即调用 stream_output 把文件内容给用户,再用 rm 删本地结果文件。禁止不带 file 模式查询,也禁止在最终回复里复述或总结实例 JSON。

边界与注意点

  • 用户输入须是一段完整需求;不能拆问题时不要反问,整段当作询盘问题即可。
  • 触发本技能后,发起找挑询的最终回答须 raw JSON 透传(仅 { "instanceId": ... }),不得包 Markdown、说明话术或额外包装字段。
  • 不调用商品表格、交互卡;不先跑独立找品/批量询盘/下单;不编造商品、价格、库存或供应商回复。

使用场景

  • 采购同学用一段话描述品类、数量、价格带和交期问题,需要立刻拿到 inquiry 的 instanceId 再异步查结果
  • 跨境选品时附带商品链接或 `--image-url`,由技能创建找品询盘任务而不在对话里塞满召回 JSON
  • 已有 instanceId,要把实例当前状态导出到文件并通过 stream_output 交给用户,避免大段 JSON 进模型上下文
  • 能拆出报价、起订量、定制等询盘问题时,用 `--questions` 传入;拆不清则整段需求作为唯一问题发起

适合人员

  • 负责 1688 找厂找货、需要把「找品 + 多轮询盘问题」交给 Agent 按 API 规范执行的采购
  • 做供应链 Agent 集成、必须遵守 raw JSON 透传与 file 模式查询协议的后端或工具开发者
  • 运营/买手在对话里提交图文采购需求,只先要 instanceId、后续再按 ID 拉实例数据的 workflow 设计方
  • 需要控制 `--inquiry-item-size` / `--recall-item-size` 规模、避免默认 30 条不符合业务场景的询盘配置同学