Prise en main de l’agent de modernisation de l’expérience getting-started

L’agent de modernisation d’expérience crée et modifie les sites Edge Delivery Services avec vous. Vous décrivez ce que vous souhaitez dans la console de modernisation de l’expérience, et l’agent importe des pages, leur définit un style et écrit le code. Ce guide vous permet d’accéder à une première page que vous pouvez modifier, prévisualiser et publier.

Dans Edge Delivery Services, le code d’un site (blocs, styles et scripts) réside dans un référentiel Git et son contenu réside dans une source de contenu distincte que les auteurs et autrices modifient. La plateforme combine les deux en pages rapides. Pour en savoir plus, consultez la présentation de la plateforme.

Dans ce guide, le contenu est stocké dans le référentiel de contenu basé sur des documents, où les auteurs le modifient dans Experience Workspace, l’interface utilisateur de création visuelle de Edge Delivery Services. Si votre contenu doit rester dans le JCR d’une instance d’auteur Adobe Experience Manager, suivez le guide de création dans Experience Manager pour connaître les étapes qui diffèrent. Pour effectuer un choix entre les deux, consultez Où le contenu est stocké et comment les auteurs le modifient.

Le mode automatique a son propre abonnement. Pour connaître l’accès à la console et les conditions qui s’appliquent lorsque vous continuez à utiliser votre propre site, consultez Utilisation du crédit d’accès et d’IA.

Commencer avec vos propres pages first-outcome

Commencez par le mode automatique ci-dessous pour migrer quelques pages, passer en revue le résultat et le reprendre avec Faites-le vôtre. Si vous avez déjà un projet ou souhaitez guider l’importation depuis le début, démarrez à partir d’un référentiel à la place : créez-en un à partir du standard ou connectez votre site existant.

Les deux itinéraires mènent à votre site connecté dans la console. À partir de là, vous demandez à l’agent, puis enregistrez, prévisualisez et publiez le résultat. La console est hébergée, de sorte qu’aucun itinéraire ne nécessite un environnement de développement local.

Avant l’importation, sélectionnez quelques pages d’un site que vous êtes autorisé à migrer, y compris une de chaque mise en page commune, et décidez de conserver la conception source ou d’en appliquer une nouvelle.

Démarrer en mode automatique brand-trial

Le mode automatique migre un site web ou une liste de ses pages, sans invite étape par étape. Dans le workflow guidé, l’agent s’arrête après chaque étape de votre révision. En mode automatique, il importe le contenu, migre la conception, critique le résultat par rapport à la source et continue à l’affiner jusqu’à ce que sa critique trouve les pages proches de la source.

Comme il vérifie et affine son propre travail, le mode automatique prend beaucoup plus de temps qu’une importation guidée des mêmes pages. Il convient donc à un premier résultat que vous collecterez ultérieurement. Une fois qu’une exécution démarre, elle ne vous demande pas votre entrée : vous l’orientez uniquement à travers la portée et les options que vous choisissez avant de démarrer. Le mode automatique démarre à partir de l’URL d’un site web, et non d’un référentiel ; si votre site se trouve déjà sur Edge Delivery Services, connectez-le à la place. Il produit du contenu basé sur des documents. Pour le contenu stocké dans le JCR, utilisez le guide de création dans Experience Manager.

  1. Ouvrez le mode automatique. Si votre compte ne l’a pas encore, sélectionnez S’inscrire ; vous recevrez un e-mail lorsque votre accès sera disponible.

  2. Fournissez l’URL de votre site ou sélectionnez les pages sélectionnées et répertoriez leurs URL. Examinez la portée, les paramètres et les limites affichés avant de commencer.

    • Pour un site source protégé, saisissez les informations d’identification dans les champs d’authentification proposés par le mode automatique, et non dans le chat.
    • Si le mode automatique propose Inclure les intégrations, sélectionnez-le pour transférer les paramètres d’intégration pris en charge à partir du site source, tels que les analyses, le gestionnaire de balises et les paramètres de consentement. Elles restent désactivées sur le nouveau site jusqu’à ce que vous les activiez.
  3. Démarrez l’exécution. Une exécution peut prendre jusqu’à 24 heures. Vous pouvez quitter la page ; vous recevrez un e-mail une fois l’exécution terminée. Si l’e-mail n’arrive pas, vérifiez votre dossier de spam.

  4. Vérifiez les pages migrées et leur contenu, les liens, les images et les styles. L’exécution affiche également son aperçu, son référentiel, son rapport et ses erreurs. Les liens vers des pages que l’exécution n’a pas migrées peuvent toujours pointer vers le site source.

  5. Ouvrez le site obtenu avec Ouvrir le site. Pour continuer à travailler dessus, transférez-le sur votre propre site avec Faites-le le vôtre, puis importez d’autres pages et affinez le résultat dans la console.

Limites du mode automatique auto-mode-limits

Le mode automatique limite chaque compte par le nombre de pages par migration, le nombre de migrations et le nombre de migrations pouvant être exécutées en même temps. La page Mode automatique affiche les limites qui s’appliquent à vous avant de commencer :

  • Par défaut, chaque migration peut contenir jusqu’à 10 pages. Une exécution de site complet migre une prévisualisation d’un nombre maximal de pages, et non l’ensemble du site ; migre le reste plus tard dans la console.
  • Si vous avez utilisé toutes les migrations autorisées par votre compte ou si vous en avez exécuté autant que autorisé, le mode automatique vous le dit. Patientez jusqu’à la fin d’une exécution ou demandez plus d’informations.
  • Pour demander plus de pages ou de migrations, utilisez Demander une limite supérieure ou Obtenir de l’aide dans l’en-tête. L’équipe qui crée les réponses de l’agent par e-mail.

Pour arrêter une exécution, utilisez Annuler la migration. Une exécution annulée ne peut pas être reprise. Démarrez une nouvelle migration à la place.

Faites-En Le Vôtre make-it-yours

Une exécution du mode automatique crée son site à un emplacement géré par Adobe. Pour continuer à travailler dessus sur votre propre site, sélectionnez Faites-le vôtre à la fin de l’exécution. Cela transfère le code et le contenu de l’exécution vers un site que vous possédez. Il ne migre plus rien.

Préparez d’abord la destination :

  • Site dont le code se trouve dans un référentiel GitHub créé à partir d’un modèle Edge Delivery Services, avec les applications AEM Code Sync et AEM Code Connector installées. La méthode la plus rapide consiste à créer un site à partir de la méthode standard. Un référentiel sur un autre hôte Git connecté via Cloud Manager peut également être utilisé.
  • Une branche main dans le référentiel et le contenu du site stocké dans le référentiel de contenu basé sur les documents. Rien n’est transféré vers une destination dont le contenu est stocké ailleurs, par exemple sur une instance de création.
  • Accédez en écriture au référentiel et au contenu du site, pour le compte Adobe que vous utilisez dans la console.
  • Site autre que le site de l’exécution.

Pour transférer l’exécution :

  1. Choisissez le site de destination. Si vous n’êtes pas encore connecté à GitHub, la console vous demande de vous connecter en premier.
  2. Vérifiez le référentiel de destination, l’URL de prévisualisation et la nouvelle branche qui recevra le code. Choisissez s’il faut remplacer les pages existantes et prévisualiser les pages transférées.
  3. Sélectionnez Démarrer le transfert et suivez sa progression. Le code est placé sur une nouvelle branche et le contenu est copié vers l’emplacement de contenu de destination. Pour une destination basée sur des documents, le transfert active également Experience Workspace pour le site de destination. Si cette étape échoue, la console affiche un avertissement ; demandez à l’administrateur du site d’activer Experience Workspace.
  4. Sélectionnez Ouvrir dans EMA pour continuer sur le site de destination dans la console, ou Modifier le site pour modifier le contenu. Si la console ne s’ouvre pas sur le site de destination, connectez-la.

Le transfert copie les éléments suivants :

Quoi
Comment est-il transféré ?
Code
poussé vers une nouvelle branche, créé à partir de la branche main de la destination. Sur cette branche, le projet de l’exécution remplace les fichiers de code de la destination. Rien n’est fusionné dans main.
Pages
Copiés en tant que documents dans le contenu de la destination dans Experience Workspace, avec les images et les autres médias auxquels ils font référence.
Pages existantes
Ignorés, sauf si vous choisissez de les remplacer. Avant de remplacer une page, le transfert enregistre l’état actuel de la page en tant que version nommée Avant le transfert, que vous pouvez restaurer à partir de l’historique des versions de la page dans Experience Workspace.
Prévisualisation
Si vous le souhaitez, les pages transférées sont prévisualisées sur le site *.aem.page de la destination. Elles ne sont pas publiées.

Le transfert ne copie pas les feuilles de calcul, telles que les redirections, les métadonnées en masse ou les espaces réservés ; les autorisations d’accès ; la configuration du site et de l’organisation ; ou les fichiers d’historique Git et de workflow GitHub de l’exécution.

Si le transfert s’arrête avec une erreur, rien n’est fusionné dans main, mais le code et le contenu sont transférés séparément. Vérifiez donc la branche et les pages. Si la nouvelle branche existe déjà, choisissez un autre nom de branche.

Un site transféré n’est pas encore en ligne. Identifiez le propriétaire de chaque étape restante :

Dans la console, continuez avec invites pour commencer avec, puis enregistrez, prévisualisez et publiez vos modifications.

Démarrer à partir d’un référentiel repo-start

Pour fonctionner dans la console, un référentiel GitHub a besoin de deux applications GitHub avec des noms similaires et des tâches différentes :

  • La synchronisation du code AEM permet à Edge Delivery Services de lire votre code afin qu’il puisse être utilisé sur votre site. Chaque site dont le code se trouve sur GitHub l’a.
  • AEM Code Connector permet à la console de pousser les modifications et d’ouvrir les demandes d’extraction dans votre référentiel. Tant qu’elle n’est pas installée, la console ne peut pas envoyer de code ni ouvrir de demandes d’extraction.
NOTE
Pour le contenu stocké dans le JCR d’une instance de création, configurez le référentiel avec le guide de création d’Experience Manager à la place.

Création d’un site à partir du modèle standard prepare-repo

Utilisez ce chemin d’accès pour un nouveau site, y compris pour un site que vous remplissez avec des pages importées d’un site web existant.

  1. Créez le site à partir du modèle standard AEM en suivant la première section du tutoriel de développement, Commencez avec le modèle de référentiel standard :

    • Sélectionnez Utiliser ce modèle pour créer votre référentiel sur GitHub.
    • Installez l’application de synchronisation du code AEM pour ce référentiel uniquement.
    • Vous pouvez éventuellement modifier les administrateurs et la source de contenu du site, puis sélectionner Terminer la configuration.

    Votre site s’exécute maintenant à l’adresse https://main--{repository}--{owner}.aem.page/, avec un exemple de contenu que vous pouvez modifier dans Experience Workspace. Vous n’avez pas besoin des étapes de développement local du tutoriel, car la console fournit l’environnement de développement.

    Pour un storefront de commerce, créez le site à partir du standard de commerce et suivez sa configuration à la place. Il contient les blocs commerciaux et les composants de liste déroulante, qui sont difficiles à ajouter ultérieurement à un site qui a démarré à partir du standard AEM. Voir Pages Commerce.

  2. Installez l’application AEM Code Connector dans le référentiel.

    • Si l’application est installée pour des référentiels sélectionnés uniquement, incluez celui-ci. Si votre organisation a besoin d’une approbation pour les applications GitHub, le propriétaire de l’organisation doit l’approuver.
  3. Ouvrez la console et connectez le site.

Apporter votre site existant existing-site

Si votre site s’exécute déjà sur Edge Delivery Services, vous n’avez pas besoin de le recréer ou de le migrer à nouveau. Connectez-le et l’agent travaille sur son code et son contenu tels qu’ils sont.

  1. Sur GitHub, vérifiez que l’application de synchronisation du code AEM est installée dans le référentiel. Si le site est déjà alimenté à partir de ce référentiel, il l’est.
  2. Installez l’application AEM Code Connector dans le référentiel, comme pour un nouveau site.
  3. Ouvrez la console et connectez le site.
  4. Avant de changer quoi que ce soit, demandez à l’agent d’expliquer le projet. Apportez ensuite une première modification visuelle avec le mode d’inspection. Voir Invites pour commencer par.

Les projets créés à partir du standard actuel comprennent AGENTS.md, où vous conservez les instructions du projet pour l’agent, et un CLAUDE.md d’une ligne qui charge l’agent AGENTS.md dans chaque conversation. Les projets plus anciens peuvent ne pas en avoir ; demandez à l’agent de les ajouter à partir du standard actuel. Voir Les Instructions Du Projet.

Pour redéfinir le style de votre site ou de vos blocs de version, consultez Redéfinir le style d’un site existant et Bloquer le développement. Aucune migration n’est requise.

Utiliser Un Autre Hôte Git other-git

Edge Delivery Services prend également en charge GitHub Enterprise (auto-hébergé), les référentiels hébergés Adobe, GitLab, Bitbucket et Azure DevOps. Intégrez le référentiel dans Adobe Cloud Manager, l’outil Experience Manager as a Cloud Service de gestion des programmes, des environnements et des référentiels de code. Configurez ensuite votre site pour l’utiliser. Voir Apporter Votre Propre Git.

IMPORTANT
La console envoie les modifications vers votre référentiel. Pour les référentiels connectés via Cloud Manager, une branche est poussée, mais aucune demande d’extraction n’est envoyée. Ouvrez-en une dans votre hôte Git si vous avez besoin d’une révision. Le jeton d’accès que vous créez dans Cloud Manager doit accorder un accès en écriture au code du référentiel, avec les autorisations répertoriées à l’étape 8 de la section Ajout de référentiels externes.
Si vous avez déjà intégré un jeton sans accès en écriture, modifiez-le dans Cloud Manager sous Référentiels > Gérer les jetons d’accès et collez une valeur qui inclut l’accès en écriture ; vous n’avez pas besoin d’intégrer à nouveau le référentiel. Voir Gérer les jetons d’accès.

Ouvrir la console de modernisation de l’expérience open-console

  1. Accédez à aemcoder.adobe.io. L’adresse courte aem.new ouvre la même console.
  2. Connectez-vous avec votre Adobe ID.
    • Utilisez un compte appartenant à l’organisation Adobe de votre entreprise. Il est impossible d’utiliser un Adobe ID personnel qui ne fait pas partie d’une organisation. La console vous l’explique et vous permet d’utiliser un autre compte. Si vous ne disposez pas d’un compte de société, demandez à l’équipe de votre compte Adobe de vous ajouter à l’organisation.

La console conserve une copie de travail hébergée de votre projet, appelée espace de travail de la console dans ces documents ; elle n’a aucun rapport avec Experience Workspace, l’interface utilisateur de création. L’agent importe le contenu et y modifie le code jusqu’au chargement ou à la notification push. La console configure votre espace de travail la première fois que vous vous connectez, ce qui peut prendre jusqu’à 10 minutes. Chaque organisation Adobe avec laquelle vous vous connectez dispose de son propre espace de travail, avec ses propres projets et conversations ; pour changer, vous déconnecter et vous connecter avec le profil de l’autre organisation. Après une période d’inactivité, l’espace de travail s’interrompt. Lorsque vous revenez, la console affiche Votre espace de travail est en pause ; sélectionnez Réveiller et patientez quelques minutes pendant sa restauration.

Mode de démonstration demo-mode

Si la console s’ouvre en mode de démonstration, un bouton Site de démonstration s’affiche dans l’en-tête. Vous pouvez explorer l’exemple de projet et essayer d’importer des pages, mais le travail sur le site de démonstration n’est pas enregistré et le site de démonstration ne peut pas pousser le code vers GitHub ou charger du contenu vers Experience Workspace.

Mode de démonstration

Connecter votre site connect-repo

Connectez le site que vous avez créé à partir de la norme standard, transféré avec Faites-le vôtre ou que vous avez déjà eu.

  1. Sélectionnez Site de démonstration dans l’en-tête, puis Changer de site ou utiliser Changer de site dans Paramètres.
  2. Vous êtes invité à autoriser l’application AEM Code Connector à l’aide de vos informations d’identification GitHub. Sélectionnez Autoriser AEM Code Connector.
    • Pour GitHub Enterprise ou lorsque la connexion OAuth n’est pas disponible, ouvrez Autres méthodes de connexion et sélectionnez Se connecter avec un jeton à la place. Saisissez l’hôte GitHub et un jeton d’accès personnel. Il est recommandé d’utiliser un jeton affiné limité aux référentiels dont vous avez besoin. Le jeton doit pouvoir lire votre compte d’utilisateur et effectuer une notification push vers le référentiel ; avec un jeton, la console répertorie uniquement les référentiels vers lesquels vous pouvez effectuer une notification push.
  3. De retour dans la console, spécifiez l’URL d’aperçu du site. Les URL d’aperçu suivent le modèle https://{branch}--{site}--{organization}.aem.page, où {site} est le nom du référentiel GitHub et {organization} est l’organisation ou l’utilisateur GitHub qui le possède. Vous pouvez en copier un en prévisualisant n’importe quelle page du site ou le construire à partir de ces noms. La console recherche automatiquement le référentiel GitHub associé. Vous pouvez également effectuer une recherche dans vos projets GitHub autorisés pour trouver un site.
    Connexion à un projet GitHub
  4. Sélectionnez Extraire vers l’espace de travail une fois le site vérifié. Le projet est ainsi copié dans l’espace de travail de la console.
  5. Lorsque vous êtes invité à Remplacer l’espace de travail existant, vérifiez que le travail en cours est enregistré ailleurs, puis sélectionnez Remplacer l’espace de travail.
    Remplacer l'espace de travail existant

Votre site et son référentiel GitHub sont désormais connectés à la console.

Confirmez le référentiel, la branche et la destination de contenu connectés avant de demander des modifications. La connexion nécessite un accès en écriture au référentiel. Si votre organisation ou référentiel n’est pas répertorié ou si la console ne peut pas vérifier l’URL d’aperçu, consultez Problèmes de connexion Git.

Connexion au site

Page de départ Console console-home

Jusqu’à ce que vous commenciez une conversation, la console s’ouvre sur sa page Accueil. Saisissez une demande ou sélectionnez l’une des invites suggérées, qui sont regroupées par tâche. Une requête que vous tapez s’exécute simultanément. La plupart des invites suggérées s’exécutent en mode Plan : l’agent propose ses étapes sans modifier aucun fichier et vous sélectionnez Exécuter le plan pour les exécuter.

Accueil de la console

Démarrer l’invite start-prompting

Une fois votre site connecté, décrivez en langage clair ce que vous souhaitez. Dites le résultat attendu et sur quelle page, plutôt que sur la manière d’écrire le code. L’agent connaît Edge Delivery Services. Vous pouvez donc également lui demander comment fonctionne une partie de votre site ou ce que signifie un terme de plateforme. Pour savoir comment une page est créée à partir de sections, de blocs et de contenu par défaut, consultez Balisage, sections, blocs et blocage automatique.

CAUTION
Ne saisissez, ne collez ou ne joignez jamais de mots de passe, de clés API, de jetons ou d’autres secrets dans le chat. Tout le contenu de la conversation atteint le modèle d’IA et l’agent peut le copier dans les fichiers de votre projet. Saisissez les informations d’identification dans les Paramètres de la console. Consultez la section Tenir les secrets en dehors de la conversation.

Sur un nouveau site, commencez par importer une page étape par étape. Sur un site qui comporte déjà des pages, comme votre site existant ou un site transféré avec Faites-le vôtre, demandez à l’agent d’expliquer le projet, puis apportez une modification visuelle avec le mode Inspect ou importez d’autres pages. Voir Invites pour commencer par.

Importer une page étape par étape guided-import

L’importation de pages à partir d’un site web existant est la méthode la plus courante pour commencer. Dans le workflow guidé, l’agent s’arrête après chaque étape afin que vous puissiez la vérifier : d’abord le contenu de la page, puis sa conception. Enregistrez chaque résultat dès que vous l’avez vérifié : chargez le contenu après l’étape de contenu et envoyez le code après l’étape de conception.

  1. Éventuellement, commencez par définir la portée du site source. Demandez « Portée du site https://www.example.com ». L’agent trouve les pages du site et regroupe celles qui partagent une mise en page en modèles, que vous pouvez consulter dans la vue Planification. Choisissez votre première page dans un modèle qui couvre de nombreuses pages, car les blocs qu’elle crée peuvent être réutilisés sur chacune d’elles. Voir Catalogue De Sites.

  2. Commencez par une page source autorisée. Remplacez l’exemple d’URL et la destination dans cette invite :

    • « Migrer uniquement https://www.example.com/about vers /about dans ce projet. Ciblez le contenu basé sur des documents. Conservez ses textes, images et liens. Réutilisez les blocs existants et le contenu par défaut. Ne effectuez aucun chargement, aucune notification push ni aucune publication. »
    • Pour la création Experience Manager, supposons que le contenu soit stocké dans le JCR, et suivez les vérifications pour cette configuration.
  3. Examinez la page importée, son chemin de destination et les écarts signalés.
    Import de contenu

  4. Une fois la page importée, le panneau Workspace l’affiche. Sélectionnez la page pour en effectuer le rendu dans le panneau d’aperçu de la console à droite. Cet aperçu affiche la copie de travail dans l’espace de travail de la console, et non le site d’aperçu sur aem.page.
    Contenu importé

  5. Vérifiez la structure de la page, ainsi que son texte. La vue Document du panneau d’aperçu indique comment le contenu est divisé en sections, blocs et contenu par défaut ; voir Vues de contenu. La majeure partie d’une page doit être du contenu par défaut : titres, texte, images et liens. Un bloc n’appartient que là où les auteurs doivent marquer le contenu qui forme un composant, comme un jeu de cartes ; CSS et JavaScript peuvent mettre en page le contenu par défaut, selon les besoins de la conception. Les auteurs vont modifier cette structure. Demandez donc à l’agent de la simplifier maintenant, avant que d’autres pages ne la réutilisent. Voir Formater la structure de contenu.

  6. Chargez le contenu afin qu’il soit enregistré et que les auteurs puissent le modifier. Tant que vous ne l’avez pas chargée, la page importée n’existe que dans l’espace de travail de la console et le code push ne l’enregistre pas.

    • Pour le contenu basé sur des documents, consultez Charger du contenu. Vous pouvez ensuite ouvrir la page et la modifier.
    • Pour la création Experience Manager, consultez Charger le contenu dans le guide de cette configuration.
  7. Maintenant que vous disposez de contenu, demandez un style de source fidèle ou choisissez explicitement une nouvelle conception cible. Le style ne modifie que le CSS et le JavaScript du projet ; le contenu que vous avez chargé reste tel quel.

    • « Importez les styles généraux à partir de https://www.example.com/about, puis appliquez un style aux blocs utilisés sur /about. Conserver le contenu importé. »
  8. Une fois l’agent terminé, sélectionnez Actualiser l’aperçu dans le panneau d’aperçu pour afficher la page stylisée.
    Styles importés

  9. Examinez la page stylisée au niveau des largeurs de bureau et mobile. Comparez son texte, ses liens, ses images et sa structure avec la page source, et demandez à l’agent de corriger les différences. Décrivez également les différences visuelles qui subsistent ; les conceptions complexes peuvent prendre plusieurs tours. Voir Comment se rapproche la conception.

  10. Envoyez le code afin que les nouveaux blocs et styles soient enregistrés dans votre référentiel et s’affichent dans l’aperçu du site. Voir Modifications Du Code Push.

L’importation de la page ne crée pas la navigation et le pied de page partagés ; demandez-les séparément. Ensuite, prévisualisez et publiez la page. Pour d’autres pages, répétez ces étapes et demandez à l’agent de réutiliser les blocs qu’il a créés. Une fois que vos premières pages semblent correctes, demandez-lui de documenter ses blocs et styles pour les conversations ultérieures ; voir Laisser l’agent conserver les fichiers.

Effectuer un changement visuel avec le mode d’inspection inspect-mode

Sur un site qui comporte déjà des pages, tel que votre site existant ou un site que vous avez transféré avec Faites-le vôtre, un changement visuel est le moyen le plus rapide de voir un résultat. Pointez sur ce que vous souhaitez modifier plutôt que de décrire où il se trouve : activez le mode Inspection dans le panneau d’aperçu, sélectionnez l’élément et décrivez la modification, par exemple « Faites en sorte que ce bouton utilise le style de bouton principal ». Effectuer votre première modification décrit les étapes à suivre, notamment la vérification de la largeur de chaque écran et l’annulation d’une modification. Puis poussez le code pour le conserver.

Invites à commencer par first-prompts

Remplacez les exemples d’URL et de chemins par les vôtres.

Un nouveau site à partir du standard :

  • « Expliquez les sections et les blocs de la page d’accueil, ainsi que le style de chacun des fichiers. »
  • « Créez une page /offers à partir de ce cadre Figma : {Figma link}. » Voir Créer une page à partir de Figma.

Après Faites-le vôtre :

  • « Comparez /about avec https://www.example.com/about et corrigez les différences de disposition et d’images. »
  • « Migrer https://www.example.com/contact vers /contact. Réutilisez les blocs existants. »

Votre site existant :

  • « Faites-moi une visite guidée de ce projet : répertoriez ses blocs, ce que chacun fait et quelles pages les utilisent. »
  • « Ajoutez une variante du bloc de cartes avec un arrière-plan sombre et affichez-la sur /products. »
  • « Vérifiez si ce projet contient les fichiers AGENTS.md et CLAUDE.md correspondant au standard AEM actuel et ajoutez-les s’ils sont manquants. »

Conseils sur l’invite prompting-tips

  • Demandez une modification à la fois et vérifiez-la avant de demander la suivante. Si une tâche longue s’arrête avant d’être terminée, demandez à l’agent de continuer.
  • Dites ce que l’agent ne doit pas faire. L’exemple d’invite dans ces guides se termine par « Ne pas télécharger, envoyer ou publier ». Cela permet de conserver le travail de l’agent dans l’espace de travail de la console, de sorte que vous puissiez le vérifier, puis le charger ou le pousser vous-même. Laissez cela de côté lorsque vous souhaitez que l’agent effectue ces étapes pour vous et qu’il ait activé les autorisations d’agent dont il a besoin.
  • Pour une modification qui s’étend sur plusieurs pages ou styles partagés, passez en mode Plan pour consulter les étapes avant toute modification.

L’agent ne sait que ce qui se trouve dans la conversation en cours et dans les fichiers de votre projet. Indiquez-lui le contexte qu’il ne peut pas connaître, tel que les exigences, les règles de la marque, les captures d’écran et les liens vers la documentation d’autres systèmes. Consultez Indiquer le contexte de l’agent. Pour respecter les conventions de votre projet dans chaque conversation, demandez-lui de les écrire dans AGENTS.md et dans les fichiers répertoriés par AGENTS.md. Consultez Instructions et mémoire du projet. Pour les invites de chaque tâche, voir le Guide de l’invite.

Enregistrer, prévisualiser et publier save-work

Le travail de l’agent reste dans l’espace de travail de la console jusqu’à ce que vous l’enregistriez ailleurs. Chacune des étapes suivantes déplace le travail vers un emplacement différent :

  • Le chargement copie le contenu de l’espace de travail de la console vers sa destination de création : Experience Workspace pour les projets basés sur des documents ou l’instance de création pour la création dans Experience Manager. Dans le menu Synchroniser, il s’agit de Push > Contenu.
  • La notification push valide le code dans votre référentiel Git, sur la branche actuelle ou dans le cadre d’une demande d’extraction.
  • L’aperçu et la publication ont placé le contenu enregistré sur le site d’aperçu, *.aem.page, puis sur le site actif, *.aem.live.

Chargez et envoyez séparément. Edge Delivery Services stocke le contenu séparément du code, de sorte que la publication du code n’enregistre pas vos pages et que le chargement n’enregistre pas votre code. Votre premier résultat est complet lorsque vous pouvez rouvrir la page dans Experience Workspace, la modifier et afficher la modification demandée sur le site d’aperçu, et pas seulement lorsqu’un lien d’aperçu existe.

Chargement du contenu upload-content

Chargez les pages dans le référentiel de contenu basé sur des documents, où les auteurs et autrices les modifient dans Experience Workspace. Certains libellés et écrans de console indiquent toujours Création de documents. Avant le chargement, confirmez la destination et le remplacement éventuel des pages existantes. Le chargement utilise vos propres autorisations de contenu ; voir Autorisations de notification push de contenu. Pour la création dans Experience Manager, suivez plutôt Charger le contenu dans le guide de cette configuration.

  1. Dans une vue Contenu, la vue par défaut de l’espace de travail, sélectionnez Charger le contenu en haut à droite. Vous pouvez également utiliser Sync > Push > Contenu dans l’en-tête de l’espace de travail pour charger toutes les pages en attente.
  2. La boîte de dialogue Charger le contenu s’ouvre avec la destination Organisation et Site renseignée à partir de la configuration de votre site. Si les champs sont vides, saisissez l’organisation et le site de votre contenu dans Experience Workspace.
  3. Choisissez les fichiers à charger et sélectionnez Charger.
    Boîte de dialogue de chargement de contenu
  4. Une fois l’opération terminée, la boîte de dialogue affiche le nombre de fichiers chargés. Vous pouvez ensuite prévisualiser ou prévisualiser et publier les pages chargées. Le chargement se poursuit si vous fermez la boîte de dialogue ; réessayez les pages qui échouent.
    Afficher dans AEM

Pour rechercher le contenu chargé, sélectionnez Afficher dans AEM dans la notification à la fin du chargement, ce qui ouvre le contenu du site dans Experience Workspace, ou accédez à https://da.live/#/{organization}/{repository}.

Contenu dans la création de documents

Ouvrez une page chargée, effectuez une modification, enregistrez-la, puis rouvrez-la pour vérifier que les auteurs et autrices peuvent la modifier et que la modification persiste. Lorsqu’Experience Workspace est activé pour le site, Modifier dans Experience Workspace dans la console ouvre la page sélectionnée dans son éditeur visuel.

Modifications du code push push-code-changes

Vérifiez la comparaison des codes et exécutez les vérifications du projet avant de procéder à la publication. Utilisez une demande d’extraction pour le travail qui doit être révisé ; pour ce qui impose la révision, voir Contrôle des modifications.

  1. Vous pouvez éventuellement passer à la vue Modifications (icône de branche dans le sélecteur de vue) pour vérifier la comparaison.
    Affichage du code

  2. Ouvrez Synchronisation dans l’en-tête de l’espace de travail et sélectionnez Push > Code.

  3. Dans la boîte de dialogue Évaluation des modifications, évaluez les fichiers à transférer et sélectionnez Continuer.

  4. Dans la boîte de dialogue Pousser les modifications, saisissez un message de validation. Créez une requête de tirage (par défaut) ou effectuez une notification push vers la branche actuelle, puis sélectionnez Confirmer pour effectuer une notification push.

    • Créer une requête de tirage envoie une nouvelle branche, nommée aem- suivie de la date et de l’heure, et ouvre une requête d’extraction dans la branche actuelle. La demande d’extraction répertorie les URL d’aperçu de vos pages sur la nouvelle branche, de sorte que les réviseurs puissent vérifier le résultat. L’espace de travail de la console reste sur la nouvelle branche ; pour continuer sur la branche d’origine, revenez-y avec Changer de branche dans la vue Modifications.
    • Envoyer vers la branche actuelle ajoute la validation à la branche actuelle et met à jour sa demande d’extraction si elle en a une. Utilisez-la uniquement lorsque la politique de votre projet l’autorise et que vous avez l’intention de modifier cette branche. Le main, la modification est activée immédiatement.
  5. Une fois l’opération terminée, une notification s’affiche au bas de la console.
    Afficher PR

Si une demande d’extraction a été créée, sélectionnez Afficher PR dans la notification d’achèvement. Dans le cas contraire, par exemple pour un référentiel ​ connecté via Cloud Manager, vérifiez la validation sur la branche de destination. Si la branche est protégée contre les notifications push directes, effectuez une notification push avec Créer une requête de tirage.

Code dans GitHub

Votre code se trouve désormais dans GitHub. Elle s’affiche immédiatement dans l’aperçu et les URL actives de cette branche.

Valider l’identité commit-identity

La console effectue une validation avec l’identité Git, user.name et user.email, configurées dans l’espace de travail de la console, et utilise une valeur par défaut pour l’une ou l’autre qui est manquante. Ni la connexion de votre compte Git ni les paramètres Git sur votre propre ordinateur ne définissent cette identité.

Si quelqu’un d’autre a modifié la branche push-conflicts

Une branche est une séquence de modifications enregistrées, appelées validations. L’espace de travail de la console maintient la branche telle qu’elle était la dernière fois que vous l’avez extraite. Ainsi, si une autre personne y a accédé depuis, le référentiel procède à des validations que votre espace de travail ne fait pas. Effectuer une notification push sur la branche actuelle, puis ajouter votre validation après la leur et effectuer une nouvelle notification push. Si vous avez modifié différents fichiers ou lignes, vous n’aurez plus rien à ajouter.

Si vous modifiez tous les deux les mêmes lignes, Git ne peut pas décider de la version à conserver. Il s’agit d’un conflit. La console affiche Échec de la notification push : la console distante comporte des modifications en conflit qui ne peuvent pas être fusionnées automatiquement, conserve vos modifications et bascule la boîte de dialogue sur Créer une requête de tirage.

  1. Sélectionnez Confirmer. La console envoie vos modifications vers une nouvelle branche et ouvre une demande d’extraction dans la branche sur laquelle vous travailliez.
  2. Sélectionnez Afficher PR dans la notification.
  3. Résolvez les conflits. Si seuls quelques lignes entrent en conflit, sélectionnez Résoudre les conflits dans GitHub et conserver la version correcte de chaque partie ; voir Résoudre un conflit de fusion sur GitHub. Si les conflits s’étendent sur de nombreux fichiers, demandez à un développeur de les résoudre dans une copie locale du référentiel.
  4. Une fois la demande d’extraction révisée, fusionnez-la.

La console ne fusionne pas les branches et ne résout pas les conflits elle-même. Synchronisation > Extraction > Code fonctionne de la même manière : si votre validation entre en conflit avec les modifications distantes, l’extraction est annulée, votre travail reste inchangé et vous suggère d’effectuer un transfert vers une nouvelle branche ou de demander de l’aide à l’agent. Pour éviter les conflits, extrayez avant de commencer une tâche, apportez souvent de petites modifications et validez les modifications apportées aux fichiers par votre équipe. Voir Travail d’équipe.

Aperçu du site preview-site

Le panneau d’aperçu de la console affiche uniquement la copie de travail dans l’espace de travail de la console. Pour vérifier les pages chargées sur le site de prévisualisation avec votre code :

  1. Revenez à Experience Workspace ou accédez à https://da.live/#/{organization}/{repository}.
  2. Ouvrez l’une des pages que vous avez précédemment chargées.
  3. Sélectionnez l’icône du plan de papier (en haut à droite), puis Aperçu.
    Publier pour prévisualisation

Vérifiez que l’aperçu contient le contenu enregistré et la version de code prévue.

Contenu de la prévisualisation publié

Si votre code se trouve dans une branche autre que celle de l’URL d’aperçu, modifiez l’URL d’aperçu en fonction de cette branche. Pour la création Experience Manager, suivez plutôt Valider la création et la prévisualisation.

Publication publish

Lorsque l’aperçu s’affiche correctement, publiez la page pour la rendre active sur *.aem.live :

  • Dans Experience Workspace, ouvrez la page, sélectionnez l’icône de plan de papier, puis Publier.
  • Ou, après un chargement dans la console, choisissez de prévisualiser et de publier les pages chargées.

La publication rend la page publique. Le rôle de publication du site définit les personnes autorisées à publier ; suivez le processus de révision de votre équipe. Le code n’a pas besoin de cette étape : il est activé dès qu’il atteint main. Voir Contrôle des modifications.

Création d’une démonstration client customer-demo

Une démonstration montre quelques pages complètes de marque d’un site que vous êtes autorisé à utiliser, le long d’un chemin que vous suivez pour votre audience. Il n’a pas besoin de basculement de production et ne doit pas être présenté comme étant prêt pour la production.

  1. Choisissez les pages et l’objectif de la démonstration. Insérez une page type, et pas seulement la plus facile.
  2. Utilisez le mode automatique ou importer les pages étape par étape, en nommant la liste de pages exacte.
  3. Conservez la conception source ou appliquez-en une nouvelle lors de la migration. Complétez la navigation, le pied de page et les ressources dont le chemin de démonstration a besoin.
  4. Vérifiez le texte, les images, les liens, la mise en page et le comportement mobile, et suivez le chemin de démonstration. Notez les interactions simulées, les intégrations qui ne sont pas connectées et les pages en dehors de la portée.
  5. Remettez les liens d’aperçu, la page source derrière chacun d’eux et les écarts connus. Voir Conserver le contexte pour les personnes et les agents.

Accès et utilisation du crédit par l’IA access

Demandez l’accès à la console de modernisation de l’expérience par l’intermédiaire de votre gestionnaire de compte Adobe et connectez-vous avec un Adobe ID appartenant à l’organisation Adobe de votre société. Le mode automatique n’a pas besoin de recevoir de demande via votre gestionnaire de compte ; inscrivez-vous sur sa page, comme dans Démarrer avec le mode automatique.

Planifiez votre migration dans le cadre de votre migration vers Edge Delivery Services. Votre équipe de compte Adobe peut examiner la portée et les dispositions commerciales de votre projet, y compris les migrations de sites volumineux et dirigées par des partenaires. L’accord de votre entreprise détermine les conditions de migration et de réduction de crédit AI applicables ; la connexion seule n’établit pas vos droits.

Dans le modèle de crédit actuel, les pages de migration peuvent utiliser des crédits d’IA :

  • Les crédits sont comptabilisés pour chaque page téléchargée vers votre destination de contenu, Experience Workspace ou l’instance d’auteur, et non pour les invites ou les itérations dans la console.
  • Chaque chargement compte, y compris le chargement d’une page que vous avez précédemment chargée. Vérifiez une page dans l’aperçu de la console, puis chargez-la une fois qu’elle est prête.
  • Un nouveau style modifie le code, et non le contenu, il ne nécessite donc aucun nouveau chargement.
  • Les exécutions du mode automatique ne consomment pas de crédits d’IA. Faites-le vôtre compte les pages qu’il copie dans Experience Workspace.
  • Les pages que l’agent charge pour vous sont comptabilisées de la même manière que les pages que vous chargez.

Pour une présentation des crédits d’IA dans les fonctionnalités d’agent d’Adobe, consultez Consommation de crédit d’IA. Les exemples ou les taux pour d’autres fonctionnalités n’établissent pas les termes de votre migration. Demandez à l’équipe de votre compte Adobe de passer en revue l’utilisation de votre organisation et de confirmer les rapports d’utilisation disponibles.

Résolution des problèmes troubleshooting

Pour tout problème lié aux importations, à l’accès à la source, aux chargements, aux aperçus, aux connexions Git ou à l’espace de travail de la console, consultez Dépannage de l’agent de modernisation de l’expérience. Si cela ne résout pas le problème, demandez l’assistance de l’équipe qui crée l’agent.

Ressources supplémentaires additional-resources

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