Reproduzir tom de teclado

Visão geral

A ferramenta de tom de teclado permite que os agentes da ElevenLabs reproduzam tons DTMF (Dual-Tone Multi-Frequency) durante chamadas telefônicas; esses são os tons reproduzidos quando você pressiona números no teclado. Isso permite que os agentes interajam com sistemas telefônicos automatizados, naveguem por menus de voz, insiram ramais, digitem códigos PIN e realizem outras operações por tons que normalmente exigiriam que uma pessoa pressionasse teclas no teclado do telefone.

Esta ferramenta de sistema oferece suporte a tons DTMF padrão (0-9, *, #), além de comandos de pausa para controle de tempo. Ela funciona perfeitamente com integrações telefônicas do Twilio e de tronco SIP, gerando automaticamente os tons de áudio adequados para a infraestrutura de telefonia subjacente.

Para coletar dígitos do teclado de quem liga, consulte entrada DTMF.

Funcionalidade

• Tons DTMF padrão: oferece suporte a todos os caracteres padrão do teclado (0-9, *, #)
• Controle de pausa: inclui comandos de pausa para um controle preciso do tempo (w = 0,5 s, W = 1,0 s)
• Suporte a vários provedores: funciona com integrações do Twilio e de tronco SIP

Esta ferramenta de sistema pode ser usada para navegar por menus telefônicos, inserir ramais e digitar códigos. O LLM determina quando e quais tons reproduzir com base no contexto da conversa.

A descrição padrão da ferramenta explica ao LLM que conduz a conversa que ele pode reproduzir esses tons, e recomendamos atualizar o prompt de sistema do seu agente para explicar quando ele deve chamar esta ferramenta.

Parâmetros:

• reason (string, opcional): O motivo para reproduzir os tons DTMF (por exemplo, “navegando até a extensão”, “inserindo PIN”)
• dtmf_tones (string, obrigatório): A sequência DTMF a ser reproduzida. Caracteres válidos: 0-9, *, #, w (pausa de 0,5 s), W (pausa de 1 s)

Formato da chamada de função:

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

DTMF fora de banda

Por padrão, os tons DTMF são enviados como sinais de áudio em banda no fluxo de voz. No entanto, alguns sistemas IVR (Resposta de Voz Interativa) podem não detectar esses tons em banda de forma confiável devido à compressão de áudio, às condições da rede ou à configuração do sistema.

O DTMF fora de banda (RFC 4733) envia tons como pacotes RTP separados em vez de áudio. Esse método é mais confiável para implementações de tronco SIP em que os sistemas IVR dos destinatários têm dificuldade para detectar o DTMF em banda padrão.

Para ativar o DTMF fora de banda:

1. Acesse a configuração de ferramentas do seu agente
2. Selecione a ferramenta Reproduzir tom de teclado
3. Marque a caixa de seleção Usar DTMF fora de banda (RFC 4733)

Caracteres compatíveis

A ferramenta oferece suporte aos seguintes caracteres e comandos DTMF:

• Dígitos: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9
• Tons especiais: * (asterisco), # (cerquilha)
• Comandos de pausa:
  • w - Pausa curta (0,5 segundo)
  • W - Pausa longa (1,0 segundo)

Implementação via API

Você pode configurar a ferramenta de sistema play_keypad_touch_tone ao criar ou atualizar um agente via API. Essa ferramenta não exige parâmetros de configuração adicionais além de ativá-la.

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