Experience Modernization Console console-reference

Die Experience Modernization Console von aemcoder.adobe.io ist die Web-Schnittstelle für den Experience Modernization Agent: eine gehostete Entwicklungsumgebung für Edge Delivery Services, in der Sie Änderungen im Chat beschreiben und die Ergebnisse überprüfen, speichern und veröffentlichen. Es ist kein lokales Setup erforderlich. Die Konsole arbeitet mit einer gehosteten Kopie Ihres Projekts, die von diesen Dokumenten als Konsolenarbeitsbereich bezeichnet wird. Sie hat nichts mit Experience Workspace zu tun, der visuellen Authoring-Benutzeroberfläche für dokumentbasierte Inhalte. Weitere Informationen finden Sie unter wo Inhalte gespeichert werden und wie sie von Autoren bearbeitet werden. Experience Workspace ersetzt die Dokumenterstellung, und bei einigen Konsolenbeschriftungen wird dieser Name weiterhin verwendet.

Auf dieser Seite werden die Ansichten, Steuerelemente und Einstellungen der Konsole beschrieben. Informationen zum Zugriff finden Sie Zugriff und KI-). Für vollständige Verfahren wählen Sie einen Weg zum ​), Produktionsmigration, Neuformatierung oder Blockentwicklung. Wenn Sie mit der Konsole noch nicht vertraut sind, bitten Sie den Agenten im Chat um eine Tour.

Menüleiste menu-bar

Die Menüleiste am oberen Rand jeder Seite bietet folgende Optionen:

  • Der Titel Adobe Experience Manager auf der linken Seite, wodurch die Startseite“ geöffnet wird
  • Eine Demo-Site-Schaltfläche, wenn Sie auf der Demo-Site arbeiten, über die erläutert wird, was die Demo nicht tun kann. Verwenden Sie Site wechseln, um Ihre eigene Site zu verbinden.
  • Eine Schaltfläche Support anfordern mit der ein Problem oder eine Frage an das Team gesendet wird, das den Agenten erstellt. Siehe Support anfordern.
  • Eine Konto-Schaltfläche auf der rechten Seite, mit der Sie in den Dunkelmodus wechseln und die Konsole abmelden können

Die Konsole zeigt auch Hinweise am oberen Seitenrand an, wie z. B. den Service-Status und Neue Funktionen der neuesten Version. Die Einstellungen für Chat, Home und Apps passen sich an die Bildschirme von Smartphones und Tablets an. Auf einem Telefon zeigt die Chat-Seite nur den Chat an. Auf einem Tablet wird jeweils ein Bedienfeld angezeigt. Wechseln Sie in der Kopfzeile zwischen dem Chat und dem Arbeitsbereich. Auf breiteren Bildschirmen werden beide Bedienfelder nebeneinander angezeigt.

Startseite home-page

Auf Startseite beginnen Sie mit der Arbeit.

Startseite der Konsole

  • Oben finden Sie eine Eingabeaufforderung für Ihre Anfrage.
  • Nachfolgend finden Sie die empfohlenen Eingabeaufforderungen für den Einstieg in Ihr Projekt.
  • Chat beginnen öffnet die Chat-Seite.
  • Einstellungen öffnet die Einstellungsseite.

Eingabeaufforderung prompt-input

Die Eingabeaufforderung enthält Steuerelemente für die Interaktion mit der KI.

  • Planungs-/Ausführungsmodi (Glühbirnen- und Zauberstabsymbole): Wechseln zwischen Planungs- und Ausführungsmodi.

    • Planmodus: Der Agent analysiert Ihre Anfrage und schlägt einen Ansatz vor, ohne Dateien zu ändern. Sie endet mit einem Plan, der eine Checkliste von Schritten enthält. Verwenden Sie ihn für mehrseitige, freigegebene oder anderweitig riskante Änderungen, damit Sie den Ansatz überprüfen und anpassen können, bevor sich etwas ändert. Wählen Sie Plan ausführen, um in den Ausführungsmodus zu wechseln und den Plan auszuführen, oder starten Sie einen neuen. Der Planmodus ist jederzeit verfügbar, auch vor der Planung oder Katalogisierung einer Site. Nur Sie können den Modus wechseln. Der Agent kann nicht selbst zwischen den Modi wechseln.
    • Ausführungsmodus: Der Agent führt die Anfrage aus und kann tatsächliche Dateiänderungen vornehmen.
    • Der Planmodus ändert die Funktionsweise des Agenten in der Konversation, nicht das, was Ihr Repository oder Ihre Site akzeptiert. Geben Sie vor der Ausführung den zulässigen Bereich an und geben Sie an, ob Upload, Push oder Veröffentlichung zulässig sind. Siehe Kontrolle über Änderungen.
  • Dateien anhängen (Papierclip-Symbol): Laden Sie Dateien hoch und fügen Sie an die Eingabeaufforderung Dateien für zusätzlichen Kontext wie Referenzdesigns, Screenshots oder Spezifikationen an. Dem Agenten werden angehängte Bilder im JPEG-, PNG-, GIF- oder WebP-Format angezeigt. Sie können auch Textdateien sowie Word-, PowerPoint- und Excel-Dateien anhängen. Der Agent erhält den Text und die eingebetteten Bilder. Jede Datei kann bis zu 10 MB groß sein; PDF-Dateien werden nicht akzeptiert. Prüfen Sie zuerst die Anhänge auf Kennwörter, Token und persönliche Daten. Siehe Geheimnisse aus dem Chat ​.

  • Eingabeaufforderungswarteschlange (Uhrensymbol): Zusätzliche Eingabeaufforderungen können in die Warteschlange gestellt werden, um automatisch ausgeführt zu werden, sobald die aktuelle Eingabeaufforderung abgeschlossen ist, damit Sie Folgeaufgaben ohne Wartezeit anordnen können.

  • Vorherige Eingabeaufforderungen: Verwenden Sie in einer leeren Eingabeaufforderung die Pfeiltasten nach oben und unten, um frühere Eingabeaufforderungen aufzurufen. Ein von Ihnen gestarteter Entwurf wird nicht überschrieben.

  • Eingabeaufforderungshinweise: Wenn diese Option aktiviert ist, zeigt die Konsole an, wenn in einer Eingabeaufforderung Details fehlen, z. B. die Seite oder das erwartete Ergebnis, und kann eine klarere Eingabeaufforderung vorschlagen. Entscheiden Sie, ob der Hinweis verwendet werden soll. Eingabeaufforderungen, die von der Konsole vorgeschlagen werden, werden nur gekennzeichnet, wenn Sie sie umformulieren. Konfigurieren Sie Hinweise unter Eingabeaufforderungs-Coach in Einstellungen.

Chat-Seite chat-page

Die Chat Seite ist die Hauptoberfläche für die Interaktion mit dem Agenten. Diese Seite ist in ein in der Größe veränderbares Chat-Bedienfeld und Arbeitsbereich-Bedienfeld unterteilt.

Chat-Bedienfeld chat-panel

Im Chat-Panel können Sie Ihre Unterhaltung mit dem Agenten anzeigen und fortsetzen. Das Chatbedienfeld enthält den Chatnachrichtenverlauf und eine Eingabeaufforderung um zusätzliche Anfragen an die Konsole zu stellen.

Die Kopfzeile des Chat-Panels enthält Links zum Navigieren zur Startseite und Einstellungen Ansichten und Chat-Aktionen.

  • Chat-Aktionen

    • Chat löschen: Entfernt alle Nachrichten und startet eine neue Konversation. Es kann nicht rückgängig gemacht werden, und es ist kein Code- oder Inhalts-Rollback. Die Transkripte der Agentensitzungen bleiben in Ihrem Konsolenarbeitsbereich, bis Sie die Option Arbeitsbereich zurücksetzen auswählen. Bitten Sie vor dem Löschen den Agenten, wichtige Entscheidungen in den Projektanweisungsdateien aufzunehmen, die er in jedem Gespräch liest, und laden Sie den Chat herunter, wenn Sie ihn behalten möchten.
    • Chat herunterladen: Dadurch wird der Unterhaltungsverlauf als Markdown-Datei heruntergeladen, die Sie als Aufzeichnung dessen, was gefragt wurde, aufbewahren können. Siehe Trace What the Agent Done.

Die Konversation wird mit Ihrem Konsolen-Arbeitsbereich gespeichert. Wenn Sie die Seite neu laden oder später zurückkehren, wird der Chat-Verlauf neu geladen. Eingabeaufforderungen, die Sie mit den Pfeiltasten zurückrufen, dauern nur so lange wie die Browser-Registerkarte.

Optionale Funktionen optional-capabilities

In Funktionsreferenz werden die integrierten Workflows und optionalen Add-ons aufgelistet. Jedes Add-on ist standardmäßig deaktiviert und pro Projekt aktiviert, wodurch der Agent für Projekte, die ihn nicht benötigen, leichter und schneller bleibt.

  • Wenn für Ihre Anfrage ein Add-on erforderlich ist, bietet der Agent an, es zu aktivieren, und bittet Sie zunächst um Ihre Bestätigung. Das Add-on ist ab der nächsten Nachricht verfügbar.
  • Sie können auch direkt um ein Add-on bitten, z. B. um „Formularmigrationsfunktion aktivieren“ oder Ihre Aufgabe beschreiben und das Angebot des Agenten annehmen.
  • Um zu sehen, welche Add-ons aktiviert sind, fragen Sie den Agenten, beispielsweise „Welche Add-ons sind für dieses Projekt aktiviert?“ Um eine auszuschalten, fragen Sie auf die gleiche Weise. Die Seite Einstellungen enthält noch keine Add-on-Steuerelemente.

Add-ons für das gesamte Projekt aktivieren persist-add-ons

Der Agent speichert die Add-ons, die Sie aktivieren, in der .agents/settings.json-Datei im Stammverzeichnis Ihres Repositorys. In der Datei werden die einzelnen Add-ons nach ihrer ID aufgelistet:

{
  "enabledPlugins": {
    "excat-figma@excat-extended": true,
    "forms-excat@excat-extended": true
  }
}

Pushen Sie diese Datei mit Ihrem Code. Jeder Arbeitsbereich, der das Repository auscheckt, einschließlich der Arbeitsbereiche und neuen Konversationen Ihrer Teammitglieder, beginnt dann mit denselben Add-ons, ohne erneut danach zu fragen. Sie können den Agenten auch bitten, die Datei zu ändern, oder sie in Ihrem Git-Repository bearbeiten und die Änderung in die Konsole ziehen. Um ein Add-on zu deaktivieren, setzen Sie seinen Wert auf false oder entfernen Sie seine Zeile. Eine Änderung wird ab Ihrer nächsten Nachricht wirksam.

Workspace Panel workspace-panel

Das Arbeitsbereich-Bedienfeld zeigt Arbeitsinhalte und Code für das verbundene Projekt an, nicht unbedingt für jede Remote-Seite der Site. Die Ansichtsauswahl bestimmt die verfügbaren Aktionen.

Ermitteln Sie, welches Ergebnis Sie anzeigen preview-states

Ergebnis
Was angezeigt wird
Was noch geprüft werden muss
Konsolenvorschau von Workspace-Inhalten
Der Arbeitsinhalt mit dem aktuellen Code im Konsolen-Arbeitsbereich.
Hochladen, Bearbeiten in der Authoring-Benutzeroberfläche und auf der Vorschau-Site.
Statische Entwurfsvorschau
Ein Entwurf oder Prototyp.
Konvertierung in Inhalte, die Autoren bei Bedarf bearbeiten können.
Remote-Inhaltserstellung
Dokumente in Experience Workspace oder Seiten in der Autoreninstanz, gespeichert.
Bearbeiten, Speichern und erneutes Öffnen; die entsprechende Code-Version; Vorschau.
Vorschau der Site (*.aem.page)
Der gespeicherte Inhalt mit dem Code der in der URL genannten Verzweigung.
Abschließende Prüfungen und Veröffentlichung.
Veröffentlichte Site (*.aem.live)
Die Version auf der Live-Site.
Prüfungen und Überwachung nach der Freigabe.

Funktionsweise der Vorschau how-preview-works

Die Konsolenvorschau ist keine Experience Manager-Umgebung. Dadurch wird die AEM CLI (aem up) in Ihrem Arbeitsbereich ausgeführt: Derselbe lokale Entwicklungs-Server, den Entwickler auf ihren eigenen Computern ausführen. Es stellt den Code Ihres Arbeitsbereichs mit den Inhaltsseiten in Ihrem Arbeitsbereich bereit. Alle anderen von einer Seite angeforderten Elemente, z. B. ein Fragment oder eine Tabelle, die sich nicht in Ihrem Arbeitsbereich befindet, stammen von der Vorschau-Site der aktuellen Verzweigung des Arbeitsbereichs https://{branch}--{site}--{organization}.aem.page.

Das Ergebnis kann nach dem Hochladen von der Vorschau-Site abweichen, da Edge Delivery Services Inhalte verarbeitet, die in der Konsolenvorschau so angezeigt werden, wie sie sind. Bei der Vorschau einer Seite nimmt sie den Inhalt auf und behält nur die Struktur von Abschnitten, Blöcken und Standardinhalten bei. Zusätzliche Elemente wie span-Tags, Datenattribute und Inline-Stile werden entfernt. Siehe Eigenes Markup mitbringen. In der Konsolenvorschau werden einige dieser Schritte reproduziert, z. B. das Umschließen eines eigenständigen Bildes oder Links in einen Absatz und das Hinzufügen von Überschriften-IDs. Dadurch wird die Vorschau nahe beieinander gelegt, sie entfernt jedoch nichts.

Achten Sie auf diese Unterschiede:

  • Markup, das Edge Delivery Services entfernt: Inline-Stile, span, Datenattribute und anderes Markup außerhalb dieser Struktur werden in der Konsolenvorschau angezeigt, verschwinden jedoch in aem.page. Behalten Sie die Seiten mit semantischen Inhalten bei und legen Sie Stile in die CSS des Projekts. Die JavaScript des Projekts kann die Seite immer noch im Browser umstrukturieren, was an beiden Stellen gleich funktioniert.
  • Inhalte von der Vorschau-Site: Fragmente, Tabellen und andere Dateien, die sich nicht in Ihrem Arbeitsbereich befinden, zeigen die Version an, die zuletzt auf der Vorschau-Site des Zweigs in der Vorschau angezeigt wurde.
  • Bilder: Ein Bild kann in der Konsolenvorschau angezeigt werden und weiterhin bei aem.page beschädigt sein, wenn es nicht korrekt hochgeladen wurde. Laden Sie die Seite erneut hoch.
  • Experience Manager-Authoring-Projekte: Der Upload konvertiert jede Seite in JCR-Inhalte, die zu den Komponentenmodellen des Projekts passen müssen. Die Vorschau zeigt die Seite vor dieser Konversion an. Überprüfen Sie die konvertierte Struktur in der JCR XML Ansicht, bevor Sie sie hochladen, und die Seite im universellen Editor danach.

Um die bereitgestellte Seite zu überprüfen, laden Sie sie hoch, zeigen Sie eine Vorschau an und öffnen Sie sie in der aem.page-URL der Verzweigung. Siehe Konsolenvorschau unterscheidet sich von der Site.

Inhaltsansichten content-view

Die Inhaltsansichten zeigen die ausgewählte Seite in verschiedenen Formularen an, sodass Sie jeden Aspekt des Ergebnisses überprüfen können. Ein ausblendbarer Datei-Browser listet die Seiten Ihrer Site auf:

  • Seiten in Ihrem Arbeitsbereich werden als Dateien angezeigt.

  • Seiten, die nur im Inhaltsziel vorhanden sind, zeigen ein Cloud-Symbol an. In dokumentbasierten Projekten sind dies die Seiten in Experience Workspace. In anderen Projekten, einschließlich Authoring-Projekten in Experience Manager, sind dies die Seiten, die in der Vorschau angezeigt oder veröffentlicht wurden. Das Öffnen einer Cloud-Seite lädt sie in Ihren Arbeitsbereich herunter.

  • Vorschau (Dokument mit Lupensymbol) rendert die ausgewählte Seite aus dem aktuellen Code und Inhalt Ihres Arbeitsbereichs. Damit können Sie die Seite so überprüfen, wie sie Besuchern angezeigt wird. Die Authoring-Umgebung oder Ihr Git-Repository wird nicht aktualisiert. Siehe Funktionsweise der Vorschau.

  • Dokumentansicht (Dokumentsymbol) zeigt die zugrunde liegende dokumentbasierte Inhaltsstruktur an. Damit können Sie überprüfen, wie Inhalte in Abschnitte, Blöcke und Standardinhalte organisiert sind.

  • HTML-Ansicht (Code-Symbol) zeigt die unformatierte HTML an. Verwenden Sie es, um das Rendering zu debuggen und Dekoration zu blockieren.

  • Markdown-Ansicht (Absatzsymbol, Experience Manager-Authoring) zeigt die zugrunde liegende Markdown-Inhaltsstruktur an. Damit können Sie den Inhalt vor der Konvertierung überprüfen.

  • JCR XML-Ansicht (Datensymbol, Experience Manager-Authoring) zeigt die resultierende JCR XML-Inhaltsstruktur an. Hiermit können Sie überprüfen, was in die Autoreninstanz importiert wird.

Inhaltsansicht

Die folgenden Aktionen sind in den Inhaltsansichten verfügbar:

  • Aktualisieren-Symbol, um das Rendering des Vorschaubereichs für die Arbeitsbereichkopie der Konsole neu zu laden. Es werden keine Inhalte aus Experience Workspace abgerufen. Um die Kopien der Konsole durch die gespeicherten Dokumente zu ersetzen, verwenden Sie Synchronisieren > Abrufen > Inhalt. Um eine einzelne Seite zu ersetzen, löschen Sie die lokale Kopie und öffnen Sie die Seite erneut.
  • Viewport-Menü, um die gerenderte Seite in responsiver Breite (der Standard, der das Bedienfeld ausfüllt) oder in einer festen Desktop, Tablet oder Mobile Größe anzuzeigen
  • Überprüfen Sie den Modus (wählen Sie das Symbol aus), um ein Element der Seite zu Ihrer Eingabeaufforderung hinzuzufügen, sodass der Agent seine Änderungen auf dieses Element beschränkt. Siehe Erste Änderung vornehmen.
  • Neues Fenster (Symbol „Öffnen in„) zum Öffnen der Vorschau-URL in einer neuen Registerkarte (für eine vollständige Desktop-Vorschau)
  • In Experience Workspace bearbeiten (dokumentbasierte Projekte) öffnet die ausgewählte Seite im Visual Editor von Experience Workspace auf einer neuen Registerkarte, die mit der aktuellen Verzweigung des Konsolenarbeitsbereichs in der Vorschau angezeigt wird. Wenn die Seite lokale Änderungen enthält, die noch nicht in Experience Workspace hochgeladen wurden, bietet die Konsole zunächst Hochladen und Bearbeiten, damit Sie keine ältere Version bearbeiten. Für Experience Manager-Authoring-Projekte wird stattdessen der universelle Editor verwendet.
  • Löschen entfernt die ausgewählte Seite aus dem Konsolenarbeitsbereich, eine Seite nach der anderen. Es kann kein Ordner gelöscht werden. Sie kann nicht rückgängig gemacht werden und löscht keine hochgeladenen, in der Vorschau angezeigten oder veröffentlichten Inhalte. Wenn die Seite im Inhaltsziel vorhanden ist, wird sie erneut mit dem Cloud-Symbol angezeigt, und beim Öffnen wird die gespeicherte Version heruntergeladen. Eine Cloud-Seite kann nicht gelöscht werden. Siehe Entfernen von Seiten.
  • Fehler-Schaltfläche (Experience Manager Authoring) öffnet ein modales Fenster, in dem die Fehler auf der ausgewählten Seite angezeigt werden.
  • Inhalt hochladen öffnet das zielspezifische Dialogfeld „Hochladen“ oder „Paket“. Überprüfen Sie Zielpfade und überschreiben Sie die Auswirkungen, bevor Sie fortfahren.

Inhalt hochladen

Nach einem Upload in Experience Workspace zeigt das Ergebnisdialogfeld an, welche Dateien hochgeladen wurden, und ermöglicht Ihnen die Vorschau oder Vorschau und Veröffentlichung der hochgeladenen Seiten auf der Vorschau- und Live-Site. Dies wird als getrackter Auftrag ausgeführt: Er wird fortgesetzt, wenn Sie das Dialogfeld verlassen und Details anzeigen in der Benachrichtigung die Ergebnisse erneut öffnet. Wiederholen Sie fehlgeschlagene Seiten aus den Ergebnissen. Wenn keine Seitenvorschau erfolgreich durchgeführt wurde, wird nichts veröffentlicht.

Inhaltsänderungen, die vom Agenten vorgenommen werden, bleiben im Konsolenarbeitsbereich, bis Sie sie hochladen oder bis Sie den Agenten bitten, sie mit seinen ​ in Experience Workspace zu ​.

Menü „Sync“ sync-menu

Durch die Synchronisierung wird Ihr unabhängiger Konsolenarbeitsbereich mit dem Git-Repository und Inhaltsziel Ihres Projekts verbunden. Pushen von Code und Pushen von Inhalten sind separate Vorgänge, und Sie können auswählen, welche geänderten Dateien oder Seiten gesendet werden sollen. Änderungen, die Sie im Arbeitsbereich der Konsole hinterlassen, wirken sich nicht auf das Projekt aus.

Die Schaltfläche Synchronisieren in der Kopfzeile von Workspace zeigt ein Badge mit der Anzahl der ausstehenden Änderungen. Öffnen Sie sie, um Inhalte und Code zwischen dem Konsolenarbeitsbereich und ihren Remote-Speicherorten zu verschieben: Experience Workspace oder die Autoreninstanz für Inhalte und Ihr Git-Repository für Code.

Abschnitt
Element
Funktion
Push
Inhalt
Öffnet das Dialogfeld Hochladen, das mit Inhalt hochladen identisch ist, in dem Sie die Seiten auswählen, die in Experience Workspace oder die Autoreninstanz hochgeladen werden sollen. Jeder Upload ersetzt die gespeicherte Version der Seite, einschließlich der Änderungen, die andere an ihr vorgenommen haben. Es wird nichts an Git übertragen. Zeigt an, wie viele Seiten ausstehen oder aktuell und eine Fortschrittsleiste beim Pushen.
Push
Code
Öffnet Änderungen bereitstellen und dann Änderungen übertragen für die geänderten Dateien; siehe Aktionen. Erfordert die AEM Code Connector GitHub-App. Das Menü AEM Code Connector installieren falls sie fehlt.
ziehen
Inhalt
Nur dokumentbasierte Projekte. Lädt Ihre Experience Workspace-Seiten über den Arbeitsbereich „Konsole“ herunter, einschließlich lokaler Bearbeitungen. Seiten, die nur im Arbeitsbereich der Konsole vorhanden sind, werden beibehalten. Dieser Vorgang kann nicht rückgängig gemacht werden.
ziehen
Code
Ruft die neuesten Commits der aktuellen Verzweigung des Arbeitsbereichs aus Ihrem Git-Repository ab. Nicht verfügbar, solange der Konsolen-Arbeitsbereich nicht festgeschriebene Dateien enthält. Zuerst pushen oder verwerfen. Wenn Ihre Änderungen mit den Remote-Änderungen in Konflikt stehen, bricht die Konsole den Pull ab und lässt Ihre Arbeit unverändert. Siehe Wenn jemand anderes die Verzweigung geändert hat. Um eine weitere Verzweigung zu ziehen, wechseln Sie zuerst mit Verzweigung wechseln.

Die Synchronisierung ist im Demo-Standort deaktiviert. Push- und Pull-Funktion informieren Sie, wenn Ihre Experience Workspace-Sitzung abgelaufen ist.

Code-Ansichten code-view

Die Codeansichten bieten Tools zum Durchsuchen Ihrer Projektdateien und zum Verwalten von Codeänderungen. Die Ansicht enthält einen Datei-Browser mit einer Übersicht über Ihre Codedateien oder Änderungen als Unterschiede sowie einen Vorschaubereich zum Anzeigen der ausgewählten Datei oder Änderungen.

  • Dateien, um die Codedateien im aktuellen Arbeitsbereich zu durchsuchen
  • Änderungen, um die Unterschiede der durch Ihre Arbeit am Projekt erstellten Dateiänderungen anzuzeigen
NOTE
In den Dateiansichten werden keine Dateien und Ordner im Stammverzeichnis des Repositorys angezeigt, deren Namen mit einem Punkt beginnen, z. B. .github/, .claude/ oder .hlxignore. Die Ausnahmen sind .gitignore, .agents/ und Ordner, die der Agent verwaltet. Sie können keine Änderungen an ausgeblendeten Elementen über die Konsole bereitstellen oder pushen. Der Agent kann sie pushen, wenn LLM darf meine Git-Anmeldeinformationen verwenden in Einstellungen aktiviert ist, und ihn bitten, die Änderung zu übernehmen und zu pushen. Andernfalls bearbeiten Sie sie in GitHub oder in einem lokalen Klon und ziehen Sie den Code dann in die Konsole. Das Abrufen umfasst ausgeblendete Elemente. Das ist wichtig für Projektfähigkeiten die in .claude/skills/ gehören.

Code-Ansicht

Dateiaktionen file-actions

  • Zum Chat hinzufügen fügt die ausgewählte Datei (oder die ausgewählten Zeilen aus der Datei) dem Chat-Bedienfeld für den Kontext hinzu.
  • Herunterladen lädt die ausgewählte Datei auf Ihren Computer herunter.

Aktionen für Änderungen changes-actions

  • Hinzufügen (±Symbol) zum Staging der geänderten Datei
  • Verwerfen (Pfeilsymbol) zum Verwerfen der geänderten Datei
  • Löschen (Papierkorbsymbol) zum Löschen der nicht bereitgestellten Datei
  • Aktualisieren (Aktualisierungssymbol), um die Liste der Änderungen zu aktualisieren
  • Verzweigung wechseln: Wechselt Verzweigungen innerhalb desselben Repositorys

Verwenden Sie zum Übertragen von Code Sync > Push > Code im Menü Synchronisieren. Im Dialogfeld Änderungen speichern können Sie die Dateien auswählen. Im Dialogfeld Änderungen pushen wird nach einer Commit-Nachricht gefragt und ob eine neue Pull-Anfrage erstellt oder an die aktuelle Verzweigung gepusht werden soll. Unter Code-Änderungen pushen finden Sie Informationen zu den einzelnen Optionen. Um den neuesten Code abzurufen, verwenden Sie Sync > Pull > Code. Code-Aktionen sind auf dem Demo-Standort nicht verfügbar, wenn GitHub nicht verbunden ist, oder bis der AEM Code Connector installiert ist. Die Konsole teilt Ihnen mit, welche Aktion gilt. Informationen dazu, wann gepushter Code die Vorschau- und Live-Site erreicht, finden Sie unter So werden Änderungen live geschaltet.

Beim Pushen von Code werden keine Inhalte hochgeladen, und beim Verwerfen von lokalem Code werden auch keine bereits hochgeladenen Inhalte rückgängig gemacht.

Änderungen per Push übertragen

Um das GitHub-Repository zu verbinden, erneut zu verbinden oder zu wechseln, verwenden Sie die Einstellungsseite.

Projektansichten project-view

Die Projektansichten helfen Ihnen bei der Planung der Migration einer vorhandenen Site.

  • Planung zur Überprüfung und Verfeinerung der Vorlagen, Seiten und Blöcke, die durch den Site-Katalog identifiziert werden, sodass Sie migrieren und eine Beispielseite pro Vorlage überprüfen können, bevor Sie den Rest importieren

Weitere Informationen finden Sie Die Planungsansicht.

Einstellungsseite settings-page

Die Einstellungen ermöglicht ​ Verwaltung der grundlegenden Einstellungen der Konsole und ist in die folgenden Abschnitte unterteilt. Hier Anmeldeinformationen eingeben, nie im Chat. Siehe Geheimnisse aus dem Chat ​.

Einstellungsansicht

Wenn Sie einen Wert in einem Bereich ändern, klicken Sie auf Speichern, um diese Änderungen im jeweiligen Bereich zu speichern. Für Agentberechtigungen, Site-Authentifizierung und Anmeldeinformationen wird die Schaltfläche Wird angewendet… angezeigt, bis die Änderung wirksam wird. Wählen Sie das Symbol Zurück aus, um zur vorherigen Ansicht zurückzukehren.

  • Projekt ermöglicht Ihnen das Anzeigen und Bearbeiten von Projekteinstellungen, wie z. B. das Verwalten Ihrer GitHub-Verbindung und das Anpassen der Bibliotheks-URL.

    • Verbinden/Erneut verbinden: Startet die GitHub-Authentifizierung
    • Site wechseln: Öffnet eine andere Site und ein anderes Repository im Konsolen-Arbeitsbereich. Die Dateien und der Chat der aktuellen Website werden beim Zurückwechseln aufbewahrt.
    • Abmelden: Trennt die Verbindung zu GitHub und widerruft den Zugriff des Agenten auf Ihre GitHub-Anmeldeinformationen
    • Bibliotheks-URL - Diese URL verweist auf eine library.json-Datei, die die für Autoren verfügbaren Blöcke, deren Varianten und Beispielinhalte definiert.
    • Site-Basis-URL - Die Ursprungs-URL der migrierten Website
  • Agentenberechtigungen - Steuert, auf was der Agent in Ihrem Namen zugreifen darf. Jede Berechtigung ist deaktiviert, bis Sie sie aktivieren und speichern. Der Agent verwendet eine Berechtigung, ohne die Berechtigung selbst zu erhalten. Siehe Sicherheit und Datenverarbeitung.

    • LLM erlauben, meine Adobe-Anmeldeinformationen für admin.hlx.page, Dokumenterstellung und außerhalb von GitHub gehostete Repositorys zu verwenden - Im Adobe IMS-Berechtigungen (admin.hlx.page & Document Authoring) Abschnitt. Wenn diese Option aktiviert ist, kann der Agent unter Verwendung Ihrer Adobe-Anmeldeinformationen Site-Konfigurationen und Metadaten lesen, Experience Workspace-Inhalte lesen und Push-Benachrichtigungen an Repositorys senden, die außerhalb von GitHub gehostet werden. admin.hlx.page ist die Admin-API von Edge Delivery Services. hlx stammt von Helix, dem Projektnamen, unter dem die Architektur entwickelt wurde. Dies genehmigt nicht die Veröffentlichung: Die Konsole hindert den Agenten daran, hochzuladen, eine Vorschau anzuzeigen oder zu veröffentlichen, es sei denn, Sie bitten darum. Siehe Kontrolle über Änderungen.
    • Benutzerdefiniertes IMS-Token (optional) - Geben Sie ein Token an, das der Agent anstelle Ihres Sitzungs-Tokens verwenden soll. IMS ist der Identity Service von Adobe, der das Token für Ihre Adobe ID-Sitzung ausgibt. Wenn möglich, sollte das Token eines Service-Kontos, auch als technisches Konto bezeichnet, einem persönlichen Token vorgezogen werden, damit der Zugriff des Agenten nicht von Ihrem eigenen Konto abhängt. Lassen Sie das Feld leer, um Ihr Sitzungs-Token zu verwenden. Der Abschnitt zeigt an, welches Token verwendet wird.
    • LLM darf meine Git-Anmeldeinformationen verwenden - Sofern verfügbar, kann der Agent in Ihrem Namen an Ihre GitHub-Repositorys pushen und von ihnen abrufen. Wenn diese Einstellung nicht angezeigt wird, steht sie Ihnen noch nicht zur Verfügung. Pushen Sie die Änderungen des Agenten selbst über Synchronisieren > Push > Code. Wenn er aktiviert ist, kann der Agent an jedes Repository und jede Verzweigung übertragen, in das bzw. die Ihre GitHub-Anmeldeinformationen schreiben können, einschließlich main. Verzweigungsschutz in Ihrem Repository gilt weiterhin. Dadurch wird der Zugriff erhöht. Geben Sie dem Agenten daher ein eigenes Token.
    • Benutzerdefiniertes Git-Token (optional, empfohlen) - Ein persönliches Zugriffstoken, das der Agent anstelle der Git-Anmeldeinformationen des Arbeitsbereichs verwenden kann. Erstellen Sie ein detailliertes Token, das nur die Repositorys umfasst, die der Agent benötigt. Lassen Sie das Feld leer, um die vorhandenen Anmeldeinformationen des Arbeitsbereichs zu verwenden.
  • Anmeldeinformationen ermöglicht es Ihnen, ein persönliches Zugriffstoken für Figma anzugeben, damit der Agent Ihre Figma-Designs lesen kann. Es hat nichts mit den Design-Token zu tun, z. B. Farben und Abstände, die der Agent aus Ihren Designs liest. Was das Token lesen kann, finden Sie unter Figma und Design-Systeme.

  • Authentifizierung für geschützte Site - Konfigurieren Sie eine benutzerdefinierte Anfragekopfzeile, HTTP-Standardauthentifizierung oder Bearer-Authentifizierung, damit der Agent Quellseiten lesen kann, für die eine Anmeldung oder eine geheime Kopfzeile erforderlich ist, oder einen anderen Service aufrufen kann, für den ein Schlüssel erforderlich ist, z. B. eine API. Siehe Authentifizierung für eine geschützte Site für Einrichtungsanweisungen und Anmeldeinformationen für andere Services.

  • Eingabeaufforderungs-Coach - Steuert, sofern verfügbar, die Eingabeaufforderungshinweise, die angezeigt werden, wenn in einer Eingabeaufforderung Details fehlen, z. B. die Seite oder das erwartete Ergebnis.

    • Eingabeaufforderungshinweise anzeigen Schaltet die Hinweise ein oder aus.
    • Weitere Optionen können Eingabeaufforderungen auf Ihrem Gerät überprüfen, das ein Modell in Ihren Browser herunterlädt. Durch Deaktivieren einer solchen Option wird das heruntergeladene Modell entfernt.
  • Support fasst die Informationen zusammen, die eine Support-Anfrage mit dem Team teilt, das den Agenten erstellt.

    • Support anfordern - Wählen Sie diese Option aus, um eine Support-Anfrage zu öffnen, ohne die Konsole zu verlassen.
  • Gefahrenbereich enthält Einstellungen, die den Konsolenarbeitsbereich zurücksetzen können.

    • Arbeitsbereich zurücksetzen - Beendet die Sitzung, trennt GitHub und löscht dauerhaft den Chat-Verlauf des geöffneten Projekts, die Transkripte der Agentensitzungen und den Code, einschließlich der Änderungen, die Sie nicht vorgenommen oder gepusht haben. Das kann nicht rückgängig gemacht werden. Code, den Sie gepusht haben, und hochgeladene Inhalte bleiben an ihren Remote-Standorten; ein Zurücksetzen stellt Remote-Inhalte nicht wieder her.

Authentifizierung für geschützte Sites protected-site-authentication

Viele Websites zeigen einige Seiten nur für angemeldete Besucher an, behalten eine Staging-Kopie hinter einem Kennwort oder verfügen über ein CDN, das nur Anfragen mit einem geheimen Header durchlässt. Verwenden Sie Geschützte Site-Authentifizierung, damit der Agent eine solche Quell-Site lesen kann, wenn er eine benutzerdefinierte Anfragekopfzeile, HTTP-Standardauthentifizierung oder Bearer-Authentifizierung akzeptiert. Sie können diese Seiten dann auf dieselbe Weise migrieren wie öffentliche Seiten.

Die Quell-Site muss von der gehosteten Umgebung des Agenten im Internet erreichbar und so konfiguriert sein, dass sie die von Ihnen bereitgestellte Authentifizierungsmethode akzeptiert. Diese Funktion stellt keine Verbindung über ein VPN her und führt keine interaktiven Anmeldevorgänge wie Single-Sign-On-Formulare (SSO) oder Multi-Faktor-Authentifizierung durch. Eine Firewall lässt den Agenten durch, wenn sein Administrator die Adressen des Agenten ändert. Wenn Ihre Quelle nur über ein privates Netzwerk erreichbar ist, fragen Sie den Administrator nach einem Staging- oder Ursprungs-Host, der über eine der unterstützten Methoden erreichbar ist.

IMPORTANT
Diese Funktion ist nicht für die Verwendung mit personenbezogenen Daten (PII) oder echten Endbenutzerdaten vorgesehen. Verwenden Sie Quellinhalte und Testkonten, die diese Daten nicht enthalten.

So konfigurieren Sie den Zugriff:

  1. Öffnen Sie Einstellungen in der Experience Modernization Console und suchen Sie nach "Site-Authentifizierung.

  2. Wählen Sie Site hinzufügen aus.

  3. Geben Sie den Site-Hostnamen ein, z. B. staging.example.com. Nur den Host-Namen ohne https:// oder URL-Pfad eingeben.

  4. Wählen Sie einen Authentifizierungstyp aus und geben Sie die entsprechenden Werte ein.

    table 0-row-2 1-row-2 2-row-2 3-row-2
    Authentifizierungstyp Einzugebende Werte
    Benutzerdefinierter Header Kopfzeilenname und Kopfzeilenwert wie für Ihre Quell-Website erforderlich. Beispielsweise könnte der Kopfzeilenname X-API-Key sein.
    Einfach (Benutzername und Kennwort) Benutzername und Kennwort für die HTTP-Standardauthentifizierung.
    Bearer-Token Das Bearer-Token, das von Ihrer Quell-Website akzeptiert wird.
  5. Wählen Speichern im Abschnitt Authentifizierung einer geschützten Site aus. Im Abschnitt wird Wird angewendet… angezeigt, bis die Änderung wirksam wird, was bis zu zwei Minuten dauern kann.

  6. Bitten Sie den Agenten, die Quell-Website wie gewohnt mithilfe ihrer URL abzukratzen oder zu migrieren.

Einstellungen für die geschützte Site-Authentifizierung mit Beispiel für benutzerdefinierte Header- und HTTP-Standardauthentifizierungseinträge

Nach dem Speichern werden Anmeldeinformationen nur noch dem entsprechenden Hostnamen zu ausgehenden Anfragen hinzugefügt und nicht für das KI-Modell freigegeben.

Verwenden Sie Anmeldeinformationen mit den geringsten Berechtigungen im Umfang, vorzugsweise ein dediziertes Konto mit schreibgeschütztem Zugriff auf den Quellinhalt. Jeder Hostname kann nur einmal konfiguriert werden. Konfigurieren Sie zusätzliche Hostnamen separat, wenn die Quell-Website geschützte Inhalte von anderen Hosts wie einer Asset-Domain lädt.

Aktivieren Sie eine geschützte Seite, bevor Sie die Ausführung eines Katalogs oder Batches starten: Ihre Erfassung muss den Seiteninhalt anzeigen, keine Anmeldeseite.

Um den Zugriff zu entfernen, wählen Site entfernen für den Eintrag und dann Speichern aus. Entfernen Sie den Eintrag, wenn die Migration abgeschlossen ist.

Anmeldedaten für andere Services other-services

Dieselben Einstellungen funktionieren für jeden Service, den der Agent aufruft, während er funktioniert, nicht nur für Quell-Sites. Fügen Sie einen Eintrag für den Host-Namen des Services hinzu, z. B. api.example.com, mit der Kopfzeile oder dem Token, die bzw. das der Service erwartet. Sie können beliebig viele Einträge hinzufügen, einen für jeden Hostnamen. Die Konsole fügt die Anmeldeinformationen zu jeder Anfrage hinzu, die der Agent an diesen Host-Namen sendet, einschließlich Anfragen von den Skripten und Befehlen, die er ausführt. Das KI-Modell erhält die Berechtigung nicht, aber der Agent sieht die Antworten des Service.

  • Teilen Sie dem Agenten mit, dass für den Hostnamen und den Service eine Berechtigung eingerichtet ist. Der Agent wird nicht über die Einträge in Einstellungen informiert, sodass er ansonsten nichts darüber weiß.
  • Der Hostname muss genau übereinstimmen. www.example.com und api.example.com als separate Einträge hinzufügen. IP-Adressen und localhost können nicht verwendet werden.
  • Die Konsole fügt jeder Anfrage eine feste -Kopfzeile hinzu. Services, die ein Token in der URL oder eine für jeden Aufruf signierte Anfrage erwarten, benötigen einen anderen Ansatz.
  • Hosts, die von der Konsole bereits authentifiziert werden, wie GitHub und Figma, verwenden weiterhin die eigenen Anmeldeinformationen der Konsole.
  • Verwenden Sie ein Token nur mit dem Zugriff, den die Aufgabe benötigt, und entfernen Sie den Eintrag, wenn Sie ihn nicht mehr benötigen.

Diese Anmeldeinformationen dienen der Arbeit des Agenten in der Konsole. Ihre veröffentlichte Site kann sie nicht verwenden: Ein Schlüssel, den die Live-Site benötigt, gehört zu einem Server-seitigen Service. Siehe Verbinden von Services und Anwendungen. Ein Beispiel, das den Agenten mit einem Chat-Tool verbindet, finden Sie unter Beispiel: Updates in Slack.

Support anfordern request-support

Wenn etwas nicht wie erwartet funktioniert oder Sie eine Frage haben, die diese Seiten nicht beantworten, sagen Sie dem Team, das den Agenten erstellt. Ihre Anfrage geht direkt an dieses Team, das sie prüft und per E-Mail weiterleitet. Informationen zu Treffen mit Fachexperten oder dem Produkt-Team finden Sie unter Das Team hinter dem Agenten.

  1. Wählen Support anfordern in der Menüleiste oder auf der Seite Einstellungen aus. Auf kleinen Bildschirmen zeigt die Schaltfläche nur das Symbol an.
  2. Wählen Sie optional ein Thema aus: Layout/Design, Fehlender Inhalt, Agent hängt fest oder Etwas Anderes.
  3. Beschreiben das Problem in bis zu 2.000 Zeichen. Benennen Sie die betroffene Seite, was Sie erwartet haben, was stattdessen passiert ist und wann. Geben Sie keine Kennwörter oder Token an.
  4. Wählen Sie optional die letzten Eingabeaufforderungen zum Anhängen aus, damit das Team sehen kann, worum Sie gebeten haben. Keine ist angehängt, es sei denn, Sie wählen sie aus.
  5. Wählen Sie Senden aus.

Die Anfrage gibt Ihre Kontaktdaten und die Sitzungsdetails weiter, die das Team benötigt, um die Konversation und die Protokolle Ihrer Sitzung zu finden; siehe Support-Anfragen für die vollständige Liste. Sie können eine Anfrage pro Minute senden.

Wenn das Gespräch darauf hindeutet, dass du feststeckst oder frustriert bist, kann der prompte Coach Hilfe unter Brauchen Sie Hilfe? Wählen Sie Support kontaktieren, um dieselbe Anfrage zu öffnen, oder Nein danke, um fortzufahren.

Auf den Seiten des automatischen Modus lautet die Schaltfläche Hilfe abrufen. Verwenden Sie diesen Modus, um nach weiteren Seiten oder gleichzeitigen Migrationen zu fragen oder um nach etwas zum Automatikmodus zu fragen. Beschreiben Sie in "können wir Ihnen helfen? und wählen Sie Senden aus. Das Team antwortet per E-Mail.

Neue Funktionen und Versionshinweise whats-new

Wenn eine neue Version der Konsole veröffentlicht wird werden in einem oben auf der Seite die Highlights aufgelistet. Erweitern Sie sie, um die Liste anzuzeigen, oder schließen Sie sie ab. Er wird für die nächste Version wieder angezeigt.

Weitere Informationen zu den einzelnen Versionen finden Sie in den Versionshinweisen zum Experience Modernization ​.

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