DocumentaçãoAEMGuia do usuário

Migração de código assistida por IA para o AEM as a Cloud Service cloud-migration-skill-overview

Última atualização: 28 de maio de 2026
  • Aplica-se a:
  • Experience Manager as a Cloud Service

Criado para:

  • Developer

A solução Migração da AEM Cloud é um conjunto de ferramentas baseado em agente que orienta os desenvolvedores por meio da migração do código Java local e das configurações OSGi ou do AEM 6.x para o AEM as a Cloud Service (AEMaaCS). Funciona dentro de qualquer IDE habilitado para IA que suporte habilidades de agente e o Protocolo de contexto de modelo (MCP).

O vídeo de demonstração a seguir fornece uma apresentação rápida e completa da solução de migração na nuvem do AEM e está incluído para referência.

https://video.tv.adobe.com/v/3491443?captions=por_br&learn=on

A solução consiste em dois componentes:

Componente
Função
Habilidade de Migração
Orquestra o fluxo de trabalho de migração, origina descobertas do Analisador de práticas recomendadas (BPA), identifica arquivos afetados em seu projeto e aplica transformações de código padrão por padrão. Funciona com uma exportação de CSV de BPA local ou com o MCP de migração na nuvem (recomendado).
MCP de migração na nuvem
Conecta seu agente IDE ao Cloud Acceleration Manager (CAM), permitindo que ele busque conclusões de BPA diretamente sem uma exportação de CSV. Recomendado em um CSV local para os resultados mais atualizados.

Pré-requisitos prerequisites

  • Um projeto do AEM (Maven ou Gradle) aberto em seu IDE

  • Uma das seguintes fontes de descoberta de BPA (altamente recomendado, não necessário para fluxos manuais):

    • Uma exportação de CSV de BPA da sua instância do AEM
    • Um projeto Cloud Acceleration Manager com um relatório BPA carregado e o MCP de migração na nuvem configurado

A habilidade de migração migration-skill

A habilidade de migração é uma habilidade do agente para IDEs habilitados para IA. Ele orquestra um fluxo de trabalho de um padrão por sessão: você nomeia o padrão a ser corrigido, aponta o agente para as suas descobertas de BPA e o agente lê as regras de transformação relevantes, localiza os arquivos afetados no seu projeto e aplica as alterações em lotes de cinco, pausando para sua revisão após cada lote.

Padrões suportados supported-patterns

Padrão
O que ele corrige
scheduler
Trabalhos baseados em sling.commons.scheduler incompatíveis com o tempo de execução sem estado do AEMaaCS
resourceChangeListener
ResourceChangeListener implementações que exigem atualizações do Cloud Service
replication
Chamadas de API Replicator herdadas substituídas por ContentDistribution equivalentes
eventListener
Implementações de OSGi EventListener atualizadas para semântica de evento do AEMaaCS
eventHandler
Serviços OSGi EventHandler síncronos adaptados para o Cloud Service
assetApi
AssetManager obsoleto e chamadas de API DAM substituídas por equivalentes com suporte
htlLint
data-sly-test avisos de comparação de constantes redundantes em modelos HTL
Configurações do OSGi
.cfg.json conversão, escopo de modo de execução e extração de segredos/env-var do Cloud Manager

A habilidade delega todas as etapas de transformação de código à habilidade best-practices complementar. Ambos são distribuídos juntos como o pacote de habilidades aem-cloud-service; instale o pacote uma vez para obter ambos.

Introdução getting-started-skill

  1. Instale o pacote de habilidades aem-cloud-service do repositório de Habilidades da Adobe.

  2. Abra o projeto AEM como a raiz do espaço de trabalho no IDE.

  3. Obter descobertas de BPA: exporte um CSV do BPA ou configure o MCP de migração na nuvem (veja abaixo).

  4. Inicie uma sessão com seu agente usando um destes prompts:

    CSV BPA:

    code language-none 
    Use the migration skill: scheduler only, BPA CSV at ./reports/bpa.csv

    CAM via MCP:

    code language-none 
    Fix replictaion findings from project <projectname>/<projectId>.

    Manual (sem BPA):

    code language-none 
    Migrate event listener in core/src/main/java/com/example/Listener.java

    Configurações OSGi:

    code language-none 
    Scan my config files and create Cloud Manager environment secrets or variables.

    Linha HTL:

    code language-none 
    Fix htlLint in ui.apps - scan for data-sly-test redundant constant warnings.
NOTE
A habilidade processa um padrão por sessão. Se seu relatório de BPA contiver vários padrões, o agente solicitará que você escolha um antes de iniciar.

Para obter uma referência de padrão completa e orientação de gerenciamento de sessão, consulte Usando a Habilidade de Migração da Nuvem.

O MCP de migração na nuvem cloud-migration-mcp

O MCP de Migração da AEM Cloud é um servidor Protocolo de Contexto de Modelo que conecta seu agente do IDE ao Cloud Acceleration Manager. Quando configurada, a habilidade de migração pode buscar descobertas de BPA diretamente do seu projeto de CAM sem precisar de um download de CSV.

O que o MCP oferece mcp-tools

Ferramenta
Descrição
fetch-cam-bpa-findings-by-pattern
Retorna descobertas de BPA para um padrão de migração de código específico do relatório de BPA mais recente em um projeto CAM.
fetch-cam-bpa-findings-by-importance
Retorna todas as descobertas de BPA em uma determinada severidade (CRITICAL, MAJOR, ADVISORY, INFO), classificada pela contagem. Útil para priorizar em quais padrões trabalhar primeiro.

Essas ferramentas são invocadas automaticamente pela habilidade de migração; você não as chama diretamente.

Introdução getting-started-mcp

  1. Na configuração MCP do IDE, adicione a URL do servidor MCP de migração na nuvem: https://mcp.adobeaemcloud.com/adobe/mcp/cloud-migration
  2. Quando solicitado, faça logon com sua Adobe ID para se autenticar no Cloud Acceleration Manager.
  3. A habilidade de migração agora pode buscar descobertas de BPA diretamente de seus projetos de CAM.

Para obter instalação e solução de problemas detalhadas, consulte Uso do MCP de Migração para Nuvem.

Como eles se encaixam na Jornada de migração migration-journey

A habilidade e o MCP complementam as outras ferramentas na Fase de implementação:

  • Analisador de práticas recomendadas: produz os resultados que impulsionam a habilidade. Consulte Uso do Analisador de Práticas Recomendadas.
  • Cloud Acceleration Manager: hospeda relatórios do BPA e rastreia o progresso geral da migração. Consulte Introdução ao CAM.
  • Ferramentas de Refatoração: lida com a estrutura do repositório e a modernização da configuração do Dispatcher. Consulte Visão Geral Das Ferramentas De Refatoração.
  • Ferramenta de transferência de conteúdo: migra o conteúdo do repositório do AEM 6.x para o AEMaaCS.

Consulte a Visão geral da Fase de Implementação para obter a imagem completa.

recommendation-more-help
experience-manager-cloud-service-help-main-toc