Smart supplier recommendation based on sourcing requirements.
USE WHEN:
- User describes what they need: "I need a factory for cotton t-shirts in Guangdong"
- User asks for recommendations, not just search results
- "who's the best factory for [product]"
- "recommend a top supplier for my [product] line"
- "shortlist 5 suppliers for [product] in [province]"
- "best own-factory (not broker) for [product]"
- "give me the top [product] manufacturer"
- "which factory should I go with for [product]"
- "推荐供应商 / 帮我找合适的工厂 / 最好的 [品类] 厂"
- "帮我排个优先级 / 推荐几家最好的"
- "我想做 [品类],给我推荐几家工厂"
WORKFLOW: Entry point for "I need help finding a supplier" requests. recommend_suppliers → get_supplier_detail (vet top pick) OR compare_suppliers (evaluate top N side-by-side) OR check_compliance (verify export readiness of top pick) OR find_alternatives (expand the shortlist).
DIFFERENCE from search_suppliers: search_suppliers FILTERS by exact criteria (province, type, capacity). This tool RANKS by fit — prioritizes own-factory, then quality score, then capacity.
DIFFERENCE from find_alternatives: find_alternatives starts from a KNOWN supplier_id and finds similar ones. This tool starts from product REQUIREMENTS.
RETURNS: { query, total_matches, showing_top, note: "ranking logic", data: [supplier objects] }
EXAMPLES:
• User: "Recommend me the top 5 factories for sportswear in Fujian"
→ recommend_suppliers({ product: "sportswear", province: "Fujian", type: "factory", limit: 5 })
• User: "I need the best own-factory (not trading company) for down jackets"
→ recommend_suppliers({ product: "down jacket", type: "factory", limit: 5 })
• User: "帮我推荐 3 家广东做 T 恤的工厂"
→ recommend_suppliers({ product: "t-shirt", province: "Guangdong", limit: 3 })
ERRORS & SELF-CORRECTION:
• Empty data → try in order: (1) drop province, (2) drop type filter, (3) broaden product (e.g. "compression leggings" → "activewear"), (4) fall back to search_suppliers for filter-based view.
• product_type not found in normalizeProductType → use the Chinese term or the parent category.
• Rate limit 429 → wait 60 seconds; do not retry immediately.
• Empty after 3 retries → tell user: "I don't see verified suppliers matching [product] in [province]. Want me to broaden to nationwide, or try a sibling category?"
AVOID: Do not call this when the user wants exact filtering — use search_suppliers. Do not call repeatedly for different limit values — request max once then slice in your response. Do not use for cluster recommendations — use search_clusters.
NOTE: Ranking: own_factory > quality_score > declared_capacity_monthly. Source: MRC Data (meacheal.ai).
中文:基于采购需求智能推荐供应商,按 自有工厂 > 质量分 > 产能 排序。