Configurare l’Assistente AI
In qualità di amministratore, puoi configurare la funzione Assistente IA in Experience Manager Guides. L’Assistente AI è protetto dall’autenticazione basata sull’autenticazione di Adobe IMS. Integra il tuo ambiente con i flussi di lavoro di autenticazione sicuri basati su token di Adobe e inizia a utilizzare la funzione di assistenza AI. La configurazione seguente consente di aggiungere la scheda Configurazione IA al profilo della cartella. Una volta aggiunto, puoi utilizzare la funzione Assistente IA in Experience Manager Guides.
Per configurare l’Assistente AI, effettua le seguenti operazioni:
- Crea configurazione IMS in Adobe Developer Console.
- Aggiungere configurazioni IMS all’ambiente
- Abilitare il flag AI nell’ambiente
- Aggiungere la variabile GUIDES_AI_SITE_ID nell’ambiente
- Applicare le modifiche all’ambiente
- Abilitare l’Assistente AI nel profilo cartella
- Configurare suggerimenti avanzati nel profilo cartelle
Creare configurazioni IMS in Adobe Developer Console
Per creare configurazioni IMS in Adobe Developer Console, effettua le seguenti operazioni:
-
Avvia Adobe Developer Console.
-
Dopo aver effettuato correttamente l'accesso a Developer Console, verrà visualizzata la schermata Home. Nella schermata Home è possibile trovare facilmente informazioni e collegamenti rapidi, inclusi i collegamenti di navigazione superiore a progetti e download.
-
Per creare un nuovo progetto vuoto, seleziona Crea nuovo progetto dai collegamenti Avvio rapido.
Crea un nuovo progetto. -
Selezionare Aggiungi API dalla schermata Progetti. Viene visualizzata la schermata Aggiungi API. Questa schermata mostra tutte le API, gli eventi e i servizi disponibili per i prodotti e le tecnologie Adobe con cui puoi sviluppare applicazioni.
-
Seleziona l'API di gestione I/O per aggiungerla al progetto.
Aggiungi API di gestione I/O al progetto. -
Crea una nuova credenziale OAuth e salvala.
Configura le credenziali OAuth nell'API.
-
Nella scheda Progetti, scegli l'opzione OAuth Server to Server, quindi seleziona le credenziali appena create.
-
Seleziona il collegamento OAuth Server-to-Server per visualizzare i dettagli delle credenziali del progetto.
Connettersi al progetto per visualizzare i dettagli delle credenziali.
-
Torna alla scheda Progetti e seleziona Panoramica progetto a sinistra.
Introduzione al nuovo progetto.
-
Seleziona il pulsante Scarica nella parte superiore per scaricare il JSON del servizio.
Scarica i dettagli del servizio JSON.
Hai configurato i dettagli di autenticazione OAuth e scaricato i dettagli del servizio JSON. Mantieni il file a portata di mano in quanto richiesto nella sezione successiva.
Aggiungere la configurazione IMS all’ambiente
Per aggiungere la configurazione IMS all’ambiente, effettua le seguenti operazioni:
-
Apri Experience Manager, quindi seleziona il programma contenente l’ambiente da configurare.
-
Passa alla scheda Ambienti.
-
Seleziona il nome dell’ambiente da configurare. Dovresti passare alla pagina Informazioni sull'ambiente.
-
Passa alla scheda Configurazione.
-
Aggiorna il campo JSON -
SERVICE_ACCOUNT_DETAILS. Assicurati di usare lo stesso nome e la stessa configurazione forniti nella schermata seguente.
Abilitare il flag AI nell’ambiente
Per abilitare la funzione Assistente IA nell'interfaccia utente di Experience Manager Guides, aggiungi il flag ENABLE_GUIDES_AI nell'ambiente.
Assicurati di usare lo stesso nome e la stessa configurazione forniti nella schermata seguente.
L'impostazione del flag su true abilita la funzionalità, mentre l'impostazione su false la disabilita.
Aggiungere la variabile GUIDES_AI_SITE_ID nell’ambiente
Aggiungi la variabile GUIDES_AI_SITE_ID nell'ambiente (Cloud Manager) e imposta il valore su id_f651abc807c84f52b425737bb93f87ba per abilitarla.
Assicurati di usare lo stesso nome e la stessa configurazione forniti nella schermata seguente.
Applicare le modifiche all’ambiente
Dopo aver aggiunto la configurazione IMS e aver abilitato il flag Assistente IA nell’ambiente, effettua le seguenti operazioni per collegare queste proprietà ad AEM Guides utilizzando OSGi:
-
Nel codice del progetto Git di Cloud Manager, aggiungi i due file seguenti (per il contenuto del file, visualizza Appendice).
com.adobe.aem.guides.eventing.ImsConfiguratorService.cfg.jsoncom.adobe.guides.ai.config.service.AiConfigImpl.cfg.json
-
Assicurati che i file appena aggiunti siano coperti dal tuo
filter.xml. -
Esegui il commit e invia le modifiche Git.
-
Esegui la pipeline per applicare le modifiche all’ambiente.
Abilitare l’Assistente AI nel profilo cartella
Una volta applicate le modifiche alla configurazione, abilita la funzione Assistente IA per il profilo cartella desiderato.
Per ulteriori dettagli, visualizzare Conoscere le funzionalità dell'editor.
Configurare suggerimenti avanzati nel profilo cartelle
Dopo aver abilitato la funzione Assistente AI, configura la funzionalità Suggerimenti avanzati in Profilo cartella.
Per ulteriori informazioni, vedere Configurare suggerimenti avanzati nel profilo cartelle.
Appendice appendix
File:com.adobe.aem.guides.eventing.ImsConfiguratorService.cfg.json
Contenuto:
{
"service.account.details": "$[secret:SERVICE_ACCOUNT_DETAILS]"
}
File: com.adobe.guides.ai.config.service.AiConfigImpl.cfg.json
Contenuto:
{
"conref.inline.threshold":0.6,
"conref.block.threshold":0.7,
"related.link.threshold":0.5,
"emerald.url":"https://adobeioruntime.net/apis/543112-smartsuggest/emerald/v1",
"instance.type":"prod",
"chat.url":"https://aem-guides-ai-v2.adobe.io"
}
Dettagli di configurazione dell’Assistente IA
Dopo aver configurato, l’icona Assistente AI viene visualizzata nella home page e nell’editor di Experience Manager Guides. Per ulteriori dettagli, visualizzare la sezione Assistente AI nella Guida utente di Experience Manager.