Lernziele

Sobald Sie dieses Lernprogramm abgeschlossen haben, wissen Sie, wie Sie Folgendes ausführen:

• Erstellen Sie ein Dokumentabrufprojekt in Discovery.
• Laden Sie PDF-Dokumente in Ihr Projekt hoch und wenden Sie ein vom Benutzer trainiertes Smart Document Understanding-Modell auf Ihre PDF-Dateien an.
• Verbinden Sie Ihr Discovery-Projekt mit einer NeuralSeek-Serviceinstanz. NeuralSeek ist eine KI-basierte Engine für die Antwortgenerierung.
• Erstellen Sie einen Assistenten in watsonx Assistant und wenden Sie eine NeuralSeek-Integration darauf an.
• Fügen Sie eine Aktion zu watsonx Assistant hinzu, die eine Verbindung zu NeuralSeek für Antworten herstellt.
• Beantworten Sie mithilfe Ihres Assistenten Fragen zu Discovery.

NeuralSeek ist ein Produkt eines Drittanbieters, das von einem Anbieter außerhalb von IBM bereitgestellt wird und einer separaten Vereinbarung zwischen Ihnen und dem Drittanbieter unterliegt, wenn Sie dessen Bedingungen akzeptieren. IBM ist nicht für das Produkt verantwortlich und macht keine Zusagen in Bezug auf Datenschutz, Sicherheit, Leistung, Support oder andere Eigenschaften des Produkts.

Produktdokumentation abrufen

Zur Verwendung der Discovery-Produktdokumentation als Wissensbasis wird die Produktdokumentation als PDF-Datei heruntergeladen.

1. Rufen Sie in einem Web-Browser die Produktdokumentationssite auf.

   https://cloud.ibm.com/docs/discovery-data
   

2. Klicken Sie in der Inhaltsverzeichnisanzeige auf das Symbol für das Überlaufmenü im Abschnitt Product guide und wählen Sie dann View as PDF aus.

3. Speichern Sie die PDF-Datei auf Ihrem System, indem Sie in der Seitenkopfzeile auf das Symbol Speichern klicken.

4. Verwenden Sie einen PDF-Dateieditor, um das PDF-Dokument in zwei separate PDF-Dateien ähnlicher Größe aufzuteilen.

   Beim Aufteilen der PDF-Datei werden zwei kleinere Dateien erstellt, die in Discoveryschneller aufbereitet werden können.

Dokumentabrufprojekt erstellen

Nachdem Sie nun über die neueste Kopie der Produktdokumentation verfügen, fügen Sie sie zu einem Discovery-Projekt als Datenquelle hinzu.

In Discoveryerstellen Sie einen Projekttyp Dokumentabruf. Dokumente, die Sie einem Projekt dieses Typs hinzufügen, werden automatisch wie folgt aufbereitet:

• Entitäten, wie z. B. Eigennamen, werden identifiziert und mit Tags versehen.
• Wortarten werden identifiziert und gekennzeichnet.

Diese mit Tags versehenen Informationen werden später verwendet, wenn ein Ausdruck in natürlicher Sprache als Suchabfrage übergeben wird, um eine korrekte Antwort zurückzugeben.

1. Öffnen Sie eine neue Web-Browser-Seite.

2. Klicken Sie auf der Serviceseite Discovery Plus-Plan in IBM Cloudauf Launch Discovery.

3. Klicken Sie auf der Seite Meine Projekte auf Neues Projekt.

4. Benennen Sie Ihr Projekt Discovery documentation und klicken Sie dann auf die Kachel Dokumentabruf.

   

5. Klicken Sie auf Weiter.

Im nächsten Schritt konfigurieren Sie die Datenquelle für das Projekt.

Daten in das Projekt hochladen

Fügen Sie die Dokumentations-PDFs Ihrem Discovery-Projekt hinzu.

1. Klicken Sie auf der Seite Datenquelle auswählen auf die Kachel Daten hochladen und anschließend auf Next.

   

2. Benennen Sie die Sammlung Discovery docs part 1und klicken Sie dann auf Weiter.

3. Klicken Sie auf Dateien hierher ziehen und ablegen oder hochladen und navigieren Sie dann zu der ersten PDF-Datei, die Sie zuvor erstellt haben.

4. Klicken Sie auf Beenden.

   Ihre Datei wird verarbeitet, wenn sie zur Sammlung hinzugefügt wird.

5. Klicken Sie in der Navigationsanzeige auf Sammlungen verwalten und anschließend auf Neue Sammlung.

   

6. Wiederholen Sie die vorherigen Schritte, um die zweite PDF-Datei als Sammlung mit dem Namen Discovery docs part 2hinzuzufügen.

Nachdem die Daten hochgeladen wurden, werden sie von Discoveryverarbeitet und indexiert. Während die Daten verarbeitet werden, erstellen wir unseren virtuellen Assistenten.

Assistenten erstellen

Für dieses Lernprogramm erstellen Sie einen Assistenten mit einer einzigen Aktion. Zuerst müssen Sie eine watsonx Assistant-Serviceinstanz erstellen.

Sowohl Lite-als auch Testplan watsonx Assistant-Serviceinstanzen sind kostenlos verfügbar. Sie erstellen einen Testplan.

1. Kehren Sie über eine neue Web-Browser-Registerkarte zum Katalog IBM Cloud zurück.

   Lassen Sie die Seite Discovery in einer separaten Registerkarte geöffnet, damit Sie zwischen den beiden Anwendungen wechseln können.

2. Erstellen Sie auf der Ressourcenseite watsonx Assistant im IBM Cloud-Katalog einen Testplan watsonx Assistant-Serviceinstanz am Standort Dallas.

3. Klicken Sie auf der Seite watsonx Assistant-Plan-Service in IBM Cloudauf Launch watsonx Assistant.

   Die Produktbenutzerschnittstelle watsonx Assistant wird angezeigt, in der Sie Ihren ersten Assistenten erstellen können.

4. Fügen Sie Discovery expert als Namen des Assistenten hinzu und klicken Sie anschließend auf Weiter.

5. Wenn Sie aufgefordert werden, Informationen über Sie und Ihren Assistenten zu teilen, füllen Sie die erforderlichen Felder aus und klicken Sie anschließend auf Weiter.

   Wenn Sie einen Assistenten erstellen, wird automatisch eine Web-Chat-Anwendung erstellt.

6. Klicken Sie auf Erstellen, um den Assistenten und die entsprechende Web-Chat-App zu erstellen.

Nach einer Glückwunschnachricht wird die Homepage für Ihren neuen Assistenten angezeigt.

Bevor wir unserem neuen Assistenten etwas hinzufügen, lassen Sie uns den Status unserer Daten überprüfen.

Daten für Abruf vorbereiten

Um die Abrufbarkeit der Informationen in Ihren PDF-Dateien zu verbessern, teilen Sie die PDF-Dateien in viele kleinere Dokumente auf. Dazu werden Sie zuerst Discovery die Struktur Ihrer PDF-Dateien beibringen, damit sie verstehen, wie Unterabschnitte formatiert werden, und das Dokument nach Unterabschnitten aufteilen können.

1. Kehren Sie zur Registerkarte des Web-Browsers zurück, auf der Ihr Discovery-Projekt angezeigt wird.

   Die Seite Verbessern und anpassen für die zuletzt hochgeladene PDF-Datei wird angezeigt.

2. Erweitern Sie in der Anzeige Verbesserungstools Struktur definierenund klicken Sie anschließend auf Neue Felder.

   

3. Wählen Sie die Sammlung Discovery docs part 1 aus.

   Die Registerkarte "Felder identifizieren" wird angezeigt, auf der Sie den Typ des Smart Document Understanding-Modells auswählen können, das Sie verwenden möchten.

4. Klicken Sie auf Vom Benutzer trainierte Modelle und anschließend auf Übergeben.

   

5. Klicken Sie auf Änderungen anwenden und erneut verarbeiten.

   Nach einer gewissen Verarbeitung wird eine Darstellung des Dokuments im Tool Smart Document Understanding angezeigt. Das Tool zeigt Ihnen eine Ansicht des Originaldokuments zusammen mit einer Darstellung des Dokuments, wobei der Text durch Blöcke ersetzt wird. Die Blöcke stellen Feldtypen dar.

   Anfänglich werden die Blöcke als text bezeichnet, da der gesamte Dokumentinhalt standardmäßig als Standardtext betrachtet und im Feld text indexiert wird.

   Wir möchten alle Überschriften der ersten und zweiten Ebene als Untertitel anstelle von Text bezeichnen.

6. Klicken Sie in der Piktogrammansicht auf das Piktogramm der ersten Volltextseite des Dokuments, um die erste Seite mit echtem Inhalt zu öffnen.

   

7. Klicken Sie zum Annotieren des Dokuments auf die Beschriftung subtitle in der Liste Feldbeschriftungen. Klicken Sie anschließend auf jeden Block in der Darstellung der PDF-Seite, die eine Überschrift darstellt, um die Bezeichnung von text in subtitle zu ändern.

   

8. Klicken Sie nach jedem Untertitel auf der aktuellen Seite auf Seite übergeben.

   Die nächste Seite der PDF-Datei wird angezeigt.

   

9. Wiederholen Sie diesen Prozess, bis das Tool die Überschriften für Sie konsistent beschriften kann, wenn neue Seiten in das Tool geladen werden. Klicken Sie dann auf Änderungen anwenden und erneut verarbeiten.

   Glückwunsch! Sie haben erfolgreich ein Smart Document Understanding-Modell (SDU) trainiert, das Untertitel in Ihren Dokumenten erkennen kann. Wenden Sie dasselbe Modell auf die andere PDF-Datei an, die Sie dem Projekt hinzugefügt haben.

10. Klicken Sie in der Symbolleiste des SDU-Editors auf das Überlaufmenüsymbol in der Seitenkopfzeile und wählen Sie Modell exportieren aus.

11. Speichern Sie die Datei .sdumodel auf Ihrem System an einer Position, an der Sie in Kürze wieder darauf zugreifen können.

12. Klicken Sie im Navigationsfenster auf Sammlungen verwalten und öffnen Sie dann die Sammlung Discovery docs part 2.

13. Öffnen Sie die Registerkarte "Felder identifizieren".

14. Klicken Sie auf Vom Benutzer trainierte Modelle und anschließend auf Übergeben.

15. Klicken Sie auf Änderungen anwenden und erneut verarbeiten.

16. Klicken Sie in der Symbolleiste des SDU-Editors auf das Überlaufmenüsymbol und wählen Sie Modell importieren aus. Klicken Sie dann auf Modell auswählen.

17. Suchen Sie die Datei .sdumodel, die Sie zuvor heruntergeladen haben, und klicken Sie anschließend auf Öffnen.

18. Klicken Sie auf Änderungen anwenden und erneut verarbeiten, um dasselbe SDU-Modell auf die erste Sammlung anzuwenden.

Discovery verarbeitet die Daten im Index erneut, um Untertitel in den Dokumenten zu identifizieren. Während die Daten erneut verarbeitet werden, erstellen wir unseren Antwortgenerator.

Erstellen einer NeuralSeek

Sie können eine Sucherweiterung in watsonx Assistant verwenden, um Ihren Assistenten direkt mit Discovery zu verbinden und Passagen direkt aus der Datenquelle zurückzugeben. In diesem Lernprogramm fügen wir jedoch den Service NeuralSeek zwischen watsonx Assistant und Discovery hinzu. NeuralSeek ruft die Passagen aus Discovery ab und konvertiert sie dann in Antworten, die dialogorientierter klingen.

1. Kehren Sie über eine neue Web-Browser-Registerkarte zum Katalog IBM Cloud zurück.

   Lassen Sie die Seiten für die anderen Services auf separaten Registerkarten geöffnet, sodass Sie zwischen den verschiedenen Serviceinstanzen wechseln können.

2. Erstellen Sie über die Ressourcenseite NeuralSeek im Katalog IBM Cloud eine Serviceinstanz des Lite-Plans.

3. Fügen Sie auf der Seite Konfigurieren Details zu Ihrer Discovery-Serviceinstanz hinzu und passen Sie die Verbindung an.

   • Sie können die URL und den API-Schlüssel von der Discovery Service-Instanz-Detailseite in IBM Cloud abrufen.
   • Die Projekt-ID ist in der Benutzerschnittstelle von IBM Cloud verfügbar. Um sie abzurufen, klicken Sie im Navigationsfenster auf Integrieren und implementieren. Öffnen Sie die Seite API-Informationen und kopieren Sie dann die Projekt-ID.
   • Legen Sie den Dokumentbewertungsbereich auf 50% fest.
   • Ändern Sie die Größe des Snippetzeichens in 400.
   • Geben Sie Ihr Unternehmen als Anzeigenamen des Unternehmens an.
   • Ändern Sie den Mindestkonfidenzprozentsatz in 50.

   Klicken Sie auf Speichern.

Teilen Sie Ihre PDF-Dokumente

Da Untertitel nun ordnungsgemäß in Discoveryindexiert werden, verwenden Sie sie als Basis für die Aufteilung der PDF-Dateien in viele kleinere Dokumente.

1. Kehren Sie zur Registerkarte des Web-Browsers zurück, auf der Ihr Discovery-Projekt angezeigt wird.

2. Öffnen Sie die Registerkarte Felder verwalten für die aktuelle Sammlung.

3. Wählen Sie im Feld Dokument bei jedem Vorkommen von aufteilen die Option Untertitel aus und klicken Sie dann auf Änderungen anwenden und erneut verarbeiten.

   

4. Klicken Sie im Navigationsfenster auf Sammlungen verwalten und öffnen Sie dann die andere Sammlung.

5. Rufen Sie die Seite Felder verwalten auf und wählen Sie dann Untertitel im Feld Dokument bei jedem Vorkommen von aufteilen.

6. Klicken Sie auf Änderungen anwenden und erneut verarbeiten.

Die Datensammlungen werden erneut verarbeitet. Nachdem die Neuindexierung abgeschlossen ist, enthalten die Sammlungen nicht jeweils ein Dokument, sondern mehrere hundert Dokumente.

Während der Index neu erstellt wird, bereiten wir unseren Assistenten vor.

Fügen Sie Ihrem Assistenten eine Erweiterung hinzu

Verbinden Sie Ihren Assistenten mit Ihrer NeuralSeek-Serviceinstanz.

1. Öffnen Sie den Service NeuralSeek über IBM Clouderneut. Sie finden die Instanz im Abschnitt AI und Machine Learning Ihrer Ressourcenliste.

2. Klicken Sie auf die Registerkarte Integrieren und befolgen Sie die Anweisungen zum Einrichten der angepassten Erweiterung NeuralSeek für Ihren Assistenten. Kehren Sie zu dieser Prozedur zurück, wenn Sie bereit sind, die Aktion zu erstellen.

   

3. Klicken Sie im Navigationsfenster watsonx Assistant auf Aktionen und anschließend auf Neue Aktion.

4. Wählen Sie Schnelleinstieg in Vorlagen aus und blättern Sie anschließend zum NeuralSeek Starter-Kit und klicken Sie darauf.

   

5. Klicken Sie auf Dieses Starter-Kit auswählen und anschließend auf Vorlagen hinzufügen.

6. Klicken Sie hier, um die Aktion NeuralSeek-Suche zu öffnen, die Sie soeben zum Assistenten hinzugefügt haben.

7. Fügen Sie die folgenden Benutzerbeispielabfragen zum ersten Schritt der Aktion hinzu:

   What Watson Discovery project types are available and what do they do?
   

   What external data sources are supported by Watson Discovery?
   

   Can I add a custom dictionary to Watson Discovery?
   

   How do I use the Content Mining application?
   

   When should I add query expansions to my project?
   

   Which file types support Smart Document Understanding models?
   

   Can I enable optical character recognition for all file types?
   

   Does my data have to be written in English?
   

   watsonx Assistant verwendet die Beispielfragen, um die Benutzerfragen zu erkennen, die an diese Aktion weitergeleitet werden sollen.

8. Klicken Sie hier, um Schritt 3 zur Bearbeitung zu öffnen.

   Klicken Sie im Abschnitt Und dann auf Erweiterung bearbeiten.

   Wählen Sie NeuralSeek und klicken Sie dann auf Übernehmen.

   

9. Klicken Sie, um Schritt 6 zur Bearbeitung zu öffnen.

   Dieser Schritt zeigt einen Link, auf den Benutzer klicken können, um weitere Informationen zu erhalten. Dieser Link soll direkt zur Produktdokumentation auf der IBM Cloud Docs-Site führen.

   Ändern Sie den Hypertext-Verweis im HTML-Element anchor so, dass er die folgende URL enthält:

   <a href="https://cloud.ibm.com/docs/discovery-data?topic=discovery-data-about" target="_blank">
   

   : caption="Ändern Sie die URL für den Link " Weitere Informationen " caption-side="bottom"}

10. Speichern Sie Ihre Änderungen und klicken Sie anschließend auf das X, um den Schritt zu schließen.

Glückwunsch! Sie haben erfolgreich eine Aktion erstellt, die Fragen zu Discoveryerkennt und ihre Antworten von der verbundenen NeuralSeek-Erweiterung erhält.

Web-Chat für Ihren Assistenten konfigurieren

Für die Vorschau Ihres Assistenten verwenden Sie den integrierten Web-Chat als Chat-Benutzerschnittstelle für die Interaktion mit dem Assistenten.

1. Klicken Sie im Navigationsfenster in watsonx Assistantauf Umgebungen.

   Die Entwurfsumgebung wird angezeigt. Es zeigt, dass ein Web-Chat mit Ihrem Assistenten verbunden ist. Sie sehen auch, dass der Web-Chat mit der Erweiterung NeuralSeek verbunden ist.

   

2. Klicken Sie auf die Kachel Web-Chat, um den Web-Chat zu bearbeiten.

   Wir möchten nicht mehrere Starterfragen hinzufügen, also schalten wir die Hauptanzeige für den Web-Chat aus. Klicken Sie auf die Registerkarte Startbildschirm. Setzen Sie den Umschalter auf Aus und klicken Sie anschließend auf Speichern und beenden.

   

Sie können eine Vorschau Ihres Assistenten anzeigen!

Vorschau des Assistenten

Zur Vorschau eines Assistenten, der eine Verbindung zu Daten herstellt, die in Discoverygespeichert sind, müssen Sie auf der Seite Umgebungen eine Vorschau des Assistenten anzeigen. Wenn Sie den Web-Chat unabhängig voranzeigen, kann der Assistent keine Daten von Discoveryabrufen. Er benötigt die Umgebungsressourcen, um eine Verbindung zu Discoveryherstellen zu können.

1. Klicken Sie auf der Seite Umgebungen auf Diese Umgebung voranzeigen.

   Es wird eine Beispielwebseite mit einem Chatsymbol angezeigt.

2. Klicken Sie auf das Chat-Symbol, um das Web-Chat-Fenster zu öffnen.

   

3. Geben Sie die folgende Textfrage ein:

   What project types are available?
   

   Die richtige Antwort wird zurückgegeben und enthält einen Link zur Produktdokumentation.

   

4. Übergeben Sie eine Frage, die beim Erstellen der Aktion nicht als Abfragebeispiel verwendet wurde.

   How do you define synonyms in Watson Discovery?
   

   Eine detaillierte Antwort wird zurückgegeben.

   

5. Stellen Sie dem Assistenten optional weitere Fragen.

   Wenn der Assistent die Antwort nicht kennt, formulieren Sie die Frage so um, dass sie "in Watson Discovery" eingeschlossen wird, damit Sie deutlicher erkennen, wie etwas in Discovery funktioniert.

Glückwunsch! Sie haben erfolgreich einen Assistenten erstellt, der Fragen zu Discovery beantworten kann, indem Sie über den Service NeuralSeek Informationen aus der Produktdokumentation abrufen.