Apporter des modifications visuelles avec l’agent de modernisation de l’expérience visual-changes

Ce guide s’adresse aux concepteurs et aux autres personnes qui changent l’apparence d’un site : couleurs, polices, espacement et mise en page de ses blocs. Vous décrivez une modification apportée à l’agent de modernisation de l’expérience dans la console de modernisation de l’expérience, la vérifiez dans l’aperçu et envoyez-la à un développeur pour révision. L’agent écrit le code, de sorte que vous n’avez pas besoin d’écrire du code CSS ou JavaScript. Vos modifications atteignent le site par le biais de son référentiel Git. Vous avez donc besoin des principes de base : vous envoyez votre travail à une branche et le transmettez dans une requête d’extraction. Si ces termes sont nouveaux pour vous, consultez Mots utilisés dans ce guide.

Avant de commencer before-you-start

Demandez ce qui suit à la personne qui dirige le projet :

Votre travail reste dans votre propre espace de travail de console jusqu’à ce que vous le transmettiez. Rien de ce que vous essayez dans l’aperçu n’atteint le site en direct par lui-même.

CAUTION
Ne tapez ou ne collez jamais de mots de passe, de jetons d’accès ou d’autres secrets dans le chat, et vérifiez les captures d’écran et les fichiers avant de les joindre. Tout le contenu de la conversation atteint le modèle d’IA et l’agent peut le copier dans les fichiers du site. Votre jeton Figma passe uniquement dans les paramètres > informations d’identification. Consultez la section Tenir les secrets en dehors de la conversation.

Ce que vous pouvez modifier what-you-can-change

Sur un site Edge Delivery Services, les auteurs écrivent le contenu et le code décide de son aspect. Une modification visuelle modifie donc le code du site, principalement son CSS, et laisse le contenu saisi par les auteurs tel quel. Vous n’avez pas besoin d’importer ou de charger des pages à nouveau.

Chaque partie du code atteint une partie différente du site. Avant de demander une modification, décidez jusqu’où elle doit aller :

Ce que vous modifiez
Exemple de requête
Ce que cela affecte
Styles au niveau du site
« Utilisez notre marque bleue pour tous les liens et boutons. »
Chaque page. Les couleurs, les polices et l’espacement sont stockés en tant que jetons de conception, avec des valeurs nommées telles que --link-color dans les styles globaux.
Contenu par défaut
« Augmentez l’espace sous tous les en-têtes de deuxième niveau. »
En-têtes, texte, listes, images et boutons situés en dehors des blocs, sur chaque page.
Un bloc
« Donnez aux cartes des coins arrondis et une ombre subtile. »
Chaque page sur laquelle le bloc apparaît.
Variante de bloc
« Ajoutez une variante sombre du bloc de cartes. »
Seuls les blocs que les auteurs marquent avec la variante, tels que Cartes (sombres).
Style de section
« Ajoutez un style de section avec un arrière-plan gris clair. »
Uniquement les sections que les auteurs appliquent à ce style dans leurs métadonnées de section.
Un modèle de page
« Sur les pages d’Adventure, affichez l’image principale à pleine largeur. »
Uniquement les pages dont les noms de métadonnées correspondent à ce modèle.

Les variantes, les styles de section et les modèles ne prennent effet que lorsque les auteurs les appliquent. Demandez à l’agent d’en appliquer une à la page sur laquelle vous travaillez, afin de pouvoir la voir, et indiquez aux auteurs quand l’utiliser.

Certaines requêtes vont au-delà de l’aspect du site. L’ajout d’un champ rempli par les auteurs, la modification de la structure du contenu d’un bloc ou l’ajout d’un comportement tel qu’un carrousel modifie le modèle de contenu du bloc ou sa logique. Décrivez ce dont vous avez besoin et laissez ces décisions au développeur. Voir Créer, mettre à jour et refactoriser des blocs.

Limiter une modification à certaines pages impact

La modification d’un bloc ou des styles globaux modifie chaque page qui les utilise. Avant d’en demander une, demandez à l’agent où le bloc ou le style est utilisé, par exemple « Quelles pages de mon espace de travail utilisent le bloc de cartes ? »

Lorsqu’une modification ne doit s’appliquer qu’à certaines pages, demandez plutôt l’une des options suivantes :

  • Variante de bloc ​, lorsque seules certaines instances d’un bloc doivent être différentes.
  • Un style de section ​, lorsqu’une partie d’une page, telle qu’une zone mise en surbrillance, a besoin de son propre aspect.
  • Un modèle de page, lorsqu’un type de page, comme toutes les pages de produits, nécessite sa propre apparence.

Expliquez Ce Que Vous Voulez Dire references

Une image est souvent plus précise qu’une description. Utilisez Joindre des fichiers (icône de trombone) dans l’invite pour joindre :

  • Capture d’écran du résultat souhaité ou du problème, avec une phrase indiquant ce qu’il faut regarder.
  • Pages du guide de style de la marque, sous forme d’images ou de fichier Word ou PowerPoint.

Vous pouvez également pointer vers une page du site qui ressemble déjà à droite : « Faites en sorte que les cartes de /adventures ressemblent à celles de /magazine. » Utilisez uniquement les conceptions et les sites de référence que votre équipe est autorisée à utiliser.

L’agent ne se souvient pas des règles de marque entre les conversations. Une fois qu’une règle est réglée, comme les styles de bouton ou les tailles d’en-tête, demandez à l’agent de l’écrire dans les fichiers d’instructions du projet, afin qu’il suive la règle dans chaque conversation. Voir Instructions et mémoire du projet.

Travail à partir d’une conception de formulaire figma

L’agent peut lire une conception de Figma via le module complémentaire d’importation de Figma. Il transforme les couleurs, la typographie, l’espacement et les variables de la conception en jetons de conception du site et ses composants en blocs ou en variantes de bloc.

  1. Dans Figma, créez un jeton d’accès personnel avec les portées en lecture seule répertoriées dans les paramètres d’identification de la console.
  2. Dans la console, ouvrez Paramètres, saisissez le jeton sous Informations d’identification et sélectionnez Enregistrer. Un nouveau jeton peut prendre quelques minutes pour prendre effet.
  3. Dans Figma, sélectionnez un composant ou une image et copiez son lien. Le lien comprend un élément node-id qui identifie votre sélection.
  4. Dans la console, envoyez une invite avec le lien, telle que « Mettez à jour le bloc de teaser pour qu’il corresponde à ce composant Figma : {Figma link}. Réutilisez nos jetons de conception existants. »

À savoir :

  • Un composant ou image à la fois. L’agent crée un bloc à partir d’un composant ou une page à partir d’un cadre. Vérifiez chaque résultat avant d’envoyer le lien suivant. Voir Créer un bloc à partir de Figma et Créer une page à partir de Figma.
  • Votre jeton, vos fichiers. Le jeton d’accès personnel lit chaque fichier Figma que vous pouvez ouvrir, et rien d’autre. La Figma la délivre et en fixe les limites. Chaque personne stocke son propre jeton. Cela n’a rien à voir avec les jetons de conception, les couleurs et l’espacement que l’agent lit à partir de la conception.
  • Votre place Figma. Vous avez besoin d’un siège Dev ou Full Figma ; voir Figma and Design Systems. Si la console signale une erreur d’API Figma avec l’état 429, le jeton a atteint la limite de débit de Figma 🔗.
  • Le module complémentaire. L’importation Figma est une fonctionnalité facultative. S’il n’est pas activé pour votre projet, l’agent vous propose de l’activer.
  • Jetons de conception. Comparez les nouveaux jetons avec les jetons existants. Lorsqu’une valeur Figma ne diffère que légèrement d’un jeton existant, décidez lequel conserver plutôt que de conserver les deux.

Pour connaître les éléments approuvés par votre organisation avant que les utilisateurs n’utilisent Figma avec l’agent, consultez Figma et systèmes de conception.

Effectuer votre premier changement first-change

  1. Ouvrez une page dans le panneau d’aperçu de la console.
  2. Dans le menu Fenêtre d’affichage, choisissez la largeur à vérifier : Bureau, Tablette ou Mobile.
  3. Activez le mode d’inspection avec l’icône de sélection dans le panneau d’aperçu.
  4. Sélectionnez l’élément à modifier, tel qu’un en-tête, une image ou un bouton. L’élément est ajouté à votre invite : l’agent reçoit son HTML et sa position sur la page, et limite ses modifications à cet élément.
  5. Décrivez la modification et l’étendue de la portée, puis envoyez l’invite. Par exemple : « Faites en sorte que ce bouton utilise notre style principal, ici et sur chaque page. »
  6. Une fois l’agent terminé, sélectionnez Actualiser l’aperçu si l’aperçu n’a pas été mis à jour. Vérifiez le résultat à chaque taille de Viewport.
  7. Si quelque chose ne fonctionne pas correctement, dites ce que vous voyez, par exemple « Sur mobile, le texte touche l’image ». Demandez une modification à la fois et vérifiez-la avant de demander la suivante.

Pour annuler une modification, demandez à l’agent de l’annuler. Pour déposer toutes les modifications non transmises dans un fichier, ouvrez la vue Modifications et sélectionnez Ignorer en regard du fichier. Voir Actions De Modifications.

Si l’agent n’obtient toujours pas de modification juste après quelques tentatives, demandez à votre développeur ou sélectionnez Demande d’assistance dans la barre de menus et décrivez ce que vous avez demandé et ce que vous voyez. Votre demande parvient à l’équipe qui crée l’agent. Lorsqu’une conversation ne se passe pas bien, la console peut également offrir de l’aide sous Besoin d’un coup de main ? Voir Demande D’Assistance.

Exemples d’invites example-prompts

  • « Faites en sorte que tous les en-têtes utilisent la police d’en-tête du guide de style joint. »
  • « Donnez aux cartes du bloc de cartes une hauteur égale, avec leurs boutons alignés en bas. »
  • « Ajoutez une variante dark du bloc de teaser avec du texte blanc sur la couleur sombre de votre marque et appliquez-la au deuxième teaser sur /adventures. »
  • « Ajoutez un style de section highlight avec un arrière-plan clair et plus d’espace au-dessus et en dessous, et utilisez-le pour la section newsletter de la page d’accueil. »
  • « Sur mobile, empilez les colonnes et placez l’image au-dessus du texte. »
  • « Quelles pages de mon espace de travail utilisent le bloc principal ? Montrez-moi comment chacun s’occupe de ce changement. »
  • « Écrivez les styles de bouton sur lesquels nous nous sommes mis d’accord dans les fichiers d’instructions du projet. »

Vérifier Avant De Remettre check

  • Vérifiez chaque taille de Viewport, en particulier Mobile.
  • Vérifiez d’autres pages qui utilisent le même bloc, le même style ou le même modèle, et pas seulement la page sur laquelle vous avez travaillé.
  • Vérifiez comment la conception gère le contenu réel : titres longs, courts, images manquantes et listes comportant de nombreux éléments.
  • Vérifiez que le texte reste lisible sur son arrière-plan. Vous pouvez demander à l’agent : « Vérifiez le contraste des couleurs du texte dans le bloc de teaser par rapport à WCAG AA. »
  • Une fois que vous avez envoyé une notification push, ouvrez les URL d’aperçu répertoriées dans la demande d’extraction et vérifiez les pages qu’elles contiennent. Voir La prévisualisation de la console diffère de celle du site.

Remise pour révision hand-over

  1. Envoyez votre code push avec Créez un PR, comme décrit dans la section Modifications du code push. Préparez uniquement les fichiers qui appartiennent à votre modification et décrivez-les en une phrase simple, comme « Coins arrondis et ombre pour les cartes ».
  2. Sélectionnez Afficher PR dans la notification et envoyez le lien de la demande d’extraction au développeur qui la révise.

Pour apporter les modifications demandées par le réviseur, continuez à travailler sur la même branche et effectuez une notification push avec Notification push sur la branche actuelle ; la demande d’extraction est mise à jour.

Votre modification atteint le site actif lorsque le développeur la fusionne. Si vous avez également modifié du texte ou des images sur une page, il s’agit d’un changement de contenu : la page n’atteint le site que lorsque la page est chargée et publiée. Je suis d’accord avec les auteurs qui font cela. Voir Coordination Des Modifications De Contenu.

Mots utilisés dans ce guide glossary

Terme
Signification
Bloc
Composant d’une page, tel que des cartes, un teaser ou un carrousel. Chaque bloc possède son propre CSS et son propre JavaScript.
Bloquer la variante
Autre aspect d’un bloc, que les auteurs choisissent en ajoutant un nom entre parenthèses, tel que Cartes (sombres).
Contenu par défaut
En-têtes, texte, listes, images et liens qui ne se trouvent pas dans un bloc.
Section
Partie d’une page qui regroupe des blocs et du contenu par défaut. Les auteurs peuvent donner un style à une section dans ses métadonnées de section.
Modèle
Type de page, tel qu’un article ou une page produit, nommé dans les métadonnées de la page.
Jeton de conception
Valeur nommée pour une couleur, une police ou un espacement, stockée en tant que propriété personnalisée CSS, telle que --link-color.
Branche
Une ligne de travail distincte dans le référentiel Git. Le site actif utilise la branche main.
Demande d’extraction
Demande de fusion de votre branche dans une autre branche, examinée par un développeur avant fusion.
Prévisualisation
Le rendu de votre espace de travail par la console. Une fois la notification push effectuée, chaque branche possède également sa propre URL d’aperçu.

Les sections, les blocs et le contenu par défaut sont expliqués plus en détail sous Façonner la structure de contenu.

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