Configurazione dell’infrastruttura create-first-app
L’infrastruttura è la base tecnica dell’app: gli archivi che memorizzano il codice e i servizi che eseguono i gestori delle azioni e distribuiscono i widget agli utenti.
Come spiegato nella panoramica, un gestore azioni esegue un’attività, ad esempio la ricerca di prodotti, mentre un widget presenta il risultato come un’esperienza interattiva nella conversazione.
LLM Apps archivia il gestore e il codice sorgente del widget in due archivi GitHub separati:
- Archivio azioni: contiene i gestori lato server e i relativi test.
- Archivio widget: contiene il codice e gli stili dei widget interattivi.
Ad esempio, un gestore di ricerca di prodotti recupera i prodotti corrispondenti e il suo widget li visualizza come schede di prodotto. Gli archivi memorizzano tale codice; Adobe I/O Runtime esegue i gestori distribuiti e Edge Delivery Services fornisce i widget.
La procedura guidata di configurazione prepara questi archivi e collega i servizi necessari per l’app. È consigliabile iniziare con l’infrastruttura gestita di Adobe, il modo più veloce per iniziare. Adobe crea e ospita gli archivi per i gestori delle azioni e i widget. Non è necessario configurare manualmente gli archivi.
In alternativa, fornire due archivi GitHub vuoti nel proprio account o organizzazione. La piattaforma li inizializza con i file di progetto richiesti; non è necessario preparare in anticipo il codice dell’azione o del widget.
In questa guida: scopri come scegliere un’opzione di infrastruttura e creare la tua app con la procedura guidata di configurazione. Dopo l’installazione, continuare con Crea azioni.
La creazione dell’app non avvia la generazione delle azioni. Avvia la generazione dell’azione separatamente dalla pagina dell’app.
Apri la procedura guidata di creazione app
Apri App Adobe LLM. Dalla pagina di benvenuto, seleziona Inizia. Se hai già un’app aperta, usa il selettore delle app e seleziona Crea nuova app.
La procedura guidata Crea app LLM inizia con Inizia. Scegli come impostare l’ambiente tecnico.
Entrambe le opzioni supportano la generazione automatica delle azioni in un secondo momento. Nessuna delle due opzioni richiede la scrittura manuale delle azioni.
Utilizzare l’infrastruttura gestita di Adobe adobe-managed-infrastructure
Utilizza questa opzione per consentire ad Adobe di configurare e gestire gli archivi e i servizi connessi per la tua app. Non è necessario creare archivi o installare GitHub app.
- Seleziona Gestione.
- Seleziona Passaggio successivo.
- Completare Dettagli app.
- Selezionare Crea app.
Nella pagina dell’app è visualizzato Configurazione dell’app mentre Adobe prepara gli archivi e connette il sito widget. L’interfaccia utente indica che la configurazione in genere richiede 1-2 minuti; azioni, test e distribuzione rimangono non disponibili fino a quando la configurazione non è pronta.
Se l’installazione non riesce, leggere l’errore e selezionare Riprova. Se la pagina non è in grado di controllare l’avanzamento, l’installazione continua in background. Selezionare Controlla di nuovo per riconnettersi.
Al termine dell’installazione, continuare con Crea azioni.
Collegare i propri archivi your-own-repositories
Seleziona Imposta io stesso, quindi Passaggio successivo. Questo percorso prevede quattro passaggi della procedura guidata:
Introduzione → configurazione dell’infrastruttura di azioni → Configurazione dell’infrastruttura di widget → Dettagli dell’app.
È necessario accedere agli archivi selezionati e disporre delle autorizzazioni necessarie per installare o configurare le GitHub app richieste. Per gli archivi di proprietà dell’organizzazione, un amministratore potrebbe dover approvare l’accesso.
Crea due archivi vuoti: uno per i gestori di azioni e uno per i widget. Non inizializzare con un file README, una licenza o .gitignore. La piattaforma aggiunge la struttura di progetto richiesta quando si convalida ogni archivio nella procedura guidata.
Se si dispone già di azioni compatibili e di progetti EDS, è possibile collegarli, ma non è necessario il codice esistente.
Configurare l’infrastruttura delle azioni
Il repository delle azioni contiene i gestori e i test lato server eseguiti quando una piattaforma LLM richiama un’azione.
-
In Origine azioni, seleziona GitHub. Le altre origini di codice non sono attualmente disponibili.
-
Risposta Esiste già un archivio GitHub?:
- Seleziona Sì, utilizzerò un archivio già creato per connettere un progetto esistente compatibile o un archivio vuoto.
- Seleziona Non ho ancora un archivio, quindi Crea archivi su GitHub, per creare un archivio azioni vuoto. In seguito, torna alla procedura guidata.
-
Connettere l’archivio all’app GitHub delle app Adobe LLM:
- Se nessuna organizzazione è connessa, selezionare Installa su GitHub.
- Se un’organizzazione è già connessa, selezionare Connetti repository e aggiungere il repository a tale installazione.
-
In GitHub, scegli Seleziona solo archivi e concedi l’accesso solo agli archivi utilizzati da questa app.
-
Torna alla procedura guidata. In Seleziona archivio, scegli l’organizzazione e il archivio.
-
Selezionare Convalida repository. La convalida inizializza un archivio vuoto con il modulo di avvio delle app Adobe LLM. Un archivio esistente deve contenere un progetto di azioni compatibile.
-
Dopo la convalida, selezionare Passaggio successivo.
Se manca un’organizzazione o un repository, utilizzare Connetti un’altra organizzazione o Connetti un altro repository nel relativo selettore. Dopo aver modificato l’accesso in GitHub, selezionare Aggiorna organizzazioni e archivi.
Configurare l’infrastruttura dei widget
I widget sono risposte visive facoltative collegate alle azioni, ad esempio schede di prodotto o moduli di prenotazione. La procedura guidata connette un archivio EDS (Edge Delivery Services) per ospitarli.
- In Origine widget, selezionare Seleziona manualmente l’archivio widget.
- In Origine codice, seleziona GitHub.
- Scegli se disponi già di un archivio. In caso contrario, selezionare Crea archivi su GitHub, creare un archivio widget vuoto e tornare alla procedura guidata.
- Installare o configurare l’app Adobe LLM Apps GitHub per questo archivio, come è stato fatto per l’archivio delle azioni.
- Selezionare la relativa organizzazione e archivio. Non selezionare l’archivio delle azioni.
- Selezionare Convalida repository. La convalida inizializza un archivio vuoto con la boilerplate di AEM. Un repository esistente deve essere un progetto EDS compatibile.
- Seleziona Installa AEM Code Sync e concedi l’accesso AEM Code Sync all’archivio widget.
- Nella pagina di conferma dell’installazione, utilizzare la procedura guidata per aggiungere se stessi come amministratore del sito EDS.
- Torna a LLM Apps e seleziona Convalida installazione di AEM Code Sync.
- Quando viene visualizzato AEM Code Sync installato, selezionare Passaggio successivo.
Se la convalida non rileva Sincronizzazione codice AEM, verifica che Sincronizzazione codice AEM abbia accesso all’archivio widget selezionato e che tu sia stato aggiunto come amministratore del sito. Quindi esegui di nuovo la convalida.
Immetti i dettagli dell’app app-details
Entrambe le opzioni di infrastruttura terminano con Dettagli app.
- Immettere il nome dell’app LLM. Utilizza un nome che identifichi il brand o l’esperienza, ad esempio Frescopa Coffee.
- Seleziona il programma AEM a cui appartiene l’app. Se si dispone dell’accesso a un solo programma, la procedura guidata lo seleziona automaticamente.
- In Area dati di Analytics, scegliere Stati Uniti o Europa (UE).
- Selezionare Crea app.
Se non è disponibile alcun programma AEM, chiedi all’amministratore di accedervi. Se il caricamento dei programmi non riesce, selezionare Riprova a caricare i programmi.
La procedura guidata apre la pagina dell’app dopo la creazione. Con l’infrastruttura gestita di Adobe, attendi il completamento della configurazione dell’infrastruttura prima di continuare.
Successivo: creare le azioni
L’app ora dispone della relativa infrastruttura, ma non è ancora stata generata alcuna azione. Continua con Crea azioni per analizzare un sito Web o scegli la creazione manuale di azioni.
Per informazioni sulla relazione tra i metadati delle azioni, i gestori, i widget e il server MCP distribuito, vedere Connessione tra app.