Habilidade do catálogo do site site-catalog-skill
Saiba como a habilidade do catálogo de sites do Agente de modernização de experiência realiza a análise automatizada de qualquer site para oferecer suporte ao planejamento de migração do Edge Delivery Services.
Visão geral overview
A habilidade de catálogo do site descobre cada página no site, identifica os modelos de página e bloqueia variantes em uso, captura capturas de tela de cada uma e apresenta os resultados na interface do usuário de planejamento de site do Console de Modernização da Experiência, onde você pode revisá-los e refiná-los.
A habilidade permite a migração de qualquer site para o Edge Delivery Services das seguintes maneiras:
- Iniciando um projeto de migração — Execute a habilidade antes que qualquer trabalho comece a entender a escala do site, incluindo contagem de páginas, modelos, variantes de blocos e localidades. Ele estabelece o inventário básico de que depende cada decisão de downstream.
- Estimativa de esforço e planejamento — obtenha métricas quantificadas para dar suporte a propostas, planejamento de sprint e recursos.
- Revisão e correção de catálogo — Valide os modelos e bloqueie o agente identificado na interface do usuário do planejamento de site e corrija-os antes de iniciar a migração.
- Preparação de importação em massa — Veja quais páginas compartilham o mesmo layout e planeje importações em massa modelo por modelo.
- Relatórios de partes interessadas — compartilhe os resultados com gerentes de projeto, arquitetos e partes interessadas comerciais.
Chamando invoking
No Console de Modernização da Experiência, peça ao agente para analisar o site.
scope site https://www.example.com
Isso também ativa a interface do usuário de planejamento de site para o seu projeto.
O fluxo de trabalho da habilidade tem quatro fases executadas em sequência:
- Análise — Cada página é carregada, capturada e dividida em blocos com base no seu conteúdo editável pelo autor.
- Catálogo de blocos — Blocos semelhantes entre páginas são agrupados em variantes de blocos, e cada variante é mapeada para um bloco da biblioteca de blocos e é nomeada.
- Modelo — Páginas que compartilham o mesmo layout de blocos são agrupadas em candidatos a modelo.
- Nomeação — Os candidatos a modelo são revisados, mesclados onde são estruturalmente os mesmos e recebem nomes significativos.
Quando a execução for concluída, examine os resultados na interface do usuário do planejamento de site.
Prompts adicionais additional-prompts
A maioria dos projetos precisa apenas do prompt acima. Se você precisar executar uma fase novamente, por exemplo, depois que o site tiver sido alterado, peça ao agente para repeti-la pelo nome.
repeat block cataloging
A reexecução de uma fase também executa novamente cada fase depois dela, enquanto as fases anteriores são mantidas. As alterações feitas na interface do usuário do planejamento de site, como dividir ou mover instâncias de bloco, são mantidas quando o catálogo é gerado novamente.
Saída output
Quando a execução for concluída, o agente postará um resumo no bate-papo com o número de páginas, modelos e variantes de blocos encontrados, um detalhamento por localidade e o status geral da execução. Os resultados completos estão disponíveis para revisão e refinamento na interface do usuário de planejamento de site.
O status da execução é mostrado no resumo do chat e na interface do usuário do planejamento de site.
Interface do usuário de planejamento do site planning-ui
A interface do usuário do planejamento de site é uma exibição no painel do espaço de trabalho do Console de Modernização da Experiência, em que você pode revisar os resultados da habilidade do catálogo de sites e corrigi-los antes de começar a migrar. Ele mostra os modelos, páginas e blocos que o agente identificou, juntamente com capturas de tela, para que você possa confirmar que eles foram identificados corretamente.
Como a precisão do catálogo afeta diretamente o dimensionamento do projeto e cada etapa de migração downstream, é recomendável revisar o catálogo na interface do usuário do planejamento de site antes de importar páginas.
Acesso à interface do usuário do Site Planning accessing-planning-ui
Você pode abrir a interface do usuário do planejamento de site de qualquer uma das seguintes maneiras.
- No cabeçalho do painel do espaço de trabalho, abra o seletor de exibições e selecione Planejamento em Projeto.
- Navegue diretamente para
https://aemcoder.adobe.io/chat/project/plan. - Quando uma execução do catálogo de sites for concluída, selecione Exibir relatório na notificação Escopo de site concluído.
A interface do usuário do planejamento do site é atualizada à medida que as páginas são analisadas, para que você possa começar a revisar os resultados antes que a execução seja concluída.
Painel de visão geral dashboard
O painel de visão geral resume o site catalogado. O cabeçalho mostra o título do site, o status do relatório e a data da análise. Selecione Abrir site no cabeçalho do espaço de trabalho para abrir o site de origem em uma nova guia.
O painel inclui os seguintes cartões.
- Conteúdo — O número de URLs descobertas, modelos identificados, páginas analisadas e documentos encontrados
- Páginas — O progresso da análise da página, mostrando o número de páginas analisadas com êxito e o número que falhou, além do método de descoberta de URL (por exemplo, mapa de site ou rastreo)
- Selecione a contagem de falhas para abrir a lista de URLs com falha.
- Blocos — O número de blocos e variantes de blocos identificados
- Localidades — O número de páginas por localidade (mostrado somente se o site tiver mais de uma localidade)
Abaixo das placas há uma tabela que você pode alternar entre duas visualizações usando a opção na barra de ferramentas da tabela.
- Modelos — Lista cada modelo com sua descrição e o número de páginas que o usam. Selecione um nome de modelo para abrir seus detalhes do modelo.
- Blocos — Lista cada bloco com suas variantes aninhadas abaixo. Selecione uma variante para exibir suas instâncias de variante.
Ambas as tabelas podem ser pesquisadas e classificadas. Selecione o ícone Expandir tabela para ocultar os cartões do painel e dar mais espaço à tabela.
Tabela de blocos blocks-table
A tabela de blocos mostra uma linha expansível por bloco, com as variantes do bloco aninhadas abaixo. Para cada bloco, ele mostra o número de variantes, páginas e modelos em que é encontrado, juntamente com seu status do código.
Cada bloco é mostrado com seu nome e o tipo de bloco da biblioteca de blocos em que ele se baseia, por exemplo, um bloco cards-story do tipo cards. Suas variantes são listadas abaixo por sua classe de variante, como .with-button. Uma variante sem uma classe é o padrão do bloco. O cabeçalho, o rodapé e o conteúdo padrão da página (como cabeçalhos e texto sem formatação) não são listados como blocos.
A coluna Código mostra se o código foi gerado para o bloco.
A mesma tabela de blocos também é mostrada nos detalhes do modelo e da página, com escopo para esse modelo ou página.
Detalhes do modelo template-details
Selecionar um modelo abre seus detalhes, que listam cada página que usa o modelo com o caminho da página, título e número de blocos. Selecione um caminho de página para abrir seus detalhes de página. Use o botão de alternância Páginas / Blocos para alternar para os blocos usados por esse modelo.
Detalhes da página page-details
Os detalhes da página listam os blocos encontrados na página, juntamente com os detalhes da análise, como o número de seções e blocos. Selecione Exibir captura de tela no cabeçalho para exibir a captura de tela de página inteira. Use a ação Localizar na página de uma variante de bloco para exibir a captura de tela de página inteira com esse bloco realçado.
Instâncias variantes variant-instances
Selecionar uma variante de bloco mostra cada instância dessa variante encontrada lado a lado no site, juntamente com o número de instâncias, páginas e modelos em que ela aparece. Isso facilita a detecção de uma instância que foi agrupada incorretamente.
O menu de ações de cada instância permite visualizar a captura de tela, localizá-la na página, abrir os detalhes da página ou abrir a página de origem.
Para corrigir o agrupamento, selecione uma ou mais instâncias e escolha uma das seguintes ações.
- Dividir em uma nova variante — Move as instâncias selecionadas para uma nova variante.
- Mover para outra variante — Move as instâncias selecionadas para uma variante existente.
Pelo menos uma instância deve permanecer na variante original. Para mover cada instância de uma variante, use Dar a esta variante seu próprio bloco ou Torná-la uma variante de outro bloco na variante. As alterações de divisão e movimentação são preservadas quando o catálogo é gerado novamente.
URLs com falha failed-urls
A lista de URLs com falha mostra cada página que não pôde ser analisada, juntamente com o motivo da falha e quando. Arquivos que não sejam de página, como imagens e documentos que foram ignorados, são contados separadamente e não são listados.
Refinamento do catálogo planning-actions
Você pode refinar o catálogo diretamente da interface do usuário de planejamento do site usando ações de IA. Abrir o menu de ações (…) de qualquer modelo, página, bloco ou variante e selecione ações de IA para ver as ações disponíveis para elas. Você também pode selecionar vários itens (até 20) para agir em conjunto.
Quando você escolhe uma ação, os itens selecionados são adicionados ao bate-papo como contexto junto com uma solicitação para a ação. O agente analisa a solicitação, propõe a alteração e aguarda que você a confirme antes de fazê-la. Você também pode escolher Adicionar ao chat para adicionar os itens selecionados ao chat como contexto e escrever seu próprio prompt.
As ações a seguir estão disponíveis.
Algumas ações são oferecidas somente quando se aplicam. Por exemplo, Gerar código de bloco e Renomear bloco só estão disponíveis para blocos cujo tipo tenha sido classificado, e Dar a esta variante seu próprio bloco só está disponível para variantes que tenham uma classe de variante.
As ações de catálogo alteram apenas o catálogo e a biblioteca de bloqueios. Elas nunca alteram o conteúdo de páginas já importadas para o seu projeto.
Fluxo de trabalho de importação em massa bulk-import
A habilidade do catálogo do site faz parte da abordagem recomendada para migrar um site completo.
- Execute a habilidade de catálogo do site para obter o catálogo de modelo completo e bloquear o catálogo.
- Abra a interface do usuário do planejamento de site para revisar os modelos e bloquear o agente identificado e corrigir os que foram identificados incorretamente.
- Para cada modelo, abra os detalhes do modelo e use a Página de migração para o AEM em uma ou duas páginas representativas. Refine a importação até que a saída esteja correta.
- Use Migrar modelo para o AEM para importar as páginas restantes que usam esse modelo.
- Repita o procedimento para cada modelo até que o site completo seja migrado.
Arquivos do catálogo catalog-files
A maioria dos usuários precisa apenas da interface do usuário de planejamento de site. Se você quiser trabalhar com a saída bruta, por exemplo, para compartilhar um relatório offline ou usar os dados em outras ferramentas, a habilidade salva seus arquivos na pasta catalog/ do seu projeto.
template-catalog-report-bundle.zipsummary.jsontemplate-catalog.jsonblock-catalog.jsonurls-all.jsoncatalog.logA pasta também contém arquivos intermediários, incluindo análise por página e capturas de tela em .pages/ e metadados por variante em .blocks/.
Limitações limitations
A habilidade do catálogo do site tem as seguintes limitações.
- Sites públicos somente — o destino deve estar acessível publicamente (sem autenticação, VPN ou firewall).
- Não há suporte para conteúdo dinâmico — O conteúdo que requer interação do usuário para aparecer no DOM pode não ser capturado.