Referens för röstagentinställningar

Alla inställningar för ThunderPhone-röstagenten förklarade: nivåer, röster, språk, bekräftelser, verktyg, talordning, röstbrevlåda, samtyckesmeddelanden, hantering av tystnad, testning och driftsättning.

Öppna Röstagenter, välj en agent och använd fliken Konfiguration för att styra hur den låter, resonerar, startar samtal, använder verktyg, hanterar tystnad och röstbrevlåda och når uppringare. Ändringar sparas automatiskt som ett utkast; produktionstrafiken ändras inte förrän du väljer Distribuera.

Den här sidan är den kompletta referensen för kontrollpanelen. Använd Agents API-referens för fältnamn och begärandeexempel.

Prompt och identitet#

Agentens namn identifierar den i hela kontrollpanelen, rapporter, samtalshistorik och kundportaler. Prompten är agentens operativa manus: persona, företagsfakta, obligatoriska frågor, eskaleringspolicy och samtalsåtgärder.

Promptredigeraren visar uppskattat antal token och flaggar vanliga problem, som en tom prompt, olösta mallplatshållare, en saknad eskaleringsväg eller en mycket lång prompt. De första 5 000 uppskattade token ingår; längre prompter använder tilläggspriser baserade på block.

För routningsregler, kalla överföringar och screenade varma överföringar, se Överför samtal.

Modellnivå#

Storm har två valfria kontroller:

• Bekräftelse — Ingen förblir tyst medan hela svaret förbereds; Tick spelar ett diskret vänteljud; Verbal uttalar en kort bekräftelse och lägger till 2¢/min. Verbal text kan genereras från huvudprompten eller anges manuellt. Anpassad bekräftelseprompt visas endast när det valda Storm-läget stöder verbala bekräftelser; annars är fältet otillgängligt.
• Extra intelligens — lägger till djupare resonemang för komplexa samtal och 3¢/min.

Bolt har Ljudförståelse, som styr hur agenten uppfattar den som ringer. Varje Bolt-agent börjar med Standard; du kan nedgradera den till Lean eller uppgradera den till Hearing:

• Standard (standard) — tre transkriberingsmotorer. Samtal som behandlar PHI använder endast transkriberingsmotorer som omfattas av BAA.
• Lean — en transkriberingsmotor. Billigast; den feltolkar oftare.
• Hörsel — Standard, plus att en kraftfull ensemble av ljudmodeller under vissa samtalsomgångar lyssnar på ljudet från den som ringer för att fastställa exakt vad de sa. Bäst för språk och namn; dessa samtalsomgångar tar 1–2 sekunder längre. Medan ljudmodellerna lyssnar anger vad den som ringer hör under tiden: Talad bekräftelse, Tickande ljud eller Tystnad.

I API:t är dessa audio_tier (standard, standardvärdet, lean eller hearing) och acknowledgement_feedback_mode (acknowledgement, tick eller none för tystnad). Andra nivåer ignorerar audio_tier.

Byggaren visar kontinuerligt agentens totala kostnad per minut, inklusive nivå, röst-/språkväg, promptlängd, verbal bekräftelse, extra intelligens och övervakning.

Röst, bakgrund och språk#

Välj en röst och spela upp dess exempel innan du distribuerar. Väljaren kräver bara att den valda rösten har stöd för primärt språk. Om du aktiverar Byt till inhemska röster kan ytterligare språk i stället täckas av inhemska katalogröster med samma kön. Premiumkombinationer markeras med sitt tillägg. Dina anpassade röster visas i samma väljare när de är klara. Se Röstbibliotek och anpassade röster.

Bakgrundsspår kan vara:

• Ingen — inget bakgrundsljud.
• Call center — en callcenteratmosfär med förhandsvisning i kontrollpanelen.

Ange ett primärt språk och sedan valfritt antal ytterligare språk. Agenten identifierar automatiskt när en uppringare växlar till ett valt språk och svarar på det. Vissa röst-/språkkombinationer lägger till 3¢/min; se den genererade katalogen Språk som stöds.

När en agent har Ytterligare språk aktiverar du Växla till inhemska röster för att använda en katalogröst som är inhemsk för det identifierade språket, matchad efter kön. Den växlar tillbaka till den konfigurerade rösten för det primära språket. Om ingen matchande inhemsk röst är tillgänglig fortsätter den aktuella rösten att användas. Anpassade röster växlar inte. Testa varje språk med Prata och välj sedan Distribuera.

Inhemsk växling har ingen separat tilläggsavgift. Den valda språk- och röstkombinationen avgör fortfarande om premiumspråkstaxan gäller.

Anslutna funktioner#

Fliken Config har fyra funktioner som kan kopplas till oberoende av varandra:

En anslutning är en del av utkastet och blir tillgänglig för produktionssamtal efter driftsättning. Konfigurera först resurserna under Anslutningar eller Kunskap och koppla dem sedan till agenten.

Telefon- och webbslutpunkter#

Under Telefonnummer kan du koppla ett befintligt nummer, skaffa ett ThunderPhone-nummer eller importera ett nummer via en VoIP-anslutning. Ett nummer kan använda olika agenter för inkommande och utgående samtal.

Under Webbwidgetar kan du koppla en widget så att besökare kan prata med agenten från en webbplats. Widgetens tillgänglighet kan också aktiveras eller inaktiveras som en del av agentkonfigurationen.

Tidszon#

Tidszon, under telefonnumren, är vad agenten behandlar som "nu": den anger datum och tid, erbjuder mötestider och räknar ut "i dag" och "i morgon" i den här zonen. Agentens öppettider i rapporter använder också den.

En ny agent börjar med organisationens tidszon, eller din dators om organisationen saknar en. Ändra den om dina uppringare befinner sig någon annanstans. När agentens telefonnummer ligger i en annan zon än den du valde, meddelar byggaren detta och erbjuder att byta.

En agent utan tidszon (en äldre agent eller en som skapats via API:t utan timezone) använder zonen för numret som samtalet sker på, sedan zonen för agentens nummer, därefter organisationens och sedan USA:s Stillahavszon. Byggaren visar vilken zon det är och ber dig bekräfta den eller välja en när numren inte avgör det (ett avgiftsfritt nummer eller nummer i olika zoner).

När en agent betjänar kontakter i flera tidszoner ska du i stället skicka med zonen vid varje samtal: timezone i POST /v1/call eller i svaret från din konfigurationswebhook.

Om din agent ännu inte har någon tidszon#

Nya agenter kräver en tidszon. Äldre agenter kan fortfarande sakna en.

Om en äldre agent saknar tidszon använder ThunderPhone först agentens egen inställning om det finns en, sedan din organisations och därefter tidszonen som härleds från agentens telefonnummer. Om det fortfarande inte avgör saken används Los Angeles som reserv. Byggaren visar den fastställda zonen och ber dig att bekräfta den eller välja en när numren inte avgör saken.

Avancerat samtalsbeteende#

Expandera Avancerat längst ned i Konfiguration för följande kontroller.

Övervakning#

När funktionen är aktiverad kontrollerar en andra AI-övervakare varje agenttur mot instruktionerna och kan ingripa tyst. Övervakning tillkommer med 4¢/min och är inte tillgänglig på Bolt.

Anslutningston#

Spela upp en kort ton direkt efter att samtalet ansluts och innan någon av parterna talar.

Introduktionsklipp#

Spela upp ett förinspelat klipp i början av inkommande samtal, följt av ringsignaler, så att linjen låter som en företagslinje innan agenten svarar. Det spelas upp vid inkommande telefonsamtal och vid Prata-testanrop i webbläsaren i byggaren. Det spelas inte upp vid utgående samtal, AI-testanrop, samtal från webbwidgeten eller Realtime API-anrop.

• Av (standard) — agenten svarar direkt.
• Meddelande om inspelning — en inspelad röst säger ”Det här samtalet kan övervakas eller spelas in i kvalitetssäkringssyfte.” Förhandsgranska det i byggaren.
• Din egen inspelning — ladda upp en ljudfil (MP3, WAV, M4A och andra format som webbläsaren kan spela upp) eller spela in en i webbläsaren. Klipp kan vara 0,5 till 15 sekunder långa. Byggaren konverterar klippet innan det laddas upp, och du kan spela upp det eller ta bort det.

Ringsignaler efter intro anger hur många amerikanska ringsignaler som spelas efter klippet: Av, 1 ringsignal (standard) eller 2 ringsignaler.

Ordningen i början av ett samtal är: anslutningston (om den är aktiverad), introduktionsklipp, ringsignaler, sedan meddelandet om samtycke eller informationen om AI-behandling om de gäller, och därefter hälsningen. Introduktionsklippet ersätter aldrig meddelandet om samtycke eller informationen om AI-behandling, även när klippet säger att samtalet spelas in. Uppringarens ljud bearbetas inte medan klippet och ringsignalerna spelas upp. Ett anpassat klipp hämtas när samtalet startar; om det inte kan laddas inom några sekunder fortsätter samtalet utan det, så en misslyckad laddning kan fördröja hälsningen med upp till cirka 3 sekunder.

Introduktionsklippet är en utkastinställning som de andra: det används för livesamtal när du distribuerar.

Verktygsljud#

Välj ljudet som skapas av ljudverktyget som kan anropas från prompten:

• Ingen — verktyget erbjuds inte.
• Klang, Ding eller Pip — alla kan förhandsgranskas i byggaren.

Tangentbordsljud#

Aktivera Tangentbordsljud för att spela upp ett svagt tangentbordsljud medan agenten kör ett anpassat verktyg. Plattformshanterade verktyg utlöser det inte.

När den är aktiverad väljer du ljudet. Du kan förhandsgranska varje ljud i byggverktyget:

• Tangentbord och mus (standard): skrivljud med musklick, som när någon söker upp något.
• Mekaniskt tangentbord: ljusa, klickiga mekaniska tangenter.
• Skrivbordstangentbord: jämnt skrivljud på ett vanligt tangentbord.
• Bärbar dator: mjuka, platta tangenter på en bärbar dator.
• Kontorstangentbord: tyst, dämpat kontorstangentbord.
• Tyst rum: mjukt rumsljud med en person som skriver.

Rad vid verktygsstart#

Välj om något sägs när agenten anropar ett verktyg:

• Alltid (standard för nya agenter): något sägs vid varje verktygsanrop, oavsett hur snabbt verktyget svarar. Om agenten talade i samband med anropet är dess egna ord den raden. Annars spelas en kort rad som skrivits för anropet upp så snart den är klar, eller en standardrad som "Ett ögonblick, tack" om det tar mer än ungefär en sekund. Verktyg som spelar upp eget ljud eller agerar på själva samtalet (knappsatsinmatning, ljud, vänteläge, överföringar, avslutning av samtalet, överlämningar mellan steg) får fortfarande bara en rad om de är långsamma, liksom alla verktyg medan agenten är i en telefonmeny eller talar med röstbrevlådan.
• Endast om verktyget är långsamt: en kort rad spelas endast upp om verktyget fortfarande körs ungefär 3 sekunder efter att agenten senast talade. Agenter som skapades innan den här inställningen fanns behåller detta val.
• Aldrig: ThunderPhone säger ingenting när ett verktyg startar, och agenten instrueras att inte tala när den anropar ett verktyg. Allt som agenten ändå säger i samband med anropet spelas upp.

Agentens egna ord spelas alltid upp, oavsett vilket alternativ du väljer. Uppringaren hör högst en rad vid verktygsstart per tur: en rad som redan har sagts i den turen, till exempel agentens ord eller en utfyllnadsrad vid ett långsamt svar, räknas som den.

Uppdateringar vid lång väntan#

På som standard. När ett verktyg fortfarande körs efter ungefär 12 sekunders tystnad säger agenten att den fortfarande arbetar med det och lägger sedan till en kort rad som ber om tålamod ungefär var 15:e sekund tills resultatet kommer. Dessa rader formuleras för samtalet: de följer agentens prompt och persona, samtalet hittills och samtalets språk, så de upprepar inte en och samma fasta mening. Om en rad inte kan skrivas i tid använder agenten en standardrad som "Ursäkta, det här tar lite längre tid än förväntat". Långsamma svar utan ett verktyg får korta standardrader som "Ett ögonblick bara".

Stäng av Uppdateringar vid lång väntan för att vara tyst efter raden när verktyget startar tills resultatet kommer. Långsamma svar utan verktyg får då inte heller någon utfyllnad. Skrivljud spelas fortfarande upp om de är aktiverade. Storms inställning för bekräftelse är separat och påverkas inte.

Inställningar har företräde framför prompten#

Rad vid verktygsstart och Uppdateringar vid lång väntan avgör vad ThunderPhone säger medan ett verktyg körs. Prompttext kan inte stoppa eller lägga till dessa rader. För en agent som ska vara tyst medan verktyg körs ställer du in Rad vid verktygsstart på Aldrig och stänger av Uppdateringar vid lång väntan i stället för att be om tystnad i prompten. Byggarens promptkontroll varnar när prompten ber om tystnad eller om en rad vid varje verktygsanrop, medan dessa inställningar säger något annat.

Skicka e-post#

Aktivera Skicka e-post och ange en mottagaradress för att ge agenten verktyget send_email. Adressen är fast i agentinställningarna. Modellen skriver ämnesraden och brödtexten i klartext, men kan inte välja eller ändra mottagaren. Ange i prompten exakt vilka situationer som ska skapa ett e-postmeddelande, till exempel att skicka en uppringares meddelande efter att ha samlat in personens namn och återuppringningsnummer.

Se Inbyggda verktyg för fullständig information om verktygens beteende.

Calculator#

Aktivera Calculator för att ge agenten verktyget calculate. Agenten använder det för att exakt summera ordersummor, avgifter och växel i stället för att räkna själv. Det är avstängt som standard; aktivera det för agenter som uppger priser. Ingen ändring av prompten behövs.

Se Inbyggda verktyg för fullständig information om verktygens beteende.

Skicka SMS#

Aktivera Skicka SMS för att ge agenten verktyget send_sms.

Välj vilket anslutet VoIP-nummer (Twilio eller Telnyx, med SMS-stöd och verifierat) som ska användas för att skicka från. Nummer som tillhandahålls av ThunderPhone kan inte skicka SMS. Du kan begränsa utskick till endast uppringaren eller tillåta andra mottagare och behålla en tillåtelselista med godkända nummer. Du kan också aktivera en SMS-mall för uppföljning för meddelanden som skickas efter samtalet.

Se Inbyggda verktyg för fullständig information om verktygens beteende.

Extra ljudkontext#

Extra ljudkontext styr hur mycket nyligt ljud från uppringaren som följer med mellan turer:

• Automatiskt (rekommenderas) använder mer nyligt ljud för inkommande samtal, webbläsarsamtal och WebSocket-samtal, och endast den senaste turen för utgående telefonsamtal.
• På inkluderar de senaste turerna från uppringaren för att underlätta korrigeringar, stavning och datainsamling med många siffror.
• Av inkluderar endast den senaste turen från uppringaren för lägre latens.

Agents API exponerar också det Storm-exklusiva kompatibilitetsfältet audio_context_mode: full eller reduced. Det är separat från instrumentpanelens trelägesinställning additional_audio_context ovan.

Vem talar först#

Konfigurera inkommande och utgående samtal separat:

• Inkommande: agenten talar först eller uppringaren talar först.
• Utgående: agenten talar först eller den uppringda talar först.

För att ta bort agentens inledande hälsning väljer du Uppringaren talar först för inkommande samtal eller Den uppringda talar först för utgående samtal.

Den här inställningen är användbar för utgående uppringare som måste vänta på en person eller en telefonmeny innan skriptet påbörjas.

Hantering av röstbrevlåda#

Välj vad som händer när ett utgående samtal når en röstbrevlåda:

Meddelanden till röstbrevlådan kan innehålla upp till 2 000 tecken och har stöd för {agent_name} och {org_name}. Se Prissättning för information om hur samtalstid debiteras.

Meddelande om samtycke#

Som standard informerar ett kort meddelande i början av varje samtal uppringaren om att personen talar med en AI-assistent och att samtalet spelas in. Du kan redigera meddelandetexten, upp till 2 000 tecken; den spelas upp ordagrant på agentens språk.

För att inaktivera meddelandet för en behörig agent måste en organisationsadministratör intyga att organisationen kommer att ge alla lagstadgade meddelanden och inhämta allt lagstadgat samtycke. Om du återaktiverar och senare inaktiverar det krävs ett nytt intygande. Läs guiden om lagar för samtycke till inspelning innan du ändrar den här inställningen.

Spela in samtal#

Spela in samtal styr om den här agenten lagrar samtalsljud, transkriptioner och annat samtalsinnehåll. Organisationens övergripande inspelningsinställning måste också vara aktiverad för att inspelning ska ske. När inspelning är avstängd lagras inte dessa data. En inspelning omfattar högst de första 3 timmarna av ett samtal; ett längre samtal fortsätter, men ljudet efter 3 timmar spelas inte in. Se Lagar om samtycke till samtalsinspelning.

Information om AI-bearbetning#

När inspelning är avstängd styr Information om AI-bearbetning det kortare meddelandet om att ljud bearbetas live men inte spelas in. Välj Använd organisationsinställning, Spela alltid upp eller Spela inte upp. Att inaktivera meddelandet kräver ett intygande från en organisationsadministratör.

Oavbrytbara meddelanden#

Oavbrytbara meddelanden visas fortfarande för kompatibilitet, men att aktivera funktionen har ingen effekt. Låt den vara avstängd. Använd Meddelande om samtycke för obligatorisk inledande information, eftersom den spelas upp före samtalet och inte kan avbrytas.

Avstämningar vid tystnad#

När funktionen är aktiverad kontrollerar röstagenten om den som ringer fortfarande är kvar efter en period av tystnad, upprepar upp till din gräns och lägger sedan på eller kopplar samtalet vidare:

• Sekunder före kontroll: 10–120 sekunder.
• Kontroller före påläggning eller vidarekoppling: 1–10.
• Efter den sista kontrollen: Lägg på (standardinställningen) eller Koppla vidare till ett av röstagentens vidarekopplingsnummer. Vidarekopplingen hoppas över om den som ringer aldrig sa något under samtalet: röstagenten lägger i stället på, så att en död linje aldrig ringer upp en person. Om vidarekopplingen inte kan genomföras lägger röstagenten på.
• Vad röstagenten säger: repliken som sägs vid det tillfället, upp till 300 tecken, läses exakt som den är skriven. Lämna fältet tomt för standardtexten: "Ursäkta, men jag kommer att lägga på nu. Hej då." före påläggning, eller "Vänta medan jag kopplar dig vidare." före en vidarekoppling, på samtalets språk.

Standardinställningarna är 15 sekunder och 3 kontroller. Kontrollerna följer samtalet:

• Om ingen har sagt något sedan samtalet startade frågar röstagenten "Hallå? Är du kvar?" efter cirka 6 sekunder och väntar sedan ditt intervall mellan kontrollerna.
• Om den som ringer bad röstagenten att vänta ("ge mig en minut", "låt mig hämta mitt kort") ger röstagenten personen den tid som begärdes, minst en minut, och meddelar sedan bara att den fortfarande är kvar. Den lägger på efter cirka en minut utan svar efter sin senaste kontroll.
• Annars kontrollerar röstagenten om den som ringer fortfarande är kvar och upprepar sedan kort sin fråga.

Samtalslängd och tidsgränser#

Använd dessa kontroller för att förhindra att avstannade eller ovanligt långa samtal ackumulerar samtalstid och telekommunikationsavgifter:

• Minuter av tystnad före påläggning: 1–60 minuter. Standardvärdet är 10 minuter och gäller när tystnadskontroller är inaktiverade. Samtalet avslutas då utan att något sägs; inställningarna efter den senaste kontrollen gäller inte.
• Maximal samtalslängd: 1–360 minuter. Nya röstagenter startar på 60 minuter, förutom röstagenter som skapats från mallen Interpreter, vilka startar utan någon gräns på röstagentnivå; höj den, sänk den eller stäng av den för att inte ha någon gräns på röstagentnivå. Röstagenter som skapades före detta standardvärde behåller sin befintliga inställning. 45 sekunder före gränsen (en fjärdedel av gränsen när den är under 3 minuter) uppmanas röstagenten att avrunda och säga hejdå.
• Plattformsgräns: varje samtal avslutas efter 6 timmar, oavsett röstagentens inställning. Röstagenten får samma varning om att avrunda först.
• Ringtid: låt utgående och överförda samtal ringa i 5–120 sekunder. Lämna den osatt för plattformens standardvärden: 60 sekunder för utgående samtal, 45 sekunder för varma överföringar och operatörens standardvärde för kalla överföringar. Den här inställningen påverkar inte inkommande ringsignaler.

Builderflikar och livscykel#

Om en annan redigerare sparar samma agent efter att du har läst in den stoppar ThunderPhone den motstridiga sparningen eller driftsättningen och ber dig att uppdatera i stället för att skriva över deras ändringar.

Hantera agenter från listan#

Sidan Röstagenter har även livscykelåtgärder på organisationsnivå:

• Duplicera en agent som en ny utgångspunkt i samma organisation.
• Överför en agent till en annan organisation som du tillhör. Kopiera behåller källan; Flytta tar bort den från den aktuella organisationen och kräver administratörsbehörighet.
• Ta bort en agent eller massradera valda agenter efter bekräftelse.

Exportera agentlistan#

Välj en eller flera agenter och exportera deras sammanfattningsfält som CSV eller JSON. Exporten innehåller inte fullständiga promptar och är ingen säkerhetskopia av konfigurationen.

Att kopiera eller flytta en agent mellan organisationer ger inte tyst målorganisationen åtkomst till anslutningar som bara finns i källorganisationen. Granska den kopierade agentens kopplingar till appar, API:er, kunskap, MCP, telefonnummer och widgetar innan du driftsätter den där.

Relaterade sidor#