Abilità catalogo sito site-catalog-skill

Scopri in che modo l’agente di modernizzazione esperienza esegue l’analisi automatizzata di un sito web esistente per supportare la pianificazione della migrazione di Edge Delivery Services.

Panoramica overview

L’abilità del catalogo del sito individua ogni pagina del sito, identifica i modelli di pagina e le varianti di blocco in uso, acquisisce le schermate di ciascuna e genera un bundle di rapporti interattivi di HTML che puoi sfogliare nella scheda di anteprima della console o scaricare e aprire localmente.

L’abilità supporta te e la migrazione di un progetto esistente a Edge Delivery Services nei seguenti modi:

  • Avvio di un progetto di migrazione: esegui l’abilità prima di iniziare qualsiasi lavoro per comprendere la scala del sito, inclusi il conteggio delle pagine, i modelli, le varianti di blocco e le impostazioni internazionali. Stabilisce l’inventario di base da cui dipende ogni decisione a valle.
  • Stima e pianificazione dello sforzo: ottenere metriche quantificate per supportare proposte, pianificazione dello sprint e risorse.
  • Preparazione importazione in blocco. Utilizzare template-catalog.json per identificare le pagine che condividono lo stesso layout e pianificare le importazioni in blocco modello per modello.
  • Rapporti per le parti interessate: condividi il bundle di rapporti interattivi di HTML con project manager, architetti e stakeholder aziendali.

Richiamare invoking

Nella console di modernizzazione esperienza utilizza il linguaggio naturale per richiedere all’agente di catalogare un sito. Di seguito sono riportati alcuni esempi di prompt.

  • 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

Noterai che il flusso di lavoro dell’abilità prevede quattro fasi che vengono eseguite in sequenza:

  1. Analisi
  2. Modellazione
  3. Sintonizzazione
  4. Catalogazione a blocchi

È possibile riprodurre qualsiasi fase e l’agente cancella le uscite di quella fase e tutte le uscite a valle e quindi riprende da quel momento in poi. Di seguito sono riportati alcuni esempi di prompt relativi alle fasi di ripetizione.

  • 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

Durante la riproduzione di una fase, le fasi precedenti vengono mantenute.

Output output

Quando l’abilità completa la catalogazione del sito, ricevi tre diversi tipi di output.

  1. Riepilogo del completamento in chat che include i totali (pagine, modelli, varianti di blocco con raggruppamento EDS-mappato rispetto a raggruppamento personalizzato), raggruppamento delle impostazioni locali, percentuale di copertura e stato generale del report (completo/incompleto/non riuscito)

  2. Un bundle interattivo per report di HTML come risultato finale principale, salvato in catalog/template-catalog-report-bundle.zip

    • Il bundle contiene template-catalog-report.html più tutte le schermate e le risorse di riferimento.
    • Puoi scaricare il bundle e visualizzarlo localmente o condividerlo.
    • Oppure puoi chiedere all’agente di Move template-catalog-report-bundle.zip to the /content folder to render it in the preview tab. Update all references as needed. di visualizzare il report nella console.
  3. Artefatti JSON strutturati in catalog/ per abilità downstream e utilizzo a livello di programmazione, inclusi summary.json, template-catalog.json, block-catalog.json, urls-all.json, urls-grouped.json, urls-checklist.json, .pages/, .blocks/

Contenuto cartella catalogo contents

Gli artefatti JSON strutturati sono archiviati in catalog/ dall’abilità.

File
Descrizione
template-catalog-report-bundle.zip
Pacchetto di rapporti interattivi di HTML (consegnabile principale)
summary.json
Metriche di rollup e stato rapporto
template-catalog.json
Tutti i modelli univoci con gli URL che li utilizzano (utilizzati per le importazioni in blocco)
block-catalog.json
Tutte le varianti di blocco con riferimenti a metadati e schermate
urls-all.json
Ogni URL individuato
urls-grouped.json
URL raggruppati per pattern e impostazioni internazionali
urls-sample.json
URL rappresentativi campionati per l’analisi
urls-checklist.json
Stato analisi per URL
catalog.log
Registro di esecuzione
.pages/<page-slug>/page-catalog.json
Output di analisi a livello di pagina
.pages/<page-slug>/full-page.jpg
Schermata a tutta pagina
.pages/<page-slug>/blocks/<block-name>.jpg
Schermate per blocco
.pages/_global/header.json + header.jpg
Analisi e schermata dell’intestazione globale
.pages/_global/footer.json + footer.jpg
Analisi globale del piè di pagina e schermata
.blocks/<variantId>/metadata.json
Blocca metadati variante
.blocks/<variantId>/screenshots/<name>.jpg
Blocca schermate varianti

Stati dei rapporti status

Il campo status in summary.json può essere:

Stato
Significato
complete
Tutte le pagine sono state analizzate correttamente (oppure si è verificato un tasso di errore pari o inferiore al 10%).
incomplete
Più del 10% delle pagine non è riuscito o il rilevamento dei blocchi si è interrotto su oltre il 50% delle pagine. Gli output sono ancora utilizzabili ma parziali.
failed
Nessuna pagina analizzata correttamente.

Campionamento per siti di grandi dimensioni sampling

Per impostazione predefinita, la competenza limita l’analisi delle pagine profonde a 1000 URL. Per i siti con un massimo di 1000 URL, ogni pagina viene analizzata.

Per i siti con più di 1000 URL, l’agente si interrompe e chiede come procedere:

  • Aumentare il limite di campionamento (fino a un massimo di 4000 URL)
  • Analizzare solo un gruppo specifico (ad esempio solo /products/* o /blog/*)
  • Analizza tutti gli URL ed esegui il sito completo senza campionatura

L’individuazione URL copre sempre l’intero sito indipendentemente dal limite di esempi. Solo la fase di analisi approfondita per pagina è limitata.

Per ignorare e analizzare ogni pagina, indica all’agente:

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

Flusso di lavoro importazione in blocco bulk-import

L’abilità per il catalogo dei siti fa parte dell’approccio consigliato per la migrazione di un sito completo.

  1. Esegui l’abilità per il catalogo dei siti per ottenere il catalogo completo dei modelli e il catalogo dei blocchi.
  2. Apri il bundle per report HTML per rivedere visivamente i modelli identificati dall’agente.
  3. Per ogni modello, importare manualmente le pagine rappresentative (elencate in template-catalog.json) e perfezionare l’importazione fino a quando l’output non è corretto.
  4. Importare in blocco le pagine rimanenti del modello utilizzando l’elenco URL di template-catalog.json.
  5. Ripeti l’operazione per ciascun modello fino alla migrazione dell’intero sito.

Limitazioni limitations

L’abilità per il catalogo del sito presenta le seguenti limitazioni.

  • Solo siti pubblici: la destinazione deve essere accessibile al pubblico (nessuna autenticazione, VPN o firewall).
  • Il contenuto dinamico non è supportato. Il contenuto che richiede l’interazione dell’utente per essere visualizzato nel DOM potrebbe non essere acquisito.
  • Limite URL predefinito di 1000 - Per impostazione predefinita, la fase di analisi approfondita è limitata a 1000 URL, che possono essere ignorati fino a un massimo di 4000 URL.
recommendation-more-help
experience-manager-cloud-service-help-main-toc