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 um site existente 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 gera um conjunto de relatórios interativo do HTML que você pode navegar na guia de visualização do Console ou baixar e abrir localmente.

A habilidade oferece suporte a você e à migração de um projeto existente 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.
  • Preparação da importação em massa — Use template-catalog.json para identificar quais páginas compartilham o mesmo layout e planejam as importações em massa modelo por modelo.
  • Relatórios de partes interessadas — compartilhe o conjunto de relatórios interativos do HTML com gerentes de projeto, arquitetos e partes interessadas comerciais.

Chamando invoking

No Console de Modernização da Experiência, use linguagem natural para solicitar que o agente cataloge um site. Veja a seguir exemplos de prompts.

  • scope site https://www.example.com
  • site scope https://www.example.com
  • analyze https://www.example.com
  • find templates on https://www.example.com
  • discover templates on https://www.example.com
  • catalog site https://www.example.com
  • how many page types are there on https://www.example.com
  • what are the layouts on https://www.example.com
  • analyze site structure of https://www.example.com

Você observará que o fluxo de trabalho da habilidade tem quatro fases executadas em sequência:

  1. Análise
  2. Modelagem
  3. Ajuste
  4. Bloquear catalogação

Você pode reproduzir qualquer fase e o agente limpa as saídas dessa fase e todas as saídas downstream e, em seguida, reinicia a partir desse ponto. Estes são alguns exemplos de prompts de fases de repetição.

  • Repeat analyzing / Redo page analysis / Rerun analyze pages
  • Repeat templating / Redo the template discovery step / Restart the templating step
  • Repeat tuning / Rerun tune templates / Redo template tuning
  • Repeat block cataloging / Restart catalog block variants

Ao reproduzir uma fase, as fases anteriores são preservadas.

Saída output

Quando a habilidade concluir a catalogação do site, você receberá três tipos diferentes de saída.

  1. Um resumo de conclusão no chat incluindo totais (páginas, modelos, variantes de bloco com EDS mapeado vs. detalhamento personalizado), detalhamento de localidade, porcentagem de cobertura e status geral do relatório (concluído / incompleto / com falha)

  2. Um conjunto de relatórios interativo do HTML como sua entrega principal, salvo em catalog/template-catalog-report-bundle.zip

    • O pacote contém template-catalog-report.html além de todas as capturas de tela e ativos referenciados.
    • Você pode baixar o pacote e visualizá-lo localmente ou compartilhá-lo.
    • Ou você pode pedir ao agente Move template-catalog-report-bundle.zip to the /content folder to render it in the preview tab. Update all references as needed. para exibir o relatório no console.
  3. Artefatos JSON estruturados em catalog/ para habilidades de downstream e uso programático, incluindo summary.json, template-catalog.json, block-catalog.json, urls-all.json, urls-grouped.json, urls-checklist.json, .pages/, .blocks/

Conteúdo da pasta do catálogo contents

Os artefatos JSON estruturados são armazenados em catalog/ pela habilidade.

Arquivo
Descrição
template-catalog-report-bundle.zip
Conjunto de relatórios interativos do HTML (entrega principal)
summary.json
Métricas acumuladas e status do relatório
template-catalog.json
Todos os modelos exclusivos com os URLs que usam cada (usados para importações em massa)
block-catalog.json
Todas as variantes de blocos com referências de metadados e captura de tela
urls-all.json
Cada URL descoberto
urls-grouped.json
URLs agrupados por padrão e localidade
urls-sample.json
URLs representativos amostrados para análise
urls-checklist.json
Status da análise por URL
catalog.log
Log de execução
.pages/<page-slug>/page-catalog.json
Saída de análise em nível de página
.pages/<page-slug>/full-page.jpg
Captura de tela de página inteira
.pages/<page-slug>/blocks/<block-name>.jpg
Capturas de tela por bloco
.pages/_global/header.json + header.jpg
Análise de cabeçalho global e captura de tela
.pages/_global/footer.json + footer.jpg
Análise de rodapé global e captura de tela
.blocks/<variantId>/metadata.json
Bloquear metadados de variante
.blocks/<variantId>/screenshots/<name>.jpg
Bloquear capturas de tela de variante

Status do relatório status

O campo status em summary.json pode ser:

Status
Significado
complete
Todas as páginas foram analisadas com êxito (ou houve uma taxa de falha de 10% ou menor).
incomplete
Mais de 10% das páginas falharam ou a detecção de bloco falhou em mais de 50% das páginas. As saídas ainda são utilizáveis, mas parciais.
failed
Nenhuma página foi analisada com sucesso.

Amostragem para sites grandes sampling

Por padrão, a habilidade limita a análise de página profunda a 1000 URLs. Para sites com até 1000 URLs inclusos, cada página é analisada.

Para sites com mais de 1000 URLs, o agente faz uma pausa e pergunta como proceder:

  • Aumente o limite de amostragem (até um máximo de 4.000 URLs)
  • Analisar apenas um grupo específico (por exemplo, somente /products/* ou /blog/*)
  • Analisar todos os URLs e executar o site completo sem amostragem

A descoberta de URL sempre cobre o site completo, independentemente do limite de amostra. Somente a fase de análise detalhada por página é limitada.

Para substituir e analisar cada página, informe ao agente:

  • analyze all URLs
  • analyze everything
  • analyze every page
  • run the full site

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.

  1. Execute a habilidade de catálogo do site para obter o catálogo de modelo completo e bloquear o catálogo.
  2. Abra o conjunto de relatórios do HTML para examinar visualmente os modelos identificados pelo agente.
  3. Para cada modelo, importe manualmente as páginas representativas (listadas em template-catalog.json) e refine a importação até que a saída esteja correta.
  4. Importe em massa as páginas restantes desse modelo usando a lista de URLs de template-catalog.json.
  5. Repita o procedimento para cada modelo até que o site completo seja migrado.

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.
  • Limite de 1000 URL padrão - A fase de análise profunda é limitada por padrão a 1000 URLs, que podem ser substituídas até no máximo 4000 URLs.
recommendation-more-help
experience-manager-cloud-service-help-main-toc