Spela upp knappsatston

Översikt

Verktyget för knappsatsens tonsignaler gör det möjligt för ElevenLabs-agenter att spela DTMF-toner (Dual-Tone Multi-Frequency) under telefonsamtal. Det är tonerna som spelas när du trycker på siffror på knappsatsen. Det gör att agenter kan interagera med automatiserade telefonsystem, navigera i röstmenyer, ange anknytningar, mata in PIN-koder och utföra andra knapptryckningar som vanligtvis kräver att en mänsklig uppringare trycker på tangenter på telefonens knappsats.

Det här systemverktyget har stöd för vanliga DTMF-toner (0–9, *, #) samt pauskommandon för tidsstyrning. Det fungerar smidigt med telefonintegrationer för både Twilio och SIP-trunking och genererar automatiskt rätt ljudtoner för den underliggande telefoniinfrastrukturen.

Om du i stället vill samla in knappsatssiffror från uppringare, se DTMF-inmatning.

Funktioner

• Vanliga DTMF-toner: Stöd för alla vanliga tecken på knappsatsen (0–9, *, #)
• Pausstyrning: Innehåller pauskommandon för exakt tidsstyrning (w = 0,5 s, W = 1,0 s)
• Stöd för flera leverantörer: Fungerar med både Twilio- och SIP-trunking-integrationer

Det här systemverktyget kan användas för att navigera i telefonmenyer, ange anknytningar och mata in koder. LLM:et avgör när och vilka toner som ska spelas utifrån samtalets sammanhang.

Standardbeskrivningen av verktyget förklarar för LLM:et som driver samtalet att det kan spela dessa toner, och vi rekommenderar att du uppdaterar agentens systemprompt för att förklara när agenten ska anropa det här verktyget.

Parametrar:

• reason (sträng, valfritt): Anledningen till att spela DTMF-tonerna (t.ex. “navigerar till anknytning”, “anger PIN-kod”)
• dtmf_tones (sträng, krävs): DTMF-sekvensen som ska spelas upp. Giltiga tecken: 0-9, *, #, w (paus på 0,5 s), W (paus på 1 s)

Format för funktionsanrop:

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

DTMF utanför ljudkanalen

Som standard skickas DTMF-toner som ljudsignaler i ljudströmmen. Vissa IVR-system (Interactive Voice Response) kanske dock inte kan identifiera dessa signaler på ett tillförlitligt sätt på grund av ljudkomprimering, nätverksförhållanden eller systemkonfiguration.

DTMF utanför ljudkanalen (RFC 4733) skickar toner som separata RTP-paket i stället för ljud. Den här metoden är mer tillförlitlig för SIP-trunking-implementationer där mottagarens IVR-system har svårt att upptäcka vanliga DTMF-toner i ljudkanalen.

Så här aktiverar du DTMF utanför ljudkanalen:

1. Gå till agentens verktygskonfiguration
2. Välj verktyget Spela tonsignal från knappsats
3. Markera kryssrutan Använd DTMF utanför ljudkanalen (RFC 4733)

Tecken som stöds

Verktyget har stöd för följande DTMF-tecken och kommandon:

• Siffror: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9
• Specialtoner: * (asterisk), # (fyrkant)
• Pauskommandon:
  • w – Kort paus (0,5 sekunder)
  • W – Lång paus (1,0 sekund)

API-implementering

Du kan konfigurera systemverktyget play_keypad_touch_tone när du skapar eller uppdaterar en agent via API:t. Verktyget kräver inga ytterligare konfigurationsparametrar utöver att det aktiveras.

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"},
                    }
                },
            },
        ),
    ),
)