Prompting Guide for Experience Modernization Agent prompting-guide
Der Experience Modernization Agent arbeitet von Anfragen in natürlicher Sprache. Für jede Art von Aufgabe, z. B. das Migrieren einer Seite oder das Formatieren eines Blocks, folgt dies einem integrierten Workflow, der als Qualifikation bezeichnet wird. Es wählt die Qualifikation aus Ihrer Anfrage aus, sodass Sie sie nicht benennen müssen. Einige Fähigkeiten gehören zu optionalen Funktionen die der Agent für Ihr Projekt aktivieren kann, wenn eine Anfrage sie benötigt.
In diesem Handbuch finden Sie Beispielaufforderungen in der Reihenfolge, in der Sie sie verwenden: planen, migrieren, überprüfen, skalieren und entwickeln. Befolgen Sie Produktionsstandort migrieren, um das vollständige Migrationsprozedere anzuzeigen. Abschnitte, Standardinhalte, Blöcke und Varianten werden unter " der Inhaltsstruktur“ . Ersetzen Sie die Beispiel-URLs und -Pfade in den Eingabeaufforderungen durch Ihre eigenen.
Agentenkontext angeben context
Der Agent kennt Edge Delivery Services und liest den Code Ihres Projekts. Es kennt nicht Ihr Unternehmen, Ihre Markenregeln oder die anderen Systeme, mit denen Ihre Site arbeitet, bis Sie es sagen, und jede Anfrage mit dem richtigen Kontext speichert eine Reihe von Korrekturen. Geben Sie frei, was die Aufgabe benötigt:
- Das Ziel und wie es zu überprüfen ist was Sie wollen, für wen und wie das fertige Ergebnis aussieht.
- Umfang und Ziel: die Quellseiten oder -designs, die Zielpfade, wo der Inhalt gespeichert ist, das Repository und die Verzweigung, was sich nicht ändern darf und ob der Agent hochladen, pushen oder veröffentlichen darf.
- Anforderungen: Spezifikationen sowie Marken- und Barrierefreiheitsregeln.
- Beispiele Eine Seite, die bereits gut aussieht, ein Screenshot, ein Figma-Link oder eine Beispiel-API-Antwort.
- Dokumentation Ein Link zur öffentlichen Dokumentation, die der Agent im Internet liest, oder zu den Dokumenten selbst, wenn sie angemeldet werden müssen. Dateien anhängen akzeptiert keine PDF-Dateien. Kopieren Sie daher den entsprechenden Text aus diesen Dateien. Siehe Eingabeaufforderung.
- Bereits getroffene Entscheidungen: Behalten Sie vereinbarte Konventionen in
AGENTS.mdund die darin aufgelisteten Dateien bei, damit Sie sie nicht in jeder Anfrage wiederholen. Siehe Projektanweisungen und -speicher.
Teilen Sie, was die Aufgabe benötigt, anstatt alles, was Sie haben, und befolgen Sie die Richtlinien Ihrer Organisation, was in KI-Tools gehen kann.
Stellen Sie auch Fragen zu Edge Delivery Services-Konzepten, zum Code Ihres Projekts und zu den Zielkonflikten zwischen den Ansätzen. Wenn Sie sich nicht sicher sind, wie Sie etwas tun sollen, fragen Sie, wie es in Edge Delivery Services geschieht, bevor Sie den Agenten darum bitten, es zu tun, oder wechseln Sie in den Plan-Modus, um den Ansatz zu überprüfen. Bitten Sie den Agenten, seine Fragen und Annahmen aufzulisten: Sie zu beantworten ist schneller, als das Ergebnis zu korrigieren.
Geheimnisse aus dem Chat fernhalten secrets
Der Chat ist kein sicherer Ort für ein Geheimnis. Alles, was Sie eingeben oder anhängen, wird an das KI-Modell gesendet und in der Konversation beibehalten. Der Agent behandelt sie wie jeden anderen Text: Er kann einen Wert in eine Datei Ihres Projekts kopieren, z. B. ein Skript oder eine Konfigurationsdatei. Sobald diese Datei gepusht wurde, bleibt der Wert im Verlauf des Repositorys, und alles im Repository wird an die Browser der Besucher Ihrer Site übermittelt. Anmeldeinformationen, die Sie unter Einstellungen eingeben, erreichen den Agenten nie. Siehe Anmeldeinformationen.
Bewahren Sie diese außerhalb des Chats, außerhalb von Anhängen und außerhalb von Projektdateien auf:
- Kennwörter, einschließlich der Kennwörter von Testkonten und des eigenen Adobe ID- oder Git-Kontos
- API-Schlüssel, Zugriffstoken und persönliche Zugriffstoken
- Private Schlüssel und Zertifikate
- Verbindungszeichenfolgen, Sitzungs-Cookies und Links, die eigenständig Zugriff gewähren, z. B. signierte URLs
- Der Inhalt
.envDateien und andere Konfigurationen, die geheime Daten enthalten - Personenbezogene Daten von echten Kunden oder Mitarbeitern; verwenden Sie stattdessen konfektionierte Beispieldaten
- Alles andere, was die Richtlinie Ihrer Organisation von KI-Tools fernhält
Bevor Sie einen Screenshot, ein Protokoll, eine exportierte Datei oder eine Fehlermeldung anhängen, überprüfen Sie diese und maskieren Sie sie.
Wohin die Anmeldeinformationen stattdessen gehen credential-settings
Wenn eine Aufgabe einen Schlüssel benötigt, fügen Sie ihn nicht ein, um die Aufgabe zu erledigen. Geben Sie an der Stelle ein, an der die Tabelle steht, und geben Sie dem Agenten eine Sandbox oder einen Test-Endpunkt anstelle eines Produktions-Endpunkts.
Wenn Sie geheime Daten freigegeben haben secret-shared
- Widerrufen oder ersetzen Sie das Geheimnis bei dem Dienst, der es ausgegeben hat, sofort. Wenn Sie den Chat löschen, wird nicht das zurückgenommen, was bereits gesendet wurde. Die Transkripte der Sitzungen des Agenten behalten dies, bis Sie den Arbeitsbereich zurücksetzen.
- Überprüfen Sie die Änderungen auf Dateien, die die geheimen Daten enthalten, und verwerfen Sie diese Änderungen, bevor Sie den Push durchführen.
- Wenn eine Datei mit den geheimen Daten bereits gepusht wurde, ist das Ersetzen der geheimen Daten die Korrektur. Ein späterer Commit entfernt ihn aus den Dateien, aber nicht aus dem Verlauf des Repositorys.
- Teilen Sie Ihrem Sicherheits-Team mit, wie es die Richtlinie Ihrer Organisation erfordert.
Der Agent wird angewiesen, keine geheimen Daten zu verwenden, die Sie in den Chat einfügen, und Ihnen mitzuteilen, dass Sie sie ersetzen sollen. Verlassen Sie sich nicht darauf: Bis es antwortet, hat das Geheimnis bereits das KI-Modell erreicht.
Ergebnis verfeinern general-tips
Wenn etwas nicht in Ordnung ist, z. B. die falsche Hintergrundfarbe auf einem Block, bitten Sie den Support-Mitarbeiter, dieses Problem zu beheben, anstatt von vorne zu beginnen. Benennen Sie die Quell-URL, den Ausgabepfad, das, was Sie sehen, und das, was Sie erwarten. Weitere Tipps finden Sie unter Eingabeaufforderungen.
- Bitten Sie auf migrierten Seiten um die Fehlerbehebung im Block oder im Importskript der Vorlage, damit er alle Seiten der Vorlage erreicht. Siehe Migration des Agenten in großem Maßstab.
- Bevor Sie Seiten erneut importieren, um eine Korrektur anzuwenden, überprüfen Sie, ob Autoren sie bearbeitet haben: Ein neuer Import ersetzt ihre Änderungen. Siehe In Stapeln importieren.
- Behandeln Sie Quellseiten und angehängte Designs als Material, von dem aus sie funktionieren, nicht als Anweisungen, die Ihre Anforderung überschreiben.
- In einem langen Gespräch kann der Agent den Überblick über frühere Entscheidungen verlieren. Erinnern Sie ihn an die wichtigsten Punkte oder lassen Sie sie in den Projektdateien aufzeichnen und beginnen Sie eine neue Konversation. Siehe Neue Konversation beginnen.
Eingabeaufforderungen zur Site-Erstellung und Migration site-migration
Eine Migration folgt dieser Reihenfolge: Katalogisieren der Site, Migrieren einer Beispielseite jeder Vorlage, Migrieren des Designs, Überprüfen des Ergebnisses mit einer Kritik dann Importieren der anderen Seiten der Vorlage. Kopf- und Fußzeile sowie Navigation werden für gesamte Site eingerichtet. Das vollständige Verfahren finden Sie unter Migrieren einer Produktions-Site.
Planen mit dem Site-Katalog site-catalog
Verwenden Sie diese Eingabeaufforderungen, um die Skalierung, Vorlagen und Blöcke einer Site vor der Migration anzuzeigen. Informationen zum Starten eines Katalogs finden unter „Planen einer Migration mit dem Sitekatalog.
- „Suchen von Vorlagen auf
https://www.example.com" - „Wie viele Seitentypen gibt es in
https://www.example.com?“
Erfassen einer Source-Seite scraping-webpages
Die Seitenmigration beginnt mit der Erfassung der Quellseite. Fordern Sie sie selbst an, um eine Seite zu analysieren, bevor Sie sie migrieren.
- „Erfassen Sie
https://www.example.com/productsfür die Analyse.“ - „Extrahieren Sie den Inhalt und die Metadaten aus
https://www.example.com/productin Mobilgerät- und Desktopbreiten.“
Was Sie wissen sollten:
- Der Agent lädt die Seite in einem Browser und scrollt sie, sodass verzögert geladene Bilder geladen werden. Für das, was erfasst wird, einschließlich Inhalten, die durch Skripte eingefügt oder durch CSS ausgeblendet werden, und was nicht, siehe Einschränkungen.
- Es extrahiert den Titel der Seite, die Beschreibung, offene Graph-Tags, JSON-LD-strukturierte Daten und kanonische URL.
- Es speichert einen Screenshot und Kopien der Bilder und normalisiert Links und Bildverweise. Vergleichen Sie die Bilder mit der Quelle, einschließlich responsiver Bilder, Hintergründe und SVG-Bilder, und stellen Sie sicher, dass jeder Link weiterhin auf die gewünschte Position verweist.
- Fragen Sie nach einer bestimmten Bildschirmbreite, z. B. für Mobilgeräte oder Desktops. Jede zusätzliche Breite dauert länger.
Migrieren von Seiten migrate-a-site
Verwenden Sie diese Eingabeaufforderungen, um Seiten aus einer vorhandenen Website zu importieren. Informationen zum schrittweisen Importieren einer ersten Seite finden Sie unter Schritt für Schritt importieren oder für in Experience Manager Authoring gespeicherte Inhalte Verbinden der Site und Importieren einer Seite.
- „Migrieren Sie diese Seiten:
https://www.example.com/products/hiking,https://www.example.com/products/climbing. Vorhandene Blöcke wiederverwenden. Nicht hochladen, pushen oder veröffentlichen.“
Was Sie wissen sollten:
- Der Agent entscheidet über die Abschnitte, Standardinhalte, Blöcke und Varianten jeder Seite und verwendet die Blöcke des Projekts, bevor neue erstellt werden. Überprüfen Sie diese Struktur auf den ersten Seiten: Autoren bearbeiten sie, und der Massenimport wiederholt sie. Siehe Gestalten der Inhaltsstruktur.
- Inhalt und Design sind separate Schritte. Nach dem Inhaltsimport empfiehlt der Agent Design-Migration starten: Wählen Sie diese aus oder fragen Sie nach dem Quellstil. Ein neues Design finden Sie unter Neuformatierung während der Migration.
- Beim Seitenimport werden Kopf- und Fußzeile sowie Navigation weggelassen. Siehe Einrichten von Kopf-, Navigations- und Fußzeile.
- Bei jeder Migration wird ein Importskript für die Vorlage der Seite geschrieben, das Massenimport auf den anderen Seiten der Vorlage ausgeführt wird.
- Informationen dazu, wohin Bilder gehen, einschließlich Bilder, die von Dynamic Media bereitgestellt werden, finden Sie unter Bilder und Dokumente.
Migrieren des Designs design-migration
Verwenden Sie diese Eingabeaufforderungen, um das Design der Quell-Site für den importierten Inhalt neu zu erstellen.
- „Migrieren des Designs aus
https://www.example.com" - „Design-Token extrahieren“
- „Den Heldenblock gestalten“
- „Alle Blöcke formatieren“
Was Sie wissen sollten:
- Der Agent formatiert zuerst die gesamte Site. Die Design-Token wie Schriftarten, Farben, Abstände und Überschriftengrößen werden als benutzerdefinierte CSS-Eigenschaften in
styles/brand.cssgeschrieben.styles/styles.cssimportiert diese Datei und formatiert den Standardinhalt: Überschriften, Absätze, Schaltflächen, Links und Abschnittshintergründe. - Dann werden die Blöcke parallel, jeweils in
blocks/{name}/{name}.css, aus den Token formatiert. Block-Stile benötigen daher zuerst die Site-weiten Stile. - Wenn das Projekt bereits über eine
brand.cssoder andere Token-Dateien verfügt, bitten Sie den Agenten, diese zu verwenden, anstatt einen zweiten Satz aus der Quelle zu extrahieren. - Geben Sie an, ob die Anfrage global oder für einen Block ist und ob sie der Quelle treu bleiben oder einem " Design“ soll. Überprüfen Sie das Ergebnis auf echten Seiten auf Desktop- und Mobilgerätebreiten.
Wie nah das Design kommt design-fidelity
Der Agent erstellt das Quelldesign neu: Er extrahiert die Design-Token, formatiert jeden Block, vergleicht dann jeden Block mit der Quelle und behebt die Unterschiede, die er findet. Siehe Kritik an der Site. Das Ergebnis kommt beim ersten Durchlauf dem Original nahe, und Sie korrigieren, was übrig bleibt, indem Sie eine Eingabeaufforderung eingeben.
Eine identische Kopie kann nicht garantiert werden. Schriftarten, Bildkomprimierung und Browser-Rendering können sich geringfügig von der Quelle unterscheiden. „identisch“ bedeutet unterschiedliche Dinge für verschiedene Projekte: Ein Team misst den Abstand zum Pixel, ein anderes überprüft, ob die Marke dasselbe liest. Die Quelle weist auch ihre eigenen Fehler auf, z. B. den Abstand zwischen zwei Seiten derselben Vorlage, und ihre Neuerstellung hilft der neuen Site nur selten.
Ziel für das beabsichtigte Design:
- Beschreiben Sie jeden verbleibenden Unterschied mit der Seite, der Bildschirmbreite und den Änderungen und überprüfen Sie das Ergebnis in der Vorschau. Ein komplexes Design kann mehrere Runden dauern.
- Korrigieren Sie einen Unterschied, der in den globalen Stilen oder im CSS des Blocks wiederkehrt, sodass die Korrektur für jede Seite gilt.
- Bevor Sie skalieren, stimmen Sie den Personen zu, die die Website abmelden, was als nahe genug zählt, und überprüfen Sie sie auf den Beispielseiten.
Erstellen eines Bausteins aus Figma figma-block-migration
Verwenden Sie diese Eingabeaufforderungen, um einen Block aus einer Figmakomponente zu erstellen. Work from a Figma Design behandelt das Zugriffstoken, den benötigten Platz und warum jeweils eine Komponente verwendet werden sollte.
- „Erstellen Sie einen Block aus dieser Figma-Komponente:
{Figma link}. Verwenden Sie unsere Design-Token wieder.“ - „Migrieren Sie die
pricing-cardaus der Figma-{fileKey}.“
Was Sie wissen sollten:
- Wählen Sie in Figma die Komponente aus und kopieren Sie ihren Link, sodass der Link die
node-identhält, die sie identifiziert:https://www.figma.com/design/{fileKey}?node-id={nodeId}. Oder geben Sie den Dateischlüssel und den Namen der Komponente an. - Der Agent liest zuerst die Komponentenstruktur, wodurch große Figma-Dateien überschaubar bleiben, und dann die Designdetails. Dabei werden die Farben, die Typografie und der Abstand als Design-Token zu
styles/styles.csshinzugefügt, wobei die Token für den Block spezifisch sind, bevor CSS geschrieben wird. Dabei wird die Komponente dem nächstgelegenen Block im Projekt zugeordnet und eine Variante erstellt. Außerdem wird das CSS der Variante aus den Token geschrieben, die Bilder und Symbole im Konsolenarbeitsbereich gespeichert und Beispielinhalte erstellt. Anschließend wird der Block in der Vorschau angezeigt und mit dem Figma-Design verglichen.
Redesign mit Blöcken von Figma figma-redesign-migration
Verwenden Sie diese Eingabeaufforderungen, wenn eine Site während der Migration ein neues Design erhält: Figma liefert das Design und die Blöcke, und die Live-Site liefert den Inhalt. Informationen zum Verfahren und zu Vergleichsmöglichkeiten finden Sie unter Neuformatierung während der Migration.
- „Erstellen Sie die Blocksammlung aus diesen Figma-Komponenten:
{Figma link}" - „Migrieren Sie diese Seiten und ordnen Sie ihren Inhalt den aus Figma erstellten Blöcken zu:
https://www.example.com/adventures,https://www.example.com/magazine"
Fordern Sie nur dann eine neue Variante an, wenn die Blöcke aus Figma nicht den Quellinhalt darstellen können.
Erstellen einer neuen Seite aus Figma figma-new-page-from-figma
Verwenden Sie diese Eingabeaufforderung, wenn eine Seite nicht auf einer Quell-Site vorhanden ist und ein Figma-Frame oder eine Figma-Seite eine neue Seite werden soll.
- „Migrieren Sie diese Figma-Seite auf eine neue Seite unter
/events:{Figma link}"
Was Sie wissen sollten:
- Wählen Sie einen Frame oder eine Seite aus, nicht eine gesamte Datei, und ordnen Sie sie in leeren Seitenabschnitten an.
- Der Agent ordnet jeden Abschnitt einem vorhandenen Block, Standardinhalt oder einer neuen Variante zu. Text und Bilder stammen aus Figma.
- Ein Figurenrahmen zeigt an, wie ein Objekt aussieht, nicht wo seine Daten herkommen oder wie es sich verhält. Bei Such-, Rechner-, Personalisierungs- oder Store-Locators erstellt die Figma-Migration das Layout. Bitten Sie dann den Agenten, das Verhalten als dynamischen Block zu erstellen und ihm die API oder Datenquelle zu geben.
Einrichten von Kopf- und Fußzeile navigation-setup
Verwenden Sie diese Eingabeaufforderungen für die Kopf- und Navigationsleiste sowie die Fußzeile, einschließlich der Fußzeilenbilder. Beim Seitenimport bleiben sie unberücksichtigt, da jede Seite eine Kopf- und eine Fußzeile gemeinsam hat.
- „Einrichten der Navigation von
https://www.example.comaus“ - „Fußzeile aus
https://www.example.commigrieren“ - „Reparieren des Navigationsmenüs“
Was Sie bei Projekten wissen sollten, die die Kopf- und Fußzeile des AEM-Textbausteins verwenden:
- Die Kopfzeile lädt die
navSeite aus dem Inhaltsstamm, und die Fußzeile lädt diefooterSeite, es sei denn, dienavoderfooterMetadaten einer Seite benennen eine andere Seite. In dokumentbasierten Projekten schreibt der Agent die Navigation wienav.mdin den Arbeitsbereich der Konsole. - Die Navigationsseite besteht aus drei durch
---getrennten Bereichen: der Marke mit dem Logo und dem Link zur Startseite, dem Hauptmenü und Tools wie Links zum Anmelden oder Abonnieren. - Ein Menüelement, das eine verschachtelte Liste enthält, wird zu einem Dropdown-Menü.
- Ein fett oder kursiv gedruckter Link allein in seinem Absatz wird wie auf anderen Seiten zu einer Schaltfläche, mit Ausnahme des Marken-Links: Die Kopfzeile entfernt die Schaltflächenformatierung. Siehe Beispiel: Ein flexibler Teaser ohne Atomblöcke.
- Wenn das Projekt
header.jsoderfooter.jsgeändert wurde, bitten Sie den Agenten, diese zuerst zu überprüfen. - Bestätigen Sie beim Experience Manager-Authoring, wo die Navigationsseite gespeichert ist und welches Modell verwendet wird.
Kritik an der Website site-critique
Verwenden Sie diese Eingabeaufforderungen nach der Designmigration, um jede migrierte Vorlage mit der Quelle zu vergleichen und die Unterschiede in einem Schritt zu beheben.
- „Kritikstelle“
- „Validieren aller Blöcke auf der migrierten Site“
Was Sie wissen sollten:
- Strukturelle Unterschiede, z. B. eine fehlende Überschrift oder ein fehlender Link oder eine falsche Anzahl von Zeilen, werden im Importskript korrigiert, und die Seiten werden erneut importiert. Stilunterschiede wie Farben, Abstände und Typografie werden in der CSS-Datei festgelegt.
- Der Agent arbeitet Schicht für Schicht: globale Stile, dann Abschnitte, dann Inhalte blockieren, dann CSS blockieren. Das Ergebnis wird nach jeder Ebene erneut überprüft.
- Wenn dasselbe Problem auf mehreren Seiten auftritt, die denselben -Block verwenden, behebt der Agent den -Block einmal für alle Seiten.
- Ohne
brand.cssfixiert der Agent nur die Struktur. - Die Kritik vergleicht, wie die Seiten aussehen. Überprüfen Sie separat, ob Autorinnen und Autoren sie bearbeiten können, ob Interaktionen funktionieren und ob sie zugänglich sind. Siehe Einschränkungen. Überprüfen Sie die Berichterstattung und die ungelösten Probleme, von denen die Kritik berichtet.
Kritik einer Seite page-critique
Verwenden Sie diese Eingabeaufforderungen, um eine migrierte Seite zu überprüfen, z. B. nach einer Site-Kritik.
- „Kritik an der Seite“
- „Validieren der migrierten
/aboutanhand vonhttps://www.example.com/about"
Der Agent benötigt die Quell-URL und den migrierten Pfad und arbeitet über dieselben Ebenen wie die Site-Kritik. Überprüfen Sie die verbleibenden Unterschiede in der Vorschau.
Block kritisieren block-critique
Verwenden Sie diese Eingabeaufforderungen, um einen Block nach der Designmigration zu überprüfen.
- „Kritik am Heldenblock“
- „Block mit benutzerdefinierten Karten validieren“
Der Block muss von einer Seitenmigration stammen. Der Agent repariert es wie in der Site-Kritik.
Seiten in Massen importieren bulk-import
Verwenden Sie diese Eingabeaufforderungen, um die anderen Seiten einer Vorlage zu importieren, sobald die Beispielseite migriert und überprüft wurde.
- „Führen Sie den Massenimport auf diesen Seiten aus:
https://www.example.com/blog/first-post,https://www.example.com/blog/second-post.“ - „Massenimport aller Produktseiten.“
Was Sie wissen sollten:
- Beim Massenimport wird das Importskript ausgeführt, das der Agent beim Migrieren der Beispielseite der Vorlage geschrieben hat. Migrieren Sie diese Seite daher zuerst. Siehe Migration des Agenten in großem Maßstab.
- Jede Ausführung deckt die Seiten einer Vorlage ab, da das Importskript für die Struktur dieser Vorlage geschrieben wird.
- Importieren Sie zuerst einige Seiten, überprüfen Sie diese und korrigieren Sie das Importskript, bevor Sie die vollständige Liste importieren. Siehe In Batches importieren und Massenimport-Workflow.
Eingabeaufforderungen für Entwicklung blockieren block-development-capabilities
Diese Eingabeaufforderungen erstellen und ändern Blöcke während der Migration oder in einem beliebigen Projekt. Die Verfahren und Prüfungen finden Sie unter Erstellen, Aktualisieren und Refaktorieren von Blöcken.
Entwerfen eines Inhaltsmodells content-modeling
Verwenden Sie diese Eingabeaufforderungen, um die Tabelle zu entwerfen, die Autoren für einen Block ausfüllen. Die inhaltsgesteuerte Entwicklung führt diesen Schritt aus, wenn sie einen Block erstellt. Fordern Sie ihn selbst an, um die Optionen zu vergleichen.
- „Gestalten eines Inhaltsmodells für einen Bericht-Block“
- „Was ist das beste Inhaltsmodell für dieses Karussell?“
Was Sie wissen sollten:
-
Vier Muster decken die meisten Blöcke ab:
- Eigenständig: ein einzelnes Element in einer Tabelle, z. B. ein Held oder ein Zitat.
- Sammlung Wiederholte Elemente wie Karten oder Karussellfolien, mit einer Zeile pro Element.
- Konfiguration: ein Block, dessen Inhalt von einer API oder Datenquelle stammt, z. B. eine Blog-Liste oder Suchergebnisse, mit Schlüsselwertzeilen, die steuern, was er anzeigt. Siehe Dynamischen Block erstellen.
- Automatisch blockiert: Inhalte, die Autorinnen und Autoren als Abschnitte oder Standardinhalte schreiben und die der Code in einen Block umwandelt, z. B. Registerkarten oder YouTube-Einbettungen.
-
Lassen Sie jede Tabelle auf ein paar Zellen beschränken und gruppieren Sie verwandte Elemente auf natürliche Weise, damit Autoren sie ausfüllen können. Dies ist für Autoren gedacht: Block-Code kann jede Tabellenstruktur lesen.
-
Aus Gründen der Stilunterschiede sollten Blockvarianten gegenüber Konfigurationszellen bevorzugt werden.
-
Akzeptieren Sie eine flexible Eingabe Postel’s Law: Ein Hero-Block sollte funktionieren, unabhängig davon, ob sein Inhalt in einer Zelle, in zwei Zellen oder in separaten Zeilen enthalten ist.
-
Für das Authoring mit Experience Manager benötigt der Baustein außerdem ein Modell für den universellen Editor. Siehe Erstellen eines Blocks.
Suchen nach Referenzblöcken reference-blocks
Verwenden Sie diese Eingabeaufforderungen, um bestehende Implementierungen zu finden, von denen aus Sie beginnen können.
- „Suchen von Blöcken, die einer Preistabelle ähneln“
- „Welche Blöcke stehen für Testimonials zur Verfügung?“
- „Block-Party nach einer Registerkarten-Implementierung durchsuchen“
Was Sie wissen sollten:
- Beginnen Sie mit der Blocksammlung. Adobe verwaltet sie und prüft jeden Block auf Inhaltsmodellierung, Leistung und Barrierefreiheit. Es deckt häufig benötigte Blöcke ab.
- Wenn es nicht das hat, was Sie brauchen, durchsuchen Sie die Blockparty. Die Community unterhält sie mit einem breiteren Spektrum, das experimentelle Ansätze, Plug-ins für AEM Sidekick, Build-Tools und Integrationen umfasst. Gibt nur genehmigte Einträge zurück. AEM Sidekick ist die Browser-Erweiterung, die eine Vorschau von Seiten anzeigt und Seiten veröffentlicht.
- Suchen Sie auch mit anderen Namen: Akkordeon für FAQ, Karussell oder Diashow für Galerie, Menü oder Kopfzeile für die Navigation.
Entwickeln eines Bausteins block-development
Verwenden Sie diese Eingabeaufforderungen, um einen Block zu erstellen oder einen vorhandenen zu ändern.
- „Erstellen eines Blocks für Empfehlungen“
- „Dem Hero-Block eine Video-Hintergrundvariante hinzufügen“
Was Sie wissen sollten:
- Der Agent erstellt Testinhalte zusammen mit dem Inhaltsmodell. Siehe Aufforderung für einen Block. Mit dem Testinhalt können Sie den Block überprüfen, der Pull-Anfrage eine Seite zuweisen, die mit PageSpeed Insights getestet werden soll, und Autoren zeigen, wie der Block verwendet wird.
- Bei einer Änderung nur an CSS überspringt der Agent das Inhaltsmodell, verwendet aber weiterhin Testinhalte, um das Ergebnis zu überprüfen.
- Bevor ein Block erstellt wird, wird nach einem gesucht, der wiederverwendet werden kann. Siehe Wiederverwenden vorhandener Blöcke.
Dokumentation durchsuchen searching-documentation
Verwenden Sie diese Eingabeaufforderungen, um Anleitungen zu Edge Delivery Services-Funktionen und -Implementierungen zu erhalten.
- „Wie lade ich Bilder in Edge Delivery Services verzögert?“
- „Dokumente nach Abschnittsmetadaten durchsuchen“
Der Agent durchsucht die Dokumentation und Blog-Beiträge auf aem.live. Verwenden Sie bestimmte Keywords wie „Blockdekoration“, „Sidekick-Plug-in“ oder „Metadaten“ anstelle allgemeiner Keywords wie „Website“ oder „Erstellen von Inhalten“. Damit der Code von beginnt, fragen Sie stattdessen nach Referenzblöcken. Überprüfen Sie anhand des Codes Ihres Projekts, wo sein Inhalt gespeichert ist, was er findet.
Änderungen testen testing
Verwenden Sie diese Eingabeaufforderungen, um eine Änderung zu testen, bevor Sie eine Pull-Anfrage öffnen.
- „Testen des neuen Kartenblocks“
- „Führen Sie die Tests durch, bevor ich eine Pull-Anfrage öffne“
Der Agent schreibt einen Test, wenn sein Wert die Wartungskosten überschreitet. Es speichert Modultests für logiklastigen Code, z. B. Dienstprogramme, Datenverarbeitung und API-Integrationen, da sie schnell sind und Regressionen im wiederverwendeten Code erfassen. Browser-Prüfungen decken ab, wie ein Block die Seite, seine Interaktionen und sein Aussehen ändert. Informationen dazu, was vor einer Pull-Anfrage zu überprüfen ist, finden Sie unter Validieren und Bereitstellen.
Problem debuggen debugging
Verwenden Sie diese Eingabeaufforderungen, wenn ein Block, ein Bild, ein Stil oder die Vorschau nicht wie erwartet funktioniert. Für eingehendere Prüfungen kann der Agent die Fehlerbehebung bei Edge Delivery Services aktivieren optionale Funktion.
- „Debuggen, warum Bilder als „about“ angezeigt :error"
- „Den Hero-Block reparieren, der nicht gerendert wird“
- „Warum werden meine Änderungen nicht in der Vorschau angezeigt?“
Was Sie wissen sollten:
-
Der Agent überprüft die Quelldateien, die gerenderte Seite, den Blockcode und die Browser-Konsole in dieser Reihenfolge. Sie verwendet die Vorschau der Konsole, sodass Sie keinen lokalen Server ausführen müssen.
-
Häufige Ursachen:
- Bilder zeigen
about:error: JavaScript des Blocks ruftcreateOptimizedPicturenicht auf oder ruft ihn auf, bevor das Markup des Blocks neu strukturiert wird. - Ein Block wird nicht gerendert: Der Blockname im Inhalt stimmt nicht mit dem Ordner in
blocks/überein oder dem Ordner fehlt die.jsoder.css. - CSS wird nicht geladen Ein Dateipfad ist falsch. Überprüfen Sie die Registerkarte Netzwerk der Entwickler-Tools des Browsers.
- Eine Änderung wird nicht angezeigt: Siehe Eine Änderung fehlt und Konsolenvorschau unterscheidet sich von der Site.
- Bilder zeigen
-
Behalten Sie die fehlerhafte URL und die Fehlerdetails bei und versuchen Sie es erneut mit dem kleinsten betroffenen Bereich, nachdem Sie die Ursache behoben haben. Bevor Sie Arbeiten überschreiben oder zurücksetzen, lesen Sie Freigeben, Wiederherstellen und Übergeben.
Über Edge Delivery Services hinaus arbeiten beyond-eds
Die Fähigkeiten und Anweisungen des Agenten konzentrieren sich auf Edge Delivery Services: Migrieren von Seiten, Erstellen und Formatieren von Bausteinen und Befolgen der Konventionen des Projekts. Der Agent selbst ist ein Allzweck-Codierer, also ist er nicht auf sie beschränkt. Es kann Ihre Site mit einer Commerce-Plattform, einer Marketing-Automatisierungsplattform, einem Such- oder Zuordnungs-Service oder Ihren eigenen APIs verbinden, eine Anwendung anpassen, die Ihr Team mit React erstellt hat, oder den Code eines Server-seitigen Services schreiben, den Ihr Team bereitstellt. Was bei Integrationen mit anderen Codierern gut funktioniert, funktioniert auch hier: Dokumentation zuerst, Plan vor Code, kleine getestete Schritte und niedergeschriebene Entscheidungen.
Um herauszufinden, mit was eine Quell-Site integriert werden kann, bitten Sie den Agenten, die Dienste von Drittanbietern aufzulisten, die eine Beispielseite lädt, z. B. Analysen, Tag-Management, Einverständnis, Karten, Video, Chat, Suche und Formulare. Entscheiden Sie dann gemeinsam mit Ihrem Team, wie die einzelnen Komponenten auf der neuen Site funktionieren.
Bei anderen Systemen hat der Agent keine Fähigkeiten, sondern nur allgemeine Kenntnisse, die veraltet sein können. Die eigene Dokumentation des Systems macht die Arbeit zuverlässig. Arbeiten Sie sie daher gemeinsam aus:
- Lassen Sie die Dokumentation zuerst lesen. Geben Sie dem Agenten den Link zur Entwicklerdokumentation des Systems oder fügen Sie ihn bei. Bevor er Code schreibt, bitten Sie ihn, zu erklären, wie die Integration funktionieren würde, was auf einem Server ausgeführt werden muss und welche Geheimnisse betroffen sind. Korrigieren Sie in diesem Stadium sein Verständnis.
- Fragen Sie nach dem Edge Delivery Services-Weg. Fragen Sie, ob die Integration in einen Block, ein Widget oder die Skripte des Projekts gehört und wie die Seiten schnell gehalten werden. Der Agent schlägt einen Ansatz vor und fragt, was er wissen muss.
- Geben Sie dem System, was es benötigt Endpunkte, Feldnamen, Beispielanfragen und -antworten sowie eine Sandbox oder ein Testkonto. Einen Schlüssel, den der Agent benötigt, während er funktioniert, finden Sie unter Wohin Anmeldeinformationen stattdessen wechseln.
- In kleinen Schritten erstellen. Testen Sie jeden Schritt in der Vorschau mit einem Nicht-Produktions-Endpunkt.
- Erfassen Sie das Ergebnis. Bitten Sie den Agenten, den gewählten Ansatz und den Dokumentations-Link in die Anweisungsdateien des Projekts zu schreiben, damit die nächste Unterhaltung damit beginnt.
Beispiel:
Lesen Sie die Entwicklerdokumentation unseres Store-Locator-Service unter
https://developer.example.com/store-locator, insbesondere die Such-API. Erklären Sie, wie unsere Site die nächstgelegenen Geschäfte anzeigen könnte, indem Sie/storesfolgenden Edge Delivery Services-Übung befolgen: Was läuft im Browser, was benötigt einen Server und welche Geheimnisse betroffen sind. Listen Sie Ihre Fragen auf. Ändern Sie noch keine Dateien.
Ersetzen Sie den Beispiel-Service, die URL und den Pfad durch Ihre eigenen.
Das Einrichten des anderen Systems, das Bereitstellen eines Server-seitigen Dienstes und das Speichern seiner geheimen Daten bleiben bei Ihrem Team und den Systemadministratoren. Informationen zu Integrationsmustern finden Sie unter Verbinden von Services und Programmen.
Beispiel: Updates in Slack (Erweitert) slack-updates
Eine Berechtigung in Einstellungen, eine Projektqualifikation und eine Zeile in AGENTS.md können den Agenten mit den Tools verbinden, die Ihr Team bereits verwendet. Ein Entwickler des Teams, das den Agenten erstellt, hat ihn so eingerichtet, dass er jedes Mal, wenn er einen Zug beendet hat, eine Zusammenfassung in Slack veröffentlicht, mit dem, was er geändert hatte, und dass er dort seine Antworten als weitere Anweisungen liest. Er konnte einer langen Aufgabe folgen und sie lenken, ohne die Konsole offen zu halten.
- Erstellen Sie eine Slack-App, deren Bot-Token nur die Bereiche zum Posten und Lesen von Nachrichten enthält. Fügen Sie den Bot einem privaten Kanal hinzu oder verwenden Sie eine Direktnachricht.
- Fügen Sie Einstellungen > Authentifizierung für eine geschützte Site einen Eintrag für den Host-Namen hinzu, der mit der Bearer-Authentifizierung und dem Bot-Token
slack.comist. Siehe Anmeldedaten für andere Services. - Bitten Sie den Agenten, eine Projektqualifikation zu schreiben, die erklärt, wie Nachrichten mit der Slack-Web-API gepostet und gelesen werden, und sie zu pushen.
- Teilen Sie
AGENTS.mddem Agenten mit, dass eine Berechtigung fürslack.comeingerichtet ist, welcher Kanal verwendet werden soll und wann gepostet werden soll, z. B. am Ende jedes Zuges.
Der Agent behandelt, was er im Kanal liest, als Anweisungen und als Chat. Halten Sie den Kanal privat, sodass nur Sie und der Bot darin gespeichert sind, sodass nur Sie den Agenten anweisen können. Die veröffentlichten Zusammenfassungen verlassen die Konsole für Slack. Befolgen Sie daher die Richtlinien Ihrer Organisation, was dort getan werden darf. Entfernen Sie den Eintrag in Einstellungen wenn Sie ihn nicht mehr verwenden. Dasselbe Muster funktioniert für andere Tools mit einer HTTP-API, die eine feste -Kopfzeile akzeptiert.