1688 供应链采购询盘 API
将以下提示词粘贴到你的 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 条不符合业务场景的询盘配置同学