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. O MCP da Adobe Commerce Storefront (Model Context Protocol) conecta dados de catálogo em tempo real às experiências do Adobe AI. A partir daí, o Agente de Catálogo usa essa interface para que o Adobe LLM Optimizer possa identificar lacunas nos nomes de produtos e descrições longas, propor melhorias e gravar alterações aprovadas no Commerce para que você possa analisá-las no Administrador do Commerce.
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.
- O IMS está configurado).
- Você tem acesso ao Adobe Admin Console.
Se você não tiver uma organização IMS, entre em contato com a equipe de conta da Adobe para provisionar uma.
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 Adobe LLM Optimizer possa se conectar ao seu ambiente Adobe Commerce e fornecer sugestões de 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.
- Store View URL: URL correspondente à exibição de armazenamento (por exemplo,
-
Opcional: insira Host Name e API Key se o ambiente exigi-los.
- Host Name: Nome do host da sua instância do Adobe Commerce.
- Adobe Commerce Endpoint: Este campo não é usado.
- API Key: chave de autenticação usada para acessar com segurança as APIs do Adobe Commerce. Clique em Copy ao lado do campo se precisar copiar a chave em outro lugar.
-
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 LLM Optimizer 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 LLM Optimizer 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.