Page 06 / 08 · Interaction

The handoff between Classifier and Recognizer

The two modules do not call each other. They are coupled via artifacts: the Classifier leaves behind path and metadata, the Recognizer reads them and infers its model from them. This loose coupling is why partial runs, repetitions, and corrections can all resume at the same point.

Module A · writes

Classifier

01 STORAGE PATH
<Classifier>/<Category>/<File>
02 BLOB METADATA
AnalysedCategory
CategoryConfidence
03 JOURNAL LEVEL
Classified · document key
Handoff
via artifacts
east
no direct
module call
Module B · reads

Recognizer

01 CLASSIFIER FROM PATH
First path segment = name of the classifier model
02 MODEL LOOKUP
Recognition model whose supported classifier matches
03 CATEGORY CHECK
Does the model cover the recognized document type?
Three outcomes of the category check
Match

Model covers the category

The standard case: analysis starts immediately with the assigned model and its engine. No intervention, no waiting state.

Auto-Onboarding

Category trained, model missing

The automation creates a recognition model itself: field schema suggested from the triggering document, analyzer published, the document attached as a permanent example. The target system assignment remains intentionally open — unverified data never reaches the target system. At most once per category.

Skipped

With reason, not silently

If no model remains, the case is written to the journal with a plain-language reason — “no recognition model for classifier X” or “category Y not configured in model Z”. A document never disappears.

The contract between the modules
Artifact Created by Evaluated by
Storage path with classifier and category Classifier at runtime Recognizer — model lookup
Recognized document type on the blob Classifier at runtime Recognizer — category check
Assignment confidence Classifier at runtime Classification gate, journal, monitor
Supported classifier per model FormRecognizerConfig console Recognizer — model lookup
Supported categories per model FormRecognizerConfig console Category check, auto-onboarding
Trained categories and threshold ClassifierConfig console Classification gate, auto-onboarding
Engine choice is the model’s responsibility

Each recognition model carries its engine: classic trained field extraction or an authorized field schema. The Recognizer branches per model — everything after that is engine-neutral because both paths produce the same result format. The Classifier remains completely untouched by this.

trained model authorized schema one result format
Two consoles, one chain
ClassifierConfig
Collect training data per category, build classifier, test ad hoc, set confidence threshold.
FormRecognizerConfig
Create recognition model, assign classifier and categories, maintain field and table mapping as well as target system assignment.
Both consoles only configure — the processing chain starts and decides.