Teilen Sie:
){kind=small}
Benjamin Aronov ist ein Entwickler-Befürworter bei Vonage. Er ist ein bewährter Community Builder mit einem Hintergrund in Ruby on Rails. Benjamin genießt die Strände von Tel Aviv, das er sein Zuhause nennt. Von Tel Aviv aus kann er einige der besten Startup-Gründer der Welt treffen und von ihnen lernen. Außerhalb der Tech-Branche reist Benjamin gerne um die Welt auf der Suche nach dem perfekten Pain au Chocolat.
Testen Sie WhatsApp-Agenten mit dem eingebauten Tester von AI Studio
Lesedauer: 4 Minuten
Eine der risikoreichsten Programmierpraktiken ist es, große Mengen an Code zu schreiben, ohne in regelmäßigen Abständen zu testen, um sicherzustellen, dass alles wie vorgesehen funktioniert. Das gleiche Prinzip gilt für No-Code/Low-Code! Zum Glück, AI Studio über einen eingebauten Tester, der sicherstellt, dass Ihr Code bei jedem Schritt funktioniert.
Dieser Artikel zeigt Ihnen, wie Sie mit dem AI Studio Tester für WhatsApp-Agenten und einige häufige Fallstricke vermeiden.
Registrieren Sie sich für einen Vonage API Account
Versuchen Sie, einen Agenten zu erstellen; sehen Sie sich unsere Anleitungen für den Anfang
Um dieses Tutorial durchzuführen, benötigen Sie ein Vonage API-Konto. Wenn Sie noch keines haben, können Sie sich noch heute anmelden und mit einem kostenlosen Guthaben beginnen. Sobald Sie ein Konto haben, finden Sie Ihren API-Schlüssel und Ihr API-Geheimnis oben auf dem Vonage-API-Dashboard.
Der erste Schritt ist das Öffnen des Tester im Canvas Ihres Agenten. Klicken Sie auf die große schwarze Schaltfläche oben rechts im Canvas, auf der Tester steht. Dadurch wird der Tester geöffnet. Sie können wählen, welches Ereignis getestet werden soll (wenn Sie mehrere haben) und ob Sie im AI Studio Canvas oder direkt in WhatsApp testen möchten.
Beachten Sie, dass der Test-Chat in WhatsApp nur vorübergehend ist und Sie trotzdem eine Nummer kaufen und einen Agenten veröffentlichen müssen, um Ihren Agenten öffentlich nutzen zu können.
A screenshot of the AI Studio built-in tester interface, allowing users to start a chat or test an agent directly in WhatsApp.Klicken Sie auf die Schaltfläche "Chat starten", und solange Sie einige Gesprächsknoten mit Ihrem Agenten verbunden haben, können Sie sofort mit dem Agenten interagieren. Wie cool!
Das wichtigste Merkmal des Testers ist die Möglichkeit, Testparameter/Variablen zu verwenden. Mithilfe von Testparametern können wir feststellen, ob Agentenfehler auf die Ablauflogik oder auf fehlerhafte Eingaben zurückzuführen sind. Um auf die Testparameter zuzugreifen, klicken Sie auf das Zahnrad-/Einstellungssymbol am oberen Rand des Tester-Fensters. Um das Fenster zu schließen, klicken Sie erneut auf das Zahnradsymbol.
AI Studio showing a chatbot flow and the tester being opened to start a test session.Agentenabläufe sind oft auf Benutzerdaten (wie die Telefonnummer des Benutzers) angewiesen, um mit externen Systemen integriert zu werden. Wir können Testparameter für diese Arten von Variablen unter Systemparameter hinzufügen. Außerdem werden Variablen, die speziell für Ihren Agenten erstellt wurden, unter Benutzerdefinierte Parameter angezeigt. Das Festlegen von Werten für Testparameter ist sehr nützlich für die Fehlersuche in Integrationsknoten wie dem Webhook-Knoten oder den Salesforce-Knoten.
Betrachten Sie den folgenden Webhook-Knoten, der den Agenten mit einem Google Sheet verbindet. Die Einrichtung der Integration ist etwas kompliziert und kann zu vielen verschiedenen Fehlern führen: der Code in den Google Apps Scripts, eine fehlerhafte Anfrage-URL, ein falscher Abfrageparameter oder etwas anderes.
A screenshot of an AI Studio Webhook node configured to retrieve a price using a GET request with a query parameter.Sie können sehen, dass wir die Schaltfläche "Test request" im Webhook-Knoten haben. Wenn wir jedoch auf "Senden" klicken, erhalten wir den folgenden Fehler: "error": "Item not found."
Unsere Anfrage sah nämlich folgendermaßen aus:
https://script.google.com/macros/s/AKfycbw5hzozzPWXB6-3f27iYA2-ug-rnJwl22ZdEXaBdemuPC4pds9NLzAC5mAQmDGMqfs/exec?item=
Das Element war leer! Glücklicherweise können wir dies korrigieren, indem wir unsere Testparameter öffnen, indem wir auf das Zahnradsymbol klicken und sie auf einen Wert aktualisieren, von dem wir sicher sind, dass er in unserer Kalkulationstabelle existiert. Und jetzt können wir sehen, dass wir eine gute Antwort erhalten haben!
A screenshot of AI Studio's test parameters panel and webhook test request, showing how setting an initial parameter affects the response.
Tipp: Ein häufiges Datenproblem ist die Übergabe von Strings, wenn Zahlen erwartet werden und umgekehrt. Die Verwendung von Testvariablen kann helfen, dies schnell zu erkennen.
Benutzer nehmen oft Aktualisierungen vor, wie z. B. die Änderung von Testparametern, und sehen keinen Unterschied in der Testleistung des Agenten. Das liegt daran, dass sie das Testprogramm nicht aktualisiert haben, um die neueste Version zu erhalten. Wenn Sie den Tester geöffnet haben, müssen Sie auf das Aktualisierungssymbol klicken, bevor Sie einen neuen Testablauf ausführen.
AI Studio showing a chatbot test session where a user interacts with an agent to retrieve a price.
Möglicherweise stoßen Sie auf Fehler, sobald Sie Ihren Agentenfluss im Prüfprogramm gestartet haben. Das ist ganz normal! Jede Chat-Bubble im Tester hat zwei Symbole. Das erste Symbol für einen externen Link passt den Canvas an, um den für diese Ausgabe verantwortlichen Knoten anzuzeigen. Das zweite Code-Symbol öffnet das Debug-Fenster, das den JSON-Code der Flow-Ausführung anzeigt.
Im folgenden Beispiel können Sie sehen, wie nützlich das Debug-Fenster ist. In diesem Chat geben wir die Eingabe "Banane" ein und der Webhook scheint ohne Fehler ausgeführt zu werden. Allerdings erhalten wir keinen Preis für die Anzeige.
A screenshot of an AI Studio chat session where a webhook executes successfully, but the agent fails to return the expected price.Der erste Schritt besteht darin, sicherzustellen, dass der Knoten Nachricht senden unseren Parameter korrekt anzeigt. Setzen wir also unseren Parameter price auf 100. Und wie wir sehen können, wird der Preis jetzt als 100 $ angezeigt. Es muss also etwas im Webhook-Knoten passieren.
AI Studio's test parameters panel being used to define values for debugging a chatbot flow.
Dieses Mal können wir das Debug-Fenster öffnen, indem wir auf das Code-Symbol in der Webhook-Nachricht klicken. Dies öffnet das JSON-Protokoll von allem, was bis jetzt in unserem Agenten ausgeführt worden ist. Wir können nach "web" suchen, um den fraglichen Knoten leichter zu finden. Und hier finden wir den Übeltäter!
Tipp: Die Suche nach "Fehler" macht es einfacher, den richtigen Fehler zu finden, wenn mehrere Dinge falsch laufen.
AI Studio's tester showing a chatbot conversation where a webhook executes successfully, but the agent fails to return a price, requiring debugging.Obwohl der Status des Webhook-Knotens "ERFOLG" anzeigt, enthält die Nachricht, die wir im Feld "Text" erhalten, keinen Preis. Stattdessen zeigt sie an:
{"error":"Item not found."}
Und das macht Sinn, denn Banane nicht in unserer Kalkulationstabelle enthalten ist.
Tipp: Um Ihren Fehler schneller zu finden, verwenden Sie ctrl+f oder cmd+f
Mit dem integrierten Tester können Sie Ihren Agenten direkt auf WhatsApp testen! Es ist auch die empfohlene Art zu testen, weil sie der Realität am nächsten kommt, da einige Funktionen im Studio-Tester fehlen könnten.
Öffnen Sie den Tester und klicken Sie dieses Mal auf "In Whatsapp testen". Daraufhin wird ein Bildschirm mit einem QR-Code und einem Link geöffnet. Scannen Sie entweder den QR-Code mit Ihrem Telefon oder klicken Sie auf den Link. Dadurch wird ein Chat mit einer Testversion Ihres Agenten geöffnet.
Beginnen Sie den Chat, indem Sie die generierte Passphrase senden. Danach wird Ihr Agent entsprechend dem Ablauf ausgeführt. Sie können sogar den Link zum Chat weitergeben, damit andere den Agenten testen können.
Hinweis: Testchats laufen maximal 24 Stunden lang ab. Möglicherweise müssen Sie den Chat neu generieren, indem Sie das Testgerät erneut öffnen und den QR-Code/Link erneut scannen. Der Test-Chat funktioniert jedoch nicht als Produktionsagent, Sie müssen Ihren Agenten veröffentlichen damit er funktioniert.
A screenshot of the AI Studio tester interface displaying a QR code for testing an agent in WhatsApp.
Jetzt, wo Sie gesehen haben, wie Sie den eingebauten Tester in AI Studio verwenden und debuggen können, steht der Erstellung von fantastischen WhatsApp Chatbots nichts mehr im Wege. Wir haben eine große Auswahl an AI Studio Anleitungen oder erstellen Sie Ihre eigene Integration und erzählen Sie uns davon. Wenn Sie nicht weiterkommen oder nicht wissen, wie Sie einen Fehler mit dem Tester umgehen können, schreiben Sie mir eine Nachricht auf dem Vonage Community Slack. Wir haben sogar einen eigenen Kanal für AI Studio.
Teilen Sie:
Benjamin Aronov ist ein Entwickler-Befürworter bei Vonage. Er ist ein bewährter Community Builder mit einem Hintergrund in Ruby on Rails. Benjamin genießt die Strände von Tel Aviv, das er sein Zuhause nennt. Von Tel Aviv aus kann er einige der besten Startup-Gründer der Welt treffen und von ihnen lernen. Außerhalb der Tech-Branche reist Benjamin gerne um die Welt auf der Suche nach dem perfekten Pain au Chocolat.