Zakończ połączenie

Omówienie

Narzędzie End Call pozwala agentowi konwersacyjnemu zakończyć połączenie z użytkownikiem. To narzędzie systemowe, które daje elastyczność w określaniu sposobu i momentu kończenia połączeń.

Działanie

• Domyślne działanie: Narzędzie może działać bez promptów zdefiniowanych przez użytkownika i kończyć połączenie, gdy rozmowa naturalnie dobiegnie końca.
• Własne prompty: Możesz określić warunki, w których połączenie powinno się zakończyć. Na przykład:
  • Zakończ połączenie, gdy użytkownik powie „do widzenia”.
  • Zakończ połączenie po wykonaniu określonego zadania.

Cel: Automatyczne kończenie rozmów, gdy zostaną spełnione odpowiednie warunki.

Warunki wywołania: LLM powinien wywołać to narzędzie, gdy:

• Główne zadanie zostało ukończone, a użytkownik jest zadowolony
• Rozmowa naturalnie dobiegła końca za obopólną zgodą
• Użytkownik wyraźnie chce zakończyć rozmowę

Parametry:

• reason (string, wymagany): Powód zakończenia rozmowy
• message (string, opcjonalny): Wiadomość pożegnalna wysyłana użytkownikowi przed zakończeniem rozmowy

Format wywołania funkcji:

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

Implementacja: Skonfiguruj jako narzędzie systemowe w ustawieniach agenta. LLM otrzyma szczegółowe instrukcje, kiedy wywołać tę funkcję.

Implementacja API

Podczas tworzenia agenta przez API możesz dodać narzędzie End Call do jego konfiguracji. 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": {
                    "end_call": {
                        "type": "system",
                        "name": "end_call",
                        # Optional: customize when the tool should be triggered
                        "description": "",
                        "params": {"system_tool_type": "end_call"},
                    }
                }
            },
        ),
    ),
)

Przykładowe prompty

Przykład 1: Podstawowe zakończenie połączenia

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

Przykład 2: Zakończenie połączenia z własnym promptem

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.