Virtual Agent-Thema debuggen

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 2 Minuten Lesedauer

    • Untersuchen und lösen Sie unerwartetes Verhalten in Ihrer Anwenderanwendung Virtual Agent Themen, Themenblöcke und Steuerungen.

    Informationen zu Themen-Discovery-Problemen finden Sie unter LLM-Themen-Discovery in Virtual Agent Und Lösen 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. Durch Beibehaltung des Originals 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 beim Testen Ihrer Konversationen

    Während Sie ein Thema in erstellen oder aktualisieren Virtual Agent-Designer, Verwenden Sie Testen Schaltfläche in der Kopfzeile des Themas, um eine Vorschau der Konversation anzuzeigen. Das Chat-Testfenster zeigt die Konversation so an, wie sie in angezeigt wird Serviceportal. 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 angezeigt, die detaillierte Informationen zum Debugging und Verfeinern Ihres Themas enthalten: Analysieren Sie Testausdrücke , Variablen , Kontext , Und Protokolle . Weitere Informationen zu diesen Registerkarten finden Sie unter Wird Getestet NLU/Stichwortthemen. Das folgende Beispiel zeigt die während des Tests protokollierten Verarbeitungsnachrichten und -Fehler.

    Konversationsvorschauprotokolle, die im Themenvorschaufenster angezeigt werden.

    Achten Sie auf Warnungen zu Steuerungenn in Ihrem Thema.

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

    Steuerungen, für die erforderliche Informationen fehlen, zeigen in der oberen linken Ecke des Steuerelements ein rotes unvollständiges Abzeichen. Das Abzeichen zeigt eine Zahl, die die Anzahl der Probleme in diesem Steuerelement angibt. Wählen Sie dieses Abzeichen aus, um eine Liste der Probleme im Steuerelement anzuzeigen.

    In der oberen linken Ecke des Canvas wird ein weiteres Warnabzeichen angezeigt, das die Anzahl der Probleme im gesamten Thema angibt.

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

    Abbildung : 2. Themenvorschaufehler im Canvas
    Das Themenvalidierungsfenster, das eine Vorschau der Fehler im Canvas anzeigt.

    Zusätzliche Informationen werden auf der Registerkarte Validierungsprobleme in der Sidebar von angezeigt Virtual Agent-Designer Canvas, 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 aus, um zum Knoten zu wechseln, und verwenden Sie die bereitgestellten Informationen, um Fehler in Ihrer Konversation zu beheben. Sie können die Registerkarte schließen, ohne die Probleme zu korrigieren. Bis die Probleme behoben sind, wird die Registerkarte Validierungsprobleme angezeigt, wenn Sie auswählen Veröffentlichen . Die Registerkarte Validierungsprobleme wird geschlossen, wenn Sie auswählen Veröffentlichen Nachdem alle Probleme korrigiert wurden.

    Häufig auftretende Virtual Agent-Probleme

    Problem Mögliche Auflösung
    Moduldesigner kann nicht unter Konversationsschnittstellen angezeigt werden
    • 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 Herstellen der Verbindung fest... 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.