음성사서함 감지

에이전트가 음성사서함 시스템을 자동으로 감지하고 필요에 따라 메시지를 남기도록 하세요.

개요

음성사서함 감지 도구를 사용하면 ElevenLabs 에이전트가 통화가 사람 대신 음성사서함 시스템에 의해 응답되었는지 자동으로 식별할 수 있습니다. 이 시스템 도구를 통해 에이전트는 미리 구성된 메시지를 남기거나 즉시 통화를 종료하여 자동화된 음성사서함 상황을 자연스럽게 처리할 수 있습니다.

기능

자동 감지: LLM은 자동 안내 및 프롬프트를 기반으로 대화 패턴을 분석하여 음성사서함 시스템을 식별합니다.
구성 가능한 응답: 음성사서함이 감지되면 사용자 지정 음성사서함 메시지를 남기거나 즉시 통화를 종료하도록 선택할 수 있습니다.
통화 종료: 감지 및 선택적 메시지 전달 후 통화가 자동으로 종료됩니다.
상태 추적: 음성사서함 감지 이벤트는 기록되며 대화 기록과 배치 통화 결과에서 확인할 수 있습니다.

파라미터:

reason (문자열, 필수): 음성사서함 감지 사유(예: “자동 안내 감지됨”, “사람의 응답 없음”)

함수 호출 형식:

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

구성 옵션

음성사서함 감지 도구는 다음 옵션으로 구성할 수 있습니다.

음성사서함 메시지: 음성사서함이 감지될 때 재생할 선택적 사용자 지정 메시지를 구성할 수 있습니다. 이 메시지는 동적 변수를 지원하므로 {{user_name}} 또는 {{appointment_time}} 같은 런타임 값으로 음성사서함 메시지를 개인화할 수 있습니다.

API 구현

API를 통해 에이전트를 생성할 때 에이전트 구성에 음성사서함 감지 도구를 추가할 수 있습니다. 시스템 도구로 정의해야 합니다.

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