Componente Ricerca IA contenuto content-ai-search-component
Il componente Ricerca IA contenuto offre ai visitatori del sito una ricerca generativa basata sull’intelligenza artificiale.
Utilizzo usage
Il componente Ricerca IA contenuto consente ai visitatori di eseguire ricerche in un Source contenuto direttamente da una pagina e, facoltativamente, di visualizzare un riepilogo dei risultati generato dall’intelligenza artificiale. Combina una casella di ricerca full-text/semantica standard con un pannello di riepilogo Mostra riepilogo generato dall’intelligenza artificiale attivato da AEM Content AI.
La finestra di dialogo per modifica consente all’autore di contenuto di definire l’ambito del contenuto della ricerca, il comportamento di ricerca e le impostazioni generative. La finestra di dialogo per progettazione non è disponibile, poiché non sono disponibili impostazioni a livello di modello.
Versione e compatibilità version-and-compatibility
La versione corrente del componente Ricerca IA contenuto è la v1, introdotta con la versione 2.32.0 dei Componenti core a luglio 2026, ed è quella descritta in questo documento.
La tabella che segue descrive tutte le versioni supportate del componente, le versioni di AEM con cui le versioni del componente sono compatibili e i collegamenti alla documentazione delle versioni precedenti.
Per ulteriori informazioni sulle versioni e sugli aggiornamenti dei Componenti core, vedi il documento Versioni dei Componenti core.
Esempio di output del componente sample-component-output
Per avere un’idea del componente Ricerca IA contenuto e vedere esempi delle opzioni di configurazione e dell’output HTML e JSON, visita la libreria dei componenti.
Dettagli tecnici technical-details
La documentazione tecnica più recente sul componente Ricerca IA contenuto è disponibile su GitHub.
Per ulteriori informazioni sullo sviluppo di Componenti core, vedi la documentazione per gli sviluppatori di Componenti core.
Finestra di dialogo per modifica edit-dialog
La finestra di dialogo per modifica consente all’autore di contenuto di definire l’ambito del contenuto della ricerca, il comportamento di ricerca e le impostazioni generative. La finestra di dialogo per progettazione non è disponibile, poiché non sono disponibili impostazioni a livello di modello.
Scheda Ambito contenuto content-scope
-
ID - Questa opzione consente di controllare l’identificatore univoco del componente in HTML e nel Data Layer.
- Se non specificato, viene generato automaticamente un ID univoco reperibile sulla pagina risultante.
- Se l’ID viene specificato, è responsabilità dell’autore accertarsi che sia univoco.
- La modifica dell’ID può avere un impatto sul tracciamento di CSS, JS e livello dati.
-
Tipo di Source contenuto - Questo campo definisce il tipo di origine contenuto. Se si seleziona un tipo, il menu a discesa Source dei contenuti viene compilato con le origini corrispondenti.
- ACQUISIZIONE - Valore predefinito utilizzato per le origini pubbliche con accesso anonimo indicizzate tramite una pipeline di scansiona/acquisizione
- AEM_AUTHOR - Origine lato IA contenuto il cui contenuto è stato acquisito da un’istanza di authoring AEM
- AEM_PUBLISH: origine lato IA contenuto il cui contenuto è stato acquisito da un’istanza AEM Publish
- PERSONALIZZATO - Origine registrata al di fuori delle pipeline di acquisizione di AEM
-
Origini contenuto - Definisce il Source contenuto cercato da questo componente.
- Le voci disponibili corrispondono alle origini di contenuto già esistenti e sono disponibili, nonché al tipo impostato in Content Source Type
- Per informazioni dettagliate, consulta il documento Configurare e gestire le origini di IA per la gestione dei contenuti.
Scheda Comportamento di ricerca search-behavior
-
Layout risultati - Questa opzione definisce come i risultati della ricerca vengono visualizzati al visitatore.
- Schede - Questa opzione visualizza i risultati in formato griglia.
- Elenco - Questa opzione visualizza i risultati in un formato elenco.
-
Dimensione risultati - Definisce il numero di risultati recuperati per richiesta di ricerca.
- Il valore predefinito è
12. - I visitatori possono caricare più risultati quando sono disponibili corrispondenze aggiuntive.
- Il valore predefinito è
-
Testo segnaposto: si tratta del testo visualizzato nel campo di input della ricerca vuoto prima che il visitatore entri in una query di ricerca.
Scheda Ricerca generativa generative-search
-
Mostra/nascondi riepilogo generativo/a ai visitatori - Se questa opzione non è selezionata, i visitatori non possono modificare la visualizzazione o meno del riepilogo di IA.
- Il valore predefinito è abilitato.
-
Mostra riepilogo generativo per impostazione predefinita - Questa opzione controlla lo stato predefinito dell’interruttore rivolto al visitatore per il riepilogo generato da IA.
- Il valore predefinito è abilitato.
-
Errore GenSearch - Fallback - Definisce il comportamento o l’errore della ricerca.
- Solo risultati (nascondi errore) - Se si verifica un errore, visualizzare solo i risultati restituiti, non l’errore e il pulsante non riprova. Questo è il valore predefinito.
- Mostra errore con nuovo tentativo - Se si verifica un errore, visualizzare l’errore con un pulsante nuovo tentativo.
- Mostra solo messaggio di errore - Se si verifica un errore, visualizza solo il messaggio di errore, nessun risultato.