IA no Magento e Adobe Commerce: Adobe Sensei, Live Search e Product Recommendations na Prática

Adobe Sensei: o motor de IA por trás do Commerce, e por que ele NÃO é GenAI

Adobe Sensei não é um produto que você compra nem um botão que você liga. É o framework de IA/ML da Adobe, embutido em todo o Experience Cloud — Commerce, Analytics, AEM, Target. Pense nele como uma camada de modelos treinados que os produtos Adobe consomem por baixo do pano. Quando o Live Search re-ranqueia resultados por comportamento do comprador, ou quando o Product Recommendations decide que quem viu o produto A costuma comprar o B, é o Sensei rodando. Você não interage com o Sensei diretamente; você interage com os serviços que ele alimenta.

A distinção que mais gera ruído hoje é Sensei clássico vs Sensei GenAI. O Sensei tradicional é majoritariamente ML clássico e deep learning preditivo: ranking, recomendação, personalização, classificação. Ele prevê e ordena — não gera texto nem imagem. Já o Sensei GenAI, anunciado pela Adobe em 21 de março de 2023, adiciona modelos de linguagem grandes (LLMs) para geração de conteúdo. São coisas diferentes, com riscos e maturidades diferentes, e misturá-las é o erro número um de quem vende "IA no Magento" sem saber do que fala.

O que o anúncio de GenAI cobriu (com cautela)

Sou rigoroso com isso porque a documentação muda rápido. O anúncio de 2023 da Adobe descreveu serviços de GenAI para geração de copy de marketing, Dynamic Chat, criação de audiências e jornadas, e geração de variações de imagem de produto via Adobe Firefly — por exemplo, gerar variações de cor/textura a partir de uma foto de produto para e-commerce. Os LLMs citados incluem ChatGPT via Microsoft Azure OpenAI Service e o FLAN-T5, ancorados na Adobe Experience Platform. A aplicação direta dentro do Commerce para enriquecer catálogo (gerar descrições de produto, por exemplo) é direção estratégica — eu trato como roadmap e confirmo feature por feature na documentação oficial antes de prometer a cliente.

A Adobe anunciou os serviços Sensei GenAI em 21 de março de 2023, posicionando a geração de conteúdo por LLMs ancorada na Adobe Experience Platform e no Firefly como evolução do framework Sensei, que até então era predominantemente preditivo.

Fonte: Adobe Newsroom (21/03/2023)

Resumo prático: hoje, quando você "liga a IA do Adobe Commerce", o que entra em produção de forma sólida é o Sensei clássico via Live Search e Product Recommendations. GenAI é uma fronteira que vale acompanhar, mas eu não construo proposta comercial em cima do que ainda é roadmap. Para a discussão de IA no fluxo de desenvolvimento (que é outra história), veja IA no desenvolvimento Magento.

Live Search: busca com IA que substitui o OpenSearch nativo

Live Search é a busca com IA da Adobe — e a primeira coisa que você precisa internalizar é que ele é exclusivo do Adobe Commerce (cloud e on-premises). Não existe Live Search no Magento Open Source. Ponto. Se você está em Open Source, sua busca continua sendo OpenSearch/Elasticsearch, e nenhum truque de instalação vai mudar isso. Os requisitos são Adobe Commerce 2.4.4+ e PHP 8.1, 8.2, 8.3 ou 8.4.

A documentação da Adobe é explícita sobre o papel dele:

Live Search is a feature that replaces the standard search capabilities in Adobe Commerce.

Fonte: Adobe Experience League — What is Live Search?

O que o Live Search entrega (funcionalidades confirmadas)

Não é só "uma busca melhor". É um conjunto de recursos de merchandising e relevância que o OpenSearch cru não tem:

• Busca enquanto digita (popover): sugestões com thumbnails de produto em tempo real, via o módulo module-live-search-storefront-popover.
• Fuzzy search: tolerância a erro de digitação com distância de Levenshtein máxima de 1.
• Faceting dinâmico: facetas que se reordenam com re-ranking por comportamento do comprador — Sensei em ação.
• Sinônimos: expansão de queries; multi-word synonyms foram adicionados em 20/02/2025.
• Regras de merchandising (if-then): boost, bury, pin e hide para empurrar ou esconder produtos por regra.
• Price facet com slider: intervalos configuráveis no Admin em Settings.
• Intelligent Ranking Boost: adicionado como atualização do serviço hospedado em 22/05/2026 (disponível em todas as versões suportadas).
• Semantic Search: busca por significado e contexto usando IA, adicionada como atualização do serviço hospedado em 08/06/2026 — disponível por toggle nas configurações, sem necessidade de atualização de versão.

Quando trocar a busca nativa por Live Search

Na minha prática, a troca compensa quando o catálogo passa de alguns milhares de SKUs e a busca interna vira canal de conversão relevante — aí o re-ranking por comportamento e as regras de merchandising pagam o esforço de migração. Em loja pequena com busca pouco usada, o OpenSearch nativo bem configurado resolve. E, claro: só faz sentido se você já tem (ou vai ter) licença Adobe Commerce. A boa notícia é que, tendo a licença, o Live Search é um serviço SaaS leve, incluído sem custo adicional — você não paga a mais por ele. Importante para SEO: a busca interna não deve ser indexável; isso eu trato no guia de SEO técnico do Magento 2.

Instalando o Live Search: pacote Composer, módulos e a regra do OpenSearch

O pacote Composer é magento/live-search, e a instalação é uma linha — mas há uma regra de coexistência que derruba quem não a conhece. Vamos ao comando e aos módulos que ele traz:

composer require magento/live-search --with-dependencies
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

Esse pacote instala um conjunto de módulos, mais as dependências SaaS que fazem a ponte com a nuvem:

A regra que derruba migração: OpenSearch e Live Search não coexistem

Esta é a pegadinha mais comum. Você não pode ter os dois ligados ao mesmo tempo:

OpenSearch and Live Search cannot both be enabled on the same Commerce instance.

Fonte: Adobe Experience League — Get Started with Live Search

O detalhe que salva a operação: durante a migração, o Elasticsearch/OpenSearch continua processando as buscas do storefront até você concluir a configuração do Live Search. Ou seja, a loja não fica sem busca no meio do caminho — a troca é coordenada, e só ao final o Live Search assume. Eu sempre faço isso em janela controlada e validando o storefront antes de declarar concluído.

O índice inicial pode demorar — e isso é normal

Depois de instalar, conectar (próxima seção) e disparar a sincronização, o índice inicial pode levar até 60 minutos para ser construído; catálogos grandes levam mais. Já vi gente abrir chamado de "Live Search não funciona" 5 minutos depois de ligar. Não é bug, é o data export populando a nuvem. Paciência e monitoramento do feed resolvem. A API GraphQL do Live Search (para storefronts headless/PWA) está documentada em developer.adobe.com — é por ela que um front desacoplado consome os resultados.

Product Recommendations: 13 tipos de recomendação por Adobe Sensei

O segundo grande serviço de IA é o Product Recommendations — também exclusivo do Adobe Commerce, também SaaS, também alimentado pelo Sensei. Ele entrega recomendações treinadas pelo comportamento real dos seus visitantes: o que foi visto, o que foi comprado junto, o que está em alta. O pacote principal é magento/product-recommendations:

composer require magento/product-recommendations
bin/magento setup:upgrade
bin/magento cache:flush

Há dois módulos opcionais que valem conhecer: magento/module-page-builder-product-recommendations (para posicionar recomendações dentro do Page Builder, arrastando e soltando) e magento/module-visual-product-recommendations (similaridade visual — recomenda produtos parecidos pela aparência). A versão mais recente é a 6.7.0, lançada em 17/03/2026, com suporte a PHP 8.5.

Os 13 tipos de recomendação

Esses são os tipos confirmados na documentação do Adobe Commerce. A graça é combinar o tipo certo com a posição certa da página:

Como funcionam: coleta de eventos no storefront

O segredo da qualidade dessas recomendações é a coleta de eventos comportamentais (storefront events): visualizações de produto, adições ao carrinho, compras. Esses eventos vão para a nuvem da Adobe, o Sensei treina os modelos e devolve as recomendações. Sem dados de comportamento acumulados, as recomendações começam pobres e melhoram com o tempo — é normal a unidade "Trending" ou "Bought this, bought that" só ficar boa depois de semanas de tráfego real. Você cria cada unidade no Admin, escolhe o tipo, e posiciona via widget ou Page Builder na home, PDP, categoria ou carrinho. A coleta de eventos tem implicações de LGPD que trato na seção final — e que você não pode ignorar no Brasil.

Configurando Product Recommendations: API keys obrigatórias e firewall

A partir das versões 4.x.x, a configuração ficou mais rígida — e é exatamente aqui que a maioria trava. A documentação é direta:

In versions 4.x.x and higher, you must provide public and private API keys for both the sandbox and production environments.

Fonte: Adobe Experience League — Install and Configure Product Recommendations

Traduzindo para a prática: você precisa de quatro chaves — pública e privada de sandbox, pública e privada de produção. Esquecer o par de sandbox é o motivo mais comum de "configurei tudo e não recomenda nada". As chaves vêm do Commerce Services Connector, que detalho na próxima seção.

O firewall que ninguém lembra

Tem um item de infraestrutura que trava o serviço inteiro e some no meio dos chamados: o firewall allowlist. Tanto Live Search quanto Product Recommendations precisam falar com a nuvem da Adobe, e o domínio precisa estar liberado:

# adicionar à allowlist do firewall (saída):
commerce.adobe.io

Sem commerce.adobe.io liberado na saída, o data export não envia, as recomendações não chegam e o Live Search não indexa. Em ambientes corporativos com firewall restritivo, esse é o primeiro lugar que eu checo quando o feed "não anda". É um teste de 30 segundos com curl a partir do servidor que economiza horas de debug no lugar errado.

Privacidade já na configuração

Vale antecipar: a partir da versão 6.3.0, o Product Recommendations respeita integralmente o modo de restrição de cookies do Magento. Quando as restrições estão habilitadas, ele não coleta nem armazena dados em cookies/localStorage. Isso não é detalhe jurídico abstrato — é configuração que você liga, e que trato em profundidade na seção de LGPD. Mantenha o módulo atualizado: versões antigas têm comportamento de coleta menos granular.

Commerce Services Connector: a cola que conecta sua loja à nuvem da Adobe

Aqui está o coração da operação. Live Search e Product Recommendations são SaaS — eles rodam na nuvem da Adobe, não na sua instância. O que conecta os dois mundos é o Commerce Services Connector. O caminho no Admin é:

Stores > Configuration > Services > Commerce Services Connector

É nessa tela que você cola as API keys e escolhe o environment (production ou sandbox) e o data space. As chaves não nascem no Admin — elas são geradas pelo titular da licença Commerce:

The production and sandbox API keys are generated from the Commerce account of the license owner

Fonte: Adobe Experience League — Commerce Services Connector

Onde gerar as chaves e a regra da chave privada

As chaves saem de account.magento.com, na aba Magento > API Portal. Você gera o par público + privado para produção e para sandbox. Um detalhe operacional crítico: a chave privada é baixável uma única vez. Perdeu, gerou de novo. Eu guardo as chaves no cofre de segredos do cliente no mesmo instante em que gero — nunca confio que vou "pegar depois".

Serviços que dependem do Connector

O Commerce Services Connector habilita um conjunto de serviços — e a tabela abaixo é a resposta honesta sobre o que é exclusivo do Adobe Commerce e o que o Open Source também alcança:

Repare: dos serviços do Connector, só o Payment Services alcança o Open Source. Toda a IA de busca e recomendação fica do lado do Adobe Commerce. Essa é a fronteira comercial real entre as edições — e o motivo de eu sempre alinhar expectativa antes de o cliente investir esperando IA no Open Source. O comparativo completo está em Adobe Commerce vs Magento Open Source.

SaaS Data Export: sincronizando catálogo e os comandos de resync

Conectado o Connector, falta a parte que move os dados: o SaaS Data Export. Ele é quem exporta seu catálogo (produtos, preços, categorias, atributos) e mantém a nuvem da Adobe em sincronia com a sua loja. Quando alguém diz "as recomendações estão mostrando produto que já saiu de linha" ou "o Live Search não acha o produto novo", 9 em 10 vezes é o data export desatualizado.

Os feeds e os comandos de resync

O comando central é bin/magento saas:resync, parametrizado por feed. Estes são os feeds disponíveis:

# resync completo de um feed
bin/magento saas:resync --feed products
bin/magento saas:resync --feed prices
bin/magento saas:resync --feed categories

# resync parcial por SKU (rápido, cirúrgico)
bin/magento saas:resync --feed products --by-ids='SKU1,SKU2'

Diagnóstico com log estendido

Quando o export apresenta comportamento inesperado ou você precisa inspecionar o payload gerado, use a variável de ambiente EXPORTER_EXTENDED_LOG=1 combinada com o modo --dry-run:

EXPORTER_EXTENDED_LOG=1 bin/magento saas:resync --feed products --dry-run

Isso processa o feed de produtos sem enviar os dados ao SaaS e salva o payload em var/log/saas-export.log — útil para identificar atributo com problema, plugin custom no caminho ou gargalo de dados. O fluxo mental que eu sigo em todo go-live de Live Search/Recommendations é: instalar pacote, conectar Connector com as 4 chaves, liberar commerce.adobe.io no firewall, rodar saas:resync dos feeds, e esperar o índice (até 60 min). Pular o resync e ficar olhando o storefront vazio é o erro clássico.

O comando saas:resync do pacote magento/saas-export permite gerenciar a sincronização de feeds por feed individual, com suporte a resync parcial por IDs (--by-ids), modo de simulação sem envio (--dry-run) e log estendido de payload via EXPORTER_EXTENDED_LOG=1.

Fonte: Adobe Experience League — Sync Feeds Using the Commerce CLI

Comparação honesta: o que é nativo e grátis vs o que exige Adobe Commerce

Chega a hora da verdade sem marketing. Eu faço esse quadro em toda proposta porque ele evita expectativa frustrada — e frustração de cliente custa caro. A pergunta real não é "Magento tem IA?", e sim "qual IA, em qual edição, e a que custo?".

Busca nativa (OpenSearch) vs Live Search com IA

No Open Source, o OpenSearch entrega busca por texto sólida: tokenização, stemming, relevância por TF/IDF, facetas estáticas. É bom — e, bem configurado, atende muita loja. O que ele não faz é aprender com o comportamento: as facetas não se reordenam pelo que os compradores realmente clicam, não há re-ranking por conversão, não há semantic search por significado, não há regras visuais de merchandising prontas no Admin. Tudo isso é o delta que o Live Search adiciona — e que justifica a licença Adobe Commerce em catálogos onde a busca é canal de receita.

A armadilha que eu desmonto sempre

Existe muito "módulo de IA para Magento" de terceiros no marketplace que promete recomendação e busca inteligente para Open Source. Alguns são bons. Mas é importante separar: esses são produtos de terceiros, não a IA nativa da Adobe (Sensei). Você está comprando a IA de outro fornecedor, com outra arquitetura, outro custo e outro encanamento. Não confunda "IA embutida do Adobe Commerce" com "extensão de IA instalada no Open Source" — são coisas diferentes na origem, no suporte e na integração. Se a decisão de edição ainda está aberta, e a IA pesa nela, leia o comparativo das edições antes de fechar.

Operação e LGPD: versões, conexão, hibernação e a coleta de eventos

Para fechar, o que eu chamo de "manutenção do dia seguinte" — os pontos que mantêm a IA funcionando e em conformidade depois que o entusiasmo do go-live passa. Começo pelos requisitos e pela checklist de conexão consolidada, e termino no ponto que mais ignoram no Brasil: LGPD.

Requisitos e checklist de conexão

• Versão e PHP: Adobe Commerce 2.4.4+ e PHP 8.1 a 8.4 para Live Search; Product Recommendations 6.7.0 chegou a suportar PHP 8.5.
• Pacotes: magento/live-search e magento/product-recommendations via Composer.
• Connector: 4 chaves (pública + privada de sandbox e de produção) em Stores > Configuration > Services.
• Firewall: commerce.adobe.io liberado na saída.
• Sync: saas:resync dos feeds e até 60 min para o índice inicial.
• Exclusão mútua: OpenSearch e Live Search nunca ligados juntos.

Hibernação de ambientes de teste

Um detalhe que assusta quem não sabe: catálogos em ambientes de teste inativos entram em hibernação após 90 dias consecutivos sem queries de busca. Se você montou um sandbox para demonstração e voltou três meses depois, pode encontrar o data space dormindo — é necessário abrir um ticket de suporte solicitando a reativação. Ambientes de produção não são afetados, então não há risco em loja no ar. Eu menciono isso porque já vi gente achar que "quebrou" quando era só hibernação esperada de sandbox.

LGPD: a coleta de eventos comportamentais é dado pessoal

Esse é o ponto não-negociável no Brasil. Product Recommendations e o data collection coletam eventos de comportamento do usuário — o que ele vê, adiciona ao carrinho, compra. Sob a LGPD, identificadores online (cookie IDs, IPs) associados a comportamento são tratados como dado pessoal. A boa notícia é que a Adobe construiu o produto com isso em mente:

• Modo de restrição de cookies: a partir da versão 6.3.0, o Product Recommendations respeita integralmente o cookie restriction mode do Magento — com restrições habilitadas, ele não coleta nem armazena em cookies/localStorage.
• Conformidade por configuração: manter o módulo na versão 6.3.0+ e integrá-lo ao banner de consentimento é a abordagem recomendada.
• Revisão periódica: confirme as políticas de dados na documentação oficial da Adobe à medida que o produto evolui.

A partir da versão 6.3.0, o Product Recommendations respeita integralmente o modo de restrição de cookies do Commerce, impedindo coleta e armazenamento em cookies/localStorage quando as restrições estão ativas.

Fonte: Adobe Experience League — Product Recommendations Release Notes

Minha recomendação prática: mantenha o módulo na 6.3.0+ (de preferência na mais recente), ative o cookie restriction mode integrado ao seu banner de consentimento, e documente no aviso de privacidade que a loja usa serviços da Adobe para recomendação e busca. Conformidade não é só configuração técnica — é processo. E ela conversa diretamente com o endurecimento geral da loja, que trato em Segurança e Hardening do Magento 2.