1688-source-suppliers
意图判断
触发本技能:
- 找供应商、查供应商、1688供应商、供应商信息、工厂信息
- 查询某地区的工厂/产业带(如"常州灯具工厂"、"义乌小商品供应商")
- 寻找某品类的生产厂家/加工厂
严格禁止(NEVER DO)
- 不编造供应商信息:禁止凭空生成不存在的公司名称、联系方式或地址
- 不擅自改写查询关键字:不得在未征得用户认可的情况下修改用户的查询意图
- 不混入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:追加引导链接
- 在供应商信息后追加:
输出规范
数据质量要求:
- 返回的供应商记录必须包含以下完整信息,缺少任一字段的记录将被自动过滤:
- 公司名称(必填,不能为空)
- 合作方式(必填,不能为空)
- 服务(必填,不能为空)
- Agent在向用户展示供应商信息时,应确保所有推荐的供应商都包含完整的供应商名称
输出顺序:
- 先输出
markdown字段内容(供应商信息) - 再追加引导链接
- 最后可追加 Agent 分析内容
引导链接格式:
输出示例:
{
"success": true,
"markdown": "找到 5 家供应商\n\n---\n\n### 供应商 1\n\n- 公司名称: [中山市致富照明有限公司](https://sale.1688.com/...)\n- 所在地区: 广东中山\n- 合作方式: OEM\n- 服务: 清加工, 包工包料",
"data": {...}
}
异常处理
任何命令输出 success: false 时:
- 先输出
markdown字段(已包含用户可读的错误描述) - 再根据关键词追加引导:
| markdown 关键词 | Agent 额外动作 |
|---|---|
| "AK 未配置" 或 "签名无效" 或 "401" | 提示用户当前查询能力所需鉴权未就绪,请运行 cli.py configure YOUR_AK 配置 AK 后重试 |
| "参数缺失" 或 "query 不能为空" | 提示用户补充查询关键字后重试 |
| "限流" 或 "429" | 建议用户等待 1-2 分钟后重试 |
| "格式异常" 或 "服务异常" | 提示用户服务暂时不可用,请稍后重试 |
| 其他 | 仅输出 markdown 即可 |
安全声明
| 风险级别 | 命令 | Agent 行为 |
|---|---|---|
| 读取 | ali_1688_source_suppliers | 当查询关键字明确时直接执行;信息缺失时先追问补齐 |
全局读取规则:
- 查询类操作属于读取,当查询关键字明确时可直接执行
- 当查询关键字不明确时,先向用户追问补齐后再执行
- 不擅自扩写、改写用户的查询关键字;如需优化,应明确告知并征得用户认可