1688 采购询盘寻源#

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

命令速查#

命令说明示例procurement发起采购询盘cli.py procurement --offerName "衣服" --count "10" --demand "价格便宜"``configure配置 AKcli.py configure YOUR_AK

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

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

严格禁止 (NEVER DO)#

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

意图判断#

技能定位与边界#

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

四个技能的协作关系：

text

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

判断维度本技能（询盘寻源）智能选品（product-find）交易下单（1688-order）用户阶段有采购意向，未选定商品搜索浏览，货比三家已选定商品，要下单付款商品确定性模糊描述（"衣服"、"螺丝"）可模糊可具体已有具体商品ID/链接核心动作发布询盘、求报价搜索、浏览、比较下单、支付、查订单典型表述"我有一批衣服要采购，谁能供货""帮我搜一下黑色卫衣""帮我下单这个商品"

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

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

触发示例：

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

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

用户表述转交技能原因"帮我搜一下黑色卫衣"1688-product-find搜索浏览商品，非询盘"帮我找同款" / "以图搜图" / "比价"1688-product-find选品比价，非询盘"帮我下单这个商品（offerId: xxx）"1688-order已有具体商品，直接下单"帮我下单，商品链接是 xxx"1688-order已选定商品，交易下单"我要买100箱打印纸"（已有具体商品）1688-order已选定商品要下单"帮我支付订单" / "查询订单状态"1688-order订单交易流程"帮我找做保温杯的供应商"1688-source-suppliers找供应商信息"我要下单付款" / "查物流"不处理非本技能范围

边界场景处理#

• "帮我采购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 → "请问您对商品有什么要求？（如价格、材质、发货速度等）"

• 所有字段齐全后再执行命令

安全声明#

风险级别命令Agent 行为写入procurement当商品名称、数量、需求明确时直接执行；信息缺失时先追问补齐

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

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

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

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

异常处理#

任何命令输出 success: false 时：

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

markdown 关键词Agent 额外动作"AK 未配置" 或 "签名无效" 或 "401"提示用户当前能力所需鉴权未就绪，请补充有效 AK 或检查鉴权配置后重试"offerName 不能为空"询问用户要采购什么商品"count 不能为空"询问用户大概需要采购多少"demand 不能为空"询问用户对商品有什么要求"参数缺失" 或 "title/userId/text 不能为空"提示用户补充缺失参数后重试"限流" 或 "429"建议用户等待 1-2 分钟后重试其他仅输出 markdown 即可

参数补齐引导话术#

采购询盘：

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