Ceļveži

Balss aģents

Aģents ir tikpat labs, cik labs ir tā sistēmas prompts. Šajā lapā uzzināsiet, kā to uzrakstīt, saņemsiet trīs gatavus paraugus kopēšanai un redzēsiet ierobežojumus, ar kuriem jārēķinās.

1systemPrompt struktūra

Labam promptam ir četras daļas. Izlaidiet kādu no tām, un aģents agrāk vai vēlāk iestrēgs un nezinās, ko darīt tālāk - tas vai nu apklusīs, vai kaut ko izdomās.

• Kas es esmu - viens vai divi teikumi: uzņēmuma nosaukums, loma, runas tonis. Aģentam šī identitāte jānosaka jau savā pirmajā replikā.
• Ko es varu - konkrētie uzdevumi, ko aģents patiešām veic (pasūtījumi, vizītes, informācija) - nevis neskaidrs "varu palīdzēt ar visu".
• Ko es NEKAD nedaru - robežas: ko aģents nekad nedrīkst izdomāt, apsolīt vai izpaust. Šo daļu izlaiž visbiežāk, un tieši tā atšķir aģentu, kas izdomā cenas, no tāda, kas godīgi saka "nezinu, zvaniet...".
• Kā beigt zvanu - kad un kā noslēgt zvanu (kopsavilkums, atvadas) un ko darīt, ja zvanītājs vēlas ko, kas ir ārpus aģenta kompetences.

Garāki norādījumi palēnina atbildi aptuveni par desmito daļu sekundes uz katrām divām tūkstošiem rakstzīmju - aģenta redaktors brīdina, sākot no 3000 rakstzīmēm. Stingrais ierobežojums ir 6000 rakstzīmes.

Trīs pilnīgi paraugi - nokopējiet tos un pielāgojiet savam gadījumam:

Kafejnīcas recepcionists

Jūs esat kafejnīcas Nula Cafe Vinohrados balss recepcionists. Runājat
mierīgi, sirsnīgi un īsi - tā, kā to darītu pieredzējis darbinieks,
nevis robots.

KO JŪS VARAT
- Pieņemt pasūtījumus saņemšanai uz vietas (kafija, tēja, kruasāni, sendviči).
- Pateikt zvanītājiem aktuālo darba laiku: no pirmdienas līdz piektdienai
  8-18, brīvdienās 9-15.
- Pasūtījuma beigās to pilnībā atkārtot un apstiprināt saņemšanas laiku
  (vismaz 15 minūtes no šī brīža).

KO JŪS NEKAD NEDARIET
- Nekad neizdomājiet cenas vai produktus, kas nav ēdienkartē - sakiet,
  ka precīzu cenu uz vietas apstiprinās darbinieki.
- Nekad neapsoliet piegādi, kafejnīca nepiegādā.
- Nekad neizliecieties par cilvēku, ja zvanītājs jautā tieši - sakiet,
  ka esat kafejnīcas balss asistents.

KĀ BEIGT ZVANU
Apkopojiet pasūtījumu un saņemšanas laiku, novēliet labu dienu un beidziet
zvanu. Ja zvanītājs vēlas ko tādu, ko jūs nevarat atrisināt (sūdzības,
ēdināšana pasākumiem), sakiet, lai zvana vēlreiz darba laikā un runā
tieši ar īpašnieku.

Apmierinātības aptauja

Jūs zvanāt interneta veikala Botanika vārdā, lai pēc nesen veikta
pasūtījuma veiktu īsu apmierinātības aptauju. Esat pieklājīgs, ejat
tieši pie lietas un zvanu nevelkat garumā.

KO JŪS VARAT
- Pajautāt, vai klientam ir minūte trim ātriem jautājumiem.
- 1. jautājums: kā viņš vērtē apmierinātību ar pasūtījumu skalā no 1 līdz 5.
- 2. jautājums: vai sūtījums ieradās laikā?
- 3. jautājums: vai ir kaut kas, ko mēs varētu uzlabot?
- Atcerēties atbildes un zvana beigās tās īsi apkopot.

KO JŪS NEKAD NEDARIET
- Nekad nespiediet klientu, kurš atsakās vai saka, ka nav laika - uzreiz
  pieklājīgi beidziet zvanu.
- Nekad neizskatiet sūdzības vai preču atgriešanu - tas pieder klientu
  atbalsta līnijai, ko pēc lūguma varat nolasīt.
- Nekad nepiedāvājiet atlaides vai kuponus, jums nav šādu pilnvaru.

KĀ BEIGT ZVANU
Pateicieties par laiku un atsauksmēm, novēliet labu dienu. Ja klients
jebkurā brīdī saka, ka nevēlas turpināt, uzreiz pieklājīgi beidziet zvanu
bez turpmākiem jautājumiem.

Reģistratūra / ēkas ieeja

Jūs esat biroju ēkas Nordwex Pankrácā balss reģistratūra. Uz šo numuru
zvana kurjeri, apmeklētāji un piegādātāji.

KO JŪS VARAT
- Noskaidrot, kas zvana un kāpēc (kurjers ar sūtījumu, apmeklētājs uz
  tikšanos, piegādātājs).
- Apmeklētājam uzzināt vārdu un to, ar ko viņš tiekas, pēc tam likt viņam
  reģistrēties pirmā stāva reģistratūrā un pagaidīt, līdz pēc viņa
  kāds nonāks.
- Kurjeram likt sūtījumu atstāt reģistratūrā un uz tā uzrakstīt
  uzņēmuma nosaukumu un saņēmēju.
- Pieņemt īsu ziņu, ja persona, kam zvana, šobrīd nav pieejama.

KO JŪS NEKAD NEDARIET
- Nekad neizsniedziet darbinieku privātos mobilos numurus - piedāvājiet
  pārslēgt uz reģistratūru vai pieņemt ziņu.
- Nekad neļaujiet nevienam doties "augšā vienam" - visi apmeklētāji iet
  caur reģistratūru.
- Nekad neizpaudiet, kas šobrīd atrodas ēkā un kad - sakiet, ka jāpajautā
  reģistratūrā.

KĀ BEIGT ZVANU
Atkārtojiet, par ko vienojāties (ziņa, gaidīšana reģistratūrā,
pārslēgšana), novēliet labu dienu un beidziet zvanu.

2Nozaru veidnes

Nevēlaties rakstīt promptu no nulles? Vietnē ir gatavas veidnes sešām nozarēm (zobārstniecības prakse, autoserviss, restorāns, interneta veikals, nekustamo īpašumu birojs, amatnieki) - pilns sistēmas prompts, parauga dialogs un piemērs, cik šāds recepcionists izmaksātu. Nokopējiet un pielāgojiet, tāpat kā iepriekšējos paraugus.

Skatīt nozaru veidnes

3firstMessage

firstMessage ir pirmais teikums, ko klients izdzird - uzreiz pēc tam, kad ienākošā zvana gadījumā tiek pacelta klausule, vai uzreiz pēc tam, kad izejošā zvana gadījumā atbild zvanāmais.

• Īsa, runāta latviešu valoda - tā, kā cilvēks to pateiktu, nevis kā uzrakstītu e-pastā.
• Uzreiz pasakiet, kas zvana vai atbild - klientam jāzina, ar ko viņš runā, trīs sekunžu laikā.
• Beidziet ar atvērtu jautājumu ("kā varu palīdzēt", "vai jums ir minūte") - nevis ar garu monologu.
• Nolasiet to skaļi - teksts, kas rakstīts izskatās labi, runājot var skanēt neveikli.
• Izejošos zvanos pārstāvieties un nosauciet zvana iemeslu jau pašā sākumā - cilvēki ar aizdomām atbild uz nezināmiem numuriem.

4Rīki

Rīks ir jūsu API adrese, ko aģents zvana laikā izsauc un kuras atbildi uzreiz izmanto runā. Bez rīka aģents var tikai runāt; ar rīku tas var pārbaudīt pasūtījumu, atrast brīvu laiku vai ierakstīt rezervāciju.

Rīkus izveido portālā adresē /agent/nastroje (vai ar POST /v1/tools) un pēc tam aģentam ieslēdz ar izvēles rūtiņu tā detaļu lapā (API tas ir lauks toolIds). Rīks pieder kontam, nevis aģentam - vienu un to pašu rīku var izmantot vairāki aģenti. Tam norādāt četras lietas:

• Nosaukums - lasāms nosaukums ("Pārbaudīt pasūtījumu"). No tā automātiski atvasina nosaukumu, ko redz modelis (overit_objednavku), un parāda to zem lauka.
• Kad aģentam to izmantot - vienīgais, uz ko modelis balsta lēmumu rīku vispār izsaukt. Uzrakstiet to kā norādījumu: "Izmanto, kad zvanītājs jautā, kur ir viņa pasūtījums."
• Adrese un metode - tikai https, publiski sasniedzama. GET sūta parametrus vaicājuma virknē, POST JSON pamattekstā. Kā arī galvenes, parasti Authorization.
• Parametri - katram norādāt, no kurienes tā vērtība nāk: modelis to izvelk no zvana, zvanītāja vai zvanītā numurs tiek aizpildīts automātiski, vai arī tā ir fiksēta vērtība.

Tā izskatās pieprasījums, kas zvana laikā nonāk pie jūsu galapunkta:

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

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

Un šī ir atbilde, ar kuru aģents var strādāt - īss JSON saturs, ko tas var pārvērst vienā teikumā:

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

5Pārslēgšana uz cilvēku

Aģents var pārslēgt zvanu uz jūsu numuru, kad zvanītājs vēlas runāt ar cilvēku vai saskaras ar kaut ko, ko aģents nevar atrisināt. To ieslēdz aģenta detaļu lapā (API tas ir lauks transferTo); nosacījumu rakstāt kā norādījumu modelim laukā transferCondition. Ja tā nav, mēs izmantojam noklusējuma teikumu.

volai paša balss dzinējā

volai paša balss dzinējā pārslēgšana notiek ar tiltu: aģents pasaka, ka savieno, zvanītājs dzird zvana signālu, un cilvēks jūsu numurā redz aģenta numuru. Kad jūs paceļat klausuli, aģents apklust, un zvans starp jums abiem turpinās caur volai. Ja kāds no jums nolika klausuli, zvans beidzas abiem. Ja neatbildat 25 sekunžu laikā, aģents atvainojas zvanītājam, piedāvā pieņemt ziņu un turpina darbu.

Pārslēgt uz savu volai numuru nevar - zvans apgrieztos pats pret sevi, līdz beigtos kredīts. Tā paša iemesla dēļ ir aizliegtas maksas līnijas (90x).

Aģents, kas izmanto numurs zvaniem un SMS, pārslēdz tikai uz Čehijas numuriem (+420): zvani no šī numura iet tikai uz Čehijas numuriem, tāpēc pārslēgšanas numurs ārpus +420 šādam aģentam netiek saglabāts, un API atgriež destination_not_allowed.

6No zvaniem iegūtie dati

Tā vietā, lai lasītu pilnu transkriptu, varat precīzi norādīt, ko vēlaties no zvana iegūt - vārdu, vienību skaitu, vai tas ir steidzami. Aģents to aizpilda pēc zvana, un jūs saņemat to atpakaļ kā JSON.

Katram laukam ir atslēga, tips un apraksts. Līdz desmit laukiem uz aģentu:

• Atslēga (key) - mazie burti, cipari un pasvītras, līdz 40 rakstzīmēm - jāsākas ar mazo burtu. Vērtību rezultātā atradīsiet zem šī nosaukuma.
• Tips (type) - string, number vai boolean.
• Apraksts (description) - precīzi tas, ko modelim jāizvelk, no 5 līdz 500 rakstzīmēm. Norādiet arī, kas jādara, ja zvanā tas nav minēts.
• Opcijas (enumValues) - neobligāts saraksts, tikai teksta laukiem. Tad modelis izvēlas tikai no piedāvātajām vērtībām, tāpēc rezultātu var tieši filtrēt. Ne vairāk kā 20 opcijas, katra līdz 60 rakstzīmēm.

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": "Zvanītāja vārds tādā formā, kā viņš to nosauca. Ja nav minēts, atstāt tukšu."},
      {"key": "coffee_count", "type": "number", "description": "Cik kafijas zvanītājs pasūtīja."},
      {"key": "urgency", "type": "string", "description": "Cik steidzams bija pieprasījums.", "enumValues": ["low", "normal", "high"]}
    ]
  }'

Rezultāts parādās trīs vietās: zvana detaļu lapā portālā kā kartīte "Iegūtie dati", zvana laukā data (gan GET /v1/calls, gan GET /v1/calls/{id}) un call.completed webhook pamattekstā.

{
  "call": {
    "id": "c_8f2ac1d4",
    "status": "completed",
    "hasRecording": true,
    "data": {
      "name": "Jānis Bērziņš",
      "coffee_count": 2,
      "urgency": "normal"
    }
  }
}

Vērtība null nozīmē "zvanā nav minēts" - tas pats attiecas uz gadījumu, ja modelis atgriež tukšu virkni. Ja aģentam nav nokonfigurēts neviens lauks, atslēgas data atbildē vispār nav.

7Aģenta mērķis un vērtējums

Mērķis ir viens teikums, kas apraksta, ko zvanam jāpanāk - "vienoties par apskati", "noskaidrot, vai klientu interesē piedāvājums". To ievadāt laukā "Aģenta mērķis" portālā (veidojot aģentu vai jebkurā brīdī vēlāk, rediģējot to) vai caur REST API un MCP ar lauku goal pie POST/PATCH /v1/agents un create_agent/update_agent (līdz 300 rakstzīmēm).

Mērķis aģentam nonāk kā zvana vērtēšanas kritērijs: kad zvans beidzas, modelis nolasa transkriptu un izlemj, vai mērķis ir sasniegts, nav sasniegts vai no zvana to nevar noteikt. Rezultātu redzēsiet pie zvana portālā - zvana detaļu lapā un zvanu sarakstā - kā arī e-pastā pēc zvana blakus kopsavilkumam.

Ko aģents zina (pamatmateriāli)

Papildus norādījumiem aģentam varat dot pamatmateriālus - darba laiku, cenrādi, biežāk uzdotos jautājumus. Ievadiet tos laukā "Ko aģents zina" portālā (sadaļa Papildu) vai laukā knowledge pie POST/PATCH /v1/agents. Teksts tiek pievienots prompta beigās, ietilpst 20000 rakstzīmēs, un PATCH ar tukšu vērtību to notīra. Atšķirībā no rīka šis materiāls zvana laikā nekad nemainās - viss, kas mainās (pasūtījuma statuss, brīvie laiki), pieder rīkam, nevis šeit.

8E-pasts pēc zvana

Kad zvans ar aģentu beidzas, volai nosūta jums e-pastu ar kopsavilkumu un saiti uz zvana detaļām portālā - to pašu kopsavilkumu, ko API redzat laukā summary. Tas tiek sūtīts aģentiem, kas darbojas uz volai paša balss dzinēja (provider: "engine"); aģents uz ElevenLabs (provider: "elevenlabs") to pagaidām nesaņem.

Slēdzis "E-pasts pēc katra zvana" atrodas lapā Iestatījumi - tā izslēgšana uzreiz aptur e-pastu visam kontam. Lai to apturētu vienam aģentam, izmantojiet izvēles rūtiņu "Sūtīt man e-pastu pēc katra zvana" šī aģenta detaļu lapā (API tas ir lauks notifyEmail: false). Jūs saņemat ne vairāk kā vienu e-pastu uz zvanu, un zvans, par kuru nav ko ziņot (nav kopsavilkuma, nav savākto datu un nav beigu iemesla), e-pastu neizraisa.

9Ieraksti

Aģenta zvani tiek ierakstīti, un jūs varat tos atskaņot tieši no zvana detaļu lapas portālā - klikšķis transkriptā pārlec uz atbilstošo vietu ierakstā. Lai to lejupielādētu vai atskaņotu citur, izmantojiet GET /v1/calls/{id}/recording (ar to pašu API atslēgu) - formātu nosaka atbildes galvene content-type: audio/mpeg (MP3) aģentam uz ElevenLabs, šobrīd audio/ogg aģentam uz volai dzinēja. Lauks hasRecording norāda, vai zvanam ir ieraksts.

• Glabājam 90 dienas pēc zvana, pēc tam dzēšam. Transkripts un kopsavilkums tiek glabāti atsevišķi un kopā ar ierakstu netiek dzēsti. Pēc deviņdesmit dienām galapunkts atgriež recording_expired.
• Varat to izslēgt katram aģentam ar slēdzi tā detaļu lapā vai lauku recordCalls: false API. Zvaniem, kas sākti no šī brīža, ieraksts netiek veidots; zvans, kas jau zvana vai notiek, ievēro iestatījumu no tā sākuma brīža (izejošais zvans no brīža, kad tas tika sazvanīts), tāpēc tas joprojām tiek ierakstīts.
• Tiek ierakstīti tikai zvani, ko apstrādā iebūvētais aģents. Tiešs tilts starp diviem numuriem, releja zvans un SIP zvans netiek ierakstīti nekad.

Katra API kļūda satur cause (kam tā jālabo) un action (ko darīt) - skatiet Kļūdu formāts REST API atsaucē.

10Ierobežojumi

• Zvans ilgst ne ilgāk kā 10 minūtes (600 sekundes), pēc tam aģents to beidz pats.
• Ja zvanītājs 20 sekundes klusē, aģents to uzskata par zvana beigām un nolieka klausuli.
• Aģents atbild aptuveni 1 sekundi pēc tam, kad esat beidzis runāt - reālā trafikā tas nedaudz mainās atkarībā no slodzes.

11Valodas

Aģents var runāt piecās valodās - čehu (noklusējums), slovāku, angļu, vācu un poļu - valodu iestatāt aģenta detaļu lapā (lauks language pie POST/PATCH /v1/agents, create_agent/update_agent). Atsevišķa balss katrai valodai (Cartesia) ir pieejama tikai aģentam, kas darbojas uz volai paša dzinēja (skatiet sadaļu Balsis zemāk) - aģents, kas paliek uz ElevenLabs, izvēlēto valodu runā ar balsi Anet.

12Testa zvans

Poga "Zvanīt man testam" aģenta detaļu lapā portālā liek aģentam veikt īstu zvanu uz jūsu ievadīto numuru - ātra pārbaude, kā tas skan un kā reaģē uz jūsu sistēmas promptu, nevajadzot zvanīt uz tā numuru pašam.

Rēķina kā parastu izejošo zvanu ar aģentu, ieskaitot aģenta uzcenojumu (skatiet sadaļu Cenas zemāk) - bez atlaides, bez īpašas likmes.

Aģents uz volai paša balss dzinēja var veikt testa zvanu pat bez sava tālruņa numura - zvans iziet pa kopīgo volai līniju, tāpēc zvanāmais savā displejā redz volai numuru, nevis aģenta numuru. Aģents uz ElevenLabs bez sava numura testa zvanu sākt nevar, kamēr tam nepiešķirat numuru.

Ne vairāk kā 3 testa zvana mēģinājumi uz kontu dienā, visiem aģentiem kopā - skaitās katrs mēģinājums, kas patiešām savienojās, pat ja neviens neatbildēja; mēģinājums, kas neizdevās vēl pirms savienošanas (nepietiekams kredīts, aizņemta līnija), ierobežojumā netiek ieskaitīts. Parastajiem zvaniem caur POST /v1/calls šāda stingrāka ierobežojuma nav.

13Balsis

Pakalpojumu sniedzēja izvēlei izveides brīdī ir trīs stāvokļi: useForOutboundTasks: true pie POST /v1/agents vai create_agent izvēlas volai paša balss dzinēju, false sāk uz ElevenLabs pat ar pārslēgšanu, bet izlaists lauks izmanto izvietošanas noklusējumu, kas ir atkarīgs no dzinēja pieejamības, ieslēgšanas un konfigurētajām valodām. Tikai cs vai sk izvēle dzinēju negarantē; kad dzinēja noklusējums ir izslēgts, izveide sākas uz ElevenLabs. Kad skaidri norādīts false pārraksta valodas dzinēja noklusējumu, izveides atbilde satur brīdinājumu elevenlabs_by_explicit_choice, tāpēc aģentu, kas paredzēts tikai ienākošajiem zvaniem, veidojiet bez šī lauka. Kad ElevenLabs aģentam ieslēdzat transferTo, volai pēc saglabāšanas mēģina to pārcelt uz dzinēju. Mēģinājums var tikt apturēts, nebūt pieejams vai neizdoties, tāpēc rezultātu pārbaudiet ar sekojošu GET /v1/agents/{id} REST gadījumā vai atgrieztajā aģentā MCP gadījumā. Lauks provider norāda, uz kuras platformas aģents darbojas; kamēr tas paliek uz ElevenLabs, pārslēgšana nedarbojas. Sekmīga pārslēgšanās var mainīt tā balsi. Tāds pats mēģinājums seko language maiņai ElevenLabs aģentam no valodas, kurā jauni aģenti sāk uz ElevenLabs (šobrīd en, de, pl), uz valodu, kurā tie sāk uz dzinēja (cs, sk); tad aģents saņem jaunās valodas noklusējuma dzinēja balsi (Milena, Katarina). Maiņa starp cs un sk neko nepārceļ. Citādi pārcelšanu starp platformām veic volai atbalsts. ElevenLabs no kataloga pieņem tikai katty vai neapstrādātu ElevenLabs balss id; citām kataloga balsīm nepieciešams dzinējs.

voiceId pie create_agent/update_agent (un tāda paša nosaukuma lauks pie POST/PATCH /v1/agents) izvēlas aģenta balsi. Nefiltrētajā sarakstā GET /v1/voices (MCP list_voices bez argumenta provider) ElevenLabs balss katty netiek rādīta - REST to atgriež tikai ar ?provider=elevenlabs, MCP ar argumentu provider: "elevenlabs". Cartesia balsis (Milena, Jan un balsis citām valodām) ir paredzētas aģentiem uz volai paša dzinēja, Katty - aģentiem uz ElevenLabs (iepriekšējā piezīme paskaidro, uz kuras platformas aģents darbojas). Vecākā balss anet paliek tikai aģentiem, kuriem tā jau ir - kopš 2026. gada 12. septembra ElevenLabs to jauniem aģentiem vairs nepiešķir, un volai šādu pieprasījumu noraida ar paskaidrojumu. Izveidojot ar skaidru useForOutboundTasks: true, atpazīta kataloga balss, kas dzinējā nav pieejama, ieskaitot katty, tiek aizstāta ar dzinēja noklusējumu izvēlētajai valodai; kad dzinēju izvēlas izlaists lauks caur izvietošanas noklusējumu, tā pati nesaderīgā balss tiek noraidīta. Neapstrādāts ElevenLabs id dzinējam tiek noraidīts vienmēr. Bez voiceId aģents saņem sava pakalpojumu sniedzēja noklusējuma balsi - Milena uz dzinēja, veidnes balss (Katty) uz ElevenLabs.

Katalogā katrai valodai ir vismaz viena sieviešu un viena vīriešu balss (čehu valodai šobrīd četras): 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. Portāls piedāvā tikai aģenta izvēlētās valodas balsis - tās mainās kopā (skatiet sadaļu Valodas iepriekš).

Katra tabulā redzamā balss pieder volai paša balss dzinējam. Aģentam uz ElevenLabs API tās noraida ar 400 - šis aģents pieņem tikai katty (ko nefiltrētais saraksts nerāda) un neapstrādātu ElevenLabs balss id.

voiceId pieņem arī neapstrādātu ElevenLabs ID, bet tikai aģentam uz standarta platformas (provider: "elevenlabs"). Aģentam uz dzinēja izmantojiet kataloga balss id. Nezināma vērtība vai pakalpojumu sniedzējam nesaderīga vērtība atgriež kļūdu ar derīgo opciju sarakstu.

14Statistika

Aģenta detaļu ekrāns portālā rāda atbildēto zvanu skaitu, to vidējo un garāko ilgumu un cik zvanu notika pēdējās 30 dienās - atsevišķa API tam nav, tos pašus skaitļus varat aprēķināt paši no GET /v1/calls.

15Cenas

Balss aģentu rēķina papildus zvana cenai pa sekundēm - bez noapaļošanas līdz veselām minūtēm. Likmes ir bez PVN, tāpat kā viss cenrādis.

Pilnas cenas ar piemēriem ir lapā Cenrādis.

16Transkripti un webhook

Kad zvans beidzas, transkriptu un kopsavilkumu iegūstiet ar GET /v1/calls/{id} (lauki transcript un summary) - vai arī volai tos var nosūtīt uz jūsu URL kā notikumu call.completed, tiklīdz tie ir gatavi. Transkripta formāts, paraksta pārbaude un kļūdu apstrāde ir lapā Webhooks.

17volai balss dzinējs

Daži aģenti šobrīd darbojas uz volai paša balss dzinēja, nevis uz ElevenLabs. Pārslēgšana maina zvanu maršrutēšanu, un līdz ar to pārceļas visa aģenta konfigurācija - norādījumi, sākuma replika, datu lauki, zvana mērķis, zināšanas, rīki un pārslēgšana uz cilvēku. Kas mainās un kas ne:

• Balsis aģents, kuram bija izvēlēta ElevenLabs balss (Katty vai vecākā Anet), pēc pārslēgšanas saņem dzinēja noklusējuma balsi savai valodai - čehu valodai Milena. Dzinējs ElevenLabs balsi kā galveno nepiedāvā, ElevenLabs paliek tikai kā rezerve Cartesia darbības traucējumu gadījumam. Pēc tam aģenta iestatījumos varat izvēlēties jebkuru citu kataloga balsi aģenta valodai, tostarp čehu valodai Jan. Balss, kas aģentam jau ir no dzinēja kataloga, netiek aizskarta.
• Atbildes laiks paliek tāds pats kā ElevenLabs - aptuveni 1 sekunde pēc tam, kad esat beidzis runāt.
• Ieraksti nemainās - joprojām tiek glabāti 90 dienas un tos var izslēgt tāpat aģenta detaļu lapā.
• Paziņojums par ierakstīšanu nemainās - ja aģentam ieslēgts paziņojums par ierakstīšanu (`recordingNotice`), volai arī šeit aģenta pirmajai replikai pievieno īsu teikumu, ka zvans tiek ierakstīts (skatiet sadaļu Ieraksti iepriekš). Bez šīs opcijas vai ar izslēgtu ierakstīšanu teikums netiek pievienots vispār.
• Paziņojums par mākslīgo intelektu nemainās - sākuma replika pakalpojumu sniedzējam nonāk tieši tāda, kā to uzrakstījāt. Mēs to neuzspiežam: ja replikā nav teikts, ka zvanītājs runā ar digitālo asistentu, mēs tikai brīdinām (ES MI akts, 50. pants), saglabāšana tik un tā notiek. Paziņojums paliek jūsu atbildība ar jebkuru pakalpojumu sniedzēju.
• Rīki un pārslēgšana uz cilvēku tie pārceļas kopā ar aģentu - sekmīga pārslēgšanās nosūta dzinējam tā rīkus un nokonfigurēto pārslēgšanu uz cilvēku, tāpēc tie nav jāiestata no jauna. volai paša balss dzinējā pārslēgšana darbojas ar tiltu (tāpat kā iepriekšējā sadaļā Pārslēgšana uz cilvēku) - tilts ir pārbaudīts ikdienas darbībā, un portāls aģentam uz dzinēja rāda pilnu pārslēgšanas veidlapu. Pārslēgšanas ieslēgšana aģentam uz standarta platformas (ElevenLabs) tūlīt pēc saglabāšanas izraisa pārslēgšanās mēģinājumu; rezultātu pārbaudiet laukā `provider`, jo apturēts mēģinājums, nepieejams dzinējs vai kļūme var atstāt to uz ElevenLabs, kur pārslēgšana nedarbojas. Sekmīga pārslēgšanās var nomainīt tā balsi uz dzinēja noklusējumu. Tāpēc masveida numuru migrācija viļņos izlaiž aģentus ar nokonfigurētu pārslēgšanu.
• Balss pasta noteikšana izejošajos zvanos to var tikai volai paša balss dzinējs - dažu sekunžu laikā pēc atbildes tas atpazīst balss pastu cilvēka vietā un atkarībā no iestatījuma to tikai atzīmē, nolieka klausuli vai gaida signālu un nolasa ziņu. Iestata aģenta detaļu skatā (tikai dzinēja aģentiem), laukā `voicemail` caur API un MCP. Zvanu saraksts tad izejošam zvanam ar balss pastu parāda "Atbildēja balss pasts" parastā iznākuma vietā. Standarta platformai (ElevenLabs) šādas noteikšanas nav.
• Atgādinājums par klusumu to atskaņo tikai volai paša balss dzinējs - kad zvanītājs kādu laiku klusē, aģents vienreiz pajautā, vai viņš vēl ir klāt. Iestatījums (ieslēgts/izslēgts, 3 līdz 25 sekundes) tiek saglabāts jebkuram pakalpojumu sniedzējam - aģentam uz standarta platformas (ElevenLabs) lauks aģenta detaļu skatā ir pelēks, un vērtība būs dzirdama, kad aģents pārslēgsies uz dzinēju. Jūsu pašu atgādinājuma teikums (`silencePromptText`, līdz 80 rakstzīmēm, noklusējuma atgādinājuma vietā aģenta valodai, kas angļu valodā ir "Are you still there?") tiek saglabāts tāpat.
• Pirmās replikas aizsardzība to var tikai volai paša balss dzinējs, un tikai izejošos zvanos: kamēr skan pirmā replika (jūsu iestatītais sekunžu skaits, no 0 līdz 20), īsa atbildējušā cilvēka reakcija ("Hallo?", "Jā?") to nepārtrauc: atbilde bez pārtraucoša vārda (piemēram, stop, nē, pagaidi) aizsargātajā logā tiek atmesta, tāpēc tā replikai netraucē, transkriptā neparādās un aģents uz to nereaģē, savukārt pārtraucošs vārds to pārtrauc vienmēr. Pārtraucošie vārdi seko aģenta valodai: angļu valodas aģentu pārtrauc stop, no, wait vai hold. Lauks `firstMessageProtectSecs` tiek saglabāts jebkuram pakalpojumu sniedzējam bez piespiedu noklusējuma - aģentam uz standarta platformas (ElevenLabs) tas aģenta detaļu skatā ir pelēks, un būs dzirdams, kad aģents pārslēgsies uz dzinēju. Zvana transkriptā aģenta replika, ko zvanītājs pārtrauca, satur karodziņu `interrupted`.
• Aģenta smiekli tikai volai paša balss dzinējs var smieties pretī, kad jūs vai zvanītājs zvana laikā smejaties vai jokojat - un tikai ar čehu Cartesia balsi (Milena, Jan un pārējās kataloga balsis). Standarta platforma (ElevenLabs) to nevar vispār, pat ar iestatītu lauku. Aģenta iestatījumos izvēlaties Automātiski (dzinējs smieklus pats izslēdz jutīgām tēmām, piemēram, parādu piedziņai, veselības aprūpei, iestādēm vai apbedīšanas pakalpojumiem), Ieslēgts (pārraksta šo noteikšanu) vai Izslēgts. Izmaiņa stājas spēkā ar nākamo zvanu.

18Kalendārs un vizītes

Aģents uz volai paša balss dzinēja var zvana laikā pārbaudīt brīvu laiku jūsu Google vai Apple kalendārā un uz vietas ierakstīt vizīti - tas pasaka zvanītājam, vai laiks ir brīvs, piedāvā tuvākos brīvos laikus un ieraksta vizīti, kad ir apstiprinājis vārdu. Ieslēdziet to aģenta redaktora cilnē Kalendārs: izvēlieties savienojumu (Dati un integrācijas), konkrēto kalendāru un pieejamības noteikumus.

• Pieejamības noteikumi logi pa nedēļas dienām (kad aģents vispār piedāvā vizītes), vizītes ilgums, rezerve starp vizītēm, minimālais brīdinājuma laiks pirms rezervētā laika un horizonts - cik tālu uz priekšu aģents meklē. Redaktors aizpilda noklusējumus, bet katram aģentam var būt savas vērtības.
• Iebūvētie rīki kalendārs izmanto divus iebūvētus rīkus, check_availability un book_appointment - atšķirībā no pielāgotajiem rīkiem no iepriekšējās sadaļas Rīki tos neveido ar roku, tie ieslēdzas kopā ar kalendāru un netiek ieskaitīti konta rīku ierobežojumā.
• Tikai volai paša dzinējs darbojas tikai aģentam uz volai paša balss dzinēja. Ja kalendāru ieslēdzat aģentam uz standarta platformas (ElevenLabs), iestatījums tiek saglabāts, un aģents uzreiz pēc saglabāšanas mēģina pārslēgties uz volai dzinēju - tāpat kā ar pārslēgšanu uz cilvēku.
• Ko aģents saka un nesaka aģents nekad nenolasa to, kas ierakstīts kalendārā - tikai to, vai konkrēts laiks ir brīvs. Zvanītāja tālruņa numurs notikumam tiek pievienots tikai tad, ja aģents to zina (slēpts numurs nozīmē, ka notikumam nav tālruņa numura).
• Arī ārpus zvana tāda pati brīvo laiku meklēšana un vizīšu rezervēšana darbojas arī ārpus zvana, caur REST (POST /v1/integrations/{id}/availability, POST /v1/integrations/{id}/events) un MCP (find_free_slots, create_calendar_event) - sīkāku informāciju skatiet sadaļā Kalendāri REST API atsaucē un MCP atsaucē.