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.

Importante:

È 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

    1. Dopo aver creato un'istanza dell'assistente AI, vai su Home > Integrazioni.

    2. Fare clic su Apri all'interno del riquadro Ricerca per visualizzare la finestra "Apri ricerca".

    3. Nella finestra "Cerca", seleziona Draft l'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, seleziona Live l'opzione nel menu a tendina.

    4. Nella seguente finestra "Modifica di una nuova integrazione di ricerca esistente", selezionare il riquadro Elasticsearch.

  • Selezionare l'integrazione della ricerca Elasticsearch dalla pagina Ambienti

    1. Dopo aver creato un'istanza dell'assistente AI, vai su Home > Ambienti.

    2. Selezionare la scheda 'Draft se si desidera configurare Elasticsearch nell'ambiente draft. Se si desidera configurare Elasticsearch nell'ambiente live, selezionare la scheda 'Live.

    3. 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.

Suggerimento:

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".

  1. 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:

  1. 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.

Integrazione della ricerca

  1. 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

  1. 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.

  2. Nell'opzione Usa il mio indice, digitare il nome dell'indice Elasticsearch.

  3. Fare clic su Avanti per passare alla sezione Abilita la ricerca conversazionale (opzionale).

  4. Nella sezione Abilita la ricerca conversazionale (opzionale), impostare la levetta Ricerca conversazionale su 'on se 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.

  5. 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.

Nota:

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:

  1. Nella sezione Seleziona indice della finestra Elasticsearch, fare clic su Carica documenti in un nuovo indice dell'istanza Elasticsearch.

Nota:

L'assistente AI inoltra i documenti caricati alla tua istanza di Elasticsearch per l'archiviazione, la suddivisione in blocchi e l'indicizzazione.

  1. 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.

  1. 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 ).

Importante:

Non è possibile personalizzare il testo della query nell'assistente AI con una configurazione esistente di " Elasticsearch ".

  1. 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.

Tabella 1. Messaggi relativi ai risultati della ricerca

Scheda

Scenario

Messaggio di esempio

Messaggio

Vengono restituiti i risultati della ricerca

I found this information that might be helpful:

Nessun risultato trovato

Non è stato trovato alcun risultato

I searched my knowledge base for information that might address your query, but did not find anything useful to share.

Problema di connettività

Impossibile completare la ricerca per qualche motivo

I might have information that could help address your query, but am unable to search my knowledge base at the moment.

  1. Passare la levetta " Ricerca conversazionale a " on se si desidera attivare la ricerca conversazionale. Se non si vuole attivare la ricerca conversazionale, spostare la levetta su 'off.

  2. 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.

  3. Fai clic su Salva per salvare le impostazioni.

  4. Fare clic sulla scheda Documenti nella finestra Elasticsearch.

Suggerimento:

La scheda "Documenti" è attiva solo se si seleziona l'opzione "Carica documenti in un nuovo indice" nell'istanza di Elasticsearch.

  1. 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.

Importante:

È 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.

Caricamento del documento Elasticsearch

  1. Dopo aver caricato i documenti, è possibile vedere lo stato di caricamento dei documenti in una tabella nella finestra di Elasticsearch.

  2. Lo stato " Ready indica che i file sono disponibili per la ricerca.

  3. Se lo stato indica " Error, è possibile eliminare il file facendo clic sui tre punti accanto a " Error e su " Delete.

Errore di caricamento di Elasticsearch

  1. 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.

  2. 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.

ConversationalSearchToggleOff

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

ConversationalSearchToggleOn