Erste App automatisch erstellen create-first-app
Die Plattform macht Ihre Website zu einer voll funktionsfähigen App. Es schlägt Aktionen vor, schreibt Handler-Code und Tests, erstellt EDS-Widgets und sendet die generierten Dateien an zwei GitHub-Repositorys, die Sie besitzen.
Die Generierung dauert ca. 15 Minuten. Am Ende dieses Tutorials verfügen Sie über eine bereitgestellte App, die Sie in einer unterstützten LLM-Plattform wie ChatGPT testen können.
Journey: Bestätigen Sie die Anforderungen, → zwei Repositorys → erstellen Sie die App → überprüfen Sie die generierten Aktionen, → Sie sie für das Staging bereitstellen → das Plug-in testen, → Produktionssysteme anzuschließen.
Bevor Sie beginnen
Schließen Sie alle LLM Apps-Anforderungen ab, bevor Sie mit diesem Tutorial beginnen.
In diesem Tutorial wird eine LLM-App für Frescopa Coffee erstellt.
Zwei leere Repositorys erstellen
Die Plattform benötigt zwei leere Repositorys. Erstellen Sie beide unter demselben GitHub-Konto oder derselben Organisation:
- Handler-Repository - speichert Aktions-Handler und Tests. Beispiel:
my-brand-llm-app. - EDS-Repository - speichert generierte Widget-Blöcke und -Stile. Beispiel:
my-brand-llm-app-eds.
Navigieren Sie zu github.com/new für jedes Repository.
Initialisieren Sie keines der Repositorys mit einer README-, .gitignore- oder Lizenzdatei. Die Plattform bereitet die erforderliche Projektstruktur vor.
App starten
-
Öffnen Sie Adobe LLM- und wählen Sie App erstellen aus.
-
Geben Sie den LLM-App- und eine optionale Beschreibung ein.
-
Wählen Sie die Analytics-Region aus.
note important IMPORTANT Die Analytics-Region kann nach der Erstellung der App nicht mehr geändert werden. -
Wählen unter „Meine App" die Option Meine App automatisch erstellen aus.
-
Geben in „Ihre" Ihre Website-URL einschließlich des
https://ein. Die Plattform analysiert diese Website, um nützliche Aktionen und repräsentative Beispielergebnisse zu ermitteln.
LLM Apps Zugriff auf die Repositorys gewähren
Die Adobe LLM Apps GitHub App bietet LLM Apps Zugriff auf die von Ihnen ausgewählten Repositorys.
Verbundene Organisation
Wenn die Adobe LLM Apps GitHub App bereits vor der Erstellung der Repositorys installiert war:
- Die verbundene Organisation auswählen.
- Wählen Sie Repositorys auf GitHub verwalten aus.
- Fügen Sie die beiden Repositorys zur vorhandenen GitHub App-Installation hinzu.
- Kehren Sie zu LLM Apps zurück und aktualisieren Sie die Repository-Listen.
Nur erstmalige Verbindung
Wenn die Organisation nicht im Dialogfeld angezeigt wird:
- Wählen Sie GitHub-Organisation verbinden aus.
- Installieren Sie die Adobe LLM Apps GitHub App.
- Wählen Sie Nur Repositorys und wählen Sie die beiden Repositorys aus.
- Kehren Sie zum Dialogfeld LLM-App erstellen zurück.
Wenn Sie die GitHub App nicht installieren oder aktualisieren können, wenden Sie sich an einen Organisationsadministrator.
Repositorys auswählen
-
Wählen unter „Textbausteinrepository die Organisation und das leere Handler-Repository aus.
-
Wählen Sie EDS-Repository die Organisation und das leere EDS-Repository aus.
-
Aktivieren unter "" die Option Ich akzeptiere die Adobe Developer-.
-
Wählen Sie App erstellen aus.
EDS-Einrichtung abschließen
Wenn das ausgewählte EDS-Repository leer ist, wird es von LLM Apps mit dem AEM-Textbaustein initialisiert. Im Dialogfeld werden Sie dann aufgefordert, AEM Code Sync zu installieren, bevor Sie versuchen, die App erneut zu erstellen.
-
Wählen Sie in der Meldung unter dem EDS-Repository die Option AEM Code Sync installieren aus.
-
Installieren Sie auf GitHub AEM Code Sync und gewähren Sie ihm Zugriff auf das EDS-Repository.
Wählen Sie auf der AEM-Code-Synchronisierung registriert unter „Site-" die Option + Benutzer hinzufügen und fügen Sie die E-Mail-Adresse hinzu, mit der Sie sich bei LLM Apps mit der Rolle admin anmelden. Wählen Sie dann Setup beenden unten auf der Seite aus.
-
Kehren Sie zum Dialogfeld LLM-App erstellen zurück.
Sie müssen Administrator für die EDS-Site sein. Wenn im Dialogfeld gemeldet wird, dass Sie kein Administrator sind:
-
Wählen Sie AEM Live Admin öffnen.
-
Fügen Sie sich als Administrator für die EDS-Website hinzu, indem Sie auf die Schaltfläche + Benutzer hinzufügen.
-
Kehren Sie zu LLM Apps zurück, aktualisieren Sie das EDS-Repository und wählen Sie erneut App erstellen aus.
Nachdem die Repository- und Administrator-Prüfungen bestanden wurden, erstellt LLM Apps die App und beginnt mit der Erstellung von Aktionen.
Auf die Erstellung von Aktionen warten
Gehen Sie Seite Aktionen“ von links. Die Seite Aktionen zeigt "für Ihr Gesprächserlebnis“ an während der Agent die Website analysiert und die App generiert. Die Generierung dauert in der Regel etwa 15 Minuten. Sie können diese Seite verlassen und später zurückkehren.
Während der Generierung LLM Apps:
- Analysiert die Website und identifiziert nützliche Kundenabsichten.
- Erstellt Aktionsmetadaten, einschließlich Beschreibungen und Eingabeparametern.
- Generiert einen Handler und testet für jede Aktion im Handler-Repository.
- Erzeugt ein EDS-Widget für jede Aktion im EDS-Repository.
- Bereitet die Aktionen zur Überprüfung vor.
Die generierten Handler verwenden zunächst Beispieldaten, die von der Website abgeleitet wurden. Sie demonstrieren das gesamte Erlebnis, stellen jedoch keine Verbindung zu Ihren Produktionssystemen her.
Überprüfen der generierten Aktionen
Nach Abschluss der Generierung zeigt die Seite Aktionen die generierten Aktionen und Widget-Vorschauen an. Jede Aktion hat eine KI-generierte Aktion, muss überprüft.
Für jede Aktion:
- Wählen Sie Überprüfen aus.
- Überprüfen Sie den Namen, die Beschreibung, die Parameter, die Anmerkungen, den generierten Handler und das Widget.
- Wählen Sie Als geprüft markieren aus. Dadurch werden die generierten Pull-Anforderungen zusammengeführt.
- Kehren Sie zur Seite Aktionen zurück und wiederholen Sie den Vorgang für die verbleibenden Aktionen.
Wenn alle Aktionen überprüft wurden, wählen Sie Zur App-Seite wechseln aus.
Bereitstellen der App
- Kehren Sie zur App-Detailseite zurück.
- Wählen Sie Bereitstellen aus.
- Wählen Sie Staging als Zielumgebung aus.
- Wählen Sie Bereitstellen aus.
Warten Sie, während LLM Apps die App vorbereitet, erstellt und veröffentlicht.
Nach der Bereitstellung wird Abschnitt „App testen die Staging-MCP-Server-URL angezeigt. Wählen Sie URL kopieren aus.
Test in ChatGPT
Folgen Sie Testen in ChatGPT, um ein Plug-in mithilfe der Staging-MCP-Server-URL zu erstellen.
Stellen Sie eine Frage, die einer der generierten Aktionen entspricht. Überprüfen Sie, ob:
- ChatGPT wählt die erwartete Aktion aus.
- Das Widget wird gerendert und enthält die erwarteten Beispieldaten.
- Widget-Steuerelemente erzeugen das erwartete Folgeverhalten.
- Die Textantwort fasst das Ergebnis genau zusammen.
Sie verfügen jetzt über eine voll funktionsfähige, funktionierende End-to-End-App.
Produktionsbereit machen
Die generierte App verwendet Beispieldaten. Vor der Verwendung mit Kunden:
- Systeme verbinden - jeden generierten Handler anpassen um Beispieldaten durch Aufrufe an Ihre APIs oder Datenquellen zu ersetzen.
- Anmeldeinformationen schützen - API-URLs und Anmeldeinformationen werden in der verwalteten Laufzeitkonfiguration gespeichert, nie im Quell-Code oder Widget-JavaScript.
- Daten validieren - Validieren von Aktionsargumenten und API-Antworten, Hinzufügen von Anfrage-Timeouts und Rückgeben sicherer Fehlermeldungen.
- Widgets aktualisieren - Halten Sie jedes Widget an den
structuredContentseines Handlers ausgerichtet und wenden Sie dann Ihre Branding- und Barrierefreiheitsanforderungen an. Siehe Anpassen eines generierten Widgets. - Handler testen - umfasst gültige Eingaben, ungültige Eingaben, leere Ergebnisse, API-Fehler und die vom Widget erwartete Datenform.
- In Staging überprüfen - Stellen Sie jede Aktion über das Plug-in ChatGPT erneut bereit und testen Sie sie.
- In Produktion bereitstellen - Nach erfolgreichem Staging-Test können Sie das Plug-in in der Produktion bereitstellen und mit der Produktions-MCP-Server-URL erstellen oder aktualisieren.
Informationen zum Hinzufügen einer Funktion, die von der Plattform nicht erstellt wurde, finden Sie unter Erstellen einer neuen Aktion.