Przewodniki

Tryb czatu

Skonfiguruj agenta do rozmów wyłącznie tekstowych w trybie czatu

Tryb czatu pozwala agentom działać jako agenci czatu, czyli prowadzić rozmowy wyłącznie tekstowe bez wejścia/wyjścia audio. Przydaje się do tworzenia interfejsów czatu, testowania agentów lub gdy audio nie jest potrzebne.

Omówienie

Są dwa główne sposoby włączenia trybu czatu:

  1. Konfiguracja agenta: Skonfiguruj agenta do trybu wyłącznie tekstowego podczas tworzenia go przez API
  2. Nadpisania w trakcie działania: Użyj nadpisań SDK, aby programowo wymusić rozmowy wyłącznie tekstowe

Ten przewodnik omawia oba podejścia i wdrażanie trybu czatu w różnych SDK.

Tworzenie agentów wyłącznie tekstowych

Skonfiguruj agenta do trybu wyłącznie tekstowego, aby był to domyślny tryb każdej rozmowy z tym agentem.

Otwórz agenta w panelu, przejdź do karty Advanced i włącz przełącznik Text only. Zapisz zmiany.

Pełną dokumentację API i wszystkie dostępne opcje konfiguracji znajdziesz w polu text only w dokumentacji API Create Agent .

Nadpisania w trakcie działania dla trybu wyłącznie tekstowego

Aby włączyć tryb czatu w trakcie działania za pomocą nadpisań (zamiast konfiguracji na poziomie agenta), możesz użyć nadpisania textOnly w konfiguracji rozmowy:

from elevenlabs.client import ElevenLabs
from elevenlabs.conversational_ai.conversation import Conversation, ConversationInitiationData
# Configure for text-only mode with proper structure
conversation_override = {
    "conversation": {
        "text_only": True
    }
}
config = ConversationInitiationData(
    conversation_config_override=conversation_override
)
conversation = Conversation(
    elevenlabs,
    agent_id,
    requires_auth=bool(api_key),
    config=config,
    # Important: Ensure agent_response callback is set
    callback_agent_response=lambda response: print(f"Agent: {response}"),
    callback_user_transcript=lambda transcript: print(f"User: {transcript}"),
)
conversation.start_session()

Ta konfiguracja zapewnia, że:

  • Nie jest używane wejście/wyjście audio
  • Cała komunikacja odbywa się przez wiadomości tekstowe
  • Rozmowa działa w trybie interfejsu podobnego do czatu

Ważne uwagi

Krytyczne: Podczas korzystania z trybu czatu musisz dopilnować, aby zdarzenie/callback agent_response było aktywne i poprawnie skonfigurowane. Bez tego tekstowe odpowiedzi agenta nie zostaną wysłane ani wyświetlone użytkownikowi.

Nadpisania zabezpieczeń: Gdy używasz nadpisań w trakcie działania (a nie konfiguracji na poziomie agenta), musisz włączyć nadpisania rozmowy w ustawieniach zabezpieczeń agenta. Przejdź do karty Security agenta i włącz odpowiednie nadpisania. Więcej informacji znajdziesz w dokumentacji nadpisań .

Kluczowe wymagania

  1. Zdarzenie odpowiedzi agenta: Zawsze konfiguruj callback lub procedurę obsługi zdarzenia agent_response, aby odbierać i wyświetlać wiadomości tekstowe agenta.

  2. Konfiguracja agenta: Jeśli agent jest ustawiony na tryb czatu w ustawieniach agenta, automatycznie użyje rozmów wyłącznie tekstowych bez nadpisania.

  3. Brak interfejsu audio: W trybie wyłącznie tekstowym nie musisz konfigurować interfejsów audio ani prosić o uprawnienia do mikrofonu.

Przykład: obsługa odpowiedzi agenta

def handle_agent_response(response):
    """Critical handler for displaying agent messages"""
    print(f"Agent: {response}")  # Update your UI with the response
    update_chat_ui(response)
config = ConversationInitiationData(
    conversation_config_override={"conversation": {"text_only": True}}
)
conversation = Conversation(
  elevenlabs,
  agent_id,
  config=config,
  callback_agent_response=handle_agent_response,
)
conversation.start_session()

Wysyłanie wiadomości tekstowych

W trybie czatu musisz wysyłać wiadomości użytkownika programowo zamiast przez audio:

# Send a text message to the agent
conversation.send_user_message("Hello, how can you help me today?")

Korzyści dla współbieżności

Tryb czatu zapewnia znaczną przewagę we współbieżności nad rozmowami głosowymi:

  • Wyższe limity: Rozmowy wyłącznie tekstowe mają limity współbieżności 25 razy wyższe niż rozmowy głosowe
  • Osobna pula: Rozmowy tekstowe korzystają z dedykowanej puli współbieżności, niezależnej od limitów rozmów głosowych
  • Skalowalność: Idealne do aplikacji o dużej przepustowości, takich jak obsługa klienta, chatboty czy automatyczne testy
PlanWspółbieżność głosowaWspółbieżność tylko czatu
Free4100
Starter6150
Creator10250
Pro20500
Scale30750
Business30750
EnterprisePodwyższonaPodwyższona (25x)

Podczas inicjowania połączenia rozmowy wyłącznie tekstowe są najpierw sprawdzane względem całkowitego limitu współbieżności w trakcie handshake, a po ustanowieniu połączenia są przenoszone do osobnej puli współbieżności tylko czatu.

Zastosowania

Tryb czatu jest idealny do:

  • Interfejsów czatu: Tworzenia tradycyjnych interfejsów czatu bez głosu
  • Testowania: Testowania logiki agenta bez zależności od audio
  • Dostępności: Zapewniania użytkownikom alternatyw tekstowych
  • Cichych środowisk: Gdy wejście/wyjście audio nie jest odpowiednie
  • Testów integracyjnych: Automatycznego testowania rozmów agentów

Rozwiązywanie problemów

Agent nie odpowiada

Jeśli odpowiedzi agenta się nie wyświetlają:

  1. Sprawdź, czy callback agent_response jest poprawnie skonfigurowany
  2. Sprawdź, czy agent jest skonfigurowany do trybu czatu lub ustawiono nadpisanie textOnly
  3. Upewnij się, że połączenie WebSocket zostało pomyślnie ustanowione

Następne kroki