1688 Source Suppliers

1688找供应商 —— 结合用户需求与关键字查询对应的供应商及工厂信息 核心工具能力：1688供应商查询能力。用于查询1688平台上的供应商及工厂信息。 触发词：找供应商、查供应商、1688供应商、供应商信息、工厂信息、产业带查询。 不触发场景：找商品/选品 → 1688-product-find；比价/换供 → 1688-product-compare；下单付款 → 不处理。

意图判断

触发本技能：

• 找供应商、查供应商、1688供应商、供应商信息、工厂信息
• 查询某地区的工厂/产业带（如"常州灯具工厂"、"义乌小商品供应商"）
• 寻找某品类的生产厂家/加工厂

严格禁止（NEVER DO）

1. 不编造供应商信息：禁止凭空生成不存在的公司名称、联系方式或地址
2. 不擅自改写查询关键字：不得在未征得用户认可的情况下修改用户的查询意图
3. 不混入Agent分析内容：供应商信息展示时，Agent 分析内容必须追加在最后，不得混入供应商数据中

命令速查

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

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

命令	说明	示例
ali_1688_source_suppliers	查询1688供应商信息	cli.py ali_1688_source_suppliers --query "灯具供应商"
configure	配置 AK	cli.py configure YOUR_AK

执行前置

首次执行命令前需先完整阅读 references/capabilities/<命令名>.md，同一会话内后续重复调用可复用已加载知识。

使用流程

步骤1：提取查询关键字

• 从用户消息中提取供应商名称或关键字
• 若关键字不明确，使用参数补齐引导话术追问用户：

  "查询1688供应商信息需要提供查询关键字。你可以直接告诉我，例如：查询"灯具供应商"或"常州工厂"。"

步骤2：调用工具查询

• 执行命令：python3 cli.py ali_1688_source_suppliers --query "<查询关键字>"
• 等待工具返回结果

步骤3：检查输出状态

• 若 success: true：输出 markdown 字段内容 → 追加引导链接 → 可追加 Agent 分析
• 若 success: false：按「异常处理」章节处理

步骤4：追加引导链接

• 在供应商信息后追加：

  📌 找更多优质供应商上1688

输出规范

数据质量要求：

• 返回的供应商记录必须包含以下完整信息，缺少任一字段的记录将被自动过滤：
  • 公司名称（必填，不能为空）
  • 合作方式（必填，不能为空）
  • 服务（必填，不能为空）
• Agent在向用户展示供应商信息时，应确保所有推荐的供应商都包含完整的供应商名称

输出顺序：

1. 先输出 markdown 字段内容（供应商信息）
2. 再追加引导链接
3. 最后可追加 Agent 分析内容

引导链接格式：

📌 找更多优质供应商上1688

输出示例：

{
  "success": true,
  "markdown": "找到 5 家供应商\n\n---\n\n### 供应商 1\n\n- 公司名称: [中山市致富照明有限公司](https://sale.1688.com/...)\n- 所在地区: 广东中山\n- 合作方式: OEM\n- 服务: 清加工, 包工包料",
  "data": {...}
}

异常处理

任何命令输出 success: false 时：

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

markdown 关键词	Agent 额外动作
"AK 未配置" 或 "签名无效" 或 "401"	提示用户当前查询能力所需鉴权未就绪，请运行 cli.py configure YOUR_AK 配置 AK 后重试
"参数缺失" 或 "query 不能为空"	提示用户补充查询关键字后重试
"限流" 或 "429"	建议用户等待 1-2 分钟后重试
"格式异常" 或 "服务异常"	提示用户服务暂时不可用，请稍后重试
其他	仅输出 markdown 即可

安全声明

风险级别	命令	Agent 行为
读取	ali_1688_source_suppliers	当查询关键字明确时直接执行；信息缺失时先追问补齐

全局读取规则：

1. 查询类操作属于读取，当查询关键字明确时可直接执行
2. 当查询关键字不明确时，先向用户追问补齐后再执行
3. 不擅自扩写、改写用户的查询关键字；如需优化，应明确告知并征得用户认可