Wykrywanie poczty głosowej

Omówienie

Narzędzie Wykrywanie poczty głosowej pozwala agentowi ElevenLabs automatycznie rozpoznać, że połączenie odebrał system poczty głosowej, a nie człowiek. To narzędzie systemowe pozwala agentom płynnie obsługiwać automatyczną pocztę głosową, zostawiając wcześniej skonfigurowaną wiadomość lub od razu kończąc połączenie.

Funkcje

• Automatyczne wykrywanie: LLM analizuje wzorce rozmowy, aby rozpoznać systemy poczty głosowej na podstawie automatycznych powitań i komunikatów
• Konfigurowalna reakcja: Wybierz, czy po wykryciu poczty głosowej zostawić własną wiadomość, czy od razu zakończyć połączenie
• Zakończenie połączenia: Po wykryciu i opcjonalnym przekazaniu wiadomości połączenie jest automatycznie kończone
• Śledzenie statusu: Zdarzenia wykrycia poczty głosowej są rejestrowane i widoczne w historii rozmów oraz wynikach połączeń wsadowych

Parametry:

• reason (string, wymagany): Powód wykrycia poczty głosowej (np. „wykryto automatyczne powitanie”, „brak odpowiedzi człowieka”)

Format wywołania funkcji:

{
  "type": "function",
  "function": {
    "name": "voicemail_detection",
    "arguments": "{\"reason\": \"Automated greeting detected with request to leave message\"}"
  }
}

Opcje konfiguracji

Narzędzie wykrywania poczty głosowej można skonfigurować za pomocą poniższych opcji:

• Wiadomość poczty głosowej: Możesz skonfigurować opcjonalną własną wiadomość odtwarzaną po wykryciu poczty głosowej. Ta wiadomość obsługuje zmienne dynamiczne, dzięki czemu możesz personalizować wiadomości poczty głosowej wartościami środowiska uruchomieniowego, takimi jak {{user_name}} lub {{appointment_time}}

Implementacja API

Podczas tworzenia agenta przez API możesz dodać narzędzie Wykrywanie poczty głosowej do konfiguracji agenta. Powinno być zdefiniowane jako narzędzie systemowe:

from elevenlabs import AgentConfig, ConversationalConfig, ElevenLabs
elevenlabs = ElevenLabs(api_key="YOUR_API_KEY")
response = elevenlabs.conversational_ai.agents.create(
    conversation_config=ConversationalConfig(
        agent=AgentConfig(
            prompt={
                "built_in_tools": {
                    "voicemail_detection": {
                        "type": "system",
                        "name": "voicemail_detection",
                        # Optional: customize when the tool should be triggered
                        "description": "",
                        "params": {
                            "system_tool_type": "voicemail_detection",
                            # Optional: message left when voicemail is detected
                            "voicemail_message": "Sorry I missed you. I'll call back later.",
                        },
                    }
                }
            },
        ),
    ),
)