Tastentöne wiedergeben

Überblick

Mit dem Tool für Tastentöne können ElevenLabs-Agents während Telefonaten DTMF-Töne (Dual-Tone Multi-Frequency) wiedergeben. Das sind die Töne, die beim Drücken von Ziffern auf der Tastatur erklingen. So können Agents mit automatisierten Telefonsystemen interagieren, Sprachmenüs navigieren, Durchwahlen eingeben, PIN-Codes eingeben und andere Tastenfunktionen ausführen, bei denen ein menschlicher Anrufer normalerweise Tasten auf dem Telefon drücken müsste.

Dieses Systemtool unterstützt Standard-DTMF-Töne (0-9, *, #) sowie Pausenbefehle zur Zeitsteuerung. Es funktioniert nahtlos mit Twilio- und SIP-Trunking-Telefonintegrationen und generiert automatisch die passenden Audiotöne für die zugrunde liegende Telefonie-Infrastruktur.

Informationen dazu, wie Sie stattdessen Tastatureingaben von Anrufern erfassen, finden Sie unter DTMF-Eingabe.

Funktionsweise

• Standard-DTMF-Töne: Unterstützt alle Standardzeichen der Tastatur (0-9, *, #)
• Pausensteuerung: Enthält Pausenbefehle für präzises Timing (w = 0,5 s, W = 1,0 s)
• Unterstützung mehrerer Anbieter: Funktioniert mit Twilio- und SIP-Trunking-Integrationen

Dieses Systemtool kann zur Navigation durch Telefonmenüs, zur Eingabe von Durchwahlen und zur Eingabe von Codes verwendet werden. Das LLM bestimmt anhand des Gesprächskontexts, wann und welche Töne wiedergegeben werden.

Die Standard-Toolbeschreibung erklärt dem LLM, das das Gespräch steuert, dass es diese Töne wiedergeben kann. Wir empfehlen, den System-Prompt Ihres Agents zu aktualisieren, um zu erklären, wann der Agent dieses Tool aufrufen soll.

Parameter:

• reason (String, optional): Der Grund für das Abspielen der DTMF-Töne (z. B. „Durchwahl auswählen“, „PIN eingeben“)
• dtmf_tones (String, erforderlich): Die abzuspielende DTMF-Sequenz. Gültige Zeichen: 0-9, *, #, w (0,5 s Pause), W (1 s Pause)

Format des Funktionsaufrufs:

{
  "type": "function",
  "function": {
    "name": "play_keypad_touch_tone",
    "arguments": "{"reason": "Navigating to customer service", "dtmf_tones": "2"}"
  }
}

Out-of-Band-DTMF

Standardmäßig werden DTMF-Töne als In-Band-Audiosignale innerhalb des Sprachstreams gesendet. Einige IVR-Systeme (Interactive Voice Response) erkennen diese In-Band-Töne jedoch aufgrund von Audiokomprimierung, Netzwerkbedingungen oder der Systemkonfiguration möglicherweise nicht zuverlässig.

Out-of-Band-DTMF (RFC 4733) sendet Töne als separate RTP-Pakete statt als Audio. Diese Methode ist für SIP-Trunking-Implementierungen zuverlässiger, wenn IVR-Systeme der Empfänger Standard-In-Band-DTMF nur schwer erkennen.

So aktivieren Sie Out-of-Band-DTMF:

1. Navigieren Sie zur Tool-Konfiguration Ihres Agents.
2. Wählen Sie das Tool Tastentöne wiedergeben aus.
3. Aktivieren Sie das Kontrollkästchen Out-of-Band-DTMF verwenden (RFC 4733).

Unterstützte Zeichen

Das Tool unterstützt die folgenden DTMF-Zeichen und -Befehle:

• Ziffern: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9
• Sondertöne: * (Stern), # (Raute)
• Pausenbefehle:
  • w – Kurze Pause (0,5 Sekunden)
  • W – Lange Pause (1,0 Sekunde)

API-Implementierung

Sie können das Systemtool play_keypad_touch_tone beim Erstellen oder Aktualisieren eines Agents über die API konfigurieren. Dieses Tool benötigt außer der Aktivierung keine weiteren Konfigurationsparameter.

from elevenlabs import AgentConfig, ConversationalConfig, ElevenLabs
elevenlabs = ElevenLabs(api_key="YOUR_API_KEY")
response = elevenlabs.conversational_ai.agents.create(
    conversation_config=ConversationalConfig(
        agent=AgentConfig(
            first_message="Hi, I can help you navigate phone systems. How can I assist you today?",
            prompt={
                "prompt": "You are a helpful assistant that can interact with phone systems.",
                "built_in_tools": {
                    "play_keypad_touch_tone": {
                        "type": "system",
                        "name": "play_keypad_touch_tone",
                        # Optional custom description
                        "description": "Play DTMF tones to interact with automated phone systems.",
                        "params": {"system_tool_type": "play_keypad_touch_tone"},
                    }
                },
            },
        ),
    ),
)