DEV Community

MapleBridge.io
MapleBridge.io

Posted on

Why AI supplier matching needs explanations, not just scores

When a buyer asks for "a small-batch stainless steel bottle supplier in China, FDA-grade, can ship to Toronto", returning ten suppliers with a score like 0.82 is not enough.

The buyer still needs to know:

  • why this supplier was included
  • which requirements were actually matched
  • what was inferred
  • what is missing
  • what should be checked before sending a message

That is why I think supplier matching needs a match_explanation object, not just a ranking score.

A small schema that works better

The smallest useful explanation I have found has four parts.

1. Matched constraints

These are the fields that clearly line up with the buyer brief:

  • product category
  • material or process capability
  • target market or compliance language
  • MOQ / sample support
  • shipping or export familiarity
  • buyer size fit

This matters because two suppliers can have the same score for very different reasons.

2. Assumptions

AI matching systems often infer things from weak signals.

For example:

  • "North America export experience" may be inferred from customer cases, not explicitly stated.
  • "Small-batch friendly" may be inferred from sample language, not a published MOQ.
  • "OEM capable" may be inferred from product customization examples.

Those assumptions should be visible. Hidden assumptions are where bad procurement recommendations usually start.

3. Missing fields

A good match should still say what it does not know.

Example:

{
  "missing_fields": [
    "confirmed MOQ for first order",
    "current lead time",
    "FDA documentation availability",
    "private-label packaging cost"
  ]
}
Enter fullscreen mode Exit fullscreen mode

This gives the buyer a better next message. Instead of asking "are you a good supplier?", they can ask about the exact gaps.

4. Next question

The final output should help the buyer move forward.

For example:

{
  "next_question": "Can you support a 300-unit trial order with FDA-compliant material documentation and private-label packaging?"
}
Enter fullscreen mode Exit fullscreen mode

This is more useful than another paragraph of supplier description.

Why this is different from normal search

Search engines are good at retrieving pages.

Procurement matching is different. The buyer is not only asking "who talks about stainless steel bottles?" They are asking "which supplier is worth contacting for this specific buying situation?"

That means the system needs to expose its reasoning in a structured way.

The score can still exist, but it should be secondary. The explanation is what makes the match actionable.

I have been writing this pattern into MapleBridge Open, an open protocol layer for buyer intent, supplier capability, and match explanations:

The broader lesson is simple: if an AI procurement system cannot explain the match, the buyer still has to redo the screening manually.

Top comments (0)