Virtual Agent-Thema debuggen

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 2 Minuten Lesedauer

    • Untersuchen und beheben Sie unerwartetes Verhalten in Ihren anwenderdefinierten Virtual Agent -Themen, Themenblöcken und Steuerungen.

    Informationen zu Problemen bei der Themen-Discovery finden Sie unter LLM-Themen-Discovery in Virtual Agent und Lösen Sie Natural Language Understanding (NLU)-Themen-Discovery-Probleme.

    Duplizieren Sie ein Live-Thema, bevor Sie es debuggen und ändern

    Duplizieren Sie ein Thema, anstatt ein Live-Thema zu aktualisieren. Das unveränderte ursprüngliche Thema kann sowohl als Referenz als auch als Sicherung dienen. Wenn Sie das Original beibehalten, können Sie das Thema schnell wiederherstellen. Denken Sie daran, das ursprüngliche Thema zu deaktivieren, bevor Sie das Duplikat veröffentlichen.

    Debuggen Sie ein Thema, während Sie Ihre Konversationen testen

    Wenn Sie ein Thema in Virtual Agent-Designererstellen oder aktualisieren, können Sie mit der Schaltfläche Test in der Kopfzeile des Themas eine Vorschau der Konversation anzeigen. Im Chat-Testfenster wird die Konversation so angezeigt, wie sie in Serviceportalenthalten ist. Elemente in einer Konversation werden in Messaging-Anwendungen von Drittanbietern möglicherweise anders angezeigt. Testen Sie Ihre Gespräche in allen Anwendungen von Drittanbietern, für die Sie eine Bereitstellung planen Virtual Agent.

    Im Test-Chat-Fenster werden vier Registerkarten mit detaillierten Informationen zum Debuggen und Eingrenzen Ihres Themas angezeigt: Testausdrücke analysieren, Variablen, Kontextund Protokolle. Einzelheiten zu diesen Registerkarten finden Sie unter Testen NLU/Stichwortthemen. Das folgende Beispiel zeigt die Verarbeitungsnachrichten und -fehler, die während des Tests protokolliert wurden.

    Konversationsvorschauprotokolle, die im Themenvorschaufenster angezeigt werden.

    Achten Sie auf Warnungen zu Steuerungenn in Ihrem Thema.

    Abbildung : 1. Warnungen zu einem Themenknoten auf der Registerkarte „Flow“.
    Anzahl der Warnungen, die im Canvas und bei den einzelnen Steuerelementen rot angezeigt werden. Für das Steuerelement „Texteingabe“ sind Knotenname und Aufforderung obligatorisch

    Bei Steuerungen, bei denen erforderliche Informationen fehlen, wird in der oberen linken Ecke des Steuerelements ein rotes Abzeichen für „Unvollständig“ angezeigt. Das Abzeichen zeigt eine Zahl an, die die Anzahl der Probleme in dieser Kontrolle angibt. Wählen Sie dieses Abzeichen aus, um eine Liste der Probleme im Steuerelement anzuzeigen.

    Ein weiteres Warnabzeichen wird in der oberen linken Ecke des Canvas angezeigt, um die Anzahl der Probleme innerhalb des gesamten Themas anzuzeigen.

    Auf Fehler prüfen, wenn keine Themenvorschau ausgeführt wird

    Abbildung : 2. Themenvorschaufehler im Canvas
    Das Fenster der Themenvalidierung, das eine Vorschau der Fehler auf dem Canvas anzeigt.

    Zusätzliche Informationen werden auf der Registerkarte Validierungsprobleme in der Sidebar des Canvas Virtual Agent-Designer angezeigt, wenn ein Fehler die Ausführung des Themas verhindert. Die Gesamtzahl der Probleme wird zusammen mit Details und einem Hyperlink für jeden Knoten aufgelistet. Wählen Sie einen Hyperlink, um zum Knoten zu wechseln, und verwenden Sie die bereitgestellten Informationen, um Fehler in Ihrer Konversation zu korrigieren. Sie können die Registerkarte schließen, ohne die Probleme zu korrigieren. Bis zur Korrektur der Probleme wird jedoch die Registerkarte Validierungsprobleme angezeigt, wenn Sie Veröffentlichenauswählen. Die Registerkarte Validierungsprobleme wird geschlossen, wenn Sie nach der Korrektur aller Probleme Veröffentlichen wählen.

    Häufig auftretende Virtual Agent-Probleme

    Problem Mögliche Auflösung
    Modul-Designer wird unter Konversations-Schnittstellen nicht angezeigt
    • Der Benutzer hat möglicherweise nicht die Rolle virtual_agent_admin.
    • Das Virtual Agent-Plugin ist möglicherweise nicht aktiviert.
    Ein Thema kann nicht bearbeitet werden. Der angemeldete Benutzer muss sich in demselben Anwendungsbereich wie das Thema befinden.
    Die Vorschau des Themas ist nicht möglich.
    • Stellen Sie sicher, dass alle Pflichtfelder in den Knoteneigenschaften ausgefüllt sind.
    • Stellen Sie sicher, dass Ihr Browser so konfiguriert ist, dass er Popups von Ihrer Instanz zulässt.
    Chat-Widget hängt beim Verbinden... Mindestens eines Ihrer Themen fehlt möglicherweise. Überprüfen Sie, um sicherzustellen, dass Themen in der Instanz vorhanden sind und sich im Status Aktiv befinden.

    In einem Konversations-Flow ausgeführte Themen überprüfen

    Bei jeder Konversation des Virtual Agent (VA) in einer Instanz wird automatisch ein Interaktionsdatensatz in der Interaktionstabelle [interactions] generiert, in dem die Konversation zwischen einer anfordernden Person und einem Virtual Agent bzw. Live-Agent protokolliert wird. Sie können das Transkript der Konversation zwischen der anfordernden Person und dem Virtual Agent überprüfen, einschließlich Live-Agent-Übertragungen (bei Verwendung des Agent-Chats). Details finden Sie unter Virtual Agent-Interaktionsdatensatz.