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:
- Agentkonfiguration: Konfigurera agenten för läget med enbart text när du skapar den via API:t
- Å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.
Uppdatera via instrumentpanelen
Uppdatera via CLI
Uppdatera via API
Ö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:
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
-
Agent Response Event: Konfigurera alltid återanropet eller händelsehanteraren
agent_responseför att ta emot och visa agentens textmeddelanden. -
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.
-
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
Skicka textmeddelanden
I chattläget behöver du skicka användarmeddelanden programmatiskt i stället för via ljud:
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
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:
- Kontrollera att återanropet
agent_responseär korrekt konfigurerat - Kontrollera att agenten är konfigurerad för chattläget eller att åsidosättningen
textOnlyär inställd - Säkerställ att WebSocket-anslutningen har upprättats
Nästa steg
- Läs om hur du anpassar agentbeteende
- Utforska klienthändelser för avancerade interaktioner
- Se konfiguration av autentisering för säkra konversationer