통화 종료

에이전트가 사용자와의 통화를 자동으로 종료하도록 설정하세요.

End Call 도구는 ElevenLabs 대시보드에서 생성한 에이전트에 기본으로 추가됩니다. API 또는 SDK를 통해 생성한 에이전트에서 End Call 도구를 활성화하려면 에이전트 구성에 시스템 도구로 수동 추가해야 합니다. 자세한 내용은 아래 API 구현을 참조하세요.

통화 종료

개요

End Call 도구를 사용하면 대화형 에이전트가 사용자와의 통화를 종료할 수 있습니다. 이 시스템 도구는 통화를 종료하는 방식과 시점에 유연성을 제공합니다.

기능

  • 기본 동작: 사용자 정의 프롬프트 없이도 도구를 작동할 수 있으며, 대화가 자연스럽게 끝날 때 통화를 종료합니다.
  • 맞춤 프롬프트: 통화가 종료되어야 하는 조건을 지정할 수 있습니다. 예를 들면 다음과 같습니다.
    • 사용자가 “안녕히 계세요”라고 말하면 통화를 종료합니다.
    • 특정 작업이 완료되면 통화를 종료합니다.

목적: 적절한 조건이 충족되면 대화를 자동으로 종료합니다.

실행 조건: 다음 경우 LLM이 이 도구를 호출해야 합니다.

  • 주요 작업이 완료되었고 사용자가 만족한 경우
  • 상호 합의하에 대화가 자연스럽게 마무리된 경우
  • 사용자가 대화를 종료하고 싶다고 명시적으로 밝힌 경우

매개변수:

  • reason (문자열, 필수): 통화를 종료하는 이유
  • message (문자열, 선택): 통화 종료 전에 사용자에게 전송할 작별 메시지

함수 호출 형식:

{
"type": "function",
"function": {
"name": "end_call",
"arguments": "{\"reason\": \"Task completed successfully\", \"message\": \"Thank you for using our service. Have a great day!\"}"
}
}

구현: 에이전트 설정에서 시스템 도구로 구성하세요. LLM은 이 함수를 호출해야 하는 시점에 관한 자세한 지침을 받습니다.

API 구현

API를 통해 에이전트를 생성할 때 에이전트 구성에 End Call 도구를 추가할 수 있습니다. 시스템 도구로 정의해야 합니다.

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": {
"end_call": {
"type": "system",
"name": "end_call",
# Optional: customize when the tool should be triggered
"description": "",
"params": {"system_tool_type": "end_call"},
}
}
},
),
),
)
기본 통화 종료 프롬프트를 사용하려면 설명을 비워 두세요.

프롬프트 예시

예시 1: 기본 통화 종료

End the call when the user says goodbye, thank you, or indicates they have no more questions.

예시 2: 맞춤 프롬프트를 사용한 통화 종료

End the call when the user says goodbye, thank you, or indicates they have no more questions. You can only end the call after all their questions have been answered. Please end the call only after confirming that the user doesn't need any additional assistance.