Erste Schritte mit dem Experience Modernization Agent getting-started

Der Experience Modernization Agent erstellt und ändert Edge Delivery Services-Sites mit Ihnen. Sie beschreiben, was Sie in der Experience Modernization Console wünschen. Der Agent importiert Seiten, formatiert sie und schreibt den Code. Dieses Handbuch führt Sie vom Zugriff auf eine erste Seite, die Sie bearbeiten, in der Vorschau anzeigen und veröffentlichen können.

In Edge Delivery Services befindet sich der Code einer Site (Blöcke, Stile und Skripte) in einem Git-Repository und der Inhalt der Site wird in einer separaten Inhaltsquelle gespeichert, die von Autoren bearbeitet wird. Die Plattform kombiniert die beiden zu schnellen Seiten. Weitere Informationen finden Sie in der Platform - Übersicht.

In diesem Handbuch werden Inhalte im dokumentbasierten Inhalts-Repository gespeichert, wo sie von Autoren in Experience Workspace, der visuellen Authoring-Benutzeroberfläche für Edge Delivery Services, bearbeitet werden. Wenn Ihre Inhalte im JCR einer Adobe Experience Manager-Autoreninstanz bleiben müssen, befolgen Sie die Anleitung für das Experience Manager-Authoring für die verschiedenen Schritte. Um zwischen diesen beiden Optionen zu wählen, siehe Wo Inhalte gespeichert werden und Wie Autoren sie bearbeiten.

Der Auto-Modus verfügt über eine eigene Anmeldung. Informationen zum Konsolenzugriff und zu den Bedingungen, die gelten, wenn Sie mit Ihrer eigenen Site fortfahren, finden Sie unter Zugriff und KI-.

Mit eigenen Seiten beginnen first-outcome

Beginnen Sie unten mit dem Modus „Automatisch“, um einige Seiten zu migrieren, das Ergebnis zu überprüfen und es mit "erstellen“. Wenn Sie bereits über ein Projekt verfügen oder den Import von Anfang an leiten möchten, ​ Sie stattdessen von einem Repository ​: Erstellen Sie eines aus dem Textbaustein oder verbinden Sie Ihre vorhandene Site.

Beide Routen führen zu Ihrer Site, die in der Konsole verbunden ist. Von dort aus ​ Sie den Agenten ​ und dann Speichern, Vorschau anzeigen und ​. Da die Konsole gehostet wird, benötigt keine der Routen eine lokale Entwicklungsumgebung.

Wählen Sie vor dem Import einige Seiten einer Site aus, die Sie migrieren dürfen, einschließlich einer für jedes gemeinsame Layout, und entscheiden Sie, ob Sie das Quelldesign beibehalten oder ein neues anwenden möchten.

Mit Auto-Modus starten brand-trial

Der automatische Modus migriert eine Website oder eine Liste ihrer Seiten, ohne dass eine schrittweise Anleitung erfolgt. Im geführten Workflow stoppt der Agent nach jedem Schritt zur Überprüfung. Im Auto-Modus importiert er den Inhalt, migriert das Design, kritisiert das Ergebnis gegenüber der Quelle und verfeinert es so lange, bis seine Kritik die Seiten in der Nähe der Quelle findet.

Da der Auto-Modus seine eigene Arbeit überprüft und verfeinert, dauert er viel länger als ein geführter Import derselben Seiten, sodass er zu einem ersten Ergebnis passt, das Sie später erfassen. Sobald ein Durchlauf beginnt, werden Sie nicht mehr nach Ihren Eingaben gefragt: Sie steuern ihn nur durch den Umfang und die Optionen, die Sie vor dem Start auswählen. Der automatische Modus beginnt über die URL einer Website, nicht über ein Repository. Wenn sich Ihre Website bereits in Edge Delivery Services befindet, ​ Sie sie ​. Es erstellt dokumentbasierte Inhalte. Für im JCR gespeicherte Inhalte verwenden Sie das Handbuch für das Experience Manager-Authoring.

  1. Öffnen Sie Automatikmodus. Wenn Ihr Konto noch nicht existiert, wählen Sie Anmelden. Sie erhalten eine E-Mail, sobald Ihr Zugang verfügbar ist.

  2. Geben Sie Ihre Site-URL an oder wählen Sie ausgewählte Seiten aus und listen Sie deren URLs auf. Überprüfen Sie den Umfang, die Einstellungen und Beschränkungen die angezeigt werden, bevor Sie beginnen.

    • Geben Sie für eine geschützte Quell-Site Anmeldeinformationen in die Authentifizierungsfelder ein, die der Auto-Modus bietet, nicht im Chat.
    • Wenn der Auto-Modus Integrationen einschließen bietet, wählen Sie diesen aus, um unterstützte Integrationseinstellungen von der Quell-Site wie Analytics, Tag-Manager und Einverständniseinstellungen zu übernehmen. Sie bleiben auf der neuen Website deaktiviert, bis Sie sie aktivieren.
  3. Startet den Lauf. Ein Durchlauf kann bis zu 24 Stunden dauern. Sie können die Seite verlassen; Sie erhalten eine E-Mail, wenn der Durchlauf abgeschlossen ist. Wenn die E-Mail nicht ankommt, überprüfen Sie Ihren Spam-Ordner.

  4. Überprüfen Sie, welche Seiten migriert wurden, und überprüfen Sie deren Inhalt, Links, Bilder und Stile. Die Ausführung zeigt außerdem Vorschau, Repository, Bericht und Fehler an. Links zu Seiten, die der Benutzer nicht migriert hat, können weiterhin auf die Quell-Site verweisen.

  5. Öffnen Sie die resultierende Site mit Site öffnen. Um weiter daran zu arbeiten, übertragen Sie es auf Ihre eigene Site mit Make it Your, importieren Sie dann weitere Seiten und verfeinern Sie das Ergebnis in der Konsole.

Auto-Modus-Beschränkungen auto-mode-limits

Im automatischen Modus wird jedes Konto durch die Anzahl der Seiten pro Migration, die Anzahl der Migrationen und die Anzahl der Migrationen, die gleichzeitig ausgeführt werden können, begrenzt. Auf der Seite „Automatischer Modus“ werden die Beschränkungen angezeigt, die vor dem Start für Sie gelten:

  • Standardmäßig kann jede Migration bis zu 10 Seiten umfassen. Bei einer vollständigen Site-Ausführung wird eine Vorschau von bis zu so vielen Seiten migriert, nicht die gesamte Site. Der Rest wird später in der Konsole migriert.
  • Wenn Sie alle Migrationen verwendet haben, die Ihr Konto zulässt, oder so viele ausgeführt werden, wie zulässig sind, sagt Ihnen der Auto-Modus dies. Warten Sie, bis ein Durchgang abgeschlossen ist, oder fordern Sie weitere an.
  • Um nach weiteren Seiten oder Migrationen zu fragen, verwenden Sie Nach einem höheren Limit fragen oder Hilfe anfordern in der Kopfzeile. Das Team, das den Agenten erstellt, antwortet per E-Mail.

Um einen Durchlauf zu stoppen, verwenden Sie Migration abbrechen. Ein abgebrochener Durchlauf kann nicht fortgesetzt werden. Starten Sie stattdessen eine neue Migration.

Machen Sie es zu Ihrem make-it-yours

Bei der Ausführung eines automatischen Modus wird die Site an einem von Adobe verwalteten Speicherort erstellt. Um weiterhin in Ihrer eigenen Site daran zu arbeiten, wählen Sie Make it Your, wenn Sie fertig sind. Dadurch werden der Code und der Inhalt des Durchgangs auf eine Site übertragen, deren Inhaber Sie sind. Es migriert nichts mehr.

Zuerst das Ziel vorbereiten:

  • Eine Site, deren Code sich in einem GitHub-Repository befindet, das aus einer Edge Delivery Services-Vorlage erstellt wurde, auf der die Apps AEM Code Sync und AEM Code Connector installiert sind. Die schnellste Möglichkeit besteht darin, eine neue Site aus dem Textbaustein zu erstellen. Ein Repository auf einem anderen Git-Host, das über Cloud Manager verbunden ist, kann ebenfalls verwendet werden.
  • Eine main Verzweigung im Repository und der Inhalt der Website, die im dokumentbasierten Inhalts-Repository gespeichert sind. Nichts wird an ein Ziel übertragen, dessen Inhalt an einer anderen Stelle gespeichert ist, z. B. in einer Autoreninstanz.
  • Schreibzugriff auf das Repository und den Inhalt der Site für das Adobe-Konto, das Sie in der -Konsole verwenden.
  • Eine andere Site als die eigene Site des Durchgangs.

So übertragen Sie den Durchlauf:

  1. Wählen Sie die Ziel-Site aus. Wenn Sie noch nicht mit GitHub verbunden sind, werden Sie von der Konsole aufgefordert, zunächst eine Verbindung herzustellen.
  2. Überprüfen Sie das Ziel-Repository, die Vorschau-URL und die neue Verzweigung, die den Code erhält. Wählen Sie aus, ob vorhandene Seiten überschrieben werden sollen und ob eine Vorschau der übertragenen Seiten angezeigt werden soll.
  3. Wählen Sie Übertragung starten und verfolgen Sie den Fortschritt. Der Code wird auf einer neuen Verzweigung platziert und der Inhalt wird an den Speicherort des Zielinhalts kopiert. Bei einem dokumentbasierten Ziel wird bei der Übertragung auch Experience Workspace für die Ziel-Site aktiviert. Wenn dieser Schritt fehlschlägt, wird in der Konsole eine Warnung angezeigt. Bitten Sie den Administrator der Site, Experience Workspace einzuschalten.
  4. Wählen Sie In EMA öffnen, um auf der Ziel-Site in der Konsole fortzufahren, oder Site bearbeiten, um den Inhalt zu bearbeiten. Wenn sich die Konsole nicht auf der Ziel-Site öffnet, verbinden Sie sie.

Die Übertragung kopiert Folgendes:

Was
Wie sie übertragen wird
Code
an eine neue Verzweigung gepusht, die von der main Verzweigung des Ziels erstellt wurde. In dieser Verzweigung ersetzt das Projekt der Ausführung die Code-Dateien des Ziels. Nichts wird mit main zusammengeführt.
Seiten
als Dokumente in den Zielinhalt in Experience Workspace kopiert, zusammen mit den Bildern und anderen Medien, auf die sie verweisen.
Vorhandene Seiten
Übersprungen, es sei denn, Sie möchten sie überschreiben. Bevor eine Seite überschrieben wird, speichert die Übertragung den aktuellen Status der Seite als Version mit dem Namen Vor der Übertragung, die Sie aus dem Versionsverlauf der Seite in Experience Workspace wiederherstellen können.
Vorschau
Wenn Sie dies wählen, werden die übertragenen Seiten auf der *.aem.page-Site des Ziels in der Vorschau angezeigt. Sie werden nicht veröffentlicht.

Die Übertragung kopiert keine Kalkulationstabellen wie Umleitungen, Massen-Metadaten oder Platzhalter, Zugriffsberechtigungen, Site- und Organisationskonfigurationen oder den Git-Verlauf und die GitHub-Workflow-Dateien der Ausführung.

Wenn die Übertragung mit einem Fehler beendet wird, wird nichts in main zusammengeführt, aber Code und Inhalt werden separat übertragen. Überprüfen Sie daher sowohl die Verzweigung als auch die Seiten. Wenn die neue Verzweigung bereits vorhanden ist, wählen Sie einen anderen Verzweigungsnamen aus.

Eine übertragene Site ist noch nicht live. Legen Sie fest, wem die verbleibenden Schritte gehören:

  • Überprüfen Sie die Übertragungsverzweigung und führen Sie sie gemäß Ihrer Repository-Richtlinie in main zusammen. Die Zusammenführung ändert den Code der Live-Site. Siehe So werden Änderungen veröffentlicht.
  • Legen Sie fest, wer den Inhalt bearbeiten, in der Vorschau anzeigen und veröffentlichen kann. Siehe Berechtigungen und ​.
  • Erstellen Sie die benötigten Arbeitsblätter neu und überprüfen Sie die Experience Workspace-Konfiguration der Site, z. B. ihre Blockbibliothek. Siehe Konfigurationen.
  • Veröffentlichen die Seiten, die Sie akzeptieren. Die Übertragung veröffentlicht nichts.
  • Wechseln Sie Ihre Domain zur Site. Siehe Freigeben, Wiederherstellen und Übergeben.

Fahren Sie in der Konsole mit Eingabeaufforderungen für den Anfang mit fort und ​ Sie dann Ihre ​ (Speichern, Vorschau und Veröffentlichen).

Von einem Repository starten repo-start

Für die Arbeit in der Konsole benötigt ein GitHub-Repository zwei GitHub-Apps mit ähnlichen Namen und verschiedenen Aufträgen:

  • AEM Code Sync ermöglicht es Edge Delivery Services, Ihren Code zu lesen, damit er Ihre Site bereitstellen kann. Jede Site, deren Code auf GitHub gespeichert ist, verfügt über diesen Code.
  • AEM Code Connector ermöglicht es der Konsole, Änderungen per Push zu übertragen und Pull-Anforderungen in Ihrem Repository zu öffnen. Solange sie nicht installiert ist, kann die Konsole keinen Push-Code senden oder Pull-Anforderungen öffnen.
NOTE
Richten Sie für im JCR einer Autoreninstanz gespeicherte Inhalte stattdessen das Repository mit dem Handbuch für das Experience Manager-Authoring ein.

Erstellen einer neuen Site aus dem Textbaustein prepare-repo

Verwenden Sie diesen Pfad für eine neue Site, einschließlich einer Site, die Sie mit Seiten ausfüllen, die von einer vorhandenen Website importiert wurden.

  1. Erstellen Sie die Site aus dem AEMTextbaustein, indem Sie dem ersten Abschnitt des Entwickler-Tutorials, „Erste mit der Textbaustein-Repository-Vorlage folgen:

    • Wählen Sie Diese Vorlage verwenden aus, um Ihr Repository auf GitHub zu erstellen.
    • Installieren Sie die AEM Code Sync -App nur für dieses Repository.
    • Ändern Sie optional die Administratoren und die Inhaltsquelle der Site und wählen Sie dann Setup beenden.

    Ihre Site wird jetzt unter https://main--{repository}--{owner}.aem.page/ ausgeführt. Sie können Beispielinhalte in Experience Workspace bearbeiten. Die lokalen Entwicklungsschritte des Tutorials sind nicht erforderlich, da die Konsole die Entwicklungsumgebung bereitstellt.

    Erstellen Sie für eine Commerce-Storefront die Site aus dem Commerce-Textbaustein und folgen Sie stattdessen der Einrichtung. Es enthält die Commerce-Blöcke und Dropdown-Komponenten, die später nur schwer zu einer Site hinzugefügt werden können, die vom AEM-Textbaustein aus gestartet wurde. Siehe Commerce Pages.

  2. Installieren Sie die AEM Code Connector-App im Repository.

    • Wenn die App nur für ausgewählte Repositorys installiert ist, schließen Sie diese ein. Wenn Ihre Organisation eine Genehmigung für GitHub-Apps benötigt, muss sie von einem Organisationsverantwortlichen genehmigt werden.
  3. Öffnen Sie die Konsole und verbinden Sie die Site.

Vorhandene Site einbringen existing-site

Wenn Ihre Site bereits auf Edge Delivery Services ausgeführt wird, müssen Sie sie nicht neu erstellen oder erneut migrieren. Verbinden Sie ihn, und der Agent arbeitet mit seinem Code und seinen Inhalten so, wie sie sind.

  1. Überprüfen Sie auf GitHub, ob die AEM Code Sync -App im Repository installiert ist. Wenn die Site bereits aus diesem Repository bereitgestellt wird, ist dies der Fall.
  2. Installieren Sie die AEM Code Connector-App im Repository, wie bei einer neuen Site.
  3. Öffnen Sie die Konsole und verbinden Sie die Site.
  4. Bevor Sie etwas ändern, bitten Sie den Agenten, das Projekt zu erklären. Nehmen Sie dann eine erste visuelle Änderung mit Prüfmodus vor. Siehe Eingabeaufforderungen zum Starten mit.

Projekte, die aus dem aktuellen Textbaustein erstellt wurden, umfassen AGENTS.md, in dem Sie die Projektanweisungen für den Agenten aufbewahren, und eine einzeilige CLAUDE.md, die den Agenten bei jeder Unterhaltung AGENTS.md lädt. Ältere Projekte enthalten sie möglicherweise nicht. Bitten Sie den Agenten, sie aus dem aktuellen Textbaustein hinzuzufügen. Siehe Projektanweisungen.

Informationen zum Umgestalten einer Site oder zu Buildblöcken finden Sie unter Vorhandene Site neu gestalten und Blockentwicklung. Eine Migration ist nicht erforderlich.

Verwenden eines anderen Git-Hosts other-git

Edge Delivery Services unterstützt auch GitHub Enterprise (selbst gehostet), von Adobe gehostete Repositorys, GitLab, Bitbucket und Azure DevOps. Integrieren Sie das Repository in Adobe Cloud Manager, das Experience Manager as a Cloud Service-Tool zum Verwalten von Programmen, Umgebungen und Code-Repositorys. Konfigurieren Sie dann Ihre Site so, dass sie sie verwendet. Siehe Eigenes Git mitbringen.

IMPORTANT
Die Konsole überträgt Änderungen an Ihr Repository. Für Repositorys, die über Cloud Manager verbunden sind, wird eine Verzweigung gepusht, es wird jedoch keine Pull-Anfrage geöffnet. Öffnen Sie eine Pull-Anfrage in Ihrem Git-Host, wenn Sie eine Überprüfung benötigen. Das Zugriffstoken, das Sie in Cloud Manager erstellen, muss Schreibzugriff auf den Repository-Code gewähren, zusätzlich zu den Berechtigungen, die unter Schritt 8 von Externe Repositorys hinzufügen aufgeführt sind.
Wenn Sie bereits ein Token ohne Schreibzugriff integriert haben, bearbeiten Sie es in Cloud Manager unter Repositorys > Zugriffstoken verwalten und fügen Sie einen Wert ein, der Schreibzugriff umfasst. Sie müssen das Repository nicht erneut integrieren. Siehe Verwalten von Zugriffstoken.

Öffnen der Experience Modernization Console open-console

  1. Navigieren Sie zu aemcoder.adobe.io. Die kurze aem.new öffnet dieselbe Konsole.
  2. Melden Sie sich mit Ihrer Adobe ID an.
    • Verwenden Sie ein Konto, das zur Adobe-Organisation Ihres Unternehmens gehört. Eine persönliche Adobe ID, die nicht zu einer Organisation gehört, kann nicht verwendet werden. Die Konsole erklärt dies und ermöglicht es Ihnen „Ein anderes Konto zu verwenden. Wenn Sie kein Unternehmenskonto haben, bitten Sie Ihr Adobe-Accountteam, Sie zum Unternehmen hinzuzufügen.

Die Konsole speichert in diesen Dokumenten eine gehostete Arbeitskopie Ihres Projekts, die als Konsolenarbeitsbereich bezeichnet wird. Sie steht in keiner Verbindung mit Experience Workspace, der Authoring-Benutzeroberfläche. Der Agent importiert Inhalte und ändert den Code dort, bis Sie ihn hochladen oder pushen. Die Konsole richtet Ihren Arbeitsbereich beim ersten Anmelden ein, was bis zu 10 Minuten dauern kann. Jedes Adobe-Unternehmen, mit dem Sie sich anmelden, verfügt über einen eigenen Arbeitsbereich mit eigenen Projekten und Chats, um zu wechseln, sich abzumelden und sich beim Profil des anderen Unternehmens anzumelden. Nach einer gewissen Zeit der Inaktivität wird der Arbeitsbereich angehalten. Wenn Sie zurückkehren, zeigt die Konsole Ihr Arbeitsbereich wurde angehalten Wählen Sie Reaktivieren und warten Sie einige Minuten, während er wiederhergestellt wird.

Demomodus demo-mode

Wenn die Konsole im Demomodus geöffnet wird, wird in Kopfzeile eine Schaltfläche Demo-Site“ angezeigt. Sie können das Beispielprojekt erkunden und versuchen, Seiten zu importieren, aber die Arbeit an der Demo-Site wird nicht gespeichert und die Demo-Site kann keinen Code an GitHub senden oder Inhalte in Experience Workspace hochladen.

Demomodus

Verbinden Ihrer Site connect-repo

Verbinden Sie die Site, die Sie aus dem Textbaustein erstellt, mit Make it Your übertragen haben oder bereits hatten.

  1. Wählen Sie Demo-Site in der Kopfzeile und dann Site wechseln oder verwenden Sie Site wechseln in Einstellungen.
  2. Dadurch werden Sie aufgefordert, die AEM Code Connector-App mit Ihren GitHub-Anmeldeinformationen zu autorisieren. Wählen AEM Code-Connector autorisieren aus.
    • Wenn GitHub Enterprise oder die OAuth-Anmeldung nicht verfügbar ist, öffnen Sie Weitere Verbindungsmöglichkeiten und wählen Sie Mit Token anmelden. Geben Sie den GitHub-Host und ein Persönliches Zugriffstoken ein. Es wird empfohlen, ein detailliertes Token zu verwenden, das auf die benötigten Repositorys beschränkt ist. Das Token muss in der Lage sein, Ihr Benutzerkonto zu lesen und zum Repository zu übertragen. Mit einem Token listet die Konsole nur Repositorys auf, an die Sie pushen können.
  3. Geben Sie zurück in der Konsole die Vorschau-URL der Site an. Vorschau-URLs folgen dem Muster https://{branch}--{site}--{organization}.aem.page , wobei {site} der GitHub-Repository-Name ist und {organization} die GitHub-Organisation oder der Benutzer, der Eigentümer der URL ist. Sie können eine Seite kopieren, indem Sie eine Vorschau einer Seite der Website anzeigen oder sie aus diesen Namen erstellen. Die Konsole findet das zugehörige GitHub-Repository automatisch. Alternativ können Sie Ihre autorisierten GitHub-Projekte durchsuchen, um eine Site zu finden.
    Verbindung zum GitHub-Projekt herstellen
  4. Wählen Sie In Arbeitsbereich auschecken aus, sobald die Website überprüft wurde. Dadurch wird das Projekt in Ihren Konsolen-Arbeitsbereich kopiert.
  5. Vergewissern Sie sich nach der Aufforderung Vorhandenen Arbeitsbereich ersetzen, dass die aktuelle Arbeit an einer anderen Stelle gespeichert ist, und wählen Sie dann Arbeitsbereich ersetzen aus.
    Vorhandenen Arbeitsbereich ersetzen

Ihre Site und das zugehörige GitHub-Repository sind jetzt mit der Konsole verbunden.

Bestätigen Sie das verbundene Repository, die verbundene Verzweigung und das Inhaltsziel, bevor Sie Änderungen anfordern. Für die Verbindung ist Schreibzugriff auf das Repository erforderlich. Wenn Ihr Unternehmen oder Repository nicht aufgeführt ist oder die Konsole die Vorschau-URL nicht überprüfen kann, finden Sie weitere Informationen unter Git-Verbindungsprobleme.

Site-Verbindung

Konsolen-Startseite console-home

Bis zum Beginn einer Konversation wird die Konsole auf ihrer - geöffnet. Geben Sie eine Anfrage ein oder wählen Sie eine der vorgeschlagenen Eingabeaufforderungen aus, die nach Aufgabe gruppiert sind. Eine von Ihnen eingegebene Anfrage wird sofort ausgeführt. Die meisten empfohlenen Eingabeaufforderungen werden im Planmodus ausgeführt: Der Agent schlägt die Schritte vor, ohne die Dateien zu ändern, und Sie wählen Plan ausführen, um sie auszuführen.

Konsole - Startseite

Eingabeaufforderung starten start-prompting

Sobald Ihre Site verbunden ist, beschreiben Sie, was Sie möchten, in einfacher Sprache. Sagen Sie, welches Ergebnis Sie erwarten und auf welcher Seite, anstatt wie Sie den Code schreiben. Der Agent kennt Edge Delivery Services, sodass Sie ihn auch fragen können, wie ein Teil Ihrer Site funktioniert oder was ein Plattformbegriff bedeutet. Informationen zum Erstellen einer Seite aus Abschnitten, Blöcken und Standardinhalten finden Sie unter Markup, Abschnitte, Blöcke und automatische Blockierung.

CAUTION
Geben Sie Kennwörter, API-Schlüssel, Token oder andere geheime Daten im Chat niemals ein, fügen Sie sie ein oder fügen Sie sie hinzu. Alles im Chat erreicht das KI-Modell und der Agent kann es in die Dateien Ihres Projekts kopieren. Geben Sie die Anmeldeinformationen in den „Einstellungen der Konsole. Siehe Geheimnisse aus dem Chat ​.

Beginnen Sie auf einer neuen Site mit dem Schritt für Schritt eine Seite importieren. Bitten Sie auf einer Site, auf der bereits Seiten vorhanden sind, z. B. eine vorhandene Site oder eine, die mit Make it Your übertragen wurde, den Agenten, das Projekt zu erklären, und nehmen Sie dann eine visuelle Änderung mit dem Prüfmodus vor oder importieren Sie weitere Seiten. Siehe Eingabeaufforderungen zum Starten mit.

Schritt für Schritt eine Seite importieren guided-import

Der häufigste Einstieg besteht darin, Seiten von einer vorhandenen Website zu importieren. Im geführten Workflow stoppt der Agent nach jedem Schritt, damit Sie ihn überprüfen können: zuerst den Inhalt der Seite, dann ihr Design. Speichern Sie jedes Ergebnis, sobald Sie es überprüft haben: Laden Sie den Inhalt nach dem Inhaltsschritt hoch und übertragen Sie den Code nach dem Design-Schritt.

  1. Geben Sie optional zuerst die Größe der Quell-Site an. Fragen Sie nach „Umfang der Site-https://www.example.com". Der Agent findet die Seiten der Site und gruppiert die Seiten, die ein Layout gemeinsam haben, in Vorlagen, die Sie in der Planning Ansicht überprüfen. Wählen Sie Ihre erste Seite aus einer Vorlage aus, die viele Seiten umfasst, da die von ihr erstellten Blöcke auf allen wiederverwendet werden können. Siehe Site-.

  2. Mit einer autorisierten Quellseite beginnen. Ersetzen Sie die Beispiel-URL und das Ziel in dieser Eingabeaufforderung:

    • „Migrieren Sie in diesem Projekt nur https://www.example.com/about nach /about. Zieldokumentbasierte Inhalte. Text, Bilder und Links beibehalten. Vorhandene Blöcke und Standardinhalte wiederverwenden. Nicht hochladen, pushen oder veröffentlichen.“
    • Sagen Sie beim Experience Manager-Authoring, dass der Inhalt im JCR gespeichert ist, und befolgen Sie die Anweisungen prüft auf diese Einrichtung.
  3. Überprüfen Sie die importierte Seite, ihren Zielpfad und alle gemeldeten Lücken.
    Content-Import

  4. Nachdem die Seite importiert wurde, wird sie im Bedienfeld Workspace angezeigt. Wählen Sie die Seite aus, um sie im Vorschaufenster der Konsole auf der rechten Seite zu rendern. Diese Vorschau zeigt die Arbeitskopie im Konsolen-Arbeitsbereich an, nicht die Vorschau-Site auf aem.page.
    Inhalt importiert

  5. Überprüfen Sie die Seitenstruktur und den Text der Seite. Die Dokumentansicht des Vorschaubereichs zeigt, wie der Inhalt in Abschnitte, Blöcke und Standardinhalte aufgeteilt ist. Siehe Inhaltsansichten. Der Großteil einer Seite sollte Standardinhalt sein: Überschriften, Text, Bilder und Links. Ein Baustein gehört nur dann dazu, wenn Autoren markieren müssen, welche Inhalte eine Komponente bilden, z. B. einen Kartensatz. CSS und JavaScript können Standardinhalte je nach Design anordnen. Autoren werden diese Struktur bearbeiten, also bitten Sie den Agenten, sie jetzt zu vereinfachen, bevor weitere Seiten sie wiederverwenden. Siehe Gestalten der Inhaltsstruktur.

  6. Laden Sie die Inhalte hoch, damit sie gespeichert werden und Autoren sie bearbeiten können. Bis zum Hochladen ist die importierte Seite nur im Konsolen-Arbeitsbereich vorhanden und wird durch Pushen von Code nicht gespeichert.

    • Informationen zu dokumentbasierten Inhalten finden Sie unter Inhalt hochladen. Anschließend können Sie die Seite öffnen und bearbeiten.
    • Informationen zum Experience Manager-Authoring ​ Sie unter ​ von Inhalten im Handbuch zu dieser Einrichtung.
  7. Nachdem Sie nun über Inhalte verfügen, fordern Sie einen originalgetreuen Quellstil an oder wählen Sie explizit ein neues Zieldesign. Durch die Formatierung werden nur die CSS- und JavaScript-Dateien des Projekts geändert. Die hochgeladenen Inhalte bleiben unverändert.

    • „Importieren Sie die allgemeinen Stile aus https://www.example.com/about und formatieren Sie dann die auf /about verwendeten Blöcke. Bewahren Sie den importierten Inhalt auf.“
  8. Wenn der Agent fertig ist, wählen Sie Vorschau aktualisieren im Vorschaubereich aus, um die formatierte Seite anzuzeigen.
    Stile importiert

  9. Überprüfen Sie die formatierte Seite auf Desktop- und Mobilgerätebreiten. Vergleichen Sie den Text, die Links, die Bilder und die Struktur mit der Quellseite und bitten Sie den Agenten, die Unterschiede zu beheben. Beschreiben Sie die visuellen Unterschiede, die weiterhin zu groß sind. Komplexe Designs können mehrere Runden dauern. Siehe Wie nah das Design kommt.

  10. Pushen Sie den Code, sodass die neuen Blöcke und Stile in Ihrem Repository gespeichert und in der Vorschau der Site angezeigt werden. Siehe Push-Code-Änderungen.

Der Seitenimport erstellt nicht die freigegebene Navigation und Fußzeile. Fragen Sie nach ihnen separat. Als Nächstes ​ Sie die Seite ​ und veröffentlichen. Wiederholen Sie diese Schritte für weitere Seiten, und bitten Sie den Agenten, die von ihm erstellten Blöcke wiederzuverwenden. Sobald Ihre ersten Seiten korrekt aussehen, bitten Sie sie, ihre Blöcke und Stile für spätere Konversationen zu dokumentieren. Siehe Lassen Sie den Agenten die Dateien verwalten.

Vornehmen einer visuellen Änderung mit dem Modus „Überprüfen“ inspect-mode

Auf einer Site, die bereits über Seiten verfügt, z. B. eine vorhandene Site oder eine Site, die Sie mit Make it Your übertragen haben, ist eine visuelle Änderung der schnellste Weg, ein Ergebnis zu sehen. Zeigen Sie auf das, was Sie ändern möchten, anstatt zu beschreiben, wo es sich befindet: Aktivieren Sie Inspektionsmodus im Vorschaubereich, wählen Sie das Element aus und beschreiben Sie die Änderung, z. B. „Diese Schaltfläche mit dem Stil der primären Schaltfläche versehen“. Erste Änderung vornehmen enthält die Schritte, einschließlich der Überprüfung der einzelnen Bildschirmbreiten und der Rückgängigmachung einer Änderung. Dann den Code drücken um ihn zu behalten.

Eingabeaufforderungen zum Starten mit first-prompts

Ersetzen Sie die Beispiel-URLs und -Pfade durch Ihre eigenen.

Eine neue Website aus dem Textbaustein:

  • „Beschreiben Sie die Abschnitte und Blöcke auf der Startseite und die jeweiligen Dateistile.“
  • „Erstellen Sie eine neue /offers aus diesem Figmarahmen: {Figma link}.“ Siehe Erstellen einer neuen Seite aus Figma.

Nachdem Sie es Ihren gemacht haben:

  • „Vergleichen Sie /about mit https://www.example.com/about und beheben Sie die Unterschiede bei Layout und Bildern.“
  • „Migrieren Sie https://www.example.com/contact nach /contact. Vorhandene Blöcke wiederverwenden.“

Ihre bestehende Site:

  • „Geben Sie mir einen Überblick über dieses Projekt: Listen Sie die Bausteine auf, was jede tut und welche Seiten sie verwenden.“
  • „Fügen Sie eine Variante des Kartenblocks mit dunklem Hintergrund hinzu und zeigen Sie sie auf /products an.“
  • „Überprüfen Sie, ob dieses Projekt über die AGENTS.md- und CLAUDE.md-Dateien des aktuellen AEM-Textbausteins verfügt, und fügen Sie sie hinzu, wenn sie fehlen.“

Tipps zur Eingabeaufforderung prompting-tips

  • Bitten Sie jeweils um eine Änderung, und überprüfen Sie sie, bevor Sie die nächste anfordern. Wenn eine lange Aufgabe beendet wird, bitten Sie den Agenten, fortzufahren.
  • Sag, was der Agent nicht tun darf. Die in diesen Handbüchern angegebenen Eingabeaufforderungen zum Beispiel enden auf „Nicht hochladen, pushen oder veröffentlichen“. Dadurch bleibt die Arbeit des Agenten in Ihrem Konsolenarbeitsbereich, sodass Sie ihn überprüfen und dann selbst hochladen oder pushen können. Lassen Sie es aus, wenn der Agent diese Schritte für Sie ausführen soll und die erforderlichen Agentenberechtigungen aktiviert hat.
  • Bei einer Änderung, die mehrere Seiten oder freigegebene Stile umfasst, wechseln Sie in den Planmodus, um die Schritte zu überprüfen, bevor sich etwas ändert.

Der Agent weiß nur, was in der aktuellen Unterhaltung und in den Dateien Ihres Projekts ist. Geben Sie ihm den Kontext, den er nicht kennen kann, z. B. Anforderungen, Markenregeln, Screenshots und Links zur Dokumentation anderer Systeme. Siehe Den Agentenkontext geben. Damit es bei jeder Unterhaltung den Konventionen Ihres Projekts entspricht, bitten Sie es, diese in AGENTS.md und die AGENTS.md aufgelisteten Dateien zu schreiben; siehe Projektanweisungen und -speicher. Informationen zu Eingabeaufforderungen für jede Aufgabe finden Sie im Eingabeaufforderung.

Speichern, Vorschau und Veröffentlichen save-work

Die Arbeit des Agenten verbleibt im Konsolenarbeitsbereich, bis Sie ihn an einer anderen Stelle speichern. Mit jedem der nächsten Schritte wird die Arbeit an einen anderen Ort verschoben:

  • Hochladen kopiert Inhalte aus dem Konsolenarbeitsbereich an das Authoring-Ziel: Erlebnis-Workspace für dokumentbasierte Projekte oder die Autoreninstanz für das Authoring-Ziel in Experience Manager. Im Menü Synchronisieren ist dies Push > Inhalt.
  • Push übergibt Code an Ihr Git-Repository, in der aktuellen Verzweigung oder als Pull-Anfrage.
  • Vorschau und Veröffentlichen platzieren gespeicherte Inhalte auf der Vorschau-Site, *.aem.page und dann auf der Live-Site, *.aem.live.

Separates Hochladen und Pushen. Edge Delivery Services speichert Inhalte getrennt vom Code, sodass das Pushen von Code Ihre Seiten nicht speichert und das Hochladen Ihren Code nicht speichert. Das erste Ergebnis ist vollständig, wenn Sie die Seite in Experience Workspace erneut öffnen, bearbeiten und die angeforderte Änderung auf der Vorschau-Site sehen können, nicht nur, wenn ein Vorschau-Link vorhanden ist.

Inhalt hochladen upload-content

Laden Sie die Seiten in das dokumentbasierte Inhalts-Repository hoch, wo Autoren sie in Experience Workspace bearbeiten. Auf einigen Konsolenbeschriftungen und Bildschirmen wird weiterhin „Dokumenterstellung“ angegeben. Bestätigen Sie vor dem Hochladen das Ziel und stellen Sie sicher, dass Sie dort vorhandene Seiten ersetzen können. Der Upload verwendet Ihre eigenen Inhaltsberechtigungen. Siehe Push-Berechtigungen für Inhalte. Folgen Sie für das Experience ManagerAuthoring stattdessen „Inhalt ​" im Handbuch für diese Einrichtung.

  1. Wählen Sie in Ansicht Inhalt“, der Standardansicht des Arbeitsbereichs, oben rechts Inhalt. Verwenden Sie alternativ Synchronisieren > Push > Inhalt in der Workspace-Kopfzeile, um alle ausstehenden Seiten hochzuladen.
  2. Das Dialogfeld Inhalt hochladen wird geöffnet, wobei das Ziel Organisation und Site aus der Konfiguration Ihrer Site ausgefüllt ist. Wenn die Felder leer sind, geben Sie die Organisation und Site Ihres Inhalts in Experience Workspace ein.
  3. Wählen Sie die Dateien aus, die Sie hochladen möchten, und wählen Sie Hochladen.
    Dialogfeld „Inhalt hochladen“
  4. Nach Abschluss des Vorgangs zeigt das Dialogfeld an, wie viele Dateien hochgeladen wurden. Sie können die hochgeladenen Seiten dann in der Vorschau anzeigen oder eine Vorschau anzeigen und veröffentlichen. Der Upload wird fortgesetzt, wenn Sie das Dialogfeld schließen. Wiederholen Sie alle fehlgeschlagenen Seiten.
    In AEM anzeigen

Um den hochgeladenen Inhalt zu finden, wählen In AEM anzeigen in der Benachrichtigung nach Abschluss des Uploads aus, wodurch der Site-Inhalt in Experience Workspace geöffnet wird, oder gehen Sie zu https://da.live/#/{organization}/{repository}.

Inhalt beim Erstellen von Dokumenten

Öffnen Sie eine hochgeladene Seite, nehmen Sie eine Bearbeitung vor, speichern Sie sie und öffnen Sie sie erneut, um sicherzustellen, dass Autoren sie bearbeiten können und die Änderung bestehen bleibt. Wenn Experience Workspace für die Site aktiviert ist, die ausgewählte Seite in der Konsole in Experience Workspace bearbeiten) im Visual Editor geöffnet.

Push-Code-Änderungen push-code-changes

Überprüfen Sie den Codevergleich und führen Sie die Prüfungen des Projekts durch, bevor Sie einen Push durchführen. Verwenden Sie eine Pull-Anfrage für Arbeiten, die überprüft werden müssen. Was eine Überprüfung erzwingt, finden Sie unter Kontrolle über Änderungen.

  1. Wechseln Sie optional zur Ansicht Änderungen (Verzweigungssymbol in der Ansichtsauswahl), um die Unterschiede zu überprüfen.
    Code-Ansicht

  2. Öffnen Sie Synchronisieren in der Workspace-Kopfzeile und wählen Sie Push > Code.

  3. Staging Sie Dialogfeld "" die Dateien, die Sie per Push übertragen möchten, und wählen Sie Weiter.

  4. Geben Sie im Änderungen Push-Benachrichtigung) eine Commit-Nachricht ein. Wählen Sie, ob Sie eine neue PR erstellen (Standard) oder zur aktuellen Verzweigung pushen möchten, und wählen Sie Bestätigen, um einen Push durchzuführen.

    • Neuen PR erstellen überträgt eine neue Verzweigung mit dem Namen aem- gefolgt von Datum und Uhrzeit und öffnet eine Pull-Anfrage in die aktuelle Verzweigung. Die Pull-Anfrage listet Vorschau-URLs Ihrer Seiten in der neuen Verzweigung auf, damit Validierungsverantwortliche das Ergebnis überprüfen können. Ihr Konsolen-Arbeitsbereich bleibt auf der neuen Verzweigung. Um mit der ursprünglichen Verzweigung fortzufahren, wechseln Sie zurück mit Verzweigung wechseln in der Ansicht Änderungen.
    • Push an aktuelle Verzweigung fügt den Commit zur aktuellen Verzweigung hinzu und aktualisiert ihre Pull-Anfrage, falls sie eine hat. Verwenden Sie sie nur, wenn die Richtlinie Ihres Projekts dies zulässt und Sie beabsichtigen, diese Verzweigung zu ändern. Am main wird die Änderung sofort live geschaltet.
  5. Nach Abschluss des Vorgangs wird unten in der Konsole eine Benachrichtigung angezeigt.
    Anzeigen von PR

Wenn eine Pull-Anfrage erstellt wurde, wählen Sie PR anzeigen in der Abschlussbenachrichtigung aus. Andernfalls, z. B. für ein Repository, das über Cloud Manager verbunden ist, überprüfen Sie den Commit auf der Zielverzweigung. Wenn die Verzweigung gegen direkte Push-Benachrichtigungen geschützt ist, per Push mit Neuen PR erstellen.

Code in GitHub

Ihr Code befindet sich jetzt in GitHub. Er wird in der Vorschau und in den Live-URLs des Zweigs sofort angezeigt.

Identität übertragen commit-identity

Die Konsole übergibt die Git-Identität, user.name und user.email, die in Ihrem Konsolenarbeitsbereich konfiguriert sind, und verwendet einen Standardwert für einen der beiden fehlenden Werte. Weder das Verbinden Ihres Git-Kontos noch die Git-Einstellungen auf Ihrem eigenen Computer legen diese Identität fest.

Wenn jemand anderes die Verzweigung geändert hat push-conflicts

Eine Verzweigung ist eine Sequenz gespeicherter Änderungen, auch Commits genannt. Ihr Konsolen-Arbeitsbereich enthält die Verzweigung so, wie sie war, als Sie sie zuletzt abgerufen haben. Wenn also jemand anderes seitdem dorthin gepusht hat, enthält das Repository Commits, die Ihr Arbeitsbereich nicht hat. In die aktuelle Verzweigung, fügt den Commit nach dem entsprechenden hinzu und pusht erneut. Wenn Sie verschiedene Dateien oder Zeilen geändert haben, ist dies ohne weiteres von Ihnen gelungen.

Wenn Sie beide dieselben Zeilen geändert haben, kann Git nicht entscheiden, welche Version beibehalten werden soll. Das ist ein Konflikt. In der Konsole wird angezeigt Push fehlgeschlagen: Remote hat widersprüchliche Änderungen, die nicht automatisch zusammengeführt werden können, behält Ihre Änderungen bei und wechselt das Dialogfeld zu Neuen PR erstellen.

  1. Wählen Sie Bestätigen aus. Die Konsole überträgt Ihre Änderungen in eine neue Verzweigung und öffnet eine Pull-Anfrage in die Verzweigung, an der Sie gearbeitet haben.
  2. Wählen in der Benachrichtigung Anzeigen-PR) aus.
  3. Konflikte lösen. Wenn nur einige Zeilen in Konflikt stehen, wählen Sie Konflikte lösen in GitHub aus und behalten Sie die richtige Version jedes Teils bei. Siehe Beheben eines Zusammenführungskonflikts auf GitHub. Wenn die Konflikte viele Dateien umfassen, bitten Sie einen Entwickler, sie in einer lokalen Kopie des Repositorys zu lösen.
  4. Nachdem die Pull-Anfrage überprüft wurde, führen Sie sie zusammen.

Die Konsole führt keine Verzweigungen zusammen und löst auch keine Konflikte selbst auf. Synchronisieren > Pull > Code funktioniert genauso: Wenn Ihr Commit mit den Remote-Änderungen in Konflikt steht, wird der Pull abgebrochen, Ihre Arbeit bleibt unverändert und es wird empfohlen, eine neue Verzweigung zu pushen oder den Agenten um Hilfe zu bitten. Um Konflikte zu vermeiden, sollten Sie vor dem Start einer Aufgabe abrufen, häufig kleine Änderungen per Push übertragen und mit Ihrem Team vereinbaren, wer welche Dateien ändert. Siehe Arbeiten als Team.

Site-Vorschau preview-site

Im Vorschaufenster der Konsole wird nur die Arbeitskopie im Arbeitsbereich der Konsole angezeigt. So überprüfen Sie die hochgeladenen Seiten auf der Vorschau-Site mit Ihrem Code:

  1. Zurück zu Experience Workspace oder https://da.live/#/{organization}/{repository}.
  2. Öffnen Sie eine der zuvor hochgeladenen Seiten.
  3. Wählen Sie das Papierebenensymbol (oben rechts) und dann Vorschau.
    In Vorschau veröffentlichen

Stellen Sie sicher, dass die Vorschau sowohl den gespeicherten Inhalt als auch die beabsichtigte Code-Version enthält.

Veröffentlichte Vorschauinhalte

Wenn sich Ihr Code auf einer anderen Verzweigung als der in der Vorschau-URL befindet, ändern Sie die Vorschau-URL in diese Verzweigung. Folgen Sie beim Experience Manager-Authoring ​ „Authoring validieren und Vorschau .

Veröffentlichung publish

Wenn die Vorschau korrekt dargestellt wird, veröffentlichen Sie die Seite, um sie auf *.aem.live live zu schalten:

  • Öffnen Sie in Experience Workspace die Seite, wählen Sie das Papierplansymbol und dann Veröffentlichen aus.
  • Oder wählen Sie nach einem Upload in der Konsole aus, ob Sie die hochgeladenen Seiten in der Vorschau anzeigen und veröffentlichen möchten.

Beim Veröffentlichen wird die Seite öffentlich. Wer veröffentlichen kann, wird durch die Veröffentlichungsrolle der Site festgelegt. Befolgen Sie den Überprüfungsprozess Ihres Teams. Der Code benötigt diesen Schritt nicht: Er wird live geschaltet, sobald er main erreicht. Siehe Kontrolle über Änderungen.

Erstellen einer Kundendemo customer-demo

In einer Demo werden einige vollständige, markenspezifische Seiten einer Site gezeigt, zu deren Nutzung Sie berechtigt sind, und zwar entlang eines Pfads, durch den Sie Ihre Zielgruppe führen. Es erfordert keine Produktionsumstellung und sollte nicht als produktionsbereit präsentiert werden.

  1. Wählen Sie die Seiten und das Ziel der Demo aus. Geben Sie eine typische Seite an, nicht nur die einfachste.
  2. Verwenden Sie Automatikmodus oder importieren Sie die Seiten Schritt für Schritt, indem Sie die genaue Seitenliste benennen.
  3. Behalten Sie das Quelldesign bei oder ​ Sie während der Migration ein neues ​. Vervollständigen Sie die Navigation, die Fußzeile und die Assets, die der Demopfad benötigt.
  4. Überprüfen Sie Text, Bilder, Links, Layout und mobiles Verhalten und gehen Sie den Demopfad entlang. Beachten Sie verspottete Interaktionen, Integrationen, die nicht verbunden sind, und Seiten außerhalb des Bereichs.
  5. Übergeben Sie die Vorschau-Links, die Quellseite dahinter und die bekannten Lücken. Siehe Kontext für Personen und Agenten beibehalten.

Nutzung von Zugriff und KI-Guthaben access

Fordern Sie über Ihren Adobe Account Manager Zugriff auf die Experience Modernization Console an und melden Sie sich mit einer Adobe ID an, die zur Adobe-Organisation Ihres Unternehmens gehört. Der Auto-Modus benötigt keine Anfrage über Ihren Account Manager. Melden Sie sich auf der Seite an, wie in Mit Auto-Modus starten.

Planen Sie die Migration im Rahmen Ihres Wechsels zu Edge Delivery Services. Ihr Adobe-Kundenbetreuerteam kann den Umfang und die geschäftlichen Vereinbarungen für Ihr Projekt überprüfen, einschließlich Migrationen an großen Standorten und unter der Leitung von Partnern. Die Vereinbarung Ihres Unternehmens bestimmt das anwendbare KI-Kreditlimit und die Migrationsbedingungen. Durch die Anmeldung allein wird Ihr Anspruch nicht bestätigt.

Unter dem aktuellen Kreditmodell können bei der Migration von Seiten KI-Credits verbraucht werden:

  • Credits werden für jede Seite gezählt, die in Ihr Inhaltsziel, Experience Workspace oder die Autoreninstanz hochgeladen wird, nicht für Eingabeaufforderungen oder Iterationen in der Konsole.
  • Jeder Upload zählt, einschließlich des Uploads einer zuvor hochgeladenen Seite. Überprüfen Sie eine Seite in der Vorschau der Konsole und laden Sie sie hoch, sobald sie bereit ist.
  • Eine Neuformatierung ändert den Code, nicht den Inhalt, sodass kein neuer Upload erforderlich ist.
  • Bei Ausführungen im automatischen Modus werden keine KI-Credits verbraucht. Gehe zu Dir zählt die Seiten, die in Experience Workspace kopiert werden.
  • Seiten, die der Agent für Sie hochlädt, zählen genauso wie Seiten, die Sie hochladen.

Eine Einführung in KI-Credits für die agenten Funktionen von Adobe finden Sie unter KI-Kreditnutzung. In den Beispielen oder Raten für andere Funktionen sind die Bedingungen für Ihre Migration nicht festgelegt. Bitten Sie Ihr Adobe-Account-Team, die Nutzung Ihres Unternehmens zu überprüfen und zu bestätigen, welche Nutzungsberichte Ihnen zur Verfügung stehen.

Fehlerbehebung troubleshooting

Informationen zu Problemen mit Importen, Quellzugriff, Uploads, Vorschauen, Git-Verbindungen oder dem Konsolen-Arbeitsbereich finden Sie unter Fehlerbehebung beim Experience Modernization Agent. Wenn das Problem dadurch nicht behoben wird, ​ Sie den Support ​ dem Team an, das den Agenten erstellt.

Zusätzliche Ressourcen additional-resources

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