Impostazione dell'integrazione della ricerca Elasticsearch
Elasticsearch consente al tuo assistente IA di eseguire diversi tipi di ricerche (metriche, strutturate, non strutturate e semantiche) con maggiore precisione e pertinenza, sfruttando i contenuti aziendali. Il motore di analisi dei dati di Elasticsearch amplia la portata dell'integrazione della ricerca a insiemi di dati più grandi nell'assistente AI. Oltre a questa integrazione, puoi attivare la ricerca conversazionale per Elasticsearch nel tuo assistente AI, che ti aiuta a rispondere alle domande in modo colloquiale.
È possibile avere una sola integrazione di ricerca per ambiente. Quando si sostituisce l'integrazione di ricerca esistente con altri tipi di integrazione, come "Servizio personalizzato" o " Milvus ", le impostazioni dell'integrazione di ricerca esistente vengono sovrascritte.
Selezione di Elasticsearch
Per selezionare Elasticsearch come integrazione di ricerca predefinita, utilizzare una delle seguenti procedure:
Selezione dell'integrazione di ricerca Elasticsearch dalla pagina Integrazioni
Dopo aver creato un'istanza dell'assistente AI, vai su Home > Integrazioni.
Fare clic su Apri all'interno del riquadro Ricerca per visualizzare la finestra "Apri ricerca".
Nella finestra "Cerca", seleziona
Draftl'opzione nel menu a tendina se desideri configurare " Elasticsearch " nell'ambiente di bozza del tuo assistente AI. Se desideri configurare l' Elasticsearch e nell'ambiente di produzione del tuo assistente AI, selezionaLivel'opzione nel menu a tendina.Nella seguente finestra "Modifica di una nuova integrazione di ricerca esistente", selezionare il riquadro Elasticsearch.
Selezionare l'integrazione della ricerca Elasticsearch dalla pagina Ambienti
Dopo aver creato un'istanza dell'assistente AI, vai su Home > Ambienti.
Selezionare la scheda '
Draftse si desidera configurare Elasticsearch nell'ambiente draft. Se si desidera configurare Elasticsearch nell'ambiente live, selezionare la scheda 'Live.Nella sezione Metodi di risoluzione, fare clic su Aggiungi all'interno del riquadro Ricerca sotto Estensioni se si desidera aggiungere una nuova integrazione di ricerca Elasticsearch.
Se hai già aggiunto l'integrazione di ricerca " Elasticsearch ", vedrai il pulsante "Apri" al posto di "Aggiungi" all'interno del riquadro "Ricerca" nella sezione "Estensioni".
Nella finestra "Imposta una nuova estensione di ricerca", selezionare il riquadro Elasticsearch per visualizzare la finestra di dialogo "Integrazione di ricerca".
Impostazione di Elasticsearch
Per configurare " Elasticsearch " sul tuo assistente AI, segui questa procedura:
Nella prima sezione della finestra "Integrazione della ricerca", compila i seguenti campi per consentire al tuo assistente AI di connettersi alla tua istanza di Elasticsearch :
Elasticsearch url
Porta diElasticsearch (opzionale)
Scegliere un tipo di autenticazione
Se si seleziona "
Basic authentication, è necessario fornire " Elasticsearch nome utente e " password Elasticsearch .Se si seleziona '
API key, è necessario fornire la chiave API diElasticsearch.se si seleziona
None, non è possibile fornire altri dati di autenticazione.

Fare clic su Avanti per passare alla sezione Selezionare un indice. Selezionare un indice ha due opzioni:
Per utilizzare un indice esistente, selezionare Usa il mio indice.
Per creare un nuovo indice, selezionare Carica documenti in un nuovo indice nell'istanza Elasticsearch.
Utilizzo di un indice esistente
Nella sezione Seleziona indice, fare clic su Usa il mio indice per collegarsi a un indice Elasticsearch esistente. L'opzione Usa il mio indice è selezionata come predefinita nella configurazione di Elasticsearch.
Nell'opzione Usa il mio indice, digitare il nome dell'indice Elasticsearch.
Fare clic su Avanti per passare alla sezione Abilita la ricerca conversazionale (opzionale).
Nella sezione Abilita la ricerca conversazionale (opzionale), impostare la levetta Ricerca conversazionale su '
onse si desidera attivare la ricerca conversazionale. Se non si desidera attivare la ricerca conversazionale, spostare la levetta su 'off. Per ulteriori informazioni sulla ricerca conversazionale, vedere Ricerca conversazionale.Fare clic su Salva e poi su Chiudi.
Caricamento di documenti in un nuovo indice (Beta)
Prima di caricare i documenti, l'istanza Elasticsearch deve avere i seguenti prerequisiti:
Elasticsearch 8.8 o superiore.
Un abbonamento a pagamento o di prova all'istanza dell' Elasticsearch, come ad esempio la Platinum Edition disponibile su IBM Cloud Databases for Elasticsearch oppure l'abbonamento Platinum o Enterprise offerto da [ Elastic.co ]( https://www.elastic.co/subscriptions ).
Un nodo di Machine Learning (ML) con un minimo di 4 GB di memoria per distribuire il modello ELSER. Per ulteriori informazioni sui requisiti ELSER, consultare la sezione "Requisiti ELSER".
I documenti caricati devono essere in inglese.
Se l'istanza di Elasticsearch non dispone dei prerequisiti per il caricamento del documento, viene visualizzato il messaggio di errore Requisiti non soddisfatti.
Se si verificano ritardi o errori nel caricamento dei documenti nonostante siano soddisfatti i prerequisiti, è possibile valutare la possibilità di ottimizzare le prestazioni di inferenza dell'implementazione del modello ELSER configurando parametri quali number_of_allocations e threads_per_allocation. Per ulteriori informazioni su come ottimizzare le prestazioni di inferenza, consultare l'API per l'implementazione dei modelli addestrati.
Per caricare i documenti in un nuovo indice, utilizzare la seguente procedura:
Nella sezione Seleziona indice della finestra Elasticsearch, fare clic su Carica documenti in un nuovo indice dell'istanza Elasticsearch.
L'assistente AI inoltra i documenti caricati alla tua istanza di Elasticsearch per l'archiviazione, la suddivisione in blocchi e l'indicizzazione.
Nella sezione Configura il contenuto dei risultati, fornire i seguenti campi per mappare il titolo, il corpo e l' URL della risposta di ricerca:
Titolo
Titolo del risultato della ricerca. Utilizza il titolo, il nome o un tipo di campo simile dalla raccolta come titolo del risultato della ricerca.
Devi selezionare qualcosa per il titolo o non viene visualizzata alcuna risposta di risultato della ricerca nelle integrazioni Facebook e Slack.
Corpo
Descrizione del risultato della ricerca. Utilizza un campo astratto, di riepilogo o di evidenziazione dalla raccolta come corpo del risultato della ricerca.
Devi selezionare qualcosa per il corpo o non viene visualizzata alcuna risposta di risultato della ricerca nelle integrazioni Facebook e Slack.
URL
Questo campo può essere popolato con qualsiasi contenuto a piè di pagina che si desidera includere alla fine del risultato della ricerca.
Quando si configura il corpo della query in Impostazioni avanzate di Elasticsearch per cercare i documenti annidati, è necessario assicurarsi che i campi Titolo, Corpo e URL provengano dai campi dei documenti interni nell'indice Elasticsearch. Per ulteriori informazioni sull'uso delle query annidate, consultare Elasticsearch nested query.
Espandere la sezione Impostazioni avanzate Elasticsearch per visualizzare le seguenti caselle di testo:
Configurare l'array di filtri per Elasticsearch
Si definisce il filtro come un array di oggetti, in modo da poter creare filtri per organizzare il contenuto in base al corpo della query. Per ulteriori informazioni, consultare la sezione "Configurazione dei filtri personalizzati ".
Configurare il corpo della query per Elasticsearch
Il corpo della query viene utilizzato per manipolare le richieste dell'utente in un formato che la ricerca si aspetta. Controlla i moduli della query, i campi di ricerca, i filtri e le dimensioni della query. Nell'API REST, il corpo della query è un oggetto che rappresenta il corpo " POST per la richiesta " _search a Elasticsearch. Il corpo della query ha un token '"$QUERY" per rappresentare la domanda del cliente e un token '"$FILTER" per rappresentare la serie di filtri definiti nelle impostazioni di ricerca o a livello di passo.
Per impostazione predefinita, l'integrazione di Elasticsearch utilizza la ricerca per parole chiave. Ma è possibile configurare il corpo della query nell' Advanced Elasticsearch settings , per abilitare tecniche di ricerca più avanzate, come ad esempio:
Ricerca semantica con ELSER
Ricerca vettoriale densa KNN
Utilizzo di query nidificate per cercare nei documenti nidificati
Ricerca ibrida
Ricerca su un campo di testo semantico
Per ulteriori informazioni sull'utilizzo dei diversi tipi di esempi di corpo della query, consultare Esempi di corpo della query.
Per ulteriori informazioni sul corpo della richiesta API di _search Elasticsearch, consultare [il corpo della richiesta API di ricerca di Elasticsearch ]( https://www.elastic.co/guide/en/elasticsearch/reference/current/search-search.html#search-search-api-request-body ).
Non è possibile personalizzare il testo della query nell'assistente AI con una configurazione esistente di " Elasticsearch ".
Utilizzare le schede Messaggio, Nessun risultato trovato e Problema di connettività per personalizzare diversi messaggi da condividere con gli utenti in base al successo della ricerca.
Scheda | Scenario | Messaggio di esempio |
|---|---|---|
Messaggio | Vengono restituiti i risultati della ricerca |
|
Nessun risultato trovato | Non è stato trovato alcun risultato |
|
Problema di connettività | Impossibile completare la ricerca per qualche motivo |
|
Passare la levetta " Ricerca conversazionale a "
onse si desidera attivare la ricerca conversazionale. Se non si vuole attivare la ricerca conversazionale, spostare la levetta su 'off.Se si attiva la ricerca conversazionale su '
on, si possono vedere i titoli delle citazioni nelle risposte dell'assistente. Per ulteriori informazioni sulla ricerca conversazionale, vedere Ricerca conversazionale.Fai clic su Salva per salvare le impostazioni.
Fare clic sulla scheda Documenti nella finestra Elasticsearch.
La scheda "Documenti" è attiva solo se si seleziona l'opzione "Carica documenti in un nuovo indice" nell'istanza di Elasticsearch.
Fare clic sul pulsante Carica. Nella sezione "Carica documenti " puoi trascinare i tuoi file o fare un semplice clic per caricarli direttamente sul tuo assistente AI.
È possibile caricare fino a 20 documenti alla volta. Le dimensioni di ciascun documento non devono superare i 25 KB. La dimensione totale di tutti i documenti non deve superare i 50 MB.

Dopo aver caricato i documenti, è possibile vedere lo stato di caricamento dei documenti in una tabella nella finestra di Elasticsearch.
Lo stato "
Readyindica che i file sono disponibili per la ricerca.Se lo stato indica "
Error, è possibile eliminare il file facendo clic sui tre punti accanto a "Errore su "Delete.

Saltate questo passaggio se non volete cambiare le credenziali dell'istanza Elasticsearch. Se si desidera modificare le credenziali dell'istanza Elasticsearch, fare clic sulla scheda Istanza, modificare le credenziali e quindi fare clic su Salva.
Fare clic su Salva e poi su Chiudi per terminare la configurazione di Elasticsearch.
Configurazione dell'assistente per l'utilizzo di Elasticsearch
Dopo aver configurato l'integrazione di ricerca con Elasticsearch, è necessario configurare l 'assistente AI in modo che utilizzi Elasticsearch quando la risposta del cliente non richiede alcuna azione. Per ulteriori informazioni su come aggiornare l'opzione "Nessun risultato" per utilizzare la ricerca, consulta la sezione "Utilizzare la ricerca quando non vengono trovati risultati ".
Testare Elasticsearch
È possibile testare l'integrazione della ricerca con Elasticsearch nell'anteprima delle azioni, nella pagina di anteprima o utilizzando il link di anteprima.
In questo esempio, l'utente chiede: 'Tell me about a custom extension.
I risultati della ricerca vengono estratti dalla vostra base di conoscenze quando la ricerca conversazionale è 'off. La risposta è 'I searched my knowledge base and found this information which might be useful.

Una risposta testuale dai migliori risultati della vostra base di conoscenze viene visualizzata quando la ricerca conversazionale è 'on.
