Visão geral do Agente de modernização de experiência experience-modernization-agent
O Agente de Modernização de Experiência é o agente de desenvolvimento de IA da Adobe para Edge Delivery Services e faz parte da Brand Experience Agent. Ele oferece um ambiente de desenvolvimento pronto para uso em seu navegador, sem nada para instalar.
Você pode começar migrando o conteúdo e o design de um site e, em seguida, continuar trabalhando com o agente para integrar sistemas de terceiros, reprojetar o site, refatorar seus blocos ou estender seu funcionamento. Os desenvolvedores podem criar integrações e comportamentos complexos, enquanto os designers e profissionais de marketing refinam a aparência do site solicitando, em vez de escrever CSS ou JavaScript. O conhecimento necessário depende do trabalho.
Para ver um primeiro resultado em suas próprias páginas, tente o modo Automático. É a melhor maneira de avaliar o Adobe Experience Manager com o conteúdo e o design de seu próprio site. Forneça o URL do site; ele migra um conjunto de páginas e envia um email para você quando termina.
Mover seu site para o Edge Delivery Services benefits
Use o agente para mover propriedades da Web para o Edge Delivery Services de outros CMSs, de sites da Experience Manager criados com componentes Java ou de sites estáticos.
O diagrama acima rastreia a migração do site de origem para um site em que sua equipe pode continuar evoluindo no Edge Delivery Services. O painel esquerdo mostra o design, o conteúdo e os recursos dinâmicos do site de origem à medida que os visitantes os veem, além de suas tags e análises. Por padrão, o agente usa as páginas renderizadas do site atual como origem da migração, a menos que você instrua o agente a executar um novo design, possivelmente fornecendo arquivos de design como designs de arquivo.
O painel direito mostra o resultado pretendido: o site completo foi transferido, com seus recursos dinâmicos recriados e suas configurações de análise, gerenciador de tags e consentimento de volta ao lugar. O objetivo da migração é ajudar sua equipe a usar completamente o que a Edge Delivery Services oferece:
- Desenvolvimento rápido: uma configuração de desenvolvimento da Web padrão e simples, familiar aos desenvolvedores e seus agentes, tornando-os mais eficientes.
- Criação visual de agente: Os autores reúnem páginas de blocos com marca na Experience Workspace ou no Universal Editor e também podem solicitar alterações de conteúdo.
- Páginas rápidas e rastreáveis: a plataforma fornece HTML rápido e semântico para ajudar a melhorar a visibilidade da pesquisa e da IA. Consulte Mantendo-O Como 100.
- Espaço para expansão: a plataforma executa alguns dos maiores sites multimercado e multilíngues, com integrações complexas.
Para atingir esse objetivo, o agente automatiza muitas das seguintes etapas:
- Ler cada página. A importação de página funciona do que o navegador renderiza. Se uma origem exigir entrada, configure a Autenticação de Site Protegida. Para proteção de bot, organize o acesso autorizado com o administrador do site: eles podem incluir na lista de permissões os endereços de backend do agente ou você pode usar um host de origem ou de preparação acessível com o mesmo conteúdo. Se apenas a descoberta de página estiver bloqueada, forneça os URLs diretamente. Consulte Sites da Source com proteção de bot.
- Analisar a estrutura. O catálogo de sites faz o inventário de páginas e as agrupa em modelos, seções e blocos, com capturas de tela. Revise os agrupamentos, defina o escopo, escolha o design de direcionamento e o modelo de conteúdo e decida o que migrar primeiro.
- Importar o conteúdo. Para cada modelo, o agente analisa uma página de exemplo e a mapeia para conteúdo padrão e blocos reutilizáveis. Ela importa a amostra como uma página editável e gera scripts de importação que aplicam o mapeamento a outras páginas nesse modelo.
- Recompilar o design. O agente extrai tokens de design CSS para cores, fontes e espaçamento e, em seguida, grava os estilos globais e bloqueia o CSS que os usa. Ele reconstrói a marcação em vez de clonar o código-fonte e seu débito técnico.
- Comparar, refinar e validar. O agente compara a página recriada com sua origem e itera em seus prompts. Refine o mapeamento e o design e valide cada amostra antes de dimensionar com os scripts gerados. As correções em um bloco reutilizável ou script de importação se aplicam às páginas nesse modelo. O guia de migração de produção abrange lotes, verificações, liberação e entrega.
- Expandir, reprojetar, otimizar e integrar. Após a migração, solicite que o agente reconstrua os recursos dinâmicos ou adicione integrações. O modo automático pode transferir análises, gerenciador de tags e configurações de consentimento compatíveis; consulte O que a Importação de Página Pode Ler e Transferir. Para obter algumas páginas para mostrar as partes interessadas, siga Criar uma demonstração ao cliente. Se você quiser que os engenheiros da Adobe operem o agente com sua equipe, consulte Delivery por engenheiros de resultados da agência.
O que a importação de página pode ler e transferir limitations
Use somente sites e designs que você está autorizado a migrar. O workflow selecionado deve ser capaz de alcançar e ler a origem. Se o site usar proteção de bot, organize o acesso com seu administrador. Consulte sites de origem com proteção de bot.
- O agente lê cada origem na Internet em seu ambiente hospedado. As páginas que exigem entrada ou um cabeçalho secreto podem ser migradas quando a fonte aceita um dos métodos na Autenticação de Site Protegida. Essa seção também informa o que solicitar ao administrador do site quando uma origem não puder ser acessada dessa maneira.
- O agente carrega cada página de origem em um navegador e a lê depois de renderizada. Isso inclui conteúdo que os scripts inserem e conteúdo que a página contém, mas que o CSS oculta, como um painel sanfonado fechado. O conteúdo que aparece somente depois que um visitante clica ou digita não está na página nesse momento, portanto, não é capturado. Verifique essas páginas nas capturas de tela e adicione o conteúdo ausente após a importação ou peça uma maneira de capturá-lo.
- O agente é direcionado ao Edge Delivery Services, incluindo sites que usam a criação do Experience Manager. Ele não converte um projeto em uma publicação baseada em HTL ou em uma pilha de entrega somente API/SPA.
- A importação de página copia o que a página de origem mostra: o conteúdo e o design. Ele não pode ver como os servidores de origem produziram essa página. Herança de conteúdo, reutilização por meio de fragmentos de conteúdo, regras de personalização, pesquisa, processamento de formulários e outras lógicas de negócios são executadas lá, portanto, a importação copia a saída nessa página, não na lógica. O agente também recria a marcação em vez de copiá-la, de modo que os scripts da origem, como tags de análise e experimentação, não aparecem. A opção Incluir integrações do modo automático transfere as configurações de análise, gerenciador de tags e consentimento com suporte. Decida como cada um dos outros funcionará no novo site; o agente poderá então criar os blocos e o código para ele. Consulte O que resta do Trabalho do Projeto e, para formulários, Envios de Formulário.
- A crítica visual do agente compara a aparência do resultado com a fonte. Ter a mesma aparência não mostra que os autores podem editar a página, que as interações funcionam ou que ela é acessível e rápida em dispositivos reais. Portanto, verifique-as antes de desconectar.
Como o site é criado e atualizado project-foundations
O resultado é um projeto padrão de sua propriedade: HTML, CSS e JavaScript no repositório Git, seguindo as convenções da matriz do AEM e da Coleção de blocos, com conteúdo armazenado separadamente para edição pelos autores. Os desenvolvedores podem continuar no console, em seu próprio editor ou com outras ferramentas de IA.
O site de origem fornece o conteúdo e o design. Você pode adicionar um design do Figma como um novo destino para todo o site ou parte dele. O agente lê essas fontes sem alterá-las e cria o resultado no espaço de trabalho do console.
O Git armazena os estilos, scripts e blocos do site. Sua filial retém o código a ser revisado; main retém o código de produção. O ambiente de criação armazena o conteúdo. O Edge Delivery Services combina esse conteúdo com o código da ramificação mostrada por cada pré-visualização ou URL ativo.
As páginas são feitas de seções, conteúdo padrão e blocos, e o conteúdo não tem estilo, então o agente pode dar a ele um novo design alterando apenas o código. Para saber como a plataforma funciona, consulte a visão geral do Edge Delivery Services e o Marcação, Seções, Blocos e Bloqueio Automático. Para saber como o agente estrutura o conteúdo importado e como você o orienta, consulte Formatar a Estrutura do Conteúdo.
Novos sites que começam com o modelo do AEM. Para uma loja de comércio, comece com o modelo de comércio, pois seus blocos de comércio são difíceis de adicionar a um projeto posteriormente; consulte Iniciar com um Repositório.
Trabalhe com segurança em uma Workspace independente independent-workspace
O agente não altera o repositório Git ou o destino de conteúdo diretamente. Funciona em um espaço de trabalho de console: sua própria cópia de trabalho do projeto, hospedada pelo Adobe e não compartilhada com outros usuários. O espaço de trabalho mantém o check-out de uma ramificação do repositório Git e cópias das páginas de conteúdo importadas, abertas ou extraídas.
Tudo o que o agente faz acontece lá primeiro. Você pode solicitar uma reformulação abrangente, verificá-la na pré-visualização do console e descartar o que não quiser, enquanto o repositório, as páginas dos autores e o site ativo permanecem inalterados. O trabalho deixa o espaço de trabalho somente quando você o envia, em duas operações separadas:
- O código de push envia os arquivos alterados selecionados para o repositório Git, como uma confirmação na ramificação atual ou como uma nova solicitação de pull.
- Carregar conteúdo envia as páginas selecionadas para a Experience Workspace ou a instância do autor, onde elas substituem as versões salvas dessas páginas.
Permissões de agente permitem que o agente faça o mesmo para você. Consulte Controle de Alterações.
A independência funciona em ambas as direções: as alterações que outras pessoas enviam por push ou por upload não chegam ao seu espaço de trabalho até que você as envie. Consulte Menu de sincronização e Trabalhar como uma equipe.
Onde o conteúdo é armazenado e como os autores o editam content-storage
O agente pergunta onde o conteúdo migrado deve ser armazenado. Qual repositório contém o conteúdo e quais autores do editor usam são perguntas relacionadas, mas separadas. O CMS de origem não decide o destino. Com qualquer uma das opções, os autores obtêm um editor visual e o Edge Delivery Services fornece as páginas.
Armazenamento baseado em documentos com a Experience Workspace document-based
O conteúdo é armazenado como documentos no repositório de conteúdo baseado em documentos. “Baseado em documento” descreve somente o armazenamento, não a experiência de criação. Os autores editam páginas visualmente no Experience Workspace, a interface de criação visual do Edge Delivery Services, que também oferece um assistente de IA, colaboração e integração com o Experience Manager Assets. A Experience Workspace está desativada por padrão e é ativada por site ou organização na configuração do projeto. Quando você transfere um site no modo Automático para um destino baseado em documentos com o Faça seu, a transferência o ativa para esse site.
Criação no Experience Manager com o editor universal jcr-persistence
O conteúdo é armazenado no Java Content Repository (JCR) de uma instância de autor do Experience Manager as a Cloud Service, uma configuração chamada anteriormente de Crosswalk. Os autores editam páginas com o Editor universal, o editor visual do Adobe para conteúdo na instância do autor e o Edge Delivery Services ainda fornece as páginas. HTL e Java não os renderizam, como fazem em sites Experience Manager criados com componentes. Repositórios de modelos para esta configuração, como aem-block-collection-xwalk, ainda contêm xwalk em seus nomes.
Estes documentos usam a criação do Experience Manager para esta opção de armazenamento e a instância do autor para o ambiente do Experience Manager as a Cloud Service em que esse conteúdo é armazenado e editado.
Recomendação da Adobe recommendation
Para qualquer nova implementação, a Adobe recomenda o armazenamento baseado em documentos com a Experience Workspace em vez da criação no Experience Manager com o Universal Editor. Isso inclui sites grandes com milhares de páginas.
Criação baseada em documentos usada para significar escrever páginas no Microsoft Word ou Google Docs, armazenadas no SharePoint ou no Google Drive, que permanecem como fontes de conteúdo compatíveis, ou na Criação de documentos, um editor de estilo de documento. Nenhuma delas oferecia edição visual de página, portanto, as equipes que precisavam dela geralmente escolhem a criação do Experience Manager. A Experience Workspace substitui a Criação de documentos e fornece conteúdo baseado em documentos como um editor visual. Um site que usa Criação de documentos pode ativar o Experience Workspace e seu conteúdo existente funciona lá sem uma migração. Isso deixa pouco motivo para uma marca evitar o armazenamento baseado em documentos. Ao ler um artigo sobre criação baseada em documento, verifique quando ele foi escrito.
A criação do Experience Manager permanece totalmente compatível. Escolha-a quando um requisito específico depender de o conteúdo permanecer no JCR. Para conteúdo headless, entregue por meio de APIs em vez de páginas da Web, o Editor universal permanece como o editor recomendado.
Como as alterações são ativadas code-content-lifecycle
No diagrama, as colunas azuis mostram ramificações de código e as linhas roxas mostram estados de conteúdo. O código de push nunca salva o conteúdo, e o upload do conteúdo nunca altera o código.
- Código: o Edge Delivery Services busca seu código do GitHub por meio do aplicativo Sincronização de Código do AEM, ou de outro host Git por meio do Cloud Manager (Traga seu próprio Git). Cada ramificação recebe seus próprios URLs, e uma alteração enviada para uma ramificação é exibida na pré-visualização dessa ramificação e URLs ativos ao mesmo tempo. O código não tem uma etapa de publicação separada: após a revisão, a mesclagem no
mainatualiza o código do site de produção imediatamente, portanto, verifique uma ramificação em suas próprias URLs antes de mesclá-las. - Conteúdo: Os autores visualizam primeiro uma página, copiando o conteúdo salvo para o site de visualização em
*.aem.page. Em seguida, eles o publicam, o que o torna ativo em*.aem.live. Os autores fazem ambos na interface do usuário de criação ou na extensão de navegador AEM Sidekick.
As URLs de visualização seguem o padrão https://{branch}--{repo}--{owner}.aem.page e mostram o conteúdo visualizado. As URLs ativas seguem o mesmo padrão em aem.live e mostram conteúdo publicado. {owner} é a organização ou usuário do GitHub que possui o repositório, e {repo} é o nome do repositório. O conteúdo não é ramificado: cada ramificação mostra as mesmas páginas, cada uma com seu próprio código. A URL ativa de main é o site de produção, ao qual o seu próprio domínio serve após a transferência.
Continuar desenvolvendo o site creation-migration
A migração não é o fim do trabalho do agente. Sua equipe pode aplicar um novo design de marca do Figma, criar novas páginas a partir de blocos existentes ou rastrear um erro. Ele também pode auditar o desempenho, a acessibilidade e o SEO, e corrigir o que a auditoria encontra. Consulte Redefinir Estilo de Sites, Reformulação Guiada e Criar, Atualizar e Refatorar Blocos. Se o site já estiver em execução no Edge Delivery Services, conecte-o e comece aqui sem migrar.
Os blocos podem chamar APIs para pesquisa, comércio, personalização, mapas, vídeo ou seus próprios serviços, como em qualquer outro site. As planilhas são publicadas como JSON e um índice de consulta lista as páginas do site, portanto, os blocos também podem criar listas e filtros do seu próprio conteúdo. A lógica de negócios permanece nos serviços que a possuem. Especifique e teste cada integração, e o agente poderá gravar seu código de bloco depois que você decidir como ela deve funcionar. Consulte Criar um Bloco Dinâmico e Conectar Serviços e Aplicativos.
Os fluxos de trabalho internos do agente se concentram no Edge Delivery Services, mas o trabalho não está limitado a eles. Aponte para a documentação de outro sistema e trabalhe a integração com ele, conforme descrito em Trabalhar além da Edge Delivery Services. A referência de recurso agrupa os fluxos de trabalho internos e os complementos opcionais em um único local; você descreve a tarefa e o agente escolhe o fluxo de trabalho.
As convenções que você mantém em AGENTS.md e arquivos relacionados permanecem com o repositório, portanto, conversas posteriores começam com o que sua equipe concordou. Consulte Instruções e memória do projeto. Para preparar a documentação para autores, desenvolvedores e administradores, use Gerar Documentação do Projeto.
Quem pode usar o agente who-can-use-ema
Você trabalha com o agente em linguagem simples: descreva o que deseja e verifique o resultado na pré-visualização. O modo automático não precisa de solicitações passo a passo. Para explorar o console em um projeto de exemplo, use o modo de demonstração.
Trabalhar no site em si requer um pouco mais. As alterações do agente são código em um repositório Git: você as verifica na visualização, as envia para uma ramificação e abre uma solicitação de pull que um desenvolvedor analisa. Alguns conhecimentos sobre o HTML e a vontade de aprender essas noções básicas do Git e do GitHub são suficientes para participar. O agente é uma ferramenta para pessoas com conhecimento em tecnologia em qualquer função, tanto em marketing e design quanto em desenvolvimento.
Um designer ou profissional de marketing que conhece a marca pode refinar o layout, a tipografia e o espaçamento de um bloco diretamente, em vez de descrever a alteração para um desenvolvedor e aguardá-la. Eles podem decidir quais blocos os autores obterão e como cada um será exibido, além de verificar o resultado em todos os tamanhos de tela. Consulte Fazer Alterações Visuais. Os especialistas em conteúdo verificam se a estrutura de conteúdo é fácil de ser editada pelos autores; consulte Formatar a Estrutura de Conteúdo. Os desenvolvedores criam comportamentos complexos e integrações, depuram e revisam alterações antes da produção. Os clientes potenciais técnicos definem o escopo da migração, escolhem o destino do conteúdo e decidem quando o site estará pronto para ser lançado.
O agente não limita solicitações por função. Suas permissões no Git e no destino do conteúdo decidem o que você pode alterar fora do seu espaço de trabalho.
Contribuição Mais Ampla, Mesmo Controle De Produção production-control
O Agente de modernização de experiência amplia quem pode contribuir para um site, não quem aprova o que entra em funcionamento. Os desenvolvedores permanecem no controle de cada linha de código que atinge a produção.
Esse controle fica no provedor do Git, não no console, portanto, é retido mesmo que uma alteração seja feita. Proteja main com proteção de ramificação que requer uma solicitação de pull aprovada por um desenvolvedor e não permita que outros colaboradores a ignorem. Os colaboradores enviam seu trabalho com Criar nova PR e um desenvolvedor verifica o resultado nas URLs de visualização que a solicitação de pull lista antes de mesclá-la. Se um colaborador ativar Permitir que o LLM use minhas credenciais do Git, o agente enviará por push com o acesso desse colaborador; portanto, a mesma proteção se aplica a ele. A publicação de conteúdo é controlada separadamente, pela função de publicação do site. Para a configuração, consulte Controle de Alterações.
Segurança e manuseio de dados security
O agente funciona sem receber as credenciais configuradas, cada usuário trabalha em um ambiente separado e você decide quando as alterações chegam ao repositório Git e ao destino de conteúdo. Para acesso e isolamento, credenciais, o que o modelo de IA processa, o controle sobre cada etapa e onde o trabalho é armazenado, consulte Segurança e Manipulação de Dados.
Para a arquitetura, a segurança e a revisão do processo de sua organização, use o Avaliar e Aprovar o Agente de Modernização de Experiência. Este guia também apresenta a equipe por trás do agente. As solicitações de suporte do console chegam às pessoas que as criaram e acompanham você.
Próximas etapas next-steps
Para obter respostas curtas a perguntas comuns, como acesso, modo automático, transferências, sites de origem protegidos e recuperação, consulte as Perguntas frequentes sobre o Agente de Modernização de Experiência. Quando algo não funcionar conforme o esperado, consulte Solução de problemas ou Solicitar suporte.
Para saber o que foi alterado nas versões recentes do console, consulte as notas de versão do Agente de modernização de experiência.