Enriquecimento do catálogo
O enriquecimento do catálogo é um recurso nativo do Adobe Commerce que ajuda a melhorar os nomes de produtos e as descrições longas, para que seu catálogo seja representado com mais precisão quando os compradores usarem LLMs e assistentes de IA para pesquisa e descoberta de produtos.
Como funciona how-it-works
O catálogo de produtos do Adobe Commerce é o sistema de registro de dados de produtos: nomes, descrições, atributos, preços e estoque. Adobe Commerce O MCP da loja (Model Context Protocol) conecta dados de catálogo em tempo real às experiências do Adobe AI. A partir daí, o Catalog Agent pode identificar lacunas em nomes de produtos e descrições longas, propor melhorias e gravar alterações aprovadas no Commerce para que você possa analisá-las no Commerce Admin.
Com o enriquecimento do catálogo, você pode:
- Identifique lacunas e inconsistências nos nomes de produtos e descrições longas que afetam como os LLMs interpretam seus produtos.
- Revise as melhorias sugeridas com o contexto de suporte, incluindo justificações e comparações antes e depois.
- Aplique atualizações aprovadas diretamente ao catálogo do Commerce para que o Administrador, a loja e outros canais que leem esses campos permaneçam alinhados.
Como os nomes dos produtos e as descrições longas ficam no Commerce, a melhoria da cópia uma vez pode beneficiar cada canal que consome esses dados do produto. O benefício depende de como e quando seus sistemas são atualizados.
Quem é este who-this-is-for
- Profissionais de marketing digital e comerciantes que desejam que os dados do produto sejam precisos e consistentes em respostas orientadas por LLM.
- Profissionais de marketing digital e comerciantes que precisam de uma maneira controlada para melhorar a cópia do catálogo em escala.
- Administradores do Commerce que são proprietários de integridade de catálogo, processos administrativos e integrações (API, CSV, PIM) que alimentam atributos de produto.
Pré-requisitos prerequisites
Os seguintes pré-requisitos se aplicam quando você tem acesso ao enriquecimento do catálogo.
- Sua loja pode ser rastreada por bots orientados a LLM e de agente, nos quais a cobertura do rastreo é necessária para sugestões com reconhecimento de catálogo.
- Os serviços Commerce necessários e a conectividade de catálogo estão ativados e íntegros. Consulte Habilitar enriquecimento do catálogo para saber mais.
- IMS configurado.
- Você tem acesso ao Adobe Admin Console.
- Sua organização assinou o GenAI Rider, ou recusou explicitamente, os serviços de IA subjacentes.
Ativar enriquecimento do catálogo enable-catalog-enrichment
Trabalhe com o administrador do Commerce ou parceiro de implementação para garantir o seguinte antes de revisar ou aplicar sugestões:
Instalar extensões de enriquecimento do catálogo e serviços de catálogo
-
Instale a extensão de enriquecimento do catálogo na instância do Commerce executando o seguinte comando:
code language-bash composer require magento/module-catalog-enrichment --no-update composer update magento/module-catalog-enrichment -
Se você ainda não tiver instalado os Serviços de catálogo, faça isso.
Catalog enrichment agora está disponível na sua instância do Commerce.
Acessar enriquecimento do catálogo
Após instalar as extensões de enriquecimento do catálogo e serviços de catálogo, o recurso de enriquecimento do catálogo estará disponível no Administrador em Catalog > Catalog Enrichment.
Configurar enriquecimento do catálogo
Configure o enriquecimento do catálogo na guia Settings para que o Commerce Catalog Agent possa se conectar ao seu ambiente Adobe Commerce e sugerir a superfície no Administrador do Commerce.
-
No Admin, vá para Catalog > Catalog Enrichment.
-
Na lista Scope na parte superior da página, selecione o modo de exibição de loja que deseja configurar ou deixe All Store Views para gerenciar as configurações entre os modos de exibição de loja.
-
Abra a guia Settings.
-
Em Commerce Configuration, expanda o painel de exibição de loja rotulado com sua URL.
Forneça os detalhes do ambiente Adobe Commerce para habilitar o Serviço de Catálogo do LLM Optimizer e os fluxos de trabalho de auditoria.
-
Insira os detalhes da conexão necessários para a exibição da loja.
- Store View URL: URL correspondente à exibição de armazenamento (por exemplo,
https://brand.example.com/fr/). - Environment ID: Identificador exclusivo do ambiente Adobe Commerce que a conexão acessa.
- Website Code, Store Code e Store View Code: Códigos de exibição de site, loja e loja do site da Commerce. Esses valores devem corresponder aos códigos no Administrador do Commerce.
- Host Name: Nome do host da sua instância Adobe Commerce.
- Store View URL: URL correspondente à exibição de armazenamento (por exemplo,
-
Clique em Save.
Depois de salvar, aguarde a conclusão de qualquer trabalho de sincronização ou validação inicial antes de depender dos resultados do catálogo ou da auditoria para essa exibição de armazenamento. Pode levar até 24 horas para que as sugestões de produtos sejam exibidas na página Catalog Enrichment.
Para remover uma configuração de exibição de repositório, expanda essa entrada e clique em Delete.
Descrições dos campos commerce-connection-fields
Os campos obrigatórios estão marcados com um asterisco (*) no formulário Commerce Configuration.
https://brand.example.com/fr/).Revisar e aplicar enriquecimento do catálogo review-and-apply
Após habilitar e configurar o enriquecimento do catálogo, as sugestões de produtos são exibidas na guia Agentic Opportunities. Aqui, você pode revisar sugestões e aplicar atualizações aprovadas a nomes de produtos e descrições longas no catálogo do Commerce.
O enriquecimento do catálogo usa as seguintes exibições de fluxo de trabalho:
- Current Suggestions: itens novos ou ativos para revisão.
- Fixed Suggestions: itens que você já aplicou ou resolveu.
- Ignored Suggestions: itens que você excluiu intencionalmente da ação.
Implantar sugestões aprovadas review-deploy-catalog
Para implantar sugestões aprovadas:
- Selecione Current Suggestions.
- Clique no controle de expansão da linha URL ou SKU para mostrar o nome do produto proposto e as atualizações da descrição do produto.
- Revise a sugestão e confirme se ela corresponde à sua estratégia de merchandising e SEO.
Você pode editar uma sugestão antes de implantá-la ou movê-la para Ignored Suggestions se ela não corresponder à sua estratégia.
- Selecione a linha do URL ou SKU a ser atualizado.
- Clique em Deploy optimizations e confirme.
Alterações de nome e descrição aprovadas são salvas no catálogo Adobe Commerce como outras atualizações de produto.
Depois de aplicar uma atualização, as sugestões serão movidas para Fixed Suggestions com o status Marcado como Fixo.
Verificar enriquecimento no Admin verify-in-admin
Para verificar o enriquecimento do catálogo aplicado:
-
Vá para Catalog > Products no Administrador do Commerce.
-
Use filtros e o seletor Store View conforme necessário (por exemplo, Default Store View).
-
Procure o SKU.
-
Abra o produto no modo de edição.
O formulário do produto mostra o nome e/ou a descrição do produto enriquecido.
-
Opcional: selecione Override Catalog Agent provided Product Name se quiser manter um nome inserido manualmente.
As substituições manuais afetam como as sugestões permanecem sincronizadas com o catálogo. Para obter mais informações, consulte Substituição manual no Admin.
-
Expanda a seção Content e localize o campo de descrição.
A descrição enriquecida é exibida quando você aplica as alterações de descrição.
-
Opcional: selecione Override Catalog Agent provided Description se quiser manter uma descrição inserida manualmente.
As substituições manuais afetam como as sugestões permanecem sincronizadas com o catálogo. Para obter mais informações, consulte Substituição manual no Admin.
Verificar enriquecimento na loja verify-storefront
Para verificar o enriquecimento na loja:
-
Procure o SKU na sua loja.
-
Abra a página do produto.
-
Confirme se o nome e a descrição do produto correspondem ao que você aprovou.
Pode levar algum tempo até que os enriquecimentos apareçam em sua loja.
-
Confirme se as regiões que mostram a descrição longa correspondem ao que você aprovou.
-
Opcional: Confirme os canais downstream que consomem os mesmos atributos de catálogo, quando relevante para a implantação.
Substituições, assimilação e sugestões desatualizadas overrides-ingestion
Depois que o enriquecimento do catálogo atualiza o nome ou a descrição de um produto, outros sistemas de assimilação podem alterar os mesmos campos. Os exemplos incluem chamadas de API REST, importações de CSV e feeds PIM.
Valor original assimilado novamente original-value-reingested
Se um processo externo gravar o nome ou a descrição original (o valor que existia antes do enriquecimento ser aplicado), a Commerce continuará a honrar o valor enriquecido para esse campo de acordo com as regras de enriquecimento do catálogo. A sugestão não pode ser revertida automaticamente com base apenas nessa assimilação.
Novo valor assimilado novamente new-value-reingested
Se o processo externo enviar um novo valor que não seja uma repetição do texto de pré-enriquecimento, o Commerce respeitará o novo valor de catálogo. Por exemplo, uma renomeação de “Sapatos vermelhos” para “Sapatos vermelhos icônicos” substitui o valor enriquecido. A sugestão de enriquecimento relacionada é normalmente marcada como Desatualizada porque o catálogo em tempo real não corresponde mais ao contexto de sugestão.
Substituição manual no administrador manual-override-in-the-admin
Se você editar manualmente o nome ou a descrição do produto no Adobe Commerce Administrador:
- O valor Admin vence como o sistema de registro para essa alteração manual.
- A sugestão de enriquecimento está marcada como Desatualizada.
- O fluxo de trabalho de sugestão volta ao estado original desse item para que você possa criar uma nova linha de base ou aceitar uma nova sugestão se a análise for executada novamente.
Essas regras ajudam você a saber se o enriquecimento do catálogo, os feeds de assimilação ou as edições de administrador são autoritativos quando vários canais tocam a mesma SKU.
Limites e considerações limits
- O enriquecimento aplica-se apenas a nomes de produtos e descrições longas. Isso não altera o layout PDP, widgets ou outro conteúdo de vitrine no nível da página.
- Catálogos grandes e contagens altas de URL podem afetar a rapidez com que a análise é concluída e quantas sugestões são exibidas de uma só vez.
- Sugestões significativas presumem que os bots relevantes para o LLM possam acessar os URLs de produto importantes para você. As regras de robôs, a autenticação, o bloqueio geográfico e a personalização pesada podem reduzir a cobertura.
Práticas recomendadas best-practices
- Documente a propriedade do sistema para o nome e a descrição do produto, de modo que as tarefas do PIM ou do feed não entrem em conflito involuntariamente com o enriquecimento do catálogo.
- Coordene com as equipes de SEO e marca antes de aplicar títulos ou descrições em massa.
- Sincronizar novamente ou analisar novamente após importações de catálogo principal para que as sugestões reflitam o estado atual do catálogo.
Exemplos
Os exemplos a seguir mostram como o enriquecimento do catálogo transforma atributos técnicos brutos em uma cópia de produto narrativa, focada no comprador, que os LLMs podem usar para responder a perguntas de compras.
Exemplo: produto de café com atributos técnicos
Um catálogo da coffee retailer armazena apenas as especificações técnicas de um produto de grãos de café torrado médio: variedade de grãos, região de origem, método de processamento, nível de torrefação e faixa de altitude. Esses campos descrevem o produto, mas não comunicam seu valor a um comprador. Portanto, um assistente de IA tem pouco a trabalhar ao responder uma pergunta como “que café tem um sabor suave e pouco ácido?”
O enriquecimento do catálogo lê os atributos técnicos e os motivos por meio de como eles interagem para inferir características relevantes para o consumidor:
O enriquecimento do catálogo aplica essas características inferidas à cópia do produto:
- Antes: “Medium Roast Coffee Beans - Arabica, Brasil Minas Gerais, Honey Process, 900-1200m”
- Depois: “Feijão arábica cultivado entre 900 e 1.200 metros em Minas Gerais, mel processado e meio torrado, desenvolvem uma sensação bucal naturalmente doce e cremosa, com caractere de avelã distinto, tons caramelo e baixa acidez. Um café especial consistente e acessível, melhor experiente através do derramamento.”
O nome e a descrição atualizados são salvos diretamente no catálogo do Commerce, de modo que a vitrine, os feeds LLM e outros canais que leem esses campos refletem a mesma cópia enriquecida.
Exemplo: configuração de mobília modular
Uma retailer de mobília vende um sofá de seção modular onde a descrição do produto lista apenas os códigos de configuração e o nome da malha, por exemplo, 6 Standard Seats + 6 Standard Sides in Sapphire Navy Corded Velvet. Essa abreviação é compreensível para um cliente recorrente, mas fornece ao assistente de IA pouco contexto sobre como o produto funciona ou o que o torna durável ou confortável.
O enriquecimento do catálogo expande os atributos de configuração e malha em uma descrição narrativa que explica o que cada componente faz e por que ele é importante para um comprador:
- Antes: “6 assentos padrão + 6 lados padrão em veludo com cabo da marinha de safira”
- Depois: “Esta configuração inclui 6 Conjuntos de Inserções de Assento Padrão e 6 Inserções Laterais Padrão que funcionam alternadamente como braços ou costas, formando os blocos de construção modulares do seu layout. Cada assento possui espuma padrão com três camadas de alta densidade projetadas para preservar a sustentação e resistir à abrasão. A cobertura de veludo com cabo da Marinha de Safira é tão durável quanto luxuosa, apresentando fios texturizados que criam um brilho sutil e uma sensação macia e macia. As capas são costuradas à mão para uma aparência precisa e personalizada e são laváveis e substituíveis por máquinas, para que sua seção possa evoluir com o seu espaço.”
Como a descrição enriquecida é gravada de volta no catálogo do Commerce, ela está disponível para bots de IA que rastream a página de detalhes do produto, bem como para qualquer canal ou feed downstream que consome os dados de catálogo do produto, sem alterar o layout ou o design que os compradores veem na página.