Enriquecimiento del catálogo
El enriquecimiento del catálogo es una funcionalidad nativa de Adobe Commerce que le ayuda a mejorar los nombres de los productos y las descripciones largas para que el catálogo se represente con mayor precisión cuando los compradores utilizan LLM y asistentes de IA para la investigación y el descubrimiento de productos.
Cómo funciona how-it-works
El catálogo de productos Adobe Commerce es el sistema de registro de los datos de productos: nombres, descripciones, atributos, precios e inventario. Adobe Commerce El MCP (protocolo de contexto de modelo) de Storefront conecta los datos del catálogo en directo con las experiencias de Adobe AI. A partir de ahí, el agente de catálogo puede identificar lagunas en los nombres de los productos y las descripciones largas, proponer mejoras y escribir los cambios aprobados de nuevo en Commerce para que pueda revisarlos en el administrador de Commerce.
Con el enriquecimiento del catálogo, puede:
- Identifique las lagunas e incoherencias en los nombres de los productos y las descripciones largas que afectan a la interpretación de los productos por parte de los LLM.
- Revise las mejoras sugeridas con contexto de soporte, incluidas justificaciones y comparaciones del antes y después.
- Aplique las actualizaciones aprobadas directamente al catálogo de Commerce para que el administrador, la tienda y otros canales que lean esos campos permanezcan alineados.
Dado que los nombres de los productos y las descripciones largas residen en Commerce, la mejora de la copia una vez puede beneficiar a todos los canales que consumen esos datos de productos. La ventaja depende de cómo y cuándo se actualicen los sistemas.
Para quién es esto who-this-is-for
- Especialistas en marketing digital y distribuidores que deseen que los datos de los productos sean precisos y coherentes en las respuestas basadas en LLM.
- Comerciantes y especialistas en marketing digital que necesiten una forma controlada de mejorar las copias de catálogo a escala.
- Administradores de Commerce propietarios de la integridad del catálogo, procesos de administración e integraciones (API, CSV, PIM) que alimentan atributos de producto.
Requisitos previos prerequisites
Los siguientes requisitos previos se aplican cuando tiene acceso al enriquecimiento del catálogo.
- Su tienda puede ser rastreada por bots agénticos y orientados a LLM donde se requiere rastrear la cobertura de las sugerencias según el catálogo.
- Los servicios de Commerce y la conectividad del catálogo requeridos están habilitados y en buen estado. Consulte Habilitar enriquecimiento de catálogo para obtener más información.
- El usuario administrador de Commerce que accede al enriquecimiento del catálogo inicia sesión a través de Adobe IMS. Ver requisitos de organización e inicio de sesión de IMS.
- Tiene acceso a Adobe Admin Console.
- Su organización ha firmado al usuario de GenAI o se ha excluido explícitamente de los servicios de IA subyacentes.
Requisitos de organización e inicio de sesión de IMS ims-sign-in-requirements
El enriquecimiento de catálogo utiliza el token de acceso Adobe IMS del usuario administrador de Commerce que inició sesión para conectarse a Adobe Brand Visibility. Este token no se produce en el inicio de sesión de un administrador nativo de Commerce que solo tenga un nombre de usuario y una contraseña de Commerce, por lo que el usuario administrador que acceda al enriquecimiento del catálogo debe iniciar sesión a través de Adobe IMS.
Para admitir el inicio de sesión en IMS, la instancia de Commerce debe tener habilitada la integración de administración de Commerce con Adobe ID. Consulte Configuración de la integración de administración de Commerce con Adobe ID.
La organización IMS de Adobe asociada a su instancia de Commerce suele ser diferente de la organización IMS que posee sus derechos de Adobe Brand Visibility. Al habilitar la integración de administración de Commerce con Adobe ID, no se concede acceso al derecho de Visibilidad de la marca, y no se requiere que ambas organizaciones sean la misma. Póngase en contacto con el administrador de Adobe o con el equipo de la cuenta para confirmar qué suscripciones a la organización IMS y qué enriquecimiento del catálogo de acceso a cuentas requiere en la configuración.
Habilitar enriquecimiento de catálogo enable-catalog-enrichment
Póngase en contacto con el administrador de Commerce o con su socio de implementación para asegurarse de lo siguiente antes de revisar o aplicar las sugerencias:
Instalación de extensiones de enriquecimiento de catálogo y servicios de catálogo
-
Instale la extensión de enriquecimiento del catálogo en la instancia de Commerce y aplique los cambios:
code language-bash composer require magento/module-catalog-enrichment:^2.1 bin/magento setup:upgrade bin/magento cache:flushsetup:upgradehabilita la extensión, crea su tabla de base de datos y concede permisos de administración. Vacíe la caché más tarde para que los permisos surtan efecto. En el modo de producción, ejecute tambiénbin/magento setup:di:compileybin/magento setup:static-content:deploy. -
Si aún no ha instalado los servicios de catálogo, hágalo.
Catalog enrichment ya está disponible en su instancia de Commerce.
magento/llm-optimizer). Si lo tiene instalado, elimínelo antes de actualizar. Ver Actualización de versiones anteriores en las notas de la versión.Acceso al enriquecimiento del catálogo
Después de instalar las extensiones de enriquecimiento de catálogo y servicios de catálogo, la capacidad de enriquecimiento de catálogo está disponible en el Administrador en AI Product Discovery > Catalog Enrichment.
Configuración del enriquecimiento del catálogo configure-catalog-enrichment
Configure el enriquecimiento de catálogo en la ficha Settings para que Commerce Catalog Agent pueda conectarse a su entorno Adobe Commerce y mostrar sugerencias en el administrador de Commerce.
Los campos de esta pestaña identifican el entorno de Commerce y la vista de tienda a la que se conecta el enriquecimiento del catálogo. Son independientes de la organización IMS de Adobe que posee sus derechos de Adobe Brand Visibility. Ver requisitos de organización e inicio de sesión de IMS.
-
En el Administrador, vaya a AI Product Discovery > Catalog Enrichment.
-
En la lista Scope de la parte superior de la página, seleccione la vista de tienda que desee configurar o deje All Store Views para administrar la configuración en las vistas de tienda.
-
Abra la ficha Settings.
-
En Commerce Configuration, expanda el panel de vista de tienda etiquetado con su dirección URL.
Proporcione los detalles de su entorno Adobe Commerce para habilitar el servicio Catalog Adobe Brand Visibility y los flujos de trabajo de auditoría.
-
Introduzca los detalles de conexión necesarios para la vista de tienda.
- Store View URL: dirección URL correspondiente a la vista de la tienda (por ejemplo,
https://brand.example.com/fr/). - Environment ID: Identificador único del entorno Adobe Commerce al que accede la conexión.
- Website Code, Store Code y Store View Code: Sitio web, tienda y códigos de vista de tienda para el sitio web de Commerce. Estos valores deben coincidir con los códigos del administrador de Commerce.
- Host Name: nombre de host de su instancia Adobe Commerce.
- Store View URL: dirección URL correspondiente a la vista de la tienda (por ejemplo,
-
Haga clic en Save.
Después de guardar, espere a que se complete cualquier trabajo de sincronización o validación inicial antes de depender de los resultados del catálogo o de la auditoría para esa vista de tienda. Las sugerencias de productos pueden tardar hasta 24 horas en aparecer en la página Catalog Enrichment.
Para quitar una configuración de vista de tienda, expanda esa entrada y haga clic en Delete.
Descripciones de campos commerce-connection-fields
Los campos obligatorios están marcados con un asterisco (*) en el formulario Commerce Configuration.
https://brand.example.com/fr/).Revisión y aplicación del enriquecimiento del catálogo review-and-apply
Una vez habilitado y configurado el enriquecimiento del catálogo, las sugerencias de productos se muestran en la pestaña Agentic Opportunities. Desde aquí puede revisar sugerencias y aplicar actualizaciones aprobadas a nombres de productos y descripciones largas en su catálogo de Commerce.
El enriquecimiento del catálogo utiliza las siguientes vistas de flujo de trabajo:
- Current Suggestions: elementos nuevos o activos para revisar.
- Fixed Suggestions: elementos que ya aplicó o resolvió.
- Ignored Suggestions: elementos que ha excluido intencionadamente de la acción.
Implementar sugerencias aprobadas review-deploy-catalog
Para implementar sugerencias aprobadas:
- Seleccione Current Suggestions.
- Haga clic en el control de expansión de la fila URL o SKU para mostrar las actualizaciones propuestas del nombre y la descripción del producto.
- Revise la sugerencia y confirme que coincide con su estrategia de comercialización y optimización de los motores de búsqueda.
Puede editar una sugerencia antes de implementarla o moverla a Ignored Suggestions si no coincide con su estrategia.
- Seleccione la fila de la URL o SKU que desea actualizar.
- Haga clic en Deploy optimizations y confirme.
Los cambios de nombre y descripción aprobados se guardan en el catálogo Adobe Commerce como otras actualizaciones de productos.
Después de aplicar una actualización, las sugerencias pasan a Fixed Suggestions con el estado Marcado como fijo.
Verificar enriquecimiento en el administrador verify-in-admin
Para comprobar el enriquecimiento del catálogo aplicado:
-
Vaya a Catalog > Products en el Administrador de Commerce.
-
Use los filtros y el selector Store View según sea necesario (por ejemplo, Default Store View).
-
Busque el SKU.
-
Abra el producto en modo de edición.
El formulario del producto muestra el nombre y/o la descripción del producto enriquecido.
-
Opcional: seleccione Override Catalog Agent provided Product Name si desea conservar un nombre ingresado manualmente en su lugar.
Las anulaciones manuales afectan a la forma en que las sugerencias permanecen sincronizadas con el catálogo. Para obtener más información, consulte Anulación manual en Admin.
-
Expanda la sección Content y busque el campo de descripción.
La descripción enriquecida aparece cuando se aplican cambios de descripción.
-
Opcional: seleccione Override Catalog Agent provided Description si desea conservar una descripción introducida manualmente en su lugar.
Las anulaciones manuales afectan a la forma en que las sugerencias permanecen sincronizadas con el catálogo. Para obtener más información, consulte Anulación manual en Admin.
Verificar enriquecimiento en la tienda verify-storefront
Para comprobar el enriquecimiento en la tienda:
-
Busque el SKU en su tienda.
-
Abra la página del producto.
-
Confirme que el nombre y la descripción del producto coinciden con lo que ha aprobado.
Puede tomar algún tiempo antes de que los enriquecimientos aparezcan en tu tienda.
-
Confirme que las regiones que muestran la descripción larga coinciden con lo que ha aprobado.
-
Opcional: Confirme los canales descendentes que consumen los mismos atributos de catálogo, cuando sean relevantes para el despliegue.
Invalidaciones, ingesta y sugerencias obsoletas overrides-ingestion
Después de que el enriquecimiento del catálogo actualice el nombre o la descripción de un producto, otros sistemas de ingesta pueden cambiar los mismos campos. Algunos ejemplos son llamadas a la API de REST, importaciones de CSV y fuentes PIM.
Valor original reintroducido original-value-reingested
Si un proceso externo escribe el nombre o la descripción originales (el valor que existía antes de aplicar el enriquecimiento), Commerce sigue respetando el valor enriquecido para ese campo según las reglas de enriquecimiento del catálogo. Es posible que la sugerencia no se revierta automáticamente solo en función de esa ingesta.
Nuevo valor reintroducido new-value-reingested
Si el proceso externo envía un nuevo valor que no es una repetición del texto previo al enriquecimiento, Commerce respeta el nuevo valor de catálogo. Por ejemplo, si cambia el nombre de “Zapatos rojos” a “Zapatos rojos icónicos”, se sustituye el valor enriquecido. La sugerencia de enriquecimiento relacionada generalmente se marca como Obsoleta porque el catálogo en vivo ya no coincide con el contexto de la sugerencia.
Anulación manual en el administrador manual-override-in-the-admin
Si edita manualmente el nombre o la descripción del producto en el administrador de Adobe Commerce:
- El valor Admin gana como sistema de registro para ese cambio manual.
- La sugerencia de enriquecimiento está marcada Desactualizada.
- El flujo de trabajo de sugerencias vuelve al estado original de ese elemento para que pueda volver a aprobar o aceptar una nueva sugerencia si el análisis se vuelve a ejecutar.
Estas reglas le ayudan a saber si el enriquecimiento del catálogo, las fuentes de ingesta o las ediciones de administración son autorizadas cuando varios canales tocan el mismo SKU.
Límites y consideraciones limits
- Actualmente, Enrichment solo admite contenido de productos en inglés.
- El enriquecimiento solo se aplica a nombres de productos y descripciones largas. No cambia el diseño de la PDP, los widgets u otro contenido de tienda de nivel de página.
- Los catálogos grandes y los recuentos altos de URL pueden afectar a la rapidez con la que se completa el análisis y a la cantidad de sugerencias que aparecen a la vez.
- Las sugerencias significativas suponen que los bots relevantes para LLM pueden acceder a las direcciones URL del producto que le interesan. Las reglas, la autenticación, el bloqueo geográfico y la personalización avanzada de los robots pueden reducir la cobertura.
Prácticas recomendadas best-practices
- Documente la propiedad del sistema para el nombre y la descripción del producto de modo que los trabajos de PIM o de fuentes no entren en conflicto involuntariamente con el enriquecimiento del catálogo.
- Coordínese con los equipos de SEO y de marca antes de aplicar títulos o descripciones por lotes.
- Volver a sincronizar o analizar después de las importaciones del catálogo principal para que las sugerencias reflejen el estado del catálogo actual.
Ejemplos
Los siguientes ejemplos muestran cómo el enriquecimiento del catálogo convierte los atributos técnicos sin procesar en una copia narrativa del producto centrada en el comprador que los LLM pueden utilizar para responder preguntas de compra.
Ejemplo: Producto de café con atributos técnicos
El catálogo de la retailer de café almacena solamente las especificaciones técnicas de un producto de grano de café tostado mediano: variedad de grano, región de origen, método de procesamiento, nivel de tostado y rango de altitud. Estos campos describen el producto, pero no comunican su valor a un comprador, por lo que un asistente de IA tiene poco con qué trabajar al responder una pregunta como “¿qué café tiene un sabor suave y poco ácido?”
El enriquecimiento del catálogo lee los atributos técnicos y las razones a través de cómo interactúan para inferir características relevantes para el comprador:
El enriquecimiento del catálogo aplica estas características inferidas a la copia del producto:
- Antes: “Granos de café asados Medium - Arabica, Brasil Minas Gerais, Proceso de miel, 900-1200 m”
- Después: “Los frijoles árabes cultivados a 900-1200 m en Minas Gerais de Brasil, procesados con miel y tostados medianos, desarrollan un tacto bucal naturalmente dulce y cremoso con un marcado carácter avellana, tonos caramelo y baja acidez. Un café especial consistente y accesible que se experimenta mejor con el vertido”.
El nombre y la descripción actualizados se guardan directamente en el catálogo de Commerce, por lo que la tienda, las fuentes LLM y otros canales que leen esos campos reflejan la misma copia enriquecida.
Ejemplo: Configuración de muebles modulares
Un mueble retailer vende un sofá de sección modular en el que la descripción del producto solo enumera los códigos de configuración y el nombre de la estructura, por ejemplo, 6 Standard Seats + 6 Standard Sides in Sapphire Navy Corded Velvet. Este método abreviado es comprensible para un cliente que regresa, pero le da a un asistente de IA poco contexto sobre cómo funciona el producto o qué lo hace duradero o cómodo.
El enriquecimiento de catálogo amplía los atributos de configuración y estructura en una descripción narrativa que explica qué hace cada componente y por qué importa a un comprador:
- Antes: “6 asientos estándar + 6 laterales estándar en terciopelo con cable de la marina de zafiro”
- Después: “Esta configuración incluye 6 juegos de inserciones de asientos estándar y 6 inserciones laterales estándar que funcionan indistintamente como brazos o respaldos, formando los bloques modulares de construcción de su diseño. Cada asiento cuenta con espuma estándar con tres capas de alta densidad diseñadas para preservar la elevación y resistir la flacidez. La funda de terciopelo con cordones Sapphire Navy es tan duradera como lujosa, con cordones con textura que crean un brillo sutil y una sensación suave y lujosa. Las fundas están cosidas a mano para lograr un aspecto preciso y personalizado, y son lavables a máquina y cambiables, por lo que su sección puede evolucionar con su espacio”.
Debido a que la descripción enriquecida se escribe de nuevo en el catálogo de Commerce, está disponible para bots de IA que rastrean por la página de detalles del producto, así como para cualquier canal descendente o fuente que consuma los datos del catálogo del producto, sin cambiar el diseño que los compradores ven en la página.
Notas de la versión release-notes
Estas notas de la versión capturan adiciones y correcciones en la extensión de enriquecimiento de catálogo (magento/module-catalog-enrichment):
Versión 2.1.2
22 de octubre de 2026
[Compatible]{class="badge informative" title="Admitido"} con Adobe Commerce 2.4.9, 2.4.8 y 2.4.7 en PHP 8.3 a 8.5.
La versión 2.1.2 convierte el enriquecimiento del catálogo en una extensión independiente. Ahora incluye todo lo que se proporcionó anteriormente con la extensión independiente Adobe Brand Visibility (magento/llm-optimizer): aplicar sugerencias aprobadas al catálogo, revertirlas y proteger sus propias ediciones para que no se sobrescriban.
Actualización de versiones anteriores upgrade-from-earlier-versions
-
Quite la extensión Adobe Brand Visibility, si está instalada:
code language-bash composer remove magento/llm-optimizerSi la extensión se instaló copiando o vinculando simbólicamente
Magento/LlmoCatalogenapp/code, elimine ese directorio. No solo deshabilite el módulo: un módulo deshabilitado que aún esté en el disco puede hacer quesetup:upgradeelimine la tabla que almacena los valores originales de los productos enriquecidos. -
Actualice el enriquecimiento del catálogo y aplique los cambios:
code language-bash composer require magento/module-catalog-enrichment:^2.1 bin/magento setup:upgrade bin/magento cache:flushVaciar la caché después de la actualización. La actualización mueve las concesiones de acceso existentes a nuevos recursos de permisos, y esas concesiones no surten efecto hasta que se borra la caché.
Requisitos
Nuevas funciones
Correcciones y mejoras
401 en lugar de 500, por lo que no se vuelve a intentar realizar la solicitud en el catálogo y se rechaza un entorno de Adobe IMS no reconocido en lugar de tratarse como de ensayo.
abv.adobe.com, lo que corrige un bucle de inicio de sesión después de que el dominio anterior empezara a redirigir.
Problemas conocidos
Versión 1.0.2
Versión inicial de la página de administración del enriquecimiento del catálogo. Requiere la extensión Adobe Brand Visibility para aplicar sugerencias al catálogo.