Dialogmodul testen

Während Sie an Ihrem Dialog arbeiten, können Sie ihn jederzeit testen, um zu sehen, wie der Dialog auf Eingaben reagiert.

Anfragen, die Sie über den Bereich "Ausprobieren" senden, generieren API-Aufrufe an /message, werden jedoch nicht protokolliert und verursachen keine Kosten.

1. Klicken Sie auf der Dialogseite auf die Schaltfläche "Ausprobieren ".

2. Geben Sie im Chatbereich Text ein und drücken Sie die Eingabetaste.

3. Überprüfen Sie die Antwort, um zu ermitteln, ob das Dialogmodul die Eingabe richtig interpretiert und die entsprechende Antwort ausgewählt hat.

   Im Chatfenster ist angegeben, welche Absichten und Entitäten in der Eingabe erkannt wurden.

   

4. Um die am häufigsten erkannten Absichten anzuzeigen, bewegen Sie den Mauszeiger über das Augensymbol , das neben der Absicht mit dem höchsten Konfidenzscore angezeigt wird.

5. Falls die Antwort nicht Ihren Erwartungen entspricht, können Sie in der Anzeige 'Ausprobieren' die folgenden Aktionen ausführen:

   • Wenn Sie eine Entität bearbeiten wollen, die in der Eingabe erkannt wurde, klicken Sie auf den Entitätsnamen, um sie auf der Seite 'Entitäten' zu öffnen.
   • Wenn die falsche Absicht erkannt wurde, können Sie auf den Pfeil neben dem Absichtsnamen klicken, um die Absicht zu korrigieren oder das Thema als irrelevant zu markieren. Weitere Informationen finden Sie unter Trainingsdaten verbessern.

6. Wenn Sie wissen möchten, welcher Knoten im Dialogbaum eine Antwort ausgelöst hat, klicken Sie auf das Standortsymbol daneben.

   Der Quellenknoten wird in den Fokus genommen und die Route durch die Baumstruktur, über die der Assistent den Knoten erreicht hat, wird hervorgehoben. Die Route bleibt hervorgehoben, bis Sie eine andere Aktion ausführen (z. B. eine neue Testeingabe eingeben).

7. Um den Wert einer Kontextvariablen zu überprüfen oder festzulegen, klicken Sie auf den Link Kontext verwalten.

   Alle Kontextvariablen, die Sie im Dialogmodul definiert haben, werden angezeigt.

   Darüber hinaus werden die folgenden Kontextvariablen aufgeführt:

   • $timezone: Das Teilfenster Probieren Sie es aus ruft Informationen zur Benutzerländereinstellung aus dem Web-Browser ab und verwendet sie zum Festlegen der Kontextvariablen $timezone. Diese Kontextvariable vereinfacht die Berücksichtigung von Zeitunterschieden beim Austausch von Testdialogdaten.
   • $metadata: Diese Kontextvariable enthält ein Benutzer-ID-Name/Wert-Paar. Da im Teilfenster Probieren Sie es aus standardmäßig kein Wert für user_id angegeben ist, wird conversation_id als Wert für user_id verwendet. Zur Laufzeit wird der ID-Wert normalerweise von einer beliebigen Integration, die Sie verwenden, an den Assistenten übergeben. Wenn Sie eine kundenspezifische Anwendung entwerfen, legen Sie diesen Wert selbst fest.

   Sie können eine Variable hinzufügen und ihren Wert festlegen, um festzustellen, wie das Dialogmodul in der nächsten Runde des Testdialogmoduls reagiert. Diese Funktionalität ist beispielsweise von Nutzen, wenn das Dialogmodul so konfiguriert ist, dass abhängig vom Wert einer Kontextvariablen, der vom Benutzer bereitgestellt wird, unterschiedliche Antworten angezeigt werden.

   1. Um eine Kontextvariable hinzuzufügen, geben Sie den Variablennamen an und drücken Sie die Eingabetaste.
   2. Um einen Standardwert für die Kontextvariable festzulegen, suchen Sie die Kontextvariable, die Sie in der Liste hinzugefügt haben, und geben Sie dann einen Wert dafür an.

   Weitere Informationen finden Sie unter Kontextvariablen.

8. Setzen Sie die Interaktion mit dem Dialogmodul fort, um den Ablauf des Dialogs im Modul nachzuvollziehen.

   • Wenn Sie eine verbale Testäußerung suchen und erneut übergeben wollen, können Sie mit der Aufwärtstaste in Ihren letzten Eingaben navigieren.
   • Um frühere verbale Testäußerungen aus dem Chatbereich zu entfernen und neu zu beginnen, klicken Sie auf den Link Löschen. Diese Aktion entfernt nicht nur die verbalen Testäußerungen und die Antworten, sondern auch die Werte aller Kontextvariablen, die infolge Ihrer Interaktion mit dem Dialogmodul festgelegt wurden.

Dialogmodul durchsuchen

Sie können den Dialog durchsuchen, um einen oder mehrere Dialogknoten zu finden, die ein Wort oder einen Ausdruck enthalten.

1. Wählen Sie aus.

2. Geben Sie einen Suchbegriff oder -ausdruck ein.

   Bei der ersten Suche wird ein Index erstellt. Möglicherweise werden Sie aufgefordert, zu warten bis der Text in Ihren Dialogmodulknoten indexiert wurde.

Knoten, die Ihren Suchbegriff enthalten, und entsprechende Beispiele werden angezeigt. Wählen Sie ein Ergebnis aus, damit es zum Bearbeiten geöffnet wird.

Dialogmodulknoten kopieren

Sie können einen Knoten duplizieren, um eine exakte Kopie als Peerknoten unmittelbar nach dem Ursprungsknoten in der Baumstruktur des Dialogmoduls) zu erstellen. Der kopierte Knoten selbst erhält denselben Namen wie der ursprüngliche Knoten, ihm wird jedoch - copyn angehängt, wobei n eine Zahl ist, die mit 1 beginnt. Wenn Sie denselben Knoten mehr als einmal duplizieren, wird die n in den Namensinkrementen für jede Kopie um eins erhöht, um die Unterscheidung der Kopien voneinander zu erleichtern. Wenn der Knoten noch keinen Namen hat, wird copyn als Name verwendet.

Wenn Sie einen Knoten duplizieren, der über untergeordnete Knoten verfügt, werden die untergeordneten Knoten ebenfalls dupliziert. Die kopierten untergeordneten Knoten tragen dieselben Namen wie die ursprünglichen untergeordneten Knoten. Die einzige Möglichkeit, einen kopierten untergeordneten Knoten vom zugehörigen Ursprungsknoten zu unterscheiden, ist die Angebe copy im Namen des übergeordneten Knotens.

1. Klicken Sie auf dem Knoten, den Sie kopieren möchten, auf das Symbol Node optionen und wählen Sie dann Duplikat aus.

2. Ziehen Sie in Betracht, die kopierten Knoten umzubenennen oder die zugehörigen Bedingungen zu bearbeiten, damit sie einfacher zu unterscheiden sind.

Dialogmodulknoten verschieben

Jeden Knoten, den Sie erstellen, können Sie an eine andere Stelle in der Baumstruktur des Dialogmoduls verschieben.

Beispiel: Sie wollen einen zuvor erstellten Knoten in einen anderen Bereich des Ablaufs verschieben, um den Dialog zu ändern. Durch das Verschieben können Sie Knoten zu gleichgeordneten Knoten oder Peerknoten in einer anderen Verzweigung machen.

1. Klicken Sie auf dem Knoten, den Sie verschieben möchten, auf Node und wählen Sie dann "Verschieben" aus.

2. Wählen Sie einen Zielknoten aus, der sich in der Baumstruktur in der Nähe der Position befindet, an die Sie diesen Knoten verschieben wollen. Wählen Sie aus, ob dieser Knoten vor oder hinter dem Zielknoten bzw. als untergeordnetes Element des Zielknotens platziert werden soll.

Dialogmodul in Ordnern zusammenfassen

Sie können Dialogmodulknoten zu einem Ordner hinzufügen, um sie zu gruppieren. Gründe für die Gruppierung von Knoten:

• Knoten zusammenfassen, die ein ähnliches Ziel haben, damit sie leichter zu finden sind. Zum Beispiel können Knoten, die Fragen zu Benutzerkonten beantworten, in einem Ordner Benutzerkonto zusammengefasst werden und Knoten, die Fragen zur Zahlungsabwicklung beantworten, in einem Ordner Zahlung.
• Um eine Reihe von Knoten zu gruppieren, die der Dialog nur verarbeiten soll, wenn eine bestimmte Bedingung erfüllt ist. Verwenden Sie eine Bedingung wie $isPlatinumMember, um Knoten zu gruppieren, die zusätzliche Dienste anbieten, die nur verarbeitet werden, wenn der aktuelle Benutzer berechtigt ist, die zusätzlichen Dienste zu erhalten.
• Knoten während der Laufzeit ausblenden, solange Sie diese Knoten bearbeiten. Sie können Knoten zu einem Ordner mit einer Bedingung false hinzufügen, um zu verhindern, dass diese Knoten verarbeitet werden.

Die folgenden Merkmale des Ordners wirken sich auf die Verarbeitung der Knoten in einem Ordner aus:

• Bedingung: Wenn keine Bedingung angegeben wird, verarbeitet der Assistent die Knoten direkt in dem Ordner. Wenn eine Bedingung angegeben wird, wertet der Assistent zunächst die Ordnerbedingung aus, um festzustellen, ob die Knoten in dem Ordner verarbeitet werden sollen.
• Anpassungen: Alle Konfigurationseinstellungen, die Sie auf den Ordner anwenden, werden von den Knoten in dem Ordner übernommen. Wenn Sie beispielsweise die Abschweifungseinstellungen für den Ordner ändern, werden diese Änderungen für alle Knoten im Ordner übernommen.
• Baumhierarchie: Die Knoten in einem Ordner werden als Stammknoten oder untergeordnete Knoten behandelt, je nachdem, ob der Ordner auf der Stammebene oder der untergeordneten Ebene in der Baumstruktur des Dialogmoduls hinzugefügt wird. Alle Knoten auf der Stammebene, die Sie zu einem Ordner der Stammebene hinzufügen, werden weiterhin als Stammknoten behandelt; d. h. sie werden nicht zu untergeordneten Knoten des Ordners. Wenn Sie jedoch einen Knoten der Stammebene in einen Ordner verschieben, der einem anderen Knoten untergeordnet ist, dann wird der Stammknoten zu einem untergeordneten Element dieses anderen Knotens.

Ordner haben keine Auswirkung auf die Reihenfolge, in der Knoten verarbeitet werden. Die Knoten werden weiterhin vom ersten bis zum letzten Knoten nacheinander verarbeitet. Wenn Ihr Assistent dem Baum folgt und der Ordner keinen Zustand hat oder sein Zustand wahr ist, verarbeitet er sofort den ersten Knoten im Ordner und fährt der Reihe nach im Baum fort. Wenn ein Ordner keine Ordnerbedingung hat, wird jeder Knoten in dem Ordner wie jeder andere einzelne Knoten in der Baumstruktur behandelt.

Begrenzungen für Dialogmodulknoten

Wie viele Dialogmodulknoten pro Skill Sie erstellen können, richtet sich nach Ihrem Plantyp.

Die Dialogknoten welcome und anything_else, die in der Baumstruktur vorab ausgefüllt sind, werden in der Gesamtzahl berücksichtigt.

Tiefe des Baums: Der Dialog unterstützt 2.000 Dialogknoten-Nachkommen; der Dialog funktioniert am besten mit 20 oder weniger.

Dialogmodulknoten anhand der Knoten-ID suchen

Sie können Dialogmodulknoten anhand der zugehörigen Knoten-ID suchen. Geben Sie die vollständige Knoten-ID in das Suchfeld ein. Die Suche nach einem Dialogmodulknoten, dem eine bekannte Knoten-ID zugeordnet ist, kann die folgenden Gründe haben:

• Sie sehen sich Protokolle an und ein Protokoll referenziert einen Abschnitt des Dialogmoduls durch die Knoten-ID.
• Sie wollen die in der Eigenschaft nodes_visited der API-Nachrichtenausgabe aufgelisteten Knoten-IDs zu Knoten zuordnen, die in der Baumstruktur Ihres Dialogmoduls angezeigt werden.
• Sie werden in einer Laufzeitfehlernachricht für das Dialogmodul über einen Syntaxfehler informiert und der Knoten, den Sie korrigieren müssen, ist dort mit der Knoten-ID angegeben.

Eine andere Methode zum Aufspüren eines Knotens anhand der zugehörigen Knoten-ID umfasst die folgenden Schritte:

1. Wählen Sie auf der Seite 'Dialogmodul' einen beliebigen Knoten in der Baumstruktur Ihres Dialogmoduls aus.

2. Schließen Sie die Bearbeitungsansicht, falls sie für den aktuellen Knoten geöffnet ist.

3. Im Adressfeld Ihres Webbrowsers sollte URL angezeigt werden, deren Syntax dem folgenden Beispiel ähnelt:

   https://{location}.assistant.watson.cloud.ibm.com/{location}/{instance-id}/skills/{skill-id}/build/dialog#node={node-id}

4. Bearbeiten Sie die URL, indem Sie den aktuellen Wert {node-id} durch die ID des Knotens ersetzen, den Sie suchen möchten, und senden Sie dann die neue URL.

5. Falls erforderlich, heben Sie die bearbeitete URL erneut hervor und übergeben Sie sie erneut.

Die Seite wird aktualisiert und verschiebt den Fokus auf den Dialogmodulknoten mit der von Ihnen angegebenen Knoten-ID. Wenn es sich um die Knoten-ID für einen Slot, für eine Slotbedingung 'Gefunden' oder 'Nicht gefunden', für einen Slot-Handler oder für eine bedingte Antwort handelt, wird der Fokus auf den Knoten gelegt, in dem der Slot oder die bedingte Antwort definiert ist, und der entsprechende Modaldialog wird angezeigt.

Wenn der Knoten noch immer nicht gefunden wird, können Sie den Dialogskill exportieren und in einem JSON-Editor öffnen, um in der JSON-Datei des Skills zu suchen.