Hoppa till navigering

Chattläge

Konfigurera din agent för konversationer med enbart text i chattläget

Med chattläget kan dina agenter fungera som chattagenter, dvs. ha konversationer med enbart text utan ljudinmatning/-utmatning. Det är användbart när du bygger chattgränssnitt, testar agenter eller när ljud inte behövs.

Översikt

Det finns två huvudsakliga sätt att aktivera chattläget:

  1. Agentkonfiguration: Konfigurera agenten för läget med enbart text när du skapar den via API:t
  2. Åsidosättningar vid körning: Använd SDK-åsidosättningar för att programmässigt framtvinga konversationer med enbart text

Den här guiden täcker båda metoderna och hur du implementerar chattläget i olika SDK:er.

Skapa agenter med enbart text

Konfigurera en agent för läget med enbart text så att det blir standard för varje konversation med den agenten.

Öppna agenten på instrumentpanelen, gå till fliken Advanced och aktivera Text only. Spara ändringarna.

Fullständig API-referens och alla tillgängliga konfigurationsalternativ finns i fältet text only i API-dokumentationen för Create Agent .

Åsidosättningar vid körning för läget med enbart text

För att aktivera chattläget vid körning med åsidosättningar (i stället för att konfigurera det på agentnivå) kan du använda åsidosättningen textOnly i konversationskonfigurationen:

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()

Den här konfigurationen säkerställer att:

  • Ingen ljudinmatning/-utmatning används
  • All kommunikation sker via textmeddelanden
  • Konversationen fungerar i ett chattliknande gränssnittsläge

Viktiga anmärkningar

Kritiskt: När du använder chattläget måste du se till att händelsen/återanropet agent_response är aktiverat och korrekt konfigurerat. Annars skickas eller visas inte agentens textsvar för användaren.

Säkerhetsåsidosättningar: När du använder åsidosättningar vid körning (inte konfiguration på agentnivå) måste du aktivera konversationsåsidosättningarna i agentens säkerhetsinställningar. Gå till agentens flik Security och aktivera lämpliga åsidosättningar. Mer information finns i dokumentationen om åsidosättningar.

Viktiga krav

  1. Agent Response Event: Konfigurera alltid återanropet eller händelsehanteraren agent_response för att ta emot och visa agentens textmeddelanden.

  2. Agentkonfiguration: Om agenten specifikt är inställd på chattläge i agentinställningarna används konversationer med enbart text automatiskt, utan att åsidosättningen krävs.

  3. Inget ljudgränssnitt: När du använder läget med enbart text behöver du inte konfigurera ljudgränssnitt eller begära mikrofonbehörighet.

Exempel: Hantera agentsvar

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()

Skicka textmeddelanden

I chattläget behöver du skicka användarmeddelanden programmatiskt i stället för via ljud:

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

Fördelar med samtidighet

Chattläget ger betydande fördelar för samtidighet jämfört med röstkonversationer:

  • Högre gränser: Konversationer med enbart chatt har 25 gånger högre samtidighetsgränser än röstkonversationer
  • Separat pool: Textkonversationer använder en dedikerad samtidighetspool, oberoende av gränserna för röstkonversationer
  • Skalbarhet: Perfekt för applikationer med hög genomströmning, som kundsupport, chattbottar eller automatiserad testning
PlanRöstsamtidighetSamtidighet för enbart chatt
Free4100
Starter6150
Creator10250
Pro20500
Scale30750
Business30750
EnterpriseFörhöjdFörhöjd (25x)

Använd samtidighetskalkylatorn för att uppskatta vilken gräns din trafik med enbart chatt behöver.

När anslutningen initieras kontrolleras konversationer med enbart chatt först mot din totala samtidighetsgräns under handskakningsprocessen och flyttas sedan till den separata samtidighetspoolen för enbart chatt när anslutningen har upprättats.

Användningsfall

Chattläget passar perfekt för:

  • Chattgränssnitt: Bygga traditionella chattgränssnitt utan röst
  • Testning: Testa agentlogik utan ljudberoenden
  • Tillgänglighet: Erbjuda textbaserade alternativ för användare
  • Tysta miljöer: När ljudinmatning/-utmatning inte är lämpligt
  • Integrationstestning: Automatiserad testning av agentkonversationer

Felsökning

Agenten svarar inte

Om agentens svar inte visas:

  1. Kontrollera att återanropet agent_response är korrekt konfigurerat
  2. Kontrollera att agenten är konfigurerad för chattläget eller att åsidosättningen textOnly är inställd
  3. Säkerställ att WebSocket-anslutningen har upprättats

Nästa steg