Documentazione AEM Guides Documentazione di AEM Guides

Configurare i suggerimenti avanzati basati sull’intelligenza artificiale per la creazione

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

Utente

In qualità di amministratore, puoi configurare la funzione Suggerimenti avanzati per gli autori. Il servizio di suggerimenti avanzati è 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 nuova funzione di suggerimenti avanzati. La configurazione seguente consente di aggiungere la scheda Configurazione IA al profilo della cartella. Una volta aggiunta, è possibile utilizzare la funzionalità di suggerimenti avanzati nell’editor web.

Creare configurazioni IMS in Adobe Developer Console

Per creare configurazioni IMS in Adobe Developer Console, effettua le seguenti operazioni:

NOTE

Se hai già creato un progetto OAuth per configurare la pubblicazione basata su microservizi, puoi saltare i seguenti passaggi per creare il progetto.

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.
{width="550"}
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 prodotti e tecnologie di 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.

{width="800"}

Connettersi al progetto per visualizzare i dettagli delle credenziali.
Torna alla scheda Progetti e seleziona Panoramica progetto a sinistra.

{width="500"}

Introduzione al nuovo progetto.
Fai clic sul pulsante Scarica nella parte superiore per scaricare il JSON del servizio.

{width="500"}

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 e 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.
Aggiornare il campo JSON SERVICE_ACCOUNT_DETAILS. Assicurati di usare lo stesso nome e la stessa configurazione forniti nella schermata seguente.

configurazione account del servizio ims

Aggiungi i dettagli di configurazione dell'ambiente.

Dopo aver aggiunto la configurazione IMS all’ambiente, esegui i seguenti passaggi 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.json
- com.adobe.fmdita.smartsuggest.service.SmartSuggestConfigurationConsumer.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.

Al termine dell’operazione, dovresti essere in grado di utilizzare la funzione di suggerimenti avanzati.

Appendice appendix

File:
com.adobe.aem.guides.eventing.ImsConfiguratorService.cfg.json

Contenuto:

{
 "service.account.details": "$[secret:SERVICE_ACCOUNT_DETAILS]",
}

File: com.adobe.fmdita.smartsuggest.service.SmartSuggestConfigurationConsumer.cfg.json

Contenuto:

{
  "smart.suggestion.flag":true,
  "conref.inline.threshold":0.6,
  "conref.block.threshold":0.7,
  "emerald.url":"https://adobeioruntime.net/apis/543112-smartsuggest/emerald/v1",
  "instance.type":"prod"
}

Dettagli della configurazione di Smart Suggestions

Chiave

Descrizione

Valori consentiti

Valore predefinito

smart.suggestion.flag

Controlla se i suggerimenti avanzati sono abilitati o meno

true/false

false

conref.inline.threshold

Soglia che controlla la precisione/il richiamo dei suggerimenti recuperati per il tag attualmente digitato dall’utente.

Qualsiasi valore compreso tra -1,0 e 1,0.

0,6

conref.block.threshold

Soglia che controlla la precisione/il richiamo dei suggerimenti recuperati per i tag nell’intero file.

Qualsiasi valore compreso tra -1,0 e 1,0.

0,7

emerald.url

Endpoint per il database vettoriale Emerald

https://adobeioruntime.net/apis/543112-smartsuggest/emerald/v1

instance.type

Tipo di istanza dell’AEM. Assicurati che questo sia univoco per ogni istanza AEM su cui sono configurati i suggerimenti avanzati. Un caso d’uso potrebbe essere quello di testare la funzione nell’ambiente di stage con "instance.type" = "stage" mentre, allo stesso tempo, la funzione è configurata anche su "prod".

Qualsiasi chiave univoca che identifica l’ambiente. Sono consentiti solo valori alfanumerici. "dev"/"stage"/"prod"/"test1"/"stage2"

"prod"

Dopo aver configurato, l’icona dei suggerimenti avanzati viene visualizzata nel pannello a destra dell’Editor web. Quando modifichi gli argomenti, puoi visualizzare l’elenco dei suggerimenti avanzati. Per ulteriori dettagli, visualizza la sezione Suggerimenti avanzati basati su IA per l'authoring nella Guida utente di Experience Manager.

recommendation-more-help

11125c99-e1a1-4369-b5d7-fb3098b9b178