Prompt und Tools
Ein Werkzeug wird nicht genutzt, Variablen bleiben leer, Änderungen wirken nicht oder das API-Tool meldet einen Fehler.
Werkzeuge wie Kalender, Web-Recherche, Weiterleitung, Wissensdatenbank oder dein CRM nutzt der Agent selbstständig, wenn der Prompt und die Beschreibung des Werkzeugs es nahelegen. Was er wann genutzt hat, siehst du im Anrufverlauf unter Main Logs.
Ein Werkzeug wird nicht genutzt
| Mögliche Ursache | Lösung |
|---|---|
| Das Werkzeug ist nicht eingeschaltet | Prüfe im Reiter Tools, ob es unter Tools steht. Ein Werkzeug, das nur im Prompt erwähnt wird, gibt es für den Agenten nicht |
| Der Agent weiß nicht, wann er es nutzen soll | Fülle die Beschreibung des Werkzeugs aus: Kontext für die KI bei der Weiterleitung, Wann soll gesucht werden? bei der Web-Recherche, Beschreibung (für KI) beim CRM-Tool. Sag es zusätzlich im Prompt |
| Es fehlen Angaben, die das Werkzeug braucht | Beim CRM-Tool fragt der Agent erst alle Pflichtparameter ab. Prüfe, ob der Anrufer sie genannt hat |
| Weiterleitung im Audio-Test | Im Browser gibt es keine Telefonleitung, eine Weiterleitung lässt sich nur mit einem echten Anruf testen |
So testest du es: Formuliere im Test genau den Satz, der das Werkzeug auslösen soll, etwa „Ich möchte einen Termin am Dienstag“. In Main Logs muss danach ein Eintrag für das Werkzeug stehen.
Ein Werkzeug wird zur falschen Zeit genutzt
| Mögliche Ursache | Lösung |
|---|---|
| Zwei Werkzeuge haben ähnliche Beschreibungen | Grenze sie klar ab, zum Beispiel „Nur bei Notfällen weiterleiten, alle anderen Anliegen als Rückruf aufnehmen.“ |
| Die Beschreibung ist zu allgemein | Nenne konkrete Auslöser statt „bei Bedarf“ |
Variablen bleiben leer
| Mögliche Ursache | Lösung |
|---|---|
| Der Name im Platzhalter weicht ab | {{Vorname}} und {{vorname}} sind verschiedene Variablen. Schreib den Namen genau so wie im Webhook, im context oder in der Spalte der Kampagne |
| Leerzeichen oder Sonderzeichen im Platzhalter | {{ vorname }} wird nie ersetzt. Schreib {{vorname}} |
| Der Incoming Webhook hat den Wert nicht geliefert | Prüfe in der Webhook Statistiken, ob er erfolgreich war, und hinterlege einen Fallback-Wert |
| Bei Kampagnen fehlt die Spalte in der CSV | Das Dashboard warnt beim Hochladen, welche Platzhalter keine Spalte haben |
Ein Platzhalter ohne Wert wird vor dem Gespräch entfernt. Der Agent liest also nie den Namen der Variable vor, der Satz wirkt nur unvollständig.
Eine Änderung wirkt nicht
| Mögliche Ursache | Lösung |
|---|---|
| Nicht gespeichert | Speichere die Änderung. Der Audio-Test speichert vor dem Start automatisch |
| Das Gespräch lief schon | Änderungen gelten ab dem nächsten Anruf |
| Du hast einen anderen Agenten bearbeitet | Prüfe unter Telefonnummer, welcher Agent der Nummer zugewiesen ist |
| Eine Vorlage hat den Prompt überschrieben | Prompt überschreiben ersetzt den bisherigen Text. Übernimm deine Änderungen danach neu |
Das CRM-Tool meldet einen Fehler
| Mögliche Ursache | Lösung |
|---|---|
| Dein System antwortet nicht mit einem Status 2xx | Prüfe in Main Logs die Ausgabe des Werkzeugs und im Log deines Systems die Anfrage |
| Zeitüberschreitung | Dein System antwortet langsamer als das Timeout. Erhöhe es unter Erweiterte Einstellungen oder beschleunige dein System |
| Ungültiges JSON im Body | Prüfe die Request Body Preview im Tool. Platzhalter in Zeichenketten stehen in Anführungszeichen: "name": "{{name}}" |
| Falscher oder fehlender Header | Prüfe Schlüssel und Schreibweise im Bereich Headers |
Der Anrufer hört Stille, während ein Werkzeug läuft
Hinterlege einen Wartetext, zum Beispiel „Einen Moment, ich trage das ein.“ Der Agent spricht ihn, während das Werkzeug arbeitet. Bei der Web-Recherche dauert eine Suche etwa zwei bis fünf Sekunden.
Weiterhilfe
Schick uns Zeitpunkt des Anrufs, Name des Werkzeugs und ein Bildschirmfoto aus Main Logs, siehe Problem melden.
War diese Seite hilfreich?