1688-sourcing-inquiry

# 1688 采购询盘寻源 统一入口：`python3 {baseDir}/cli.py <command> [options]` ## 命令速查 | 命令 | 说明 | 示例 | |------|------|------| | `procurement` | 发起采购询盘 | `cli.py procurement --offerName "衣服" --count "10" --demand "价格便宜"` | | `configure` | 配置 AK | `cli.py configure YOUR_AK` | 所有命令输出 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 ``` | 判断维度 | 本技能（询盘寻源） | 智能选品（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件衣服，要求价格便宜，帮我询个价。"