Compétence du catalogue de sites site-catalog-skill
Découvrez comment la compétence de catalogue de sites de l’agent de modernisation d’expérience effectue une analyse automatisée de n’importe quel site web pour prendre en charge la planification de la migration vers Edge Delivery Services.
Vue d’ensemble overview
La compétence de catalogue de sites découvre chaque page du site, identifie les modèles de page et les variantes de bloc en cours d’utilisation, capture des captures d’écran de chacune et présente les résultats dans l’interface utilisateur de planification du site de la console de modernisation de l’expérience, où vous pouvez les examiner et les affiner.
Les compétences prennent en charge la migration de n’importe quel site web vers Edge Delivery Services comme suit :
- Démarrer un projet de migration — Exécutez les compétences avant de commencer à comprendre l’échelle du site, y compris le nombre de pages, les modèles, les variantes de bloc et les paramètres régionaux. Il établit l’inventaire de base dont dépend chaque décision en aval.
- Estimation et planification de l’effort — Obtenez des mesures quantifiées pour soutenir les propositions, la planification du sprint et les ressources.
- Révision et correction du catalogue - Validez les modèles et bloquez l’agent identifié dans l’interface utilisateur de planification du site et corrigez-les avant le début de la migration.
- Préparation d’un import en bloc — Vérifiez quelles pages partagent la même disposition et le même plan imports en bloc modèle par modèle.
- Rapports des parties prenantes — Partagez les résultats avec les chefs de projet, les architectes et les parties prenantes de l’entreprise.
Appeler invoking
Dans la console de modernisation de l’expérience demandez à l’agent de définir la portée de votre site.
scope site https://www.example.com
Cette option active également l’interface utilisateur de planification de site pour votre projet.
Le workflow de la compétence comporte quatre phases qui s’exécutent en séquence :
- Analyse — Chaque page est chargée, capturée et divisée en blocs en fonction de son contenu modifiable par l’auteur.
- Catalogage de blocs — Des blocs similaires sur plusieurs pages sont regroupés en variantes de bloc, et chaque variante est mappée à un bloc de la bibliothèque de blocs et nommée.
- Modèles — Les pages qui partagent la même disposition de blocs sont regroupées en modèles candidats.
- Nommage — Les modèles candidats sont examinés, fusionnés lorsqu’ils sont structurellement identiques et dotés de noms significatifs.
Une fois l’exécution terminée, consultez les résultats dans l’interface utilisateur de planification du site.
Prompts supplémentaires additional-prompts
La plupart des projets n’ont besoin que de l’invite ci-dessus. Si vous devez réexécuter une phase, par exemple après que le site a changé, demandez à l’agent de la répéter par son nom.
repeat block cataloging
La réexécution d’une phase exécute également toutes les phases suivantes, tandis que les phases précédentes sont conservées. Les modifications que vous apportez à l’interface utilisateur de planification du site, telles que le fractionnement ou le déplacement d’instances de bloc, sont conservées lors de la régénération du catalogue.
Sortie output
Une fois l’exécution terminée, l’agent publie un résumé dans la conversation avec le nombre de pages, de modèles et de variantes de bloc trouvés, une répartition par paramètre régional et le statut global de l’exécution. Vous pouvez consulter et affiner les résultats complets dans l’interface utilisateur de la planification de site.
Le statut de l’exécution s’affiche dans le résumé de la conversation et dans l’interface utilisateur de planification du site.
Interface utilisateur de planification du site planning-ui
L’interface utilisateur de planification du site est une vue du panneau espace de travail de la console de modernisation de l’expérience qui vous permet de consulter les résultats de la compétence de catalogue de sites et de les corriger avant de commencer la migration. Il affiche les modèles, les pages et les blocs de l’agent identifié, ainsi que des captures d’écran, afin que vous puissiez confirmer qu’ils ont été correctement identifiés.
Étant donné que la précision du catalogue affecte directement le dimensionnement du projet et chaque étape de migration en aval, il est recommandé de consulter le catalogue dans l’interface utilisateur de planification du site avant d’importer des pages.
Accès à l’interface utilisateur de planification de site accessing-planning-ui
Vous pouvez ouvrir l’interface utilisateur de planification de site de l’une des manières suivantes.
- Dans l’en-tête du panneau Espace de travail, ouvrez le sélecteur d’affichage et sélectionnez Planification sous Projet.
- Accédez directement à
https://aemcoder.adobe.io/chat/project/plan. - Une fois l’exécution du catalogue de sites terminée, sélectionnez Afficher le rapport dans la notification Portée du site terminée.
L’interface utilisateur de planification du site se met à jour au fur et à mesure que les pages sont analysées, afin que vous puissiez commencer à consulter les résultats avant la fin de l’exécution.
Tableau de bord de présentation dashboard
Le tableau de bord de présentation résume le site catalogué. L’en-tête affiche le titre du site, le statut du rapport et la date d’analyse. Sélectionnez Ouvrir le site dans l’en-tête de l’espace de travail pour ouvrir le site source dans un nouvel onglet.
Le tableau de bord comprend les cartes suivantes.
- Contenu — Nombre d’URL découvertes, de modèles identifiés, de pages analysées et de documents trouvés
- Pages — Progression de l’analyse de la page, indiquant le nombre de pages analysées avec succès et le nombre ayant échoué, ainsi que la méthode de découverte d’URL (par exemple, plan du site ou explore)
- Sélectionnez le nombre d’échecs pour ouvrir la liste URL en échec.
- Blocks — Nombre de blocs et variantes de blocs identifiés
- Paramètres régionaux — Nombre de pages par paramètre régional (affiché uniquement si le site en comporte plusieurs)
Sous les cartes se trouve un tableau dans lequel vous pouvez basculer entre deux vues à l’aide du bouton (bascule) de la barre d’outils du tableau.
- Modèles — Répertorie chaque modèle avec sa description et le nombre de pages qui l’utilisent. Sélectionnez un nom de modèle pour ouvrir ses détails du modèle.
- Blocks — Répertorie chaque bloc avec ses variantes imbriquées en dessous. Sélectionnez une variante pour afficher ses instances de variante.
Les deux tableaux peuvent être recherchés et triés. Sélectionnez l’icône Développer le tableau pour masquer les cartes du tableau de bord et laisser plus d’espace au tableau.
Tableau Blocs blocks-table
Le tableau des blocs affiche une ligne extensible par bloc, avec les variantes du bloc imbriquées en dessous. Pour chaque bloc, il indique le nombre de variantes, de pages et de modèles sur lesquels il se trouve, ainsi que son statut du code.
Chaque bloc est affiché avec son nom et le type de bloc de la bibliothèque de blocs sur laquelle il est basé, par exemple un bloc cards-story de type cards. Ses variantes sont répertoriées sous par leur classe de variante, telle que .with-button. Une variante sans classe est la valeur par défaut du bloc. L’en-tête, le pied de page et le contenu par défaut (comme les en-têtes simples et le texte) ne sont pas répertoriés comme des blocs.
La colonne Code indique si du code a été généré pour le bloc.
Le même tableau de blocs s’affiche également dans le modèle et les détails de la page, dont la portée est limitée à ce modèle ou à cette page.
Détails du modèle template-details
La sélection d’un modèle ouvre ses détails, qui répertorient chaque page qui utilise le modèle avec le chemin d’accès, le titre et le nombre de blocs de la page. Sélectionnez un chemin de page pour ouvrir ses détails de la page. Utilisez le bouton (bascule) Pages / Blocs pour passer aux blocs utilisés par ce modèle.
Détails de la page page-details
Détails de la page répertorie les blocs trouvés sur la page, ainsi que des détails d’analyse tels que le nombre de sections et de blocs. Sélectionnez Afficher la capture d’écran dans l’en-tête pour afficher la capture d’écran pleine page. Utilisez l’action Localiser sur la page d’une variante de bloc pour afficher la capture d’écran de pleine page avec ce bloc en surbrillance.
Instances de variante variant-instances
La sélection d’une variante de bloc affiche côte à côte chaque instance de cette variante trouvée sur le site, ainsi que le nombre d’instances, de pages et de modèles sur lesquels elle apparaît. Cela permet de repérer facilement une instance qui a été groupée de manière incorrecte.
Le menu d’actions de chaque instance vous permet d’afficher sa capture d’écran, de la localiser sur sa page, d’ouvrir les détails de sa page ou d’ouvrir la page source.
Pour corriger le regroupement, sélectionnez une ou plusieurs instances et choisissez l’une des actions suivantes.
- Scinder en une nouvelle variante — Déplace les instances sélectionnées dans une nouvelle variante.
- Déplacer vers une autre variante — Déplace les instances sélectionnées vers une variante existante.
Au moins une instance doit rester dans la variante d’origine. Pour déplacer chaque instance d’une variante, utilisez Donner à cette variante son propre bloc ou Faire de cette variante une variante d’un autre bloc sur la variante à la place. Vos modifications de fractionnement et de déplacement sont conservées lorsque le catalogue est régénéré.
URL ayant échoué failed-urls
La liste des URL ayant échoué affiche chaque page qui n’a pas pu être analysée, ainsi que la raison de son échec et le moment de son échec. Les fichiers non pages, tels que les images et les documents ignorés, sont comptabilisés séparément et ne sont pas répertoriés.
Affinage du catalogue planning-actions
Vous pouvez affiner le catalogue directement à partir de l’interface utilisateur de planification du site à l’aide d’actions d’IA. Ouvrez le menu d’actions (…) de n’importe quel modèle, page, bloc ou variante et sélectionnez Actions d’IA pour afficher les actions disponibles. Vous pouvez également sélectionner plusieurs éléments (jusqu’à 20) pour les utiliser ensemble.
Lorsque vous choisissez une action, les éléments sélectionnés sont ajoutés au chat en tant que contexte avec une demande d’action. L’agent analyse la demande, propose la modification et attend que vous la confirmiez avant de l’effectuer. Vous pouvez également choisir Ajouter au chat pour ajouter les éléments sélectionnés au chat en tant que contexte et écrire votre propre invite.
Les actions suivantes sont disponibles.
Certaines actions ne sont proposées que lorsqu’elles sont applicables. Par exemple, les options Générer le code de bloc et Renommer le bloc ne sont disponibles que pour les blocs dont le type a été classé, et Donner à cette variante son propre bloc n’est disponible que pour les variantes ayant une classe de variante.
Les actions de catalogue modifient uniquement le catalogue et la bibliothèque de blocs. Ils ne modifient jamais le contenu des pages déjà importées dans votre projet.
Workflow d’importation en bloc bulk-import
Les compétences de catalogue de sites font partie de l’approche recommandée pour migrer un site complet.
- Exécutez les compétences du catalogue de sites pour obtenir le catalogue de modèles complet et le catalogue global.
- Ouvrez l’interface utilisateur de planification de site pour consulter les modèles et les blocs que l’agent a identifiés et corriger ceux qui ont été identifiés de manière incorrecte.
- Pour chaque modèle, ouvrez ses détails du modèle et utilisez Migrer la page vers AEM sur une ou deux pages représentatives. Affinez l’importation jusqu’à ce que la sortie soit correcte.
- Utilisez Migrer le modèle vers AEM pour importer les pages restantes qui utilisent ce modèle.
- Répétez l’opération pour chaque modèle jusqu’à ce que le site complet soit migré.
Fichiers de catalogue catalog-files
La plupart des utilisateurs n’ont besoin que de l’interface utilisateur de planification de site. Si vous souhaitez travailler avec la sortie brute, par exemple pour partager un rapport hors ligne ou pour utiliser les données dans d’autres outils, la compétence enregistre ses fichiers dans le dossier catalog/ de votre projet.
template-catalog-report-bundle.zipsummary.jsontemplate-catalog.jsonblock-catalog.jsonurls-all.jsoncatalog.logLe dossier contient également des fichiers intermédiaires, notamment une analyse par page et des captures d’écran dans .pages/ et des métadonnées par variante dans .blocks/.
Restrictions limitations
La compétence de catalogue de sites présente les limites suivantes.
- Sites publics uniquement — La cible doit être accessible au public (pas d’authentification, de VPN ou de pare-feu).
- Le contenu dynamique n’est pas pris en charge — Le contenu nécessitant l’interaction de l’utilisateur pour apparaître dans le DOM peut ne pas être capturé.