design pattern · 2026 · platform blueprint
catalog·agent
Pattern architetturale per agenti AI consiglieri B2B su cataloghi prodotto multi-brand. Una piattaforma, N cataloghi eterogenei, integrazione progressiva con sistemi esterni.
v1.0 · BLUEPRINT
multi-tenant ready
multi-language ready
multi-domain agnostic
Ncataloghi
Multi-brand · multi-dominio
3strati
Knowledge · Constraint · Commercial
7step
Pipeline auto-curation AI
3modi
Bootstrap · refresh · reactive
§ 01
ARCHITETTURA A TRE STRATI
C

Commercial Agent

Orchestratore consigliere · state graph framework
Accumula vincoli del cliente, esplora compatibilità cross-catalog, presenta opzioni con pro/contro, costruisce proposta strutturata. Modalità consigliere: la decisione finale resta umana.
customer_config add_constraint summarize_config generate_proposal
B

Constraint Engine

Filtraggio attributi · Compatibility cross-catalog
Tool deterministici per filtrare prodotti su attributi strutturati e verificare regole di compatibilità tra cataloghi. Pricing tier-aware live da sistema esterno.
filter_products check_compatibility find_linked get_pricing
A

Catalog Knowledge

Wiki MD canonica + DB strutturato + Vector embedding 768d
Per ogni catalogo: schede prodotto, distinte canoniche, regole tecniche, glossario sigle, schede narrative. Tutto interrogabile via search semantica, lookup codici, traversal grafo wiki link [[ns/id]].
get_codice search_semantic find_codici_by_NL get_famiglia_wiki get_regola read_distinta get_media

↓ N cataloghi multi-brand · onboarding incrementale

CAT-01
CAT-02
CAT-03
CAT-04
CAT-05
CAT-06
CAT-07
CAT-08
CAT-09
···CAT-N
DISPATCHER
classifier · fan-out cross-catalog · aggregator anti-allucinazione
External
system PROGRESSIVE INTEGRATION
STEP 1 Read cache Export periodico
platform.pricing
STEP 2 Read live API verifica
disponibilità puntuale
STEP 3 Write quote Bot crea preventivo
bozza nel sistema
STEP 4 Cart + Order Carrello + ordine
(legacy UI deprecated)
§ 02
TRE MODI OPERATIVI
A
BOOTSTRAP
Onboarding nuovo catalogo
Curator apre CLI agentico, fornisce sorgente master. Pipeline 7-step interattiva con sample → review → batch. Output in draft/, review batch via Editor UI.
~1k prodotti · 1-2 settimane
~$2k AI cost una tantum
B
REFRESH
Nuova edizione sorgente
Cron job rileva cambio sorgente master, esegue diff su chunks, re-runna pipeline solo sul delta. Notifica curator con conteggio prodotti modificati/nuovi/rimossi.
Cadenza 3-6 mesi · ~50 delta
~$200/refresh
C
REACTIVE
Auto-update self-healing
Curator modifica un dato in editor. Cascade engine propaga ri-generazione SOLO agli artefatti dipendenti via hash-based dependency tracking. Notifica review 1-click.
Continuo · 1-5 artefatti/edit
~$0.05-0.50 per cambio
§ 03
PIPELINE AUTO-CURATION · 7 STEP AI
1
extract
attributes
small LLM
2
aesthetic
tags
small + vision
3
generate
narrative
large LLM
4
extract
links
small LLM
5
extract
rules
large LLM
6
extract
glossary
small LLM
7
extract
compatibility
large LLM
→ Output per catalogo ~1k schede YAML · ~1k MD narrative · ~50 regole · ~30 sigle · ~20 compat rules
§ 04
ROADMAP — QUATTRO FASI
M1
M2
M3
M4
M5
M6
M7
M8
M9
M10
M11
M12
FASE 1 · Knowledge
Mesi 1–3
Refactor monolitico → piattaforma. Multi-catalog dispatcher. Onboarding catalogo #2 via auto-curator MVP.
FASE 2 · Constraint
Mesi 4–6
Strato B attivo: filter_products + check_compatibility. Catalogo #3 onboarded. External system step 1+2 (read).
FASE 3 · Commercial Agent
Mesi 7–11
Strato C orchestratore (state graph). Pilot utenti finali. External step 3+4 (write quote, cart, ordine). Legacy UI deprecata.
FASE 4
M12+
Hardening · cataloghi aggiuntivi · scale-out.