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 Storefront MCP (Model Context Protocol) conecta los datos del catálogo en directo con las experiencias de Adobe AI. A partir de ahí, el agente de catálogo utiliza esa interfaz para que Adobe LLM Optimizer pueda identificar lagunas en los nombres de productos y 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.
- IMS está configurado).
- Tiene acceso a Adobe Admin Console.
Si no tiene una organización de IMS, póngase en contacto con el equipo de su cuenta de Adobe para aprovisionar una.
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 de catálogo en la instancia de Commerce ejecutando el siguiente comando:
code language-bash composer require magento/module-catalog-enrichment --no-update composer update magento/module-catalog-enrichment -
Si aún no ha instalado los servicios de catálogo, hágalo.
Catalog enrichment ya está disponible en su instancia de Commerce.
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 Catalog > Catalog Enrichment.
Configuración del enriquecimiento del catálogo
Configure el enriquecimiento del catálogo en la ficha Settings para que Adobe LLM Optimizer pueda conectarse a su entorno Adobe Commerce y mostrar sugerencias en el administrador de Commerce.
-
En el Administrador, vaya a Catalog > 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 LLM Optimizer 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 de 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.
- Store View URL: dirección URL correspondiente a la vista de la tienda (por ejemplo,
-
Opcional: escriba Host Name y API Key si su entorno los requiere.
- Host Name: nombre de host de su instancia de Adobe Commerce.
- Adobe Commerce Endpoint: este campo no se usa.
- API Key: clave de autenticación utilizada para acceder de forma segura a las API de Adobe Commerce. Haga clic en Copy al lado del campo si necesita copiar la clave en otra parte.
-
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 LLM Optimizer 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 LLM Optimizer 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
- 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.