Referentie voor instellingen van spraakagenten

Elke instelling van ThunderPhone-spraakagenten uitgelegd: pakketten, stemmen, talen, bevestigingen, tools, spreekvolgorde, voicemail, toestemmingsmeldingen, stilteafhandeling, testen en implementatie.

Open Spraakagenten, selecteer een agent en gebruik het tabblad Configuratie om te bepalen hoe deze klinkt, redeneert, oproepen start, tools gebruikt, stilte en voicemail afhandelt, en bellers bereikt. Wijzigingen worden automatisch opgeslagen als concept; productiegegevens veranderen pas wanneer je Uitrollen selecteert.

Deze pagina is de volledige dashboardreferentie. Gebruik voor veldnamen en aanvraagvoorbeelden de Agents API-referentie.

Prompt en identiteit#

De naam van de agent identificeert deze in het hele dashboard, rapporten, de oproepgeschiedenis en clientportalen. De prompt is het werkscript van de agent: persona, bedrijfsfeiten, vereiste vragen, escalatiebeleid en oproepacties.

De prompteditor toont geschatte tokens en markeert veelvoorkomende problemen, zoals een lege prompt, niet-opgeloste sjabloonplaceholders, een ontbrekend escalatiepad of een zeer lange prompt. De eerste 5.000 geschatte tokens zijn inbegrepen; langere prompts gebruiken toeslagprijzen op basis van blokken.

Zie voor routeringsregels, koude transfers en warme transfers met voorselectie Oproepen doorverbinden.

Modelpakket#

Storm biedt twee optionele instellingen:

• Bevestiging — Geen blijft stil terwijl het volledige antwoord wordt voorbereid; Tik speelt een zacht wachtgeluid af; Verbaal spreekt een korte bevestiging uit en voegt 2¢/min toe. Verbale tekst kan vanuit de hoofdprompt worden gegenereerd of handmatig worden ingevoerd. Aangepaste bevestigingsprompt verschijnt alleen wanneer de geselecteerde Storm-modus verbale bevestigingen ondersteunt; anders is dat veld niet beschikbaar.
• Extra intelligentie — voegt dieper redeneren toe voor complexe oproepen en 3¢/min.

De builder toont voortdurend de totale kosten per minuut van de agent, inclusief het pakket, het stem-/taalpad, de promptlengte, verbale bevestiging, extra intelligentie en toezicht.

Stem, achtergrond en talen#

Selecteer een stem en speel het voorbeeld af voordat je implementeert. De kiezer vereist alleen dat je gekozen stem de primaire taal ondersteunt. Als je Overschakelen naar native stemmen inschakelt, kunnen aanvullende talen in plaats daarvan worden ondersteund door native catalogusstemmen van hetzelfde geslacht. Premiumcombinaties zijn gemarkeerd met hun toeslag. Je aangepaste stemmen verschijnen in dezelfde kiezer zodra ze klaar zijn. Zie Stembibliotheek en aangepaste stemmen.

Achtergrondtrack kan zijn:

• Geen — geen omgevingsaudio.
• Callcenter — een callcenterambiance, met een voorbeeld in het dashboard.

Stel één primaire taal in en vervolgens een willekeurig aantal extra talen. De agent detecteert automatisch wanneer een beller naar een geselecteerde taal overschakelt en reageert in die taal. Sommige stem-/taalcombinaties voegen 3¢/min toe; zie de gegenereerde catalogus met Ondersteunde talen.

Wanneer een agent Extra talen heeft, schakel je Overschakelen naar moedertaalstemmen in om een catalogusstem te gebruiken die moedertaalspreker is van de gedetecteerde taal, afgestemd op geslacht. De agent schakelt terug naar de geconfigureerde stem voor de primaire taal. Als er geen passende moedertaalstem beschikbaar is, blijft de huidige stem in gebruik. Aangepaste stemmen schakelen niet. Test elke taal met Praten en selecteer vervolgens Uitrollen.

Moedertaalschakeling heeft geen afzonderlijke toeslag. De geselecteerde taal- en stemcombinatie bepaalt nog steeds of het premiumtaaltarief van toepassing is.

Gekoppelde functies#

Het tabblad Config heeft vier onafhankelijk koppelbare functieonderdelen:

Een koppeling maakt deel uit van het concept en wordt beschikbaar voor productieoproepen na implementatie. Configureer de resources eerst onder Koppelingen of Kennis en koppel ze vervolgens aan de agent.

Telefoon- en web-eindpunten#

Onder Telefoonnummers koppel je een bestaand nummer, vraag je een ThunderPhone-nummer aan of importeer je een nummer via een VoIP-koppeling. Een nummer kan verschillende agenten gebruiken voor inkomende en uitgaande oproepen.

Onder Webwidgets koppel je een widget zodat bezoekers vanaf een site met de agent kunnen spreken. De beschikbaarheid van widgets kan ook worden in- of uitgeschakeld als onderdeel van de agentconfiguratie.

Tijdzone#

Tijdzone, onder de telefoonnummers, is wat de agent als "nu" beschouwt: de agent noemt de datum en tijd, biedt afspraakmomenten aan en berekent "vandaag" en "morgen" in deze zone. Ook de openingstijden van deze agent in rapporten gebruiken deze zone.

Een nieuwe agent begint met de tijdzone van je organisatie, of die van je computer als de organisatie er geen heeft. Wijzig deze als je bellers zich ergens anders bevinden. Wanneer het telefoonnummer van de agent zich in een andere zone bevindt dan de zone die je hebt gekozen, geeft de builder dit aan en biedt deze aan om te wisselen.

Een agent zonder tijdzone (een oudere agent of een agent die via de API is gemaakt zonder timezone) gebruikt de zone van het nummer waarop het gesprek plaatsvindt, vervolgens de zone van de nummers van de agent, daarna die van de organisatie en vervolgens US Pacific. De builder toont welke zone dat is en vraagt je deze te bevestigen, of er een te kiezen wanneer de nummers geen uitsluitsel geven (een gratis nummer of nummers in verschillende zones).

Wanneer één agent contacten in meerdere tijdzones bedient, geef de zone dan met elk gesprek door: timezone in POST /v1/call of in het antwoord van je configuratie-webhook.

Als je agent nog geen tijdzone heeft#

Nieuwe agenten vereisen een tijdzone. Oudere agenten kunnen er nog steeds geen hebben.

Als een oudere agent geen tijdzone heeft, gebruikt ThunderPhone eerst de eigen instelling van de agent, als die er is, vervolgens die van je organisatie en daarna de tijdzone die wordt afgeleid van de telefoonnummers van de agent. Als dat nog steeds geen uitsluitsel geeft, wordt teruggevallen op Los Angeles. De builder toont de vastgestelde tijdzone en vraagt je deze te bevestigen, of er een te kiezen wanneer de nummers geen uitsluitsel geven.

Geavanceerd oproepgedrag#

Vouw Geavanceerd onderaan Configuratie uit voor de volgende instellingen.

Toezicht#

Wanneer dit is ingeschakeld, controleert een tweede AI-monitor elke beurt van de agent aan de hand van de instructies en kan deze stilzwijgend ingrijpen. Toezicht voegt 4¢/min toe en is niet beschikbaar op Bolt.

Verbindingstoon#

Speel een korte toon af direct nadat de oproep is verbonden en voordat een van beide partijen spreekt.

Introclip#

Speel aan het begin van inkomende gesprekken een vooraf opgenomen clip af, gevolgd door beltonen, zodat de lijn klinkt als een zakelijke telefoonlijn voordat de agent opneemt. Deze wordt afgespeeld bij inkomende telefoongesprekken en bij Praten-testoproepen (browser) in de builder. Deze wordt niet afgespeeld bij uitgaande gesprekken, AI-testoproepen, oproepen via de webwidget of Realtime API-oproepen.

• Uit (standaard) — de agent neemt direct op.
• Opnamemelding — een opgenomen stem zegt: "Dit gesprek kan worden gemonitord of opgenomen voor kwaliteitsdoeleinden." Beluister deze in de builder.
• Je eigen opname — upload een audiobestand (MP3, WAV, M4A en andere indelingen die je browser kan afspelen) of neem er een op in de browser. Clips kunnen 0,5 tot 15 seconden lang zijn. De builder converteert de clip voordat deze wordt geüpload, en je kunt deze afspelen of verwijderen.

Overgaan na intro bepaalt hoeveel Amerikaanse beltonen na de clip worden afgespeeld: Uit, 1 beltoon (standaard) of 2 beltonen.

De volgorde aan het begin van een gesprek is: verbindingstoon (indien ingeschakeld), introclip, beltonen, vervolgens de toestemmingsmelding of melding over AI-verwerking als deze van toepassing zijn, en daarna de begroeting. De introclip vervangt nooit de toestemmingsmelding of de melding over AI-verwerking, ook niet wanneer je clip vermeldt dat het gesprek wordt opgenomen. Audio van de beller wordt niet verwerkt terwijl de clip en beltonen worden afgespeeld. Een aangepaste clip wordt opgehaald wanneer het gesprek begint; als deze niet binnen enkele seconden kan worden geladen, gaat het gesprek zonder de clip door. Een mislukte laadpoging kan de begroeting dus met maximaal ongeveer 3 seconden vertragen.

De introclip is net als de andere een conceptinstelling: deze wordt toegepast op live gesprekken wanneer je implementeert.

Toolgeluid#

Kies het geluid dat wordt gemaakt door de vanuit de prompt aanroepbare geluidstool:

• Geen — de tool wordt niet aangeboden.
• Klank, Ding of Pieptoon — elk geluid kan worden beluisterd in de builder.

Typgeluiden#

Schakel Typgeluiden in om een zacht toetsenbordgeluid af te spelen terwijl de agent een aangepaste tool uitvoert. Door het platform beheerde tools activeren dit niet.

Zodra deze functie is ingeschakeld, kies je het geluid. Je kunt elk geluid vooraf beluisteren in de builder:

• Toetsenbord en muis (standaard): typen met muisklikken, alsof iemand iets opzoekt.
• Mechanisch toetsenbord: heldere, klikkende mechanische toetsen.
• Desktoptoetsenbord: gelijkmatig typen op een standaardtoetsenbord.
• Laptop: zachte, vlakke laptoptoetsen.
• Kantoortoetsenbord: stil, gedempt kantoortoetsenbord.
• Stille ruimte: zachte ruimte-ambiance met één persoon die typt.

Regel bij starten van tool#

Kies of er iets wordt gezegd wanneer de agent een tool aanroept:

• Altijd (standaard voor nieuwe agents): er wordt bij elke toolaanroep iets gezegd, ongeacht hoe snel de tool een resultaat terugstuurt. Als de agent tijdens de aanroep sprak, vormen diens eigen woorden die regel. Anders wordt een korte, voor de aanroep geschreven regel afgespeeld zodra die klaar is, of een standaardregel zoals "Een ogenblik geduld" als het langer duurt dan ongeveer een seconde. Tools die zelf audio afspelen of op de oproep zelf reageren (toetsenbordinvoer, geluiden, in de wacht zetten, doorverbinden, het beëindigen van de oproep, overdrachten tussen stappen) krijgen nog steeds alleen een regel als ze traag zijn, net als elke tool terwijl de agent zich in een telefoonmenu bevindt of voicemail inspreekt.
• Alleen als de tool traag is: er wordt alleen een korte regel afgespeeld als de tool nog actief is ongeveer 3 seconden nadat de agent voor het laatst sprak. Agents die vóór het bestaan van deze instelling zijn gemaakt, behouden deze keuze.
• Nooit: ThunderPhone zegt niets wanneer een tool start en de agent krijgt de instructie niet te spreken wanneer die een tool aanroept. Alles wat de agent toch tijdens de aanroep zegt, wordt afgespeeld.

De eigen woorden van de agent worden altijd afgespeeld, ongeacht welke optie je kiest. De beller hoort maximaal één regel bij het starten van een tool per beurt: een regel die al in die beurt is uitgesproken, zoals de woorden van de agent of een opvulzin bij een trage reactie, telt daarvoor mee.

Updates bij lang wachten#

Staat standaard aan. Wanneer een tool na ongeveer 12 seconden stilte nog actief is, zegt de agent dat deze er nog mee bezig is en voegt daarna ongeveer elke 15 seconden een korte geduldsregel toe totdat het resultaat arriveert. Deze regels zijn geschreven voor het gesprek: ze volgen de prompt en persona van de agent, het gesprek tot dusver en de gesprekstaal, zodat ze niet steeds dezelfde vaste zin herhalen. Als een regel niet op tijd kan worden geschreven, gebruikt de agent een standaardregel zoals "Sorry, dit duurt iets langer dan verwacht". Trage reacties zonder tool krijgen korte standaardregels zoals "Een momentje".

Schakel Updates bij lang wachten uit om na de regel bij het starten van de tool stil te blijven totdat het resultaat arriveert. Trage antwoorden zonder tool krijgen dan ook geen opvulling. Typegeluiden worden nog steeds afgespeeld als ze zijn ingeschakeld. De bevestigingsinstelling van Storm staat hier los van en wordt niet beïnvloed.

Instellingen hebben voorrang op de prompt#

Regel bij starten van tool en Updates bij lang wachten bepalen wat ThunderPhone zegt terwijl een tool actief is. Prompttekst kan deze regels niet stoppen of toevoegen. Voor een agent die stil blijft terwijl tools actief zijn, stel je Regel bij starten van tool in op Nooit en schakel je Updates bij lang wachten uit, in plaats van in de prompt om stilte te vragen. De promptcontrole van de bouwer waarschuwt wanneer de prompt om stilte vraagt, of om een regel bij elke toolaanroep, terwijl deze instellingen iets anders aangeven.

E-mail verzenden#

Schakel E-mail verzenden in en voer één adres van een ontvanger in om de agent de tool send_email te geven. Het adres staat vast in de agentinstellingen. Het model schrijft het onderwerp en de tekst zonder opmaak, maar kan de ontvanger niet kiezen of wijzigen. Geef de agent exacte instructies voor de situaties waarin een e-mail moet worden verstuurd, zoals het verzenden van het bericht van een beller nadat je diens naam en terugbelnummer hebt verzameld.

Zie Ingebouwde tools voor het volledige gedrag van de tool.

SMS verzenden#

Schakel SMS verzenden in om de agent een send_sms-tool te geven.

Kies vanaf welk verbonden VoIP-nummer (Twilio of Telnyx, geschikt voor sms en geverifieerd) je wilt verzenden; door ThunderPhone ingerichte nummers kunnen geen sms versturen. Je kunt het verzenden beperken tot alleen de beller, of andere ontvangers toestaan en een toelatingslijst met goedgekeurde nummers bijhouden. Je kunt ook een sms-opvolgsjabloon inschakelen voor berichten die na de oproep worden verzonden.

Zie Ingebouwde tools voor het volledige gedrag van de tool.

Extra audiocontext#

Extra audiocontext bepaalt hoeveel recente audio van de beller tussen beurten wordt meegenomen:

• Automatisch (aanbevolen) gebruikt meer recente audio voor inkomende, browser- en WebSocket-oproepen, en alleen de meest recente beurt voor uitgaande telefoongesprekken.
• Aan bevat de laatste paar beurten van de beller om te helpen bij correcties, spelling en het verzamelen van gegevens met veel nummers.
• Uit bevat alleen de meest recente beurt van de beller voor een lagere latentie.

De Agents API biedt ook het alleen voor Storm beschikbare compatibiliteitsveld audio_context_mode: full of reduced. Dit staat los van de bovenstaande driewaardige dashboardinstelling additional_audio_context.

Wie spreekt eerst#

Configureer inkomende en uitgaande oproepen afzonderlijk:

• Inkomend: de agent spreekt eerst, of de beller spreekt eerst.
• Uitgaand: de agent spreekt eerst, of de gebelde spreekt eerst.

Kies Beller spreekt eerst voor inkomende oproepen of Gebelde spreekt eerst voor uitgaande oproepen om de eerste begroeting van de agent te verwijderen.

Deze instelling is handig voor uitgaande belsystemen die moeten wachten op een persoon of telefoonmenu voordat het script begint.

Voicemailafhandeling#

Kies wat er gebeurt wanneer een uitgaande oproep voicemail bereikt:

Voicemailberichten kunnen maximaal 2.000 tekens bevatten en ondersteunen {agent_name} en {org_name}. Zie Prijzen voor informatie over hoe oproeptijd wordt gemeten.

Toestemmingsmelding#

Standaard meldt een korte aankondiging aan het begin van elke oproep aan de beller dat deze met een AI-assistent spreekt en dat de oproep wordt opgenomen. Je kunt de aankondigingstekst aanpassen tot maximaal 2.000 tekens; deze wordt woordelijk afgespeeld in de taal van de agent.

Als je de aankondiging uitschakelt voor een in aanmerking komende agent, moet een organisatiebeheerder bevestigen dat de organisatie elke wettelijk vereiste kennisgeving verstrekt en elke wettelijk vereiste toestemming verkrijgt. Als je deze opnieuw inschakelt en later weer uitschakelt, is een nieuwe bevestiging vereist. Bekijk de gids over wetgeving voor toestemming voor opname voordat je deze instelling wijzigt.

Oproepen opnemen#

Oproepen opnemen bepaalt of deze agent oproepaudio, transcripties en andere oproepinhoud opslaat. De organisatiebrede opname-instelling moet ook zijn ingeschakeld om opnames te maken. Wanneer opname is uitgeschakeld, worden deze gegevens niet opgeslagen. Een opname omvat maximaal de eerste 3 uur van een oproep; een langere oproep gaat door, maar de audio na 3 uur wordt niet opgenomen. Zie Toestemmingswetten voor oproepopnames.

Kennisgeving AI-verwerking#

Wanneer opname is uitgeschakeld, bepaalt Kennisgeving AI-verwerking de kortere melding dat audio live wordt verwerkt maar niet wordt opgenomen. Kies Organisatie-instelling gebruiken, Altijd afspelen of Niet afspelen. Het uitschakelen van de melding vereist een bevestiging van een organisatiebeheerder.

Niet-onderbreekbare meldingen#

Niet-onderbreekbare meldingen blijft zichtbaar voor compatibiliteit, maar inschakelen heeft geen effect. Laat deze instelling uitgeschakeld. Gebruik voor verplichte openingszinnen Toestemmingsmelding, die vóór het gesprek wordt afgespeeld en niet kan worden onderbroken.

Stiltecontroles#

Wanneer dit is ingeschakeld, controleert de agent na een periode van stilte of de beller nog aanwezig is, herhaalt dit tot aan je limiet en hangt vervolgens op:

• Seconden vóór controle: 10–120 seconden.
• Maximumaantal controles: 1–10.

De standaardwaarden zijn 15 seconden en 3 controles.

Oproepduur en time-outs#

Gebruik deze instellingen om te voorkomen dat vastgelopen of ongewoon lange oproepen oproeptijd en telefoniekosten blijven ophopen:

• Minuten stilte voordat wordt opgehangen: 1–60 minuten. De standaardwaarde is 10 minuten en geldt wanneer stiltecontroles zijn uitgeschakeld.
• Maximale oproepduur: 1–360 minuten. Nieuwe agents beginnen op 60 minuten, behalve agents die zijn gemaakt op basis van de Interpreter-sjabloon; die beginnen zonder limiet op agentniveau. Verhoog of verlaag deze limiet, of schakel deze uit om geen limiet op agentniveau te hebben. Agents die vóór deze standaardwaarde zijn gemaakt, behouden hun bestaande instelling. 45 seconden vóór de limiet (een kwart van de limiet wanneer deze minder dan 3 minuten is) krijgt de agent de instructie om af te ronden en afscheid te nemen.
• Platformlimiet: elke oproep eindigt na 6 uur, ongeacht de instelling van de agent. De agent krijgt eerst dezelfde waarschuwing om af te ronden.
• Rinkeltijd: laat uitgaande en doorverbonden oproepen 5–120 seconden overgaan. Laat deze instelling leeg voor de platformstandaarden: 60 seconden voor uitgaande oproepen, 45 seconden voor warme doorschakelingen en de standaardwaarde van de provider voor koude doorschakelingen. Deze instelling heeft geen invloed op inkomend overgaan.

Builder-tabbladen en levenscyclus#

Als een andere editor dezelfde agent opslaat nadat je deze hebt geladen, stopt ThunderPhone de conflicterende opslag of implementatie en wordt je gevraagd te vernieuwen, in plaats van hun wijzigingen te overschrijven.

Agenten beheren vanuit de lijst#

De pagina Spraakagenten ondersteunt ook levenscyclusacties op organisatieniveau:

• Dupliceer een agent als nieuw startpunt binnen dezelfde organisatie.
• Draag over een agent over naar een andere organisatie waartoe je behoort. Kopiëren behoudt de bron; Verplaatsen verwijdert deze uit de huidige organisatie en vereist beheerderstoegang.
• Verwijder één agent, of verwijder geselecteerde agenten in bulk, na bevestiging.

De agentlijst exporteren#

Selecteer één of meer agenten en exporteer hun samenvattingsvelden als CSV of JSON. De export bevat geen volledige prompts en is geen configuratieback-up.

Het kopiëren of verplaatsen van een agent tussen organisaties geeft de doelorganisatie niet stilzwijgend toegang tot verbindingen die alleen voor de bron beschikbaar zijn. Controleer de app-, API-, kennis-, MCP-, telefoonnummer- en widgetkoppelingen van de gekopieerde agent voordat je deze daar implementeert.

Gerelateerde pagina's#