Arricchimento del catalogo
L’arricchimento del catalogo è una funzionalità nativa di Adobe Commerce che consente di migliorare i nomi dei prodotti e le descrizioni lunghe in modo che il catalogo venga rappresentato in modo più accurato quando gli acquirenti utilizzano LLM e assistenti AI per la ricerca e l’individuazione dei prodotti.
Come funziona how-it-works
Il catalogo prodotti Adobe Commerce è il sistema di registrazione per i dati dei prodotti: nomi, descrizioni, attributi, prezzi e inventario. Adobe Commerce Storefront MCP (Model Context Protocol) collega i dati live del catalogo alle esperienze Adobe AI. Da lì, l’agente catalogo può identificare le lacune nei nomi dei prodotti e nelle descrizioni lunghe, proporre miglioramenti e riscrivere le modifiche approvate in Commerce in modo da poterle esaminare nell’amministratore Commerce.
Con l’arricchimento del catalogo puoi:
- Identifica le lacune e le incoerenze nei nomi dei prodotti e nelle descrizioni lunghe che influiscono sul modo in cui i moduli LLM interpretano i prodotti.
- Revisione dei miglioramenti suggeriti con contesto di supporto, incluse giustificazioni e confronti prima e dopo.
- Applica gli aggiornamenti approvati direttamente al catalogo Commerce in modo che l’amministratore, la vetrina e altri canali che leggono tali campi rimangano allineati.
Poiché i nomi dei prodotti e le descrizioni lunghe risiedono in Commerce, il miglioramento della copia una sola volta può essere utile per ogni canale che utilizza tali dati di prodotto. Il vantaggio dipende da come e quando i sistemi vengono aggiornati.
Per chi è questo who-this-is-for
- Professionisti del marketing digitale e commercianti che desiderano che i dati dei prodotti siano accurati e coerenti nelle risposte basate su LLM.
- Esperti di marketing digitale e merchandising che necessitano di un modo controllato per migliorare la copia del catalogo su larga scala.
- Amministratori Commerce proprietari di integrità del catalogo, processi di amministrazione e integrazioni (API, CSV, PIM) che forniscono attributi di prodotto.
Prerequisiti prerequisites
I seguenti prerequisiti si applicano quando si ha accesso all’arricchimento del catalogo.
- La vetrina può essere scansionata da bot agentici e orientati verso LLM in cui è necessaria la copertura della scansiona per i suggerimenti in base al catalogo.
- I servizi Commerce richiesti e la connettività al catalogo sono abilitati e integri. Per ulteriori informazioni, consulta Abilita arricchimento catalogo.
- L’utente amministratore di Commerce che accede all’arricchimento del catalogo effettua l’accesso tramite Adobe IMS. Consulta Requisiti di accesso e organizzazione IMS.
- Hai accesso a Adobe Admin Console.
- La tua organizzazione ha firmato il rider GenAI, o ha esplicitamente rinunciato, per i servizi di intelligenza artificiale sottostanti.
Requisiti di accesso e organizzazione IMS ims-sign-in-requirements
L’arricchimento del catalogo utilizza il token di accesso Adobe IMS dell’utente amministratore Commerce connesso per connettersi a Adobe Brand Visibility. L’accesso come amministratore nativo di Commerce con un solo nome utente e una sola password Commerce non produce questo token, pertanto l’utente amministratore che accede all’arricchimento del catalogo deve effettuare l’accesso tramite Adobe IMS.
Per supportare l’accesso IMS, l’istanza di Commerce deve avere l’integrazione amministratore Commerce con Adobe ID abilitata. Consulta Configurare l’integrazione dell’amministratore di Commerce con Adobe ID.
L’organizzazione Adobe IMS associata alla tua istanza Commerce è in genere diversa dall’organizzazione IMS che possiede l’adesione Adobe Brand Visibility. L’abilitazione dell’integrazione dell’amministratore di Commerce con Adobe ID non concede di per sé l’accesso alla Visibilità dei brand, e le due organizzazioni non devono essere necessariamente le stesse. Rivolgiti al tuo amministratore Adobe o al team dell’account per confermare quali iscrizioni all’organizzazione IMS e arricchimento del catalogo per l’accesso all’account richiedono nella configurazione.
Abilita arricchimento catalogo enable-catalog-enrichment
Prima di rivedere o applicare suggerimenti, rivolgiti al tuo amministratore Commerce o al tuo partner di implementazione per verificare quanto segue:
Installare le estensioni di Catalog Enrichment e Catalog Services
-
Installa l’estensione di arricchimento del catalogo nell’istanza Commerce e applica le modifiche:
code language-bash composer require magento/module-catalog-enrichment:^2.1 bin/magento setup:upgrade bin/magento cache:flushsetup:upgradeabilita l’estensione, crea la relativa tabella di database e concede le autorizzazioni di amministratore. Svuota successivamente la cache in modo che le autorizzazioni abbiano effetto. In modalità di produzione, eseguire anchebin/magento setup:di:compileebin/magento setup:static-content:deploy. -
Se non hai già installato Catalog Services, procedi.
Catalog enrichment è ora disponibile nella tua istanza di Commerce.
magento/llm-optimizer). Se è installato, rimuoverlo prima dell'aggiornamento. Consulta Aggiornamento da versioni precedenti nelle note sulla versione.Accedere all’arricchimento del catalogo
Dopo aver installato le estensioni di Catalog Enrichment e Catalog Services, la funzionalità di arricchimento del catalogo è disponibile nell’amministratore in AI Product Discovery > Catalog Enrichment.
Configurare l’arricchimento del catalogo configure-catalog-enrichment
Configura l’arricchimento del catalogo nella scheda Settings in modo che Commerce Catalog Agent possa connettersi all’ambiente Adobe Commerce e presentare suggerimenti in Commerce Admin.
I campi di questa scheda identificano l’ambiente Commerce e la visualizzazione archivio a cui si connette l’arricchimento del catalogo. Sono separati dall’organizzazione Adobe IMS che detiene il tuo diritto a Adobe Brand Visibility. Consulta Requisiti di accesso e organizzazione IMS.
-
In Amministrazione, passa a AI Product Discovery > Catalog Enrichment.
-
Nell’elenco Scope nella parte superiore della pagina, selezionare la visualizzazione dello store che si desidera configurare oppure lasciare All Store Views per gestire le impostazioni tra le visualizzazioni dello store.
-
Apri la scheda Settings.
-
In Commerce Configuration, espandere il pannello di visualizzazione archivio con l’etichetta con il relativo URL.
Fornisci i dettagli dell’ambiente Adobe Commerce per abilitare il servizio Catalog Adobe Brand Visibility e i flussi di lavoro di controllo.
-
Immettere i dettagli di connessione richiesti per la visualizzazione archivio.
- Store View URL: URL corrispondente alla visualizzazione archivio, ad esempio
https://brand.example.com/fr/. - Environment ID: identificatore univoco per l’ambiente Adobe Commerce a cui la connessione accede.
- Website Code, Store Code e Store View Code: codici di visualizzazione sito Web, archivio e archivio per il sito Web Commerce. Questi valori devono corrispondere ai codici presenti nell’amministratore Commerce.
- Host Name: nome host dell’istanza Adobe Commerce.
- Store View URL: URL corrispondente alla visualizzazione archivio, ad esempio
-
Fare clic su Save.
Dopo il salvataggio, attendere il completamento di qualsiasi processo di sincronizzazione o convalida iniziale prima di basarsi sui risultati del catalogo o del controllo di audit per la visualizzazione archivio. La visualizzazione dei suggerimenti di prodotto nella pagina Catalog Enrichment potrebbe richiedere fino a 24 ore.
Per rimuovere una configurazione della visualizzazione archivio, espandere tale voce e fare clic su Delete.
Descrizioni dei campi commerce-connection-fields
I campi obbligatori sono contrassegnati con un asterisco (*) nel modulo Commerce Configuration.
https://brand.example.com/fr/).Rivedere e applicare l’arricchimento del catalogo review-and-apply
Dopo aver abilitato e configurato l’arricchimento del catalogo, i suggerimenti di prodotto vengono visualizzati nella scheda Agentic Opportunities. Da qui puoi rivedere i suggerimenti e applicare gli aggiornamenti approvati ai nomi dei prodotti e alle descrizioni lunghe nel catalogo Commerce.
L’arricchimento del catalogo utilizza le seguenti visualizzazioni del flusso di lavoro:
- Current Suggestions: elementi nuovi o attivi da rivedere.
- Fixed Suggestions: elementi già applicati o risolti.
- Ignored Suggestions: elementi esclusi intenzionalmente dall’azione.
Distribuire i suggerimenti approvati review-deploy-catalog
Per distribuire i suggerimenti approvati:
- Selezionare Current Suggestions.
- Fai clic sul controllo di espansione per l’URL o la riga SKU per visualizzare il nome del prodotto e gli aggiornamenti della descrizione del prodotto proposti.
- Rivedi il suggerimento e conferma che corrisponda alla tua strategia di merchandising e SEO.
È possibile modificare un suggerimento prima di distribuirlo o spostarlo in Ignored Suggestions se non corrisponde alla strategia.
- Seleziona la riga per l’URL o lo SKU da aggiornare.
- Fai clic su Deploy optimizations e conferma.
Le modifiche approvate al nome e alla descrizione vengono salvate nel catalogo Adobe Commerce come per gli altri aggiornamenti di prodotto.
Dopo aver applicato un aggiornamento, i suggerimenti passano a Fixed Suggestions con uno stato Contrassegnato come Fisso.
Verificare l’arricchimento nell’amministratore verify-in-admin
Per verificare l’arricchimento del catalogo applicato:
-
Vai a Catalog > Products nell’amministratore di Commerce.
-
Utilizza i filtri e il selettore Store View come necessario (ad esempio, Default Store View).
-
Cerca lo SKU.
-
Apri il prodotto in modalità di modifica.
Il modulo del prodotto riporta il nome e/o la descrizione del prodotto arricchito.
-
Facoltativo: selezionare Override Catalog Agent provided Product Name se si desidera mantenere un nome immesso manualmente.
Le sostituzioni manuali influiscono sul modo in cui i suggerimenti rimangono sincronizzati con il catalogo. Per ulteriori informazioni, vedere Sostituzione manuale in Admin.
-
Espandere la sezione Content e individuare il campo di descrizione.
La descrizione arricchita viene visualizzata quando hai applicato le modifiche alla descrizione.
-
Facoltativo: selezionare Override Catalog Agent provided Description se si desidera conservare una descrizione immessa manualmente.
Le sostituzioni manuali influiscono sul modo in cui i suggerimenti rimangono sincronizzati con il catalogo. Per ulteriori informazioni, vedere Sostituzione manuale in Admin.
Verificare l’arricchimento nella vetrina verify-storefront
Per verificare l’arricchimento nella vetrina:
-
Cerca lo SKU nella vetrina.
-
Apri la pagina del prodotto.
-
Verifica che il nome e la descrizione del prodotto corrispondano a quelli approvati.
Potrebbero volerci un po’ di tempo prima che l’arricchimento appaia sul vetrina.
-
Verifica che le aree che mostrano la descrizione estesa corrispondano a quelle approvate.
-
Facoltativo: conferma i canali a valle che utilizzano gli stessi attributi del catalogo, se pertinente per il rollout.
Override, acquisizione e suggerimenti obsoleti overrides-ingestion
Dopo che l’arricchimento del catalogo ha aggiornato il nome o la descrizione di un prodotto, gli stessi campi possono essere modificati da altri sistemi di acquisizione. Alcuni esempi includono chiamate REST API, importazioni CSV e feed PIM.
Valore originale riacquisito original-value-reingested
Se un processo esterno scrive il nome o la descrizione originale (il valore esistente prima dell’applicazione dell’arricchimento), Commerce continua a rispettare il valore arricchito per quel campo in base alle regole di arricchimento del catalogo. Il suggerimento potrebbe non essere ripristinato automaticamente in base a quella sola acquisizione.
Nuovo valore riacquisito new-value-reingested
Se il processo esterno invia un nuovo valore che non è una ripetizione del testo di prearricchimento, Commerce rispetta il nuovo valore di catalogo. Ad esempio, il valore arricchito viene sostituito con un nuovo nome da “Scarpe rosse” a “Scarpe rosse iconiche”. Il suggerimento di arricchimento correlato è in genere contrassegnato come Obsoleto perché il catalogo live non corrisponde più al contesto del suggerimento.
Sostituzione manuale in Admin manual-override-in-the-admin
Se si modifica manualmente il nome o la descrizione del prodotto nell’amministratore Adobe Commerce:
- Il valore Admin vince come sistema di registrazione per quella modifica manuale.
- Il suggerimento di arricchimento è contrassegnato come Obsoleto.
- Il flusso di lavoro dei suggerimenti torna allo stato originale per l’elemento in modo da poter ridefinire la linea di base o accettare un nuovo suggerimento se l’analisi viene eseguita nuovamente.
Queste regole ti aiutano a capire se l’arricchimento del catalogo, i feed di acquisizione o le modifiche dell’amministratore sono autorevoli quando più canali toccano la stessa SKU.
Limiti e considerazioni limits
- Attualmente Enrichment supporta solo contenuti di prodotto in lingua inglese.
- L’arricchimento si applica solo ai nomi dei prodotti e alle descrizioni lunghe. Non modifica il layout PDP, i widget o altri contenuti della vetrina a livello di pagina.
- Cataloghi di grandi dimensioni e conteggi URL elevati possono influenzare la rapidità con cui viene completata l’analisi e il numero di suggerimenti visualizzati contemporaneamente.
- Suggerimenti significativi presuppongono che i bot rilevanti per LLM possano accedere agli URL del prodotto a cui tieni. Regole robot, autenticazione, blocco geografico e personalizzazione intensiva possono ridurre la copertura.
Best practice best-practices
- Documentare la proprietà del sistema per il nome e la descrizione del prodotto in modo che i processi PIM o di feed non entrino involontariamente in conflitto con l’arricchimento del catalogo.
- Coordina con i team SEO e brand prima di applicare titoli o descrizioni in blocco.
- Risincronizza o analizza dopo le principali importazioni del catalogo in modo che i suggerimenti riflettano lo stato corrente del catalogo.
Esempi
Gli esempi seguenti mostrano come l’arricchimento del catalogo trasforma gli attributi tecnici grezzi in copie di prodotto narrative incentrate sull’acquirente che i moduli LLM possono utilizzare per rispondere alle domande di acquisto.
Esempio: prodotto a base di caffè con attributi tecnici
Un catalogo di Coffee retailer memorizza solo le specifiche tecniche per un prodotto di chicchi di caffè arrosto medio: varietà di chicchi, regione di origine, metodo di elaborazione, livello di arrosto e gamma di altitudine. Questi campi descrivono il prodotto ma non ne comunicano il valore a un acquirente, quindi un assistente AI ha poco da lavorare quando risponde a una domanda come “quale caffè ha un sapore liscio e a basso contenuto acido?”
L’arricchimento del catalogo legge gli attributi tecnici e i motivi attraverso il modo in cui interagiscono per dedurre le caratteristiche rilevanti per l’acquirente:
L’arricchimento del catalogo applica le seguenti caratteristiche dedotte alla copia del prodotto:
- Prima: “Medium chicchi di caffè arrosto - Arabica, Brasile Minas Gerais, processo del miele, 900-1200m”
- Dopo: “I fagioli Arabica coltivati a 900-1200m nel Minas Gerais brasiliano, miele lavorato e medio torrefatto, sviluppano un sapore dolce naturale, cremoso con un carattere di nocciola distinto, sottotoni di caramello, e bassa acidità. Un caffè speciale coerente e avvicinabile, meglio sperimentato attraverso versare sopra.”
Il nome e la descrizione aggiornati vengono salvati direttamente nel catalogo Commerce, pertanto la vetrina, i feed LLM e altri canali che leggono tali campi riflettono tutti la stessa copia arricchita.
Esempio: configurazione di mobili modulari
Un retailer per mobili vende un divano modulare in cui la descrizione del prodotto elenca solo i codici di configurazione e il nome del fabric, ad esempio 6 Standard Seats + 6 Standard Sides in Sapphire Navy Corded Velvet. Questa scorciatoia è comprensibile per un cliente di ritorno, ma offre all’assistente di intelligenza artificiale un piccolo contesto sul funzionamento del prodotto o su cosa lo rende resistente o confortevole.
L’arricchimento del catalogo espande gli attributi di configurazione e struttura in una descrizione narrativa che spiega cosa fa ogni componente e perché è importante per l’acquirente:
- Prima: “6 Posti Standard + 6 Lati Standard in Velluto Cordato Sapphire Navy”
- Dopo: “Questa configurazione include 6 set di inserimento posti standard e 6 inserti laterali standard che funzionano in modo intercambiabile come braccia o schienali, formando gli elementi modulari del layout. Ogni sedile è dotato di Schiuma standard con tre strati ad alta densità progettati per preservare l’sollevamento e resistere alle cadute. La copertina Sapphire Navy Corded Velvet è durevole come è lussuosa, con corde testurizzate che creano un sottile lucentezza e una sensazione morbida e peluche. Le coperture sono cucite a mano per un aspetto preciso e personalizzato e sono lavabili in lavatrice e modificabili, in modo che la sezione possa evolvere con il tuo spazio.”
Poiché la descrizione arricchita viene scritta nuovamente nel catalogo Commerce, è disponibile per i bot AI che scansionano la pagina dei dettagli del prodotto e per qualsiasi canale o feed a valle che consuma i dati del catalogo del prodotto, senza modificare il layout o la progettazione visualizzati dagli acquirenti sulla pagina.
Note sulla versione release-notes
Queste note sulla versione acquisiscono aggiunte e correzioni nell’estensione di arricchimento del catalogo (magento/module-catalog-enrichment):
v2.1.2
22 ottobre 2026
[Supportato]{class="badge informative" title="Supportato"} Adobe Commerce 2.4.9, 2.4.8, 2.4.7 su PHP da 8.3 a 8.5.
La versione 2.1.2 rende l’arricchimento dei cataloghi un’estensione autonoma. Ora include tutto ciò che era stato fornito in precedenza dall’estensione Adobe Brand Visibility separata (magento/llm-optimizer): l’applicazione dei suggerimenti approvati al catalogo, il loro rollback e la protezione delle proprie modifiche dalla sovrascrittura.
Aggiornamento da versioni precedenti upgrade-from-earlier-versions
-
Rimuovere l’estensione Adobe Brand Visibility, se installata:
code language-bash composer remove magento/llm-optimizerSe l’estensione è stata installata tramite copia o collegamento simbolico di
Magento/LlmoCataloginapp/code, eliminare la directory. Non disabilitare solo il modulo: un modulo disabilitato che è ancora su disco può causare l’eliminazione disetup:upgradedalla tabella in cui sono memorizzati i valori originali dei prodotti arricchiti. -
Aggiorna l’arricchimento del catalogo e applica le modifiche:
code language-bash composer require magento/module-catalog-enrichment:^2.1 bin/magento setup:upgrade bin/magento cache:flushSvuota la cache dopo l’aggiornamento. L’aggiornamento sposta le concessioni di accesso esistenti in nuove risorse di autorizzazione, che diventano effettive solo dopo che la cache sarà stata cancellata.
Requisiti
Nuove funzioni
Correzioni e miglioramenti
401 invece di 500, pertanto la richiesta non viene ritentata rispetto al catalogo e un ambiente Adobe IMS non riconosciuto viene rifiutato invece di essere trattato come gestione temporanea.
abv.adobe.com, che corregge un loop di accesso dopo che il dominio precedente ha iniziato il reindirizzamento.
Problemi noti
v1.0.2
Versione iniziale della pagina di amministrazione dell’arricchimento del catalogo. Richiede l’estensione Adobe Brand Visibility per applicare suggerimenti al catalogo.