Einrichten der Infrastruktur create-first-app
Infrastruktur ist die technische Grundlage für Ihre App: die Repositorys, die den Code speichern, und die Services, die die Aktionshandler ausführen und die Widgets für die Benutzer bereitstellen.
Wie in der Übersicht erläutert, führt ein Aktionshandler eine Aufgabe aus, z. B. das Suchen von Produkten, während ein Widget das Ergebnis als interaktives Erlebnis in der Konversation darstellt.
LLM Apps speichert Handler- und Widget-Quell-Code in zwei separaten GitHub:
- Aktions-Repository - enthält die Server-seitigen Handler und ihre Tests.
- Widget-Repository - Enthält den Code und die Stile für die interaktiven Widgets.
Beispielsweise ruft ein Produkt-Such-Handler übereinstimmende Produkte ab und zeigt diese als Produktkarten an. Die Repositorys speichern diesen Code. Adobe I/O Runtime führt die bereitgestellten Handler aus, und Edge Delivery Services stellt die Widgets bereit.
Der Setup-Assistent bereitet diese Repositorys vor und verbindet die Services, die Ihre App benötigt. Es wird empfohlen, mit Adobe Managed Infrastructure zu beginnen, was der schnellste Einstieg ist. Adobe erstellt und hostet die Repositorys für Ihre Aktionshandler und Widgets. Sie müssen Repositorys nicht selbst einrichten.
Geben Sie alternativ zwei leere GitHub-Repositorys in Ihrem eigenen Konto oder Ihrer Organisation an. Die Plattform initialisiert sie mit den erforderlichen Projektdateien. Es ist nicht erforderlich, Aktion oder Widget-Code im Voraus vorzubereiten.
In diesem Handbuch: Erfahren Sie, wie Sie mit dem Einrichtungsassistenten eine Infrastrukturoption auswählen und Ihre App erstellen. Fahren Sie nach dem Setup mit Aktionen erstellen fort.
Beim Erstellen der App wird nicht Aktionserstellung gestartet. Starten Sie die Aktionserstellung getrennt von der App-Seite.
Öffnen des Assistenten zum Erstellen einer App
Öffnen Sie Adobe LLM Apps. Wählen Sie auf der Startseite die Option Erste Schritte aus. Wenn Sie bereits eine App geöffnet haben, verwenden Sie den App-Selektor und wählen Sie Neue App erstellen.
Der Create Your LLM App-Assistent beginnt mit Erste Schritte. Wählen Sie aus, wie die technische Umgebung eingerichtet werden soll.
Beide Optionen unterstützen eine spätere automatische Aktionserstellung. Für keine dieser Optionen müssen Aktionen manuell geschrieben werden.
Verwenden der von Adobe verwalteten Infrastruktur adobe-managed-infrastructure
Verwenden Sie diese Option, damit Adobe die Repositorys und Connected Services für Ihre App einrichten und verwalten kann. Sie müssen keine Repositorys erstellen oder GitHub Apps selbst installieren.
- Wählen Sie Übernehmen wir aus.
- Wählen Sie Nächster Schritt aus.
- Vollständige App-Details.
- Wählen Sie App erstellen aus.
Auf der App-Seite wird Einrichten der App angezeigt, während Adobe die Repositorys vorbereitet und die Widget-Site verbindet. Die Benutzeroberfläche zeigt an, dass die Einrichtung in der Regel 1-2 Minuten dauert. Aktionen, Tests und die Bereitstellung bleiben bis zur Einrichtung nicht verfügbar.
Wenn das Setup fehlschlägt, lesen Sie den Fehler und wählen Sie "". Wenn die Seite den Fortschritt nicht überprüfen kann, wird die Einrichtung im Hintergrund fortgesetzt. Wählen Sie Erneut überprüfen, um die Verbindung wiederherzustellen.
Fahren Sie nach Abschluss des Setups mit Aktionen erstellen fort.
Eigene Repositorys verbinden your-own-repositories
Wählen Sie Ich richte es selbst ein und dann Nächster Schritt. Dieser Pfad weist vier Assistentenschritte auf:
Erste Schritte → Einrichten der Aktionsinfrastruktur → Einrichten der Widget-Infrastruktur → App-Details.
Sie benötigen Zugriff auf die ausgewählten Repositorys und die Berechtigung zum Installieren oder Konfigurieren der erforderlichen GitHub Apps. Bei Repositorys im Besitz eines Unternehmens muss ein Administrator möglicherweise den Zugriff genehmigen.
Erstellen Sie zwei leere Repositorys: eines für Aktions-Handler und eines für Widgets. Weder mit einer README, noch mit einer Lizenz oder .gitignore initialisieren. Die Plattform fügt die erforderliche Projektstruktur hinzu, wenn Sie jedes Repository im Assistenten überprüfen.
Wenn Sie bereits über kompatible Action- und EDS-Projekte verfügen, können Sie diese stattdessen verbinden, vorhandener Code ist jedoch nicht erforderlich.
Einrichten der Aktionsinfrastruktur
Das Aktions-Repository enthält die Server-seitigen Handler und Tests, die ausgeführt werden, wenn eine LLM-Plattform eine Aktion aufruft.
-
Wählen unter „Aktionsquelle die Option GitHub. Die anderen Code-Quellen sind derzeit nicht verfügbar.
-
Antwort Haben Sie bereits ein GitHub-Repository erstellt?:
- Wählen Sie Ja, ich werde ein bereits erstelltes Repository verwenden um ein kompatibles vorhandenes Projekt oder ein leeres Repository zu verbinden.
- Wählen Sie Ich habe noch kein Repository und dann Erstellen von Repositorys auf GitHub aus, um ein leeres Aktions-Repository zu erstellen. Kehren Sie anschließend zum Assistenten zurück.
-
Verbinden des Repositorys mit der Adobe LLM Apps GitHub App:
- Wenn keine Organisation verbunden ist, wählen Sie Auf GitHub installieren aus.
- Wenn eine Organisation bereits verbunden ist, wählen Sie Repository verbinden und fügen Sie das Repository zu dieser Installation hinzu.
-
Wählen Sie GitHub Nur Repositorys auswählen und gewähren Sie nur Zugriff auf die Repositorys, die von dieser App verwendet werden.
-
Zurück zum Assistenten. Wählen unter " auswählen“ die Optionen Organisation und Repository.
-
Wählen Sie Repository validieren aus. Bei der Validierung wird ein leeres Repository mit dem Adobe LLM Apps-Textbaustein initialisiert. Ein vorhandenes Repository muss ein kompatibles Aktionsprojekt enthalten.
-
Klicken Sie nach erfolgreicher Validierung auf Nächster Schritt.
Wenn eine Organisation oder ein Repository fehlt, verwenden Sie Andere Organisation verbinden oder Anderes Repository verbinden in der Auswahl. Nachdem Sie den Zugriff auf GitHub geändert haben, wählen Sie Organisationen und Repositorys aktualisieren aus.
Einrichten der Widget-Infrastruktur
Widgets sind optionale visuelle Antworten, die an Aktionen angehängt werden, z. B. Produktkarten oder Buchungsformulare. Der Assistent verbindet ein Edge Delivery Services-Repository (EDS), um sie zu hosten.
- Wählen unter Widget-Quelle die Option Widget-Repository manuell.
- Wählen unter "" GitHub aus.
- Wählen Sie aus, ob Sie bereits über ein Repository verfügen. Andernfalls wählen Sie Erstellen von Repositorys auf GitHub, erstellen Sie ein leeres Widget-Repository und kehren Sie zum Assistenten zurück.
- Installieren oder konfigurieren Sie die Adobe LLM Apps GitHub App für dieses Repository, wie Sie es auch für das Aktions-Repository getan haben.
- Wählen Sie die Organisation und Repository aus. Wählen Sie nicht das Aktions-Repository.
- Wählen Sie Repository validieren aus. Bei der Validierung wird ein leeres Repository mit dem AEM-Textbaustein initialisiert. Ein vorhandenes Repository muss ein kompatibles EDS-Projekt sein.
- Wählen Sie AEM Code Sync installieren und gewähren Sie AEM Code Sync Zugriff auf das Widget-Repository.
- Verwenden Sie auf der Seite zur Installationsbestätigung den Setup-Assistenten, um sich als Administrator der EDS-Site hinzuzufügen.
- Kehren Sie zu LLM Apps zurück und wählen Installation von AEM Code-Synchronisierung validieren.
- Wenn AEM Code Sync installed angezeigt wird, wählen Sie Nächster Schritt.
Wenn bei der Validierung keine AEM-Codesynchronisierung erkannt wird, stellen Sie sicher, dass AEM-Codesynchronisierung Zugriff auf das ausgewählte Widget-Repository hat und dass Sie sich selbst als Site-Admin hinzugefügt haben. Validieren Sie dann erneut.
Mobile-App-Details eingeben app-details
Beide Infrastrukturoptionen enden mit App-Details.
- Geben Sie den LLM-App-Namen ein. Verwenden Sie einen Namen, der die Marke oder das Erlebnis identifiziert, z. B „Frescopa Coffee.
- Wählen Sie das AEM Programm aus, zu dem die App gehört. Wenn Sie nur Zugriff auf ein Programm haben, wählt der Assistent dieses Programm automatisch aus.
- Wählen unter „Analytics Datenregion“ die Option Vereinigte Staaten (USA) oder Europa (EU).
- Wählen Sie App erstellen aus.
Wenn kein AEM-Programm verfügbar ist, bitten Sie Ihren Administrator um Zugriff. Wenn das Laden der Programme fehlschlägt, wählen Sie Programme erneut laden aus.
Der Assistent öffnet die App-Seite nach der Erstellung. Warten Sie bei Adobe Managed Infrastructure, bis die Einrichtung der Infrastruktur abgeschlossen ist, bevor Sie fortfahren.
Weiter: Erstellen der Aktionen
Ihre App verfügt jetzt über die Infrastruktur, es wurden jedoch noch keine Aktionen generiert. Fahren Sie mit Aktionen erstellen fort, um eine Website zu analysieren oder manuelle Aktionserstellung zu wählen.
Informationen zur Beziehung zwischen Aktionsmetadaten, Handlern, Widgets und dem bereitgestellten MCP-Server finden Sie Wie eine App verkabelt wird.