Prompt-Variablen und Einstellungen¶
Variablen fügen gespeicherte Einstellungen und Gesprächsdaten in einen Prompt ein. Nuvoca ersetzt sie beim Anruf durch die verfügbaren Werte. Wähle die Variablen aus der Liste des jeweiligen Editors.
Variablen im Agent-Prompt¶
| Variable | Bedeutung |
|---|---|
{persona} |
Text aus dem Persona-Feld des Agenten oder Flows |
{agent_name} |
Eingestellter Agent-Name |
{important_note} |
Zusätzlicher Hinweis aus den Agenten-Einstellungen |
{conversation_history} |
Vorherige Beiträge ohne die neueste Anrufereingabe |
{conversation_fact_summary} |
Ausdrücklich für dieses Gespräch gespeicherte Fakten |
{caller_phone_number} |
Verfügbare Anrufernummer, falls übermittelt |
{current_local_datetime} |
Aktuelles lokales Datum, Uhrzeit und IANA-Zeitzone der aktiven Konfiguration |
{default_language} |
Primäre Azure-Erkennungssprache, bei Kugel aus der primären ausgewählten Sprache abgeleitet, bei Deepgram de-DE |
{detected_spoken_language_locale} |
Zuletzt erkannte Anrufersprache, vor der Erkennung leer |
{context} |
Für den aktuellen Beitrag abgerufenes Wissen |
{query_transformation_context} |
Informationen zur angewandten Suchumformulierung |
{pre_call_context} |
Kontext aus der eingerichteten Pre-Processing-Abfrage |
Füge {persona} am Anfang des Hauptprompts ein, wie in der Prompt-Anleitung gezeigt. Begrüßungstexte pflegst du in den Agenten-Einstellungen. Tools weist du dem Agenten zu. Dafür brauchst du keine zusätzlichen Platzhalter im Prompt.
Die lokale Zeit hilft bei Angaben wie „morgen“. Frage bei Terminabsprachen nach, wenn die Zeitzone des Anrufers unklar ist. Die Standardsprache ist eine Einstellung, die erkannte Sprache bezieht sich auf den aktuellen Anrufer.
Einzelne Felder aus dem Anruferkontext¶
Mit Punktnotation kannst du gezielt auf das verarbeitete Pre-Processing-Ergebnis zugreifen. Zum Beispiel setzt {pre_call_context.customer.name} den Namen aus dem Objekt customer ein. {pre_call_context.orders[0].status} liest den Status des ersten Listeneintrags. Die Zählung beginnt bei 0.
Der Pfad richtet sich nach den gespeicherten Ausgabenamen. Wenn ein Mapping den Namen direkt unter name ablegt, verwendest du {pre_call_context.name}. Beispiele und das Verhalten bei fehlenden Werten findest du unter Anruferkontext abfragen.
Du kannst diese Feldpfade im Agent-Prompt, im Zusammenfassungs-Prompt und in personalisierten Begrüßungen verwenden.
Routing-Variablen¶
Routing-Prompts bieten {conversation_history}, {conversation_fact_summary} und {previous_intent}. Der vorherige Intent ist im ersten Durchlauf leer. Nutze ihn für Kontinuität und erlaube zugleich einen Routenwechsel bei einem klaren neuen Anliegen.
Fehlende Werte¶
Nutze die Anrufernummer nur, wenn sie vorhanden und vom Anrufer bestätigt ist.
Ist der Abfragekontext leer, fahre mit den Standardfragen fort.
Wenn du die Antwort nicht in den bereitgestellten Informationen findest, sage das offen.
Übernimm Variablennamen genau aus dem Editor. Verbinde die Wissensdatenbank oder Anruferabfrage, bevor du ihre Werte im Prompt nutzt.
Die passende Einstellung finden¶
| Problem | Einstellung oder Anleitung |
|---|---|
| Wiederholte Fragen | Gesprächsverlauf und Prompt |
| Abgeschnittene Antworten | Modellspezifisches Completion-Budget |
| Fehlende oder unpassende Fakten | Sucheinstellungen |
| Falsch erkannte Wörter | Erkennungseinstellungen |
| Falsch gesprochene Wörter | Ausspracheregeln |
| Falscher Fachagent | Flow-Routing |
Ändere jeweils eine Einstellung und prüfe das Ergebnis mit einem neuen Anruf.