1688 采购询盘寻源

统一入口：python3 {baseDir}/cli.py <command> [options]

命令速查

所有命令输出 JSON：{"success": bool, "markdown": str, "data": {...}}

展示时直接输出 markdown 字段，Agent 分析追加在后面，不得混入其中。

严格禁止 (NEVER DO)

• 不要编造商品价格、链接、规格或供货信息，所有内容必须来自工具返回
• 不要在用户已选定具体商品（有明确 offerId/商品链接）要下单时触发本技能，这些属于 1688-order
• 不要在用户仅表达"找商品"、"搜一下"、"看看有什么"等浏览意图时触发本技能，这些属于 1688-product-find
• 不要在用户查找供应商/工厂时触发本技能，这些属于 1688-source-suppliers
• 禁止在 AK 未配置或命令执行失败时，自行通过浏览器或搜索引擎获取商品信息

意图判断

技能定位与边界

本技能的核心场景：用户有采购需求但尚未选定具体商品或供应商，需要发布询盘让平台帮忙匹配。

四个技能的协作关系：

采购旅程：模糊需求 → 搜索选品 → 找供应商 → 询盘寻源 → 下单交易
            ↓           ↓          ↓          ↓           ↓
         不触发    product-find  source-suppliers  本技能    1688-order

触发本技能（满足以下任一条件）

1. 询盘/询价意图：用户明确表达"询盘"、"询价"、"求报价"、"发布采购需求"等寻源类表述
2. 模糊采购需求 + 无具体商品：用户描述了采购需求（商品名称 + 数量 + 要求），但没有提供具体商品ID、商品链接或已选定的商品，希望平台帮忙匹配
3. 寻源咨询：用户表达"谁能供货"、"有没有厂家能做"、"哪里能采购到"等寻源意图

触发示例：

• "我有一批衣服要采购，大概10件，要求价格便宜，帮我询个价" ✅（询盘寻源）
• "我需要采购500个304不锈钢螺丝，谁能供货？" ✅（模糊需求 + 寻源）
• "帮我发布一个采购需求：200件纯棉T恤，要便宜的" ✅（发布采购需求）
• "我想采购一批办公用品，帮我问问有没有合适的供应商报价" ✅（询盘咨询）
• "求报价：1000个纸杯，要食品级材质" ✅（求报价）

不触发本技能（转交其他技能）

边界场景处理

• "帮我采购10件衣服，要求价格便宜"（无具体商品ID）→ ✅ 触发本技能（模糊需求，发起询盘）
• "帮我采购10件衣服，商品ID是 xxx"（有具体商品）→ 交给 1688-order（已选定商品，直接下单）
• "帮我采购10件衣服，链接是 xxx"（有商品链接）→ 交给 1688-order（已选定商品，直接下单）
• "我想买打印纸"（无数量、无具体商品、意图模糊）→ 交给 1688-product-find（更接近浏览搜索）
• "找货" → 交给 1688-product-find（搜索商品）
• "帮我找做衣服的工厂" → 交给 1688-source-suppliers（找供应商）

核心区分口诀

有具体商品要下单 → 1688-order 没有具体商品，只有模糊需求要询盘 → 本技能 只是搜索浏览看看 → 1688-product-find 找供应商/工厂信息 → 1688-source-suppliers

使用流程

Agent 根据用户意图直接执行对应命令。 各命令在 AK 缺失等情况下会自行返回明确错误，Agent 按下方「异常处理」应对即可。

采购询盘使用指引：

• 当用户表达模糊的采购需求且未选定具体商品时（如"我需要采购10件衣服，要求价格便宜，帮我询个价"），使用 procurement
• Agent 需从用户自然语言中提取以下字段：
  • offerName：商品名称（如"衣服"）
  • count：采购数量，必须是纯数字，不能包含单位（如用户说"500斤"，传给 count 的值应为 "500"，而非 "500斤"）
  • demand：采购需求描述（如"价格便宜"）
• 若有字段缺失，必须主动询问用户补充：
  • 缺 offerName → "请问您要采购什么商品？"
  • 缺 count → "请问您大概需要采购多少？"
  • 缺 demand → "请问您对商品有什么要求？（如价格、材质、发货速度等）"
• 所有字段齐全后再执行命令

安全声明

全局写入规则（适用于所有写操作）：

1. 发送类、创建类操作属于写入。
2. 当所需信息明确时，可直接执行。
3. 当信息缺失时，先向用户追问补齐后再执行。
4. 不擅自扩写、改写用户的原始意图；如需调整，应明确告知并征得用户认可。

执行前置（首次命中能力时必须）

• 首次执行 procurement 前：先完整阅读 references/capabilities/procurement.md
• 首次执行 configure 前：先完整阅读 references/capabilities/configure.md
• 同一会话内后续重复调用可复用已加载知识；仅在规则冲突或文档更新时重读。

异常处理

任何命令输出 success: false 时：

1. 先输出 markdown 字段（已包含用户可读的错误描述）
2. 再根据关键词追加引导：

参数补齐引导话术

采购询盘：

"发起采购询盘需要这几个信息：商品名称、采购数量、采购需求。您可以直接告诉我，例如：我需要采购10件衣服，要求价格便宜，帮我询个价。"