Juhendid

Häälagent

Agent on nii hea, kui hästi on kirjutatud tema süsteemiprompt. See leht õpetab, kuidas seda kirjutada, annab kolm valmis näidist kopeerimiseks ja selgitab piiranguid, millega tuleb arvestada.

1systemPrompt'i ülesehitus

Hea prompt koosneb neljast osast. Ilma ükskõik millise neist jääb agent varem või hiljem toppama ega tea, mida edasi teha - ta kas vaikib või mõtleb midagi välja.

• Kes ma olen - üks kuni kaks lauset: ettevõtte nimi, roll, hääle toon. Agent peab end sellest ära tundma juba esimesel repliigil.
• Mida ma oskan - konkreetsed ülesanded, millega agent tõesti hakkama saab (tellimus, kohtumise aeg, info) - mitte üldine „aitan ükskõik millega“.
• Mida ma KUNAGI ei tee - piirid: mida agent ei tohi välja mõelda, lubada ega avaldada. Seda osa jäetakse kõige sagedamini välja, kuigi just see eristab agenti, kes mõtleb välja hindu, agendist, kes ausalt ütleb „seda ma ei tea, helistage numbril...“.
• Kuidas kõne lõpetada - millal ja kuidas kõne lõpetada (kokkuvõte, hüvastijätt) ja mida teha, kui klient soovib midagi väljaspool ulatust.

Pikemad juhised aeglustavad vastust ligikaudu kümnendiksekundi võrra iga kahe tuhande tähemärgi kohta - agendi redaktor hoiatab sellest alates 3000 tähemärgist. Kõva ülempiir on 6000 tähemärki.

Kolm täielikku näidist - kopeerige ja kohandage enda jaoks:

Vastuvõtja tellimustega

Sa oled Vinohrady linnaosa kohviku Nula häälvastuvõtja. Räägid rahulikult,
soojalt ja lühidalt - nii nagu kogenud teenindaja, mitte nagu robot.

MIDA SA OSKAD
- Võtad vastu kaasavõtutellimusi (kohv, tee, kruassaanid, võileivad).
- Ütled praegused lahtiolekuajad: esmaspäevast reedeni 8.00-18.00,
  nädalavahetusel 9.00-15.00.
- Tellimuse lõpus kordad selle tervikuna üle ja kinnitad kättesaamise
  aja (varaseimalt 15 minuti pärast).

MIDA SA KUNAGI EI TEE
- Sa ei mõtle välja hindu ega tooteid, mida pakkumises pole - ütle, et
  täpse hinna kinnitab personal kohapeal.
- Sa ei luba kohaletoomist, kohvik ei vea toitu laiali.
- Sa ei teeskle inimest, kui klient küsib otse - ütle, et oled kohviku
  häälassistent.

KUIDAS KÕNE LÕPETADA
Võta tellimus ja kättesaamise aeg kokku, soovi head päeva ja lõpeta
kõne. Kui klient soovib midagi, mida sa lahendada ei oska (kaebus,
catering), palu tal helistada uuesti lahtiolekuajal ja rääkida otse
omanikuga.

Rahuloluküsitlus

Helistad veebipoe Botanika nimel, et teha lühike rahuloluküsitlus
hiljutise tellimuse kohta. Oled viisakas, lähed otse asja juurde ega
venita kõnet põhjuseta.

MIDA SA OSKAD
- Küsid, kas kliendil on minut aega kolme lühikese küsimuse jaoks.
- Küsimus 1: kui rahul ta tellimusega on, skaalal 1-5.
- Küsimus 2: kas pakk jõudis kohale õigel ajal?
- Küsimus 3: kas on midagi, mida võiksime parandada?
- Jätad vastused meelde ja võtad need kõne lõpus lühidalt kokku.

MIDA SA KUNAGI EI TEE
- Sa ei suru kliendile peale, kui ta keeldub või ütleb, et tal pole
  aega - jätad kohe viisakalt hüvasti.
- Sa ei lahenda kaebusi ega kaupade tagastamist - need kuuluvad
  klienditoe liinile, mille numbri soovi korral ette ütled.
- Sa ei paku allahindlusi ega kuponge, selleks sul volitust pole.

KUIDAS KÕNE LÕPETADA
Täname aja ja tagasiside eest ning soovi head päeva. Kui klient ütleb
mis tahes hetkel, et ta ei soovi jätkata, lõpeta kõne viisakalt kohe,
ilma uute küsimusteta.

Portjee / kantselei

Sa oled ettevõtte Nordwex häälportjee Pankráci kontorihoones.
Sellele numbrile helistavad kullerid, külalised ja tarnijad.

MIDA SA OSKAD
- Selgitad välja, kes helistab ja mis eesmärgil (kuller pakiga, külaline
  kohtumisele, tarnija).
- Külalise puhul küsid nime ja seda, kellega tal on kohtumine, ning
  palud tal end registreerida esimese korruse vastuvõtus ja oodata,
  kuni keegi talle järele tuleb.
- Kulleri puhul palud pakk jätta vastuvõttu ja kirjutada sellele
  ettevõtte nimi ja saaja.
- Võtad vastu lühikese sõnumi, kui soovitud isik pole praegu kättesaadav.

MIDA SA KUNAGI EI TEE
- Sa ei avalda töötajate eranumbreid - pakud ühendamist vastuvõtuga
  või sõnumi jätmist.
- Sa ei lase kedagi „üles üksi“ - kõik külalised lähevad läbi
  vastuvõtu.
- Sa ei anna infot selle kohta, kes hoones viibib ja millal - ütle, et
  seda tuleb kontrollida vastuvõtust.

KUIDAS KÕNE LÕPETADA
Korda üle, milles kokku lepiti (sõnum, ootamine vastuvõtus,
ümbersuunamine), soovi head päeva ja lõpeta kõne.

2Mallid valdkondade kaupa

Ei taha prompti nullist kirjutada? Veebis on valmis mallid kuue valdkonna jaoks (hambaravi, autoteenindus, restoran, e-pood, kinnisvarabüroo, käsitöölised) - valmis süsteemiprompt, näidisdialoog ja arvutus, kui palju selline vastuvõtja maksaks. Kopeerige ja kohandage enda jaoks, nagu eespool toodud näidiseid.

Mallide ülevaade valdkondade kaupa

3firstMessage

firstMessage on esimene lause, mille klient kuuleb - sissetuleva kõne puhul kohe pärast vastamist, väljamineva puhul kohe pärast seda, kui kutsutav telefoni vastu võtab.

• Lühike, rääkimiskeelne tekst - nii nagu inimene seda ütleks, mitte nagu ta e-kirjas kirjutaks.
• Ütle kohe, kes või mis helistab või vastab - klient peab kolme sekundi jooksul teadma, kellega ta räägib.
• Lõpeta avatud küsimusega („kuidas ma saan teid aidata“, „kas teil on hetk aega“) - mitte pika monoloogiga.
• Loe tekst valjusti ette - mis näeb kirjutatuna hea välja, võib öeldes kohmakas kõlada.
• Väljaminevate kõnede puhul tutvusta end kohe alguses koos helistamise põhjusega - tundmatutele numbritele ei vasta inimesed meelsasti.

4Tööriistad

Tööriist on teie API aadress, mida agent kõne keskel kutsub ja mille vastust ta kohe kõnes kasutab. Ilma tööriistata oskab agent ainult rääkida; tööriistaga oskab ta kontrollida tellimust, leida vaba aja või kirjutada üles broneeringu.

Tööriistad luuakse portaalis aadressil /agent/nastroje (või kaudu POST /v1/tools) ja seejärel lülitatakse agendile sisse märkeruuduga tema detailvaates (API-s väli toolIds). Tööriist kuulub kontole, mitte agendile - sama tööriista saavad seega kasutada mitu agenti. Sisestate selle juures neli asja:

• Nimi - loetav („Kontrolli tellimust“). Mudeli jaoks tuletatakse sellest nimi ise (overit_objednavku) ja see kuvatakse välja all.
• Millal agent peab seda kasutama - ainus, mille põhjal mudel otsustab tööriista üldse kutsuda. Kirjutage see korraldusena: „Kasuta, kui helistaja küsib, kus tema tellimus on.“
• Aadress ja meetod - ainult https, avalikult kättesaadav. GET saadab parameetrid päringus, POST JSON-i kehas. Lisaks päised, tavaliselt Authorization.
• Parameetrid - iga parameetri juures määrate, kust väärtus tuleb: mudel võtab selle kõnest, lisatakse helistaja number või kutsutav number või on see kindel väärtus.

Selline näeb välja päring, mis jõuab kõne ajal teie lõpp-punkti:

POST https://api.yourapp.com/orders
Content-Type: application/json
Authorization: Bearer your_key

{
  "order_number": "A-42",
  "phone": "+420777123456"
}

Ja selline vastus, millega agent oskab töötada - lühike JSON, millest saab öelda ühe lause:

{
  "status": "shipped",
  "delivery": "tomorrow morning"
}

5Ümbersuunamine inimesele

Agent oskab kõne anda üle teie numbrile, kui helistaja palub inimest või jookseb kokku asjaga, mida agent lahendada ei oska. Lülitatakse sisse agendi detailvaates (API-s väli transferTo), tingimuse kirjutate mudelile korraldusena väljale transferCondition. Ilma selleta kasutame vaikelauset.

volai oma häälmootoril

volai oma häälmootoril toimub ümbersuunamine sillaga: agent ütleb, et ühendab teid, helistaja kuuleb kutsungit ja inimene teie numbril näeb agendi numbrit. Pärast vastamist agent vaikib ja kõne jätkub teie kahe vahel volai kaudu. Kui keegi teist lõpetab kõne, lõpeb see mõlemale. Kui te 25 sekundi jooksul ei vasta, vabandab agent helistaja ees, pakub sõnumi jätmist ja jätkab.

Oma volai numbrile ümber suunata ei saa - kõne tuleks iseendale tagasi, kuni krediit otsa saab. Lisatasuga liinid (90x) on samal põhjusel keelatud.

Agent, kes kasutab number kõnede ja SMS-ide jaoks, suunab ümber ainult Tšehhi numbritele (+420): sellelt numbrilt lähevad kõned ainult Tšehhi numbritele, seega ei salvestata sellise agendi ümbersuunamisnumbrit väljaspool +420 ja API tagastab destination_not_allowed.

6Mida kõnest üles märkida

Terve ärakirja lugemise asemel võite öelda, mida täpselt kõnest soovite - nimi, kogus, kas asi on kiire. Agent täidab selle pärast kõnet ja saate selle JSON-ina.

Igal väljal on võti, tüüp ja kirjeldus. Kuni kümme välja agendi kohta:

• Võti (key) - väiketähed ilma diakriitikuta, numbrid ja alakriips, kuni 40 märki - peab algama väiketähega. Selle nime all leiate väärtuse tulemusest.
• Tüüp (type) - string, number või boolean.
• Kirjeldus (description) - mida täpselt peab mudel välja võtma, 5 kuni 500 märki. Kirjutage ka, mida teha, kui seda kõnes ei kõlanud.
• Valikud (enumValues) - valikuline loend, ainult tekstiväljal. Mudel valib siis ainult pakutud väärtuste seast, mistõttu saab tulemust kohe filtreerida. Kuni 20 valikut, igaüks kuni 60 märki.

curl -X PATCH https://volai.eu/v1/agents/ag_kx91fa2b \
  -H "Authorization: Bearer vk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "dataFields": [
      {"key": "name", "type": "string", "description": "Helistaja nimi, nii nagu ta ise ütles. Kui ei kõlanud, jäta tühjaks."},
      {"key": "coffee_count", "type": "number", "description": "Mitu kohvi helistaja tellis."},
      {"key": "urgency", "type": "string", "description": "Kui kiireloomuline asi oli.", "enumValues": ["low", "normal", "high"]}
    ]
  }'

Tulemus ilmub kolmes kohas: kõne detailvaates portaalis kaardina „Üles märgitud andmed“, kõne väljal data (GET /v1/calls ja GET /v1/calls/{id}) ning veebikonksu call.completed kehas.

{
  "call": {
    "id": "c_8f2ac1d4",
    "status": "completed",
    "hasRecording": true,
    "data": {
      "name": "Mari Tamm",
      "coffee_count": 2,
      "urgency": "normal"
    }
  }
}

Väärtus null tähendab „kõnes seda ei kõlanud“ - samamoodi, kui mudel vastab tühja tekstiga. Kui agendil pole ühtegi välja, ei ole vastuses võtit data üldse.

7Agendi eesmärk ja hindamine

Eesmärk on üks lause selle kohta, mida kõne peab saavutama - „leppida kokku vaatamise aeg“, „selgitada välja, kas klient on pakkumisest huvitatud“. Täidate selle portaalis väljale „Agendi eesmärk“ (agendi loomisel ja hiljem tema redaktoris igal ajal) või REST API ja MCP kaudu väljaga goal käskudes POST/PATCH /v1/agents ning create_agent/update_agent (kuni 300 märki).

Eesmärk läheb agendile kõne hindamise kriteeriumina: pärast kõne lõppu loeb mudel selle põhjal ärakirja ja otsustab, kas eesmärk sai täidetud, jäi täitmata või ei saa kõnest aru. Tulemuse näete kõne juures portaalis - nii detailvaates kui ka kõnede loendis - ning ka kõnejärgses e-kirjas kokkuvõtte kõrval.

Mida agent teab (taustamaterjalid)

Lisaks juhistele võite agendile anda taustamaterjale - lahtiolekuajad, hinnakiri, korduma kippuvad küsimused. Täidate need portaalis väljale „Mida agent teab“ (jaotis Täpsemalt), API kaudu väljaga knowledge käskudes POST/PATCH /v1/agents. Tekst lisatakse prompti lõppu, mahub 20000 märgi sisse ja PATCH tühja väärtusega kustutab selle. Erinevalt tööriistast taustamaterjalid kõne ajal ei muutu - see, mis muutub (tellimuse olek, vabad ajad), kuulub tööriista, mitte siia.

8E-kiri pärast kõnet

Pärast kõne lõppu agendiga saadab volai teile e-kirja kokkuvõtte ja viitega kõne detailvaatele portaalis - sama kokkuvõte, mida näete ka API-s väljal summary. Tuleb agentidelt, kes töötavad volai oma häälmootoril (väli provider: "engine"); ElevenLabsi agent (provider: "elevenlabs") seda veel ei saa.

Lüliti „E-kiri pärast iga kõnet“ leiate lehelt Seaded - selle väljalülitamine peatab e-kirjad kogu kontol korraga. Üksiku agendi puhul lülitate selle eraldi välja märkeruuduga „Saada mulle e-kiri pärast iga kõnet“ tema detailvaates (API-s väli notifyEmail: false). Ühe kõne kohta tuleb kõige rohkem üks e-kiri ning kõne, millest pole midagi teatada (pole kokkuvõtet, üles märgitud andmeid ega lõpetamise põhjust), e-kirja ei käivita.

9Salvestised

Agendi kõned salvestatakse ja portaalis saate neid kuulata otse kõne detailvaates - ärakirjas klõpsates liigute salvestisel õigesse kohta. Alla laadida või mujal esitada saab seda käsuga GET /v1/calls/{id}/recording (sama API võti) - formaadi määrab vastuse päis content-type: ElevenLabsi agendil audio/mpeg (MP3), volai mootoril olevatel agentidel praegu audio/ogg. Kas kõnel on salvestis, ütleb väli hasRecording.

• Hoiame neid 90 päeva kõnest alates, seejärel need kustutatakse. Ärakirja ja kokkuvõtet hoiame edasi, neid salvestisega koos ei kustutata. Üheksakümne päeva möödudes tagastab lõpp-punkt recording_expired.
• Välja saab lülitada iga agendi puhul eraldi - lülitiga tema detailvaates, API-s väljaga recordCalls: false. Salvestist ei teki kõnedest, mis algavad sellest hetkest; kõne, mis juba kutsub või käib, järgib seadistust selle alguse hetkest (väljaminev valimise hetkest), seega see veel salvestatakse.
• Salvestatakse ainult sisseehitatud agendi kõned. Kahe numbri otseühendust (bridge), relay-d ega SIP-i kaudu tehtud kõnet ei salvestata.

Iga API viga kannab välja cause (kes selle parandab) ja action (mida teha) - vt Veavorming REST API viites.

10Piirangud

• Kõne kestab kõige rohkem 10 minutit (600 sekundit), seejärel lõpetab agent selle ise.
• Kui helistaja vaikib 20 sekundit, peab agent seda kõne lõpuks ja katkestab ühenduse.
• Agendi reaktsiooniaeg on ligikaudu 1 sekund sellest, kui olete lõpetanud - päris töös kõigub see koormuse järgi veidi.

11Keeled

Agent oskab rääkida viies keeles - tšehhi (vaikimisi), slovaki, inglise, saksa ja poola - keele seadistate agendi detailvaates (väli language käskudes POST/PATCH /v1/agents, create_agent/update_agent) - eraldi hääl igale keelele (Cartesia) on ainult volai oma häälmootoril (vt peatükki Hääled allpool), ElevenLabsi agent räägib valitud keelt häälega Anet.

12Proovikõne

Nupp „Helista mulle proovimiseks“ agendi detailvaates portaalis käivitab agendilt tõelise kõne numbrile, mille sisestate - kiire viis kontrollida, kuidas agent kõlab ja kuidas ta teie süsteemipromptile reageerib, ilma et peaksite ise tema numbrile helistama.

Arvestatakse nagu tavalist väljaminevat kõnet agendiga, kaasa arvatud agendi juurdehindlus (vt peatükki Hinnad allpool) - ei mingit allahindlust ega erihinda.

volai oma häälmootoril olev agent saab proovikõnega hakkama ka ilma oma telefoninumbrita - kasutatakse volai ühist liini, mistõttu kutsutav näeb ekraanil volai numbrit, mitte agendi oma. ElevenLabsi agent ilma oma numbrita proovikõnet käivitada ei saa, kuni te talle numbrit ei määra.

Kuni 3 proovikõne katset päevas konto kohta, kõigi agentide peale kokku - arvesse läheb iga katse, mis tõesti valiti, ka siis kui keegi ei vastanud; katse, mis ebaõnnestus juba enne valimist (ebapiisav krediit, hõivatud liin), piirangusse ei lähe. Tavalistel kõnedel kaudu POST /v1/calls seda rangemat piirangut pole.

13Hääled

Pakkuja valikul loomisel on kolm olekut: useForOutboundTasks: true käsus POST /v1/agents või create_agent valib volai oma häälmootori, false alustab standardplatvormil (ElevenLabs), isegi kui seadistate samal ajal ümbersuunamise, ja väljajäetud väli kasutab paigalduse praegust vaikeseadistust, mis oleneb mootori sisselülitamisest ja lubatud keeltest. Ainult cs või sk ei taga mootorit; väljalülitatud vaikemootori korral luuakse agent ElevenLabsis. Kui selge false kirjutab keele vaikemootori üle, kannab loomisvastus hoiatust elevenlabs_by_explicit_choice; agendi ainult sissetulevate kõnede jaoks looge seetõttu ilma selle väljata. Kui lülitate ElevenLabsi agendil sisse transferTo, püüab volai ta pärast salvestamist mootorile üle viia. Katse võib olla peatatud, kättesaamatu või ebaõnnestuda, seega kontrollige tulemust alati: REST-is järgneva GET /v1/agents/{id} abil, MCP-s tagastatud agendist. Millist platvormi agent kasutab, ütleb väli provider; kuni ta jääb ElevenLabsi peale, ümbersuunamine ei tööta. Edu korral võib hääl muutuda. Sama katse käivitab language muutmine ElevenLabsi agendil keelelt, milles uued agendid luuakse ElevenLabsis (praegu en, de, pl), keelele, milles need luuakse mootoril (cs, sk); agent saab siis uue keele mootori vaikehääle (Milena, Katarina). Muutus cs ja sk vahel ei liiguta midagi. Muidu lülitab platvormide vahel volai (tugi). ElevenLabsi agent võtab ainult katty või toore ElevenLabsi voice id; kataloogi ülejäänud hääled töötavad ainult mootoril.

voiceId käskudes create_agent/update_agent (ja samanimeline väli käskudes POST/PATCH /v1/agents) valib agendi hääle. Filtreerimata loend GET /v1/voices (MCP list_voices ilma argumendita provider) ElevenLabsi häält katty ei näita - REST tagastab selle alles koos ?provider=elevenlabs, MCP argumendiga provider: "elevenlabs". Cartesia hääled (Milena, Jan ja teiste keelte hääled) on mõeldud agentidele volai oma häälmootoril, Katty ElevenLabsi agentidele (selle kohta, millisel platvormil agent töötab, vt märkust eespool). Vanem hääl anet jääb ainult agentidele, kellel see juba on - ElevenLabs uutele agentidele seda alates 12. 9. 2026 enam ei määra ja volai lükkab sellise päringu selgitusega tagasi. Loomisel selge useForOutboundTasks: true korral asendatakse mootori poolt mittetoetatud tuntud hääl, kaasa arvatud katty, valitud keele mootori vaikehäälega; kui mootori valib alles vaikeseadistus välja ära jätmisel, lükatakse sama ühildumatu hääl tagasi. Toore ElevenLabsi ID lükkab mootor alati tagasi. Ilma voiceId-ta saab agent oma pakkuja vaikehääle - mootoril Milena, ElevenLabsis malli hääle (Katty).

Kataloog pakub igale keelele vähemalt ühe naishääle ja ühe meeshääle (tšehhi keeles praegu neli): cs: Milena, Jan, Tereza, Marek; sk: Katarina, Peter; en: Skylar, Daniel; de: Alina, Lukas; pl: Ewa, Kacper; nl: Ariel, Alexander; pt: Christine, Filipe; sl: Sarah, Daniel; ro: Mikidutza, Oliver; da: Isabella, Søren; et: Alice, Chris; lv: Matilda, George; bg: Yoana, Peter K; fi: Soili, Jussi; el: Crhysa, Iordanis; fr: Natasha, Max; it: Rossana, Marco; hu: Zsófia, Gábor; lt: Sarah, Daniel; sv: Sanna, Filip. Portaal pakub ainult agendi valitud keele hääli - need vahetuvad koos (vt peatükki Keeled eespool).

Kõik tabelis olevad hääled kuuluvad volai oma häälmootorile. ElevenLabsi agendile lükkab API need tagasi veaga 400 - tema võtab kataloogist ainult katty (filtreerimata loendis peidetud) ja toore ElevenLabsi voice id.

voiceId võtab vastu ka toore ElevenLabsi ID, kuid ainult standardplatvormi agendile (provider: "elevenlabs"). Mootoril oleva agendi jaoks kasutage kataloogi hääle id-d. Tundmatu või pakkujaga kokkusobimatu väärtus tagastab vea, mis loetleb kehtivad valikud.

14Statistika

Agendi detailvaade portaalis näitab vastatud kõnede arvu, nende keskmist ja pikimat kestust ning arvu viimase 30 päeva kohta - selleks pole eraldi API-t, numbrid saate ise arvutada käsu GET /v1/calls väljundist.

15Hinnad

Häälagenti arvestatakse lisaks kõne hinnale sekundite kaupa - ilma täisminutiteks ümardamata. Hinnad on käibemaksuta, nagu kogu hinnakiri.

Üksikasjalik hinnakiri koos näidetega on lehel Hinnakiri.

16Ärakirjad ja veebikonks

Pärast kõne lõppu saate ärakirja ja kokkuvõtte kätte kaudu GET /v1/calls/{id} (väljad transcript ja summary) - või saadab volai need ise teie URL-ile sündmusena call.completed, niipea kui need valmis on. Ärakirja vorming, allkirja kontroll ja veakäitumine on lehel Veebikonksud.

17volai häälmootor

Osa agente töötab praegu volai oma häälmootoril ElevenLabsi asemel. Üleminek muudab kõne marsruutimist ja sellega kantakse üle agendi kogu konfiguratsioon - juhised, esimene lause, kogumisväljad, kõne eesmärk, teadmised, tööriistad ja ümbersuunamine inimesele. Mis üleminekuga muutub ja mis mitte:

• Hääled agent, kellel oli valitud ElevenLabsi hääl (Katty või vanem Anet), saab pärast üleminekut oma keele mootori vaikehääle - tšehhi keeles Milena. Mootor ElevenLabsi häält oma põhihäälena ei paku, ElevenLabs jääb seal ainult varuks Cartesia katkestuse korral. Agendi seadetes valite siis mis tahes muu hääle agendi keele kataloogist, tšehhi keeles näiteks Jani. Hääl, mis agendil juba mootori kataloogist on, üleminekul ei muutu.
• Reaktsiooniaeg jääb samaks nagu ElevenLabsis - ligikaudu 1 sekund sellest, kui olete lõpetanud.
• Salvestised muutumatu - hoitakse endiselt 90 päeva ja agendi detailvaates saab neid samamoodi välja lülitada.
• Salvestamise teade muutumatu - kui teil on agendil sisse lülitatud salvestamise lause (`recordingNotice`), lisab volai ka siin agendi esimesele lausele lühikese lause, et kõnet salvestatakse (vt jaotist Salvestised eespool). Ilma selle valikuta või väljalülitatud salvestamisega lauset üldse ei lisata.
• Teade, et räägib tehisintellekt muutumatu - esimese lause saadame pakkujale nii, nagu te selle kirjutasite. Me ei sunni seda peale: kui teade, et helistaja räägib digitaalse assistendiga, puudub, siis ainult juhime sellele tähelepanu (Euroopa tehisintellekti määrus, art. 50), salvestamist see ei peata. Vastutus teate eest jääb mõlema pakkuja puhul võrdselt teile.
• Tööriistad ja kõne ümbersuunamine lähevad agendiga kaasa - edukas üleminek saadab mootorile ka tema tööriistad ja seadistatud ümbersuunamise inimesele, neid ei pea uuesti sisestama. volai oma häälmootoril töötab ümbersuunamine sillaga (nii nagu kirjeldab peatükk Ümbersuunamine inimesele eespool) - sild on tavatöös tõestatud ja portaal näitab mootoril oleva agendi puhul täielikku ümbersuunamisvormi. Standardplatvormi (ElevenLabs) agendil käivitab ümbersuunamise sisselülitamine kohe pärast salvestamist katse viia ta üle oma mootorile; kontrollige tulemust väljalt `provider`, sest peatamise, mootori kättesaamatuse või vea korral võib ta jääda ElevenLabsi peale ja ümbersuunamine seal ei tööta. Edukal üleviimisel võib tema hääl muutuda mootori vaikehääleks. Numbrite hulgimigratsioon lainetena jätab seetõttu seadistatud ümbersuunamisega agendid vahele.
• Kõnepost väljaminevate kõnede puhul oskab ära tunda ainult volai oma häälmootor - mõne sekundi jooksul pärast vastamist tunneb ta ära automaatvastaja inimese asemel ja vastavalt seadistusele ainult märgib selle, katkestab ühenduse või ootab piiksu ja loeb sõnumi ette. Seadistatakse agendi detailvaates (ainult mootoril olev agent), API-s ja MCP-s väljaga `voicemail`. Kõnede loend näitab väljamineva kõne puhul, mille võttis vastu kõnepost, „Vastas kõnepost“ tavalise tulemuse asemel. Standardplatvormil (ElevenLabs) tuvastust pole.
• Meeldetuletus vaikuses esitab ainult volai oma häälmootor - kui helistaja vaikib pikalt, küsib agent ühe korra, kas ta on veel seal. Seadistus (sees/väljas, sekundite arv 3 kuni 25) salvestatakse mõlemal pakkujal - standardplatvormi (ElevenLabs) agendil on väli agendi detailvaates hallis ja väärtus kõlab alles pärast mootorile ülemineku. Enda sõnastus (`silencePromptText`, kuni 80 märki, vaikimisi „Kas olete seal?“ asemel) salvestatakse samamoodi.
• Esimese lause kaitse oskab ainult volai oma häälmootor ja ainult väljaminevate kõnede puhul: kuni esimene lause mängib (määratud sekundite arv, 0 kuni 20), ei katkesta seda vastaja lühike reaktsioon („Halloo?“, „Jah?“). Kutsutu repliik ilma katkestajata (stopp, ei, hetk, aitab, oodake) visatakse kaitstud aknas ära: lauset see ei katkesta, ärakirjas seda pole ja agent sellele ei reageeri, samas kui katkestajaga katkeb lause alati. Väli `firstMessageProtectSecs` salvestatakse ilma peale surutud vaikeväärtuseta mõlemal pakkujal - standardplatvormi (ElevenLabs) agendil on see agendi detailvaates hallis ja kõlab alles pärast mootorile ülemineku. Kõne ärakirjas kannab agendi repliik, mille helistaja katkestas, märget `interrupted`.
• Agendi naer ainult volai oma häälmootor oskab naeruga reageerida, kui kõnes naerate või teete nalja teie või helistaja - ja ainult tšehhi Cartesia häälega (Milena, Jan ja teised kataloogist). Standardplatvorm (ElevenLabs) naeru ei oska üldse, isegi kui välja seadistate. Agendi seadetes valite Automaatne (mootor lülitab naeru tundlike teemade puhul, näiteks võlad, tervishoid, ametiasutused või matusebürood, ise välja), Sees (kirjutab selle tuvastuse üle) või Väljas. Muudatus kehtib järgmisest kõnest.

18Kalender ja ajad

volai oma häälmootoril olev agent oskab otse kõnes tuvastada vaba aja teie Google'i või Apple'i kalendris ja kohtumise kohe üles kirjutada - ta ütleb helistajale, kas aeg on vaba, pakub lähimaid vabu aegu ja pärast nime kinnitamist kirjutab kohtumise üles. Lülitatakse sisse agendi redaktoris vahekaardil Kalender: valite ühenduse (Andmed ja integratsioonid), konkreetse kalendri ja kättesaadavuse reeglid.

• Kättesaadavuse reeglid nädalapäeva järgi aknad (millal agent üldse aegu pakub), kohtumise pikkus, vahe aegade vahel, minimaalne ettenähtud aeg enne kokkulepitud aega ja horisont, kui kaugele ette agent otsib. Vaikeväärtused täidab redaktor ise, kuid neid saab iga agendi jaoks eraldi muuta.
• Sisseehitatud tööriistad kalender kasutab kahte sisseehitatud tööriista, check_availability ja book_appointment - erinevalt peatüki Tööriistad omadest neid käsitsi ei looda, need lülituvad sisse koos kalendriga ega lähe konto tööriistade piirangusse.
• Ainult volai oma mootor töötab ainult volai oma häälmootoril oleval agendil. Kui lülitate kalendri sisse standardplatvormi (ElevenLabs) agendil, seadistus salvestatakse ja agent püüab end kohe pärast salvestamist volai mootorile üle lülitada - nagu ümbersuunamise puhul inimesele.
• Mida agent ütleb ja mida mitte agent ei loe kunagi ette, mis on kalendrisse kirjutatud - ainult seda, kas antud aeg on vaba. Helistaja telefon kirjutatakse sündmusele ainult siis, kui agent seda teab (peidetud number tähendab sündmust ilma telefonita).
• Ka väljaspool kõnet sama vabade aegade otsimine ja kohtumise üleskirjutamine käib ka väljaspool kõnet REST-i (POST /v1/integrations/{id}/availability, POST /v1/integrations/{id}/events) ja MCP (find_free_slots, create_calendar_event) kaudu - üksikasjad jaotises Kalendrid REST API viites ja MCP viites.