IBM Cloud Docs
Einrichtung Elasticsearch

Einrichtung Elasticsearch

Plus Unternehmen IBM Cloud Pak for DataIBM Software Hub

Elasticsearch bietet Ihren Assistenten die Möglichkeit, verschiedene Arten von Suchen wie Metriken, strukturierte, unstrukturierte und semantische Suchen mit höherer Genauigkeit und Relevanz auszuführen, indem sie Unternehmensinhalte nutzen. Die Datenanalyse-Engine in Elasticsearch erweitert den Umfang der Suchintegration auf größere Datensätze in Assistenten. Zusätzlich zu dieser Integration können Sie die interaktive Suche für Elasticsearch in Ihrem Assistenten aktivieren, um die interaktive Beantwortung von Abfragen zu erleichtern.

Sie können nur eine Suchintegration pro Umgebung haben. Wenn Sie die bestehende Suchintegration in andere Integrationstypen wie IBM Watson® Discovery oder Milvus oder Custom Service ändern, werden die Einstellungen der bestehenden Suchintegration überschrieben.

Elasticsearch auswählen

Verwenden Sie eine der folgenden Prozeduren, um Elasticsearch als Standardsuchintegration auszuwählen:

  • Elasticsearch-Suchintegration auf der Integrationsseite auswählen

    1. Rufen Sie nach der Erstellung einer watsonx Assistant-Instanz Home > Integrationen auf.
    2. Klicken Sie in der Kachel "Suchen" auf "Öffnen ", um das Fenster "Offene Suche" anzuzeigen.
    3. Wählen Sie im Fenster "Offene Suche" die Option " Draft " aus dem Dropdown-Menü aus, wenn Sie Elasticsearch in der Entwurfsumgebung Ihres Assistenten einrichten möchten. Wenn Sie Elasticsearch in der Live-Umgebung Ihres Assistenten einrichten möchten, wählen Sie die Option Live im Dropdown-Menü aus.
    4. Wählen Sie im Fenster "Vorhandene neue Suchintegration bearbeiten " die Kachel Elasticsearch aus.
  • Elasticsearch-Suchintegration auf der Seite 'Umgebungen' auswählen

    1. Nachdem Sie eine watsonx Assistant-Instanz erstellt haben, rufen Sie Home > Umgebungen auf.

    2. Wählen Sie die Registerkarte "Entwurf ", wenn Sie Elasticsearch in der Entwurfsumgebung einrichten möchten. Wenn Sie Elasticsearch in der Live-Umgebung einrichten möchten, wählen Sie die Registerkarte "Live" aus.

    3. Klicken Sie im Abschnitt "Auflösungsmethoden" auf "Hinzufügen" in der Kachel "Suchen " unter "Erweiterungen ", wenn Sie Elasticsearch hinzufügen möchten.

      Wenn Sie die Elasticsearch-Suchintegration bereits hinzugefügt haben, wird die Schaltfläche Öffnen anstelle der Schaltfläche Hinzufügen in der Kachel Suchen unter Erweiterungen angezeigt.

    4. Wählen Sie im Fenster "Neue Sucherweiterung einrichten " die Kachel Elasticsearch aus.

      Wählen Sie Elasticsearch
      Wählen Sie Elasticsearch

Einrichten Elasticsearch

Verwenden Sie die folgende Prozedur, um Elasticsearch in Ihrem Assistenten einzurichten:

  1. Geben Sie die folgenden Felder an, damit Ihr Assistent eine Verbindung zu Ihrer Elasticsearch herstellen kann:

    • Elasticsearch-URL

    • Elasticsearch-Port (optional)

    • Wählen Sie eine Authentifizierungsart

      • Wenn Sie Basic authentication auswählen, müssen Sie einen Elasticsearch Benutzernamen und Elasticsearch angeben.
      • Wenn Sie API key auswählen, müssen Sie einen API-Schlüssel fürElasticsearch bereitstellen.

      Mit Elasticsearch verbinden
      Mit Elasticsearch verbinden

  2. Klicken Sie auf Weiter, um den Abschnitt Index auswählen aufzurufen. Die Option Index auswählen hat zwei Optionen:

    • Um einen vorhandenen Index zu verwenden, wählen Sie Index verwenden aus.
    • Wählen Sie zum Erstellen eines neuen Index Dokumente in einen neuen Index in Ihrer Elasticsearch-Instanz hochladen aus.

Vorhandenen Index verwenden

  1. Klicken Sie im Abschnitt Index auswählen auf Index verwenden, um eine Verbindung zu einem vorhandenen Elasticsearch-Index herzustellen. Die Option Eigenen Index verwenden ist in Ihrer Elasticsearch-Konfiguration standardmäßig ausgewählt.

  2. Geben Sie in der Option Use my index den Elasticsearch-Indexnamen ein.

  3. Klicken Sie auf Weiter, um zum Abschnitt Dialogsuche aktivieren (optional) zu wechseln.

  4. Die interaktive Suche ist nur in den Plus-und Enterprise-Plänen von watsonx Assistantverfügbar. Wechseln Sie im Abschnitt Dialogsuche aktivieren (optional) den Schalter Dialogsuche zu on, wenn Sie die Dialogsuche aktivieren wollen. Wenn Sie die interaktive Suche nicht aktivieren wollen, wechseln Sie zu off. Weitere Informationen zur interaktiven Suche finden Sie unter interaktive Suche.

  5. Klicken Sie auf Speichern und dann auf Schließen.

Dokumente in einen neuen Index hochladen Beta

Bevor Sie Dokumente hochladen, muss Ihre Elasticsearch-Instanz die folgenden Voraussetzungen erfüllen:

  • Elasticsearch 8.8 oder höher.

  • Ein kostenpflichtiges oder Test-Abonnement Elasticsearch wie die Platinum Edition von IBM Cloud Databases for Elasticsearch oder das Platinum- oder Enterprise-Abonnement, das von Elastic.co angeboten wird.

  • Ein Machine Learning-Knoten (ML) mit mindestens 4 GB Speicher für die Bereitstellung des ELSER-Modells. Weitere Informationen zu den ELSER-Anforderungen finden Sie unter ELSER requirements.

  • Die Dokumente, die Sie hochladen, müssen in englischer Sprache verfasst sein.

Wenn Ihre Elasticsearch nicht über die Voraussetzungen für das Hochladen von Dokumenten verfügt, wird die Fehlermeldung Requirements not met angezeigt.

Wenn Sie beim Hochladen von Dokumenten auch nach Erfüllung der Voraussetzungen eine Verzögerung oder einen Fehler feststellen, können Sie die Inferenzleistung der ELSER-Modellbereitstellung durch die Einrichtung von Parametern wie number_of_allocations und threads_per_allocation anpassen. Weitere Informationen zum Skalieren der Inferenzleistung finden Sie unter Start training model deployment API.

Gehen Sie wie folgt vor, um Dokumente in einen neuen Index hochzuladen:

  1. Klicken Sie im Abschnitt Index auswählen des Fensters von Elasticsearch auf Dokumente in einen neuen Index in Ihrer Elasticsearch-Instanz hochladen.

    watsonx Assistant übergibt die hochgeladenen Dokumente zum Speichern, Chunking und Indexieren an Ihre Elasticsearch-Instanz.

  2. Geben Sie im Abschnitt Ergebnisinhalt konfigurieren die folgenden Felder ein, um den Titel, den Textkörper und die URL der Suchantwort zuzuordnen:

    • Titel

      Titel des Suchergebnisses. Verwenden Sie das Titelfeld, das Namensfeld oder einen ähnlichen Feldtyp aus der Datensammlung als Titel für das Suchergebnis.

      Sie müssen Informationen für den Titel auswählen oder es wird keine Suchergebnisantwort in den Facebook- und Slack-Integrationen angezeigt.

    • Body

      Beschreibung des Suchergebnisses. Verwenden Sie ein Kurzdarstellungs-, Zusammenfassungs- oder Hervorhebungsfeld aus der Datensammlung als Hauptteiltext für das Suchergebnis.

      Sie müssen Informationen für den Hauptteil auswählen oder es wird keine Suchergebnisantwort in den Facebook- und Slack-Integrationen angezeigt.

    • URL

      Dieses Feld kann mit jedem Fußzeileninhalt gefüllt werden, den Sie am Ende des Suchergebnisses einfügen möchten.

    Wenn Sie den Abfragetext in den erweiterten Elasticsearch konfigurieren, um die verschachtelten Dokumente zu durchsuchen, müssen Sie sicherstellen, dass der Titel, der Textkörper und die URL aus den Feldern der inneren Dokumente in Ihrem Elasticsearch stammen. Weitere Informationen zur Verwendung verschachtelter Abfragen finden Sie unter Elasticsearch verschachtelte Abfrage.

  3. Erweitern Sie den Abschnitt Erweiterte Elasticsearch-Einstellungen, um die folgenden Textfelder anzuzeigen:

    • Filterarray für Elasticsearch

      Sie definieren den Filter als Array von Objekten, sodass Sie Filter erstellen können, um den Inhalt gemäß dem Abfragehauptteil anzuordnen. Weitere Informationen finden Sie unter Konfiguration der benutzerdefinierten Filter.

    • Abfragehauptteil für Elasticsearch

      Der Abfragehauptteil wird verwendet, um die Benutzeranforderungen in einem Format zu bearbeiten, das von der Suche erwartet wird. Sie steuert die Abfrageformulare, Suchfelder, Filter und Abfragegröße. In der REST-API ist der Abfragetext ein Objekt, das den Text POST für die Anfrage _search an Elasticsearch darstellt. Der Abfragehauptteil hat ein "$QUERY"-Token, das die Abfrage des Kunden darstellt, und ein "$FILTER"-Token, das das Array von Filtern darstellt, die entweder in den Sucheinstellungen oder auf Schrittebene definiert sind.

      Standardmäßig verwendet die Elasticsearch-Integration die Schlüsselwortsuche. Sie können jedoch den Abfragetext in der E-Mail an Advanced Elasticsearch settings so konfigurieren, dass erweiterte Suchtechniken aktiviert werden, wie z. B.:

      • Semantische Suche mit ELSER
      • KNN-Dichtevektorsuche
      • Verwendung verschachtelter Abfragen zur Suche in verschachtelten Dokumenten
      • Hybrid-Suche
      • Suche in einem semantischen Textfeld

      Weitere Informationen zur Verwendung verschiedener Typen von Abfragehauptteilbeispielen finden Sie unter Abfragehauptteilbeispiele.

      Weitere Informationen zum API-Anforderungshauptteil von Elasticsearch _search finden Sie unter Elasticsearch search API request body.

      Sie können den Abfragehauptteil im Assistenten nicht mit einer vorhandenen Elasticsearch-Konfiguration anpassen.

  4. Verwenden Sie die Registerkarten Nachricht, Keine Ergebnisse gefunden und Konnektivitätsproblem, um verschiedene Nachrichten anzupassen, die basierend auf der erfolgreichen Suche mit Benutzern geteilt werden sollen.

    Nachrichten für Suchergebnisse
    Tabulatortaste Szenario Beispielnachricht
    Nachricht Es werden Suchergebnisse zurückgegeben. I found this information that might be helpful:
    Keine Ergebnisse gefunden Es werden keine Suchergebnisse gefunden. I searched my knowledge base for information that might address your query, but did not find anything useful to share.
    Verbindungsproblem Ich konnte die Suche aus einem bestimmten Grund nicht abschließen I might have information that could help address your query, but am unable to search my knowledge base at the moment.
  5. Schalten Sie die Umschaltfläche Dialogsuche auf on um, wenn Sie die Dialogsuche aktivieren wollen. Wenn Sie die interaktive Suche nicht aktivieren wollen, wechseln Sie zu off.

    Die interaktive Suche ist nur in den Plus-und Enterprise-Plänen von watsonx Assistantverfügbar. Wenn Sie die Option Dialogsuche auf on setzen, werden die Zitattitel in den Antworten des Assistenten angezeigt. Weitere Informationen zur interaktiven Suche finden Sie unter interaktive Suche.

  6. Klicken Sie auf "Speichern ", um Ihre Einstellungen zu speichern.

  7. Klicken Sie auf die Registerkarte Dokumente im Fenster Elasticsearch.

    Die Registerkarte Dokumente ist nur aktiviert, wenn Sie die Option Dokumente in einen neuen Index in Ihrer Elasticsearch-Instanz hochladen auswählen.

  8. Klicken Sie auf die Schaltfläche "Hochladen ". Im Bereich "Dokumente hochladen " können Sie Ihre Dateien per Drag-and-Drop oder mit einem einzigen Klick direkt in Ihren Assistenten hochladen.

    Sie können bis zu 20 Dokumente gleichzeitig hochladen. Die Dateigröße eines Dokuments darf 25 KB nicht überschreiten. Die Gesamtgröße aller Dokumente darf 50 MB nicht überschreiten.

    Elasticsearch Upload-Dokument
    Elasticsearch Upload-Dokument

  9. Nach dem Hochladen der Dokumente können Sie den Uploadstatus Ihrer Dokumente in einer Tabelle im Fenster Elasticsearch anzeigen.

  10. Status Ready gibt an, dass Ihre Dateien für die Suche verfügbar sind.

  11. Wenn der Status Error lautet, können Sie die Datei löschen, indem Sie auf die drei Punkte neben Error und anschließend auf Delete klicken.

    Elasticsearch Upload-Fehler
    Elasticsearch

  12. Überspringen Sie diesen Schritt, wenn Sie die Elasticsearch-Instanz-Anmeldeinformationen nicht ändern möchten. Wenn Sie die Anmeldeinformationen für die Elasticsearch-Instanz ändern möchten, klicken Sie auf die Registerkarte Instanz, bearbeiten die Anmeldeinformationen und klicken dann auf Speichern.

  13. Klicken Sie auf Speichern und anschließend auf Schließen, um die Elasticsearch-Einrichtung zu beenden.

Assistenten für die Verwendung von Elasticsearch konfigurieren

Nachdem Sie die Elasticsearch-Suchintegration konfiguriert haben, müssen Sie Ihren Assistenten für die Verwendung von Elasticsearch konfigurieren, wenn die Kundenantwort keiner Aktion entspricht. Weitere Informationen zum Aktualisieren von Keine Übereinstimmungen für die Verwendung der Suche finden Sie unter Suche verwenden, wenn keine Aktion übereinstimmt.

Elasticsearch testen

Sie können die Suchintegration mit Elasticsearch in der Aktionsvorschau, auf der Vorschauseite oder über den Vorschaulink testen.

In diesem Beispiel fragt der Benutzer Tell me about a custom extension.

Suchergebnisse werden aus Ihrer Wissensbasis extrahiert, wenn die interaktive Suche off ist. Die Antwort lautet: I searched my knowledge base and found this information which might be useful.

Gesprächssuche aus
Gesprächssuche aus

Eine textbasierte Antwort aus den besten Ergebnissen in Ihrer Wissensbasis wird angezeigt, wenn die interaktive Suche on ist.

Konversationssuche auf
Konversationssuche auf