Pagrindinės sąvokos

Visos platformos žemėlapis – ką daro kiekvienas objektas, kur jis yra valdymo skydelyje ir kuri API su juo sąveikauja.

ThunderPhone yra išsami platforma, skirta kurti, vykdyti ir tobulinti DI balso agentus. Šis puslapis yra žemėlapis: kiekviena sąvoka, su kuria susidursite, pateikta atskirame trumpame skyriuje, kartu su atitinkama skydelio sritimi ir ją pagrindžiančia API. Greitai peržvelkite jį kartą, tada grįžkite, kai reikės paaiškinti terminą.

Skydelio šoninė juosta atspindi šią struktūrą:

Organizacijos#

Organizacija yra kelių nuomininkų sistemos vienetas. Kiekvienas kitas išteklius — agentai, telefono numeriai, skambučiai, raktai — priklauso tik vienai organizacijai. Jūsų paskyra gali priklausyti daugeliui organizacijų; kiekviena turi savo balansą, savo raktus ir savo narių sąrašą.

sk_live_ API raktas, kurį sukuriate skiltyje Organizacija → Raktai, yra susietas su viena organizacija. Dėl šio susiejimo REST API yra tokia paprasta: URL keliuose niekada nenurodote organizacijos ID, nes jūsų raktas ją jau identifikuoja.

Skydelyje: organizacijos perjungiklis (šoninės juostos poraštėje) ir Organizacijos nustatymai — skirtukai Mano paskyra, Bendrieji, Raktai, Įspėjimai, Atsiskaitymo nustatymai ir Atsiskaitymo istorija. Žr. organizacijos nustatymų žinyną.

API: /v1/orgs, /v1/developer/api-keys.

Agentai#

Agentas yra DI konfigūracija, vykdanti skambutį. Ją sudaro:

• Raginimas, nustatantis, ką agentas sako ir kaip elgiasi — įskaitant skambučio veiksmus, pvz., peradresavimą, klaviatūros paspaudimus ir skambučio nutraukimą, kurie yra paprastos raginimo eilutės, o ne atskira konfigūracija.
• Variklio pakopa (spark, bolt, storm-*): Spark optimizuotas kainai, Bolt — greičiui, Storm — intelektui dirbant su sudėtingais raginimais.
• Balsas, pagrindinė kalba ir pasirenkamos papildomos kalbos — agentas automatiškai persijungia, kai skambinantysis pakeičia kalbą. Žr. Palaikomos kalbos.
• Prijungtos galimybės: prijungtos programos, API ryšiai, žinių bazės, MCP serveriai ir įterptiniai funkcijų įrankiai.
• Elgsenos nustatymai: kalbėjimo eiliškumas, patvirtinimo režimas, fono takelis, laukimo skirtasis laikas.

Pakeitimai kūrimo priemonėje automatiškai išsaugomi juodraštyje; jie nepublikuojami, kol nepaspaudžiate Diegti. Kiekvienas diegimas išsaugomas kaip momentinė kopija kūrimo priemonės skirtuke Istorija, todėl galite peržiūrėti ir atkurti bet kurią ankstesnę versiją.

Skydelyje: Balso agentai → agento kūrimo priemonė (/dashboard/agents). Žr. Sukurkite pirmąjį balso agentą.

API: /v1/agents — CRUD, dubliavimas, perdavimas, versijų istorija ir raginimų pagalbinės priemonės.

Balsai#

Balsų bibliotekoje pateikiami balsai, kuriuos gali naudoti agentas, jų atkuriami pavyzdžiai, suderinamos kalbos, lyties ir akcentų grupės bei visi papildomi mokesčiai už aukščiausios kokybės balsus ar kalbas. Mokamas pavyzdžių generatorius gali susintetinti jūsų 1–500 simbolių frazę prieš jums pasirenkant.

Reikalavimus atitinkančios organizacijos taip pat gali kurti pasirinktinius balsus iš trumpo WAV ar MP3 pavyzdžio. Pasirinktiniai balsai turi kvotą ir asinchroninę kūrimo būseną; kai jie paruošiami, rodomi toje pačioje agento pasirinkimo priemonėje kaip ir bibliotekos balsai.

Valdymo skydelyje: Balsai (/dashboard/voices). Žr. Balsų biblioteka ir pasirinktiniai balsai.

API: /v1/voices, balsų pavyzdžiai ir pasirinktiniai balsai.

Telefono numeriai#

Telefono numeris priklauso organizacijai ir nukreipia įeinančius skambučius agentui (taip pat gali būti naudojamas išeinantiems skambučiams). Du šaltiniai:

• ThunderPhone numeriai – tikri JAV numeriai, suteikiami iš ThunderPhone numerių fondo, aktyvuojami per kelias sekundes, $1 per mėnesį ir 1 ¢ per minutę papildomas mokestis. Tik įeinantiems skambučiams; išeinantiems reikia jūsų ryšio operatoriaus. Organizacija pagal numatytuosius nustatymus gali turėti 25 numerius.
• VoIP numeriai – gaunami iš jūsų tiekėjo per VoIP ryšį. Twilio ir Telnyx prijungiami tiesiogiai (Telnyx turi vedamą sąranką); SignalWire ir Vonage bus netrukus – šiuo metu juos galite pasiekti naudodami rankinę SIP konfigūraciją, kuri priima bet kurią SIP liniją. Importavus ir patvirtinus, VoIP numeriai palaiko įeinančius ir išeinančius skambučius.

Kiekvienoje numerio eilutėje galite nustatyti maršruto parinkimo režimą, pasirinkti įeinančių skambučių agentą ir pažymėti numerį etikete.

Valdymo skydelyje: Telefono numeriai (/dashboard/phone-numbers). Žr. Gaukite telefono numerį.

API: /v1/phone-numbers, /v1/voip-connections, /v1/phone-number-labels.

Skambučiai#

Kiekvienas įeinantis skambutis, išeinantis skambutis, simuliacija ir valdiklio sesija tampa skambučio žurnalu. Skambutis apima visą vaidmenimis pažymėtą nuorašą, struktūrizuotą pokalbio eigos istoriją (įskaitant įrankių iškvietimus), įrašą, bendrą atsiskaitymo sumą ir pasirinktinius DI vertinimo bei problemų pranešimus.

Kol skambutis yra tiesioginis, galite jį atidaryti ir klausytis – prisijungiate tyliai, todėl niekas skambučio metu jūsų negirdi. Pradėję klausytis, galite kuždėti: įveskite nurodymą, kuris skambučio metu tiesiogiai perduodamas jūsų agentui; skambinantysis jo niekada negirdi, o agentas jo laikosi realiuoju laiku.

Valdymo skydelyje: Skambučių istorija (/dashboard/call-history) skirta archyvui ir kiekvieno skambučio informacijai; Tiesiogiai – vykstantiems skambučiams. Žr. Peržiūrėkite, klausykitės ir konsultuokite savo skambučius.

API: /v1/calls – sąrašas, nuorašas, istorija, garsas, vertinimas, eksportavimas; /v1/issue-reports.

Klientų portalai#

Kliento portalas yra su prekės ženklu pateikiamas, tik skaitymui skirtas skambučių istorijos rodinys išoriniam klientui. Organizacijos administratoriai pasirenka agentus, kurių skambučiai rodomi, prideda patvirtintų žiūrovų el. pašto adresus, įkelia logotipą ir akcento spalvą bei pasirinktinai patvirtina pasirinktinį domeną. Portalo žiūrovai gali peržiūrėti skambučių informaciją, nuorašus ir prieinamus įrašus negaudami prieigos prie valdymo skydelio.

Valdymo skydelyje: Klientų portalai (/dashboard/client-portals). Žr. Klientų portalai.

API: /v1/client-portals, skirta administratoriaus valdymo sąsajai.

Žiniatinklio valdikliai#

Žiniatinklio valdiklis suteikia jūsų svetainės lankytojams mikrofonu pagrįstą pokalbį su agentu — telefono numerio nereikia. Jis autentifikuojamas naudojant viešąjį raktą (pk_live_...), kuris apribotas pagal kilmę iki jūsų leidžiamų domenų, todėl jį saugu naudoti kliento pusės kode.

Raktai veikia vienu iš dviejų režimų: agent (statiškai susietas su vienu agentu) arba webhook (jūsų serveris parenka konfigūraciją kiekvienam lankytojui — žr. Dinaminė konfigūracija kiekvienam skambučiui). Valdiklio seansai naudoja tą pačią skambučių infrastruktūrą kaip ir telefono skambučiai.

Valdymo skydelyje: Žiniatinklio valdikliai (/dashboard/web-widgets) — kurkite valdiklius, nustatykite režimą ir agentą, tvarkykite leidžiamus domenus ir nukopijuokite įterpimo fragmentą. Žr. Sukurti žiniatinklio valdiklį.

API: /v1/publishable-key, /v1/mic-session ir Widget SDK dokumentacija.

Žinių bazės#

Žinių bazė yra dokumentų rinkinys, kuriame jūsų agentas gali ieškoti skambučio metu, kad pagrįstų savo atsakymus — įkelkite failus, įklijuokite tekstą arba importuokite tinklalapius pagal URL, tada kūrimo priemonėje susiekite žinių bazę su agentu. Agentas užklausia ją naudodamas integruotą paieškos įrankį, kai to reikia pokalbiui.

Valdymo skydelyje: Žinios (/dashboard/knowledge) dokumentų bibliotekai; kūrimo priemonės skiltis Žinios, skirta susieti ją su agentu. Žr. Suteikite savo agentui žinių bazę.

Ryšiai#

Ryšiai leidžia agentams pasiekti išorinį pasaulį. Keturi tipai, viena šoninės juostos grupė:

• Programos (/dashboard/app-connections) — OAuth ryšiai su Slack, HubSpot, Salesforce, Google Calendar, Google Sheets ir Cal.com. Prisijunkite vieną kartą, tada įjunkite konkrečių operacijų įrankius (siųsti Slack pranešimą, atnaujinti arba sukurti HubSpot kontaktą, rezervuoti Cal.com laiką…) bet kuriam agentui. Žr. Prijungti programas.
• API (/dashboard/api-connections) — paverskite bet kurią HTTP API agento veiksmu. Įklijuokite cURL komandą, o DI vedlys parengs įrankio apibrėžtį, arba sukurkite ją rankiniu būdu; mygtukas Bandomoji užklausa prieš diegimą atlieka bandomąjį skambutį. Žr. API ryšiai — valdymo skydelio sąsają /v1/integrations.
• MCP (/dashboard/mcp-connections) — pridėkite Model Context Protocol serverį pagal URL ir leiskite agentui naudoti jo teikiamus įrankius. Žr. Pridėti MCP serverį.
• VoIP (/dashboard/voip-connections) — teikėjo prisijungimo duomenys, skirti naudoti savo telefono numerius. Žr. Prijungti VoIP teikėją.

ThunderPhone taip pat pateikia savo MCP galinį tašką, kad išorinis MCP klientas galėtų išvardyti agentus, tikrinti skambučius ir nuorašus bei atlikti skambučius. Žr. Naudoti ThunderPhone kaip MCP serverį.

API: /v1/integrations, /v1/mcp-servers ir /v1/voip-connections; taip pat žr. Sukurti įrankio integraciją.

Kampanijos#

Kampanija atlieka didelio masto išeinančius skambučius: įkelkite kontaktų CSV, pasirinkite agentą ir skambinančiojo numerį, tada nustatykite skambinimo laiką (dienas ir valandas, atsižvelgiant į laiko juostą), vienalaikiškumą ir pakartotinių bandymų politiką (didžiausią bandymų skaičių ir kurių rezultatų — neatsakyta, balso paštas, nepavyko — bandymai kartojami). Kampanija vykdo sąrašą ir įrašo kiekvieną skambutį į Skambučių istoriją.

Valdymo skydelyje: Kampanijos (/dashboard/campaigns). Žr. Vykdyti išeinančių skambučių kampaniją.

Vienkartiniams programiniams skambučiams: išeinančių skambučių API.

Stebėjimas realiuoju laiku#

Tiesiogiai rodo kiekvieną organizacijoje vykstantį skambutį ir leidžia atidaryti bet kurį iš jų, kad galėtumėte klausytis ir sufleruoti realiuoju laiku. Tai priežiūros vieta: stebėkite, kaip naujas nurodymas sulaukia pirmojo realaus srauto, arba prižiūrėkite vykstančią kampaniją.

Valdymo skydelyje: Tiesiogiai (/dashboard/live). Žr. Stebėti ir prižiūrėti tiesioginius skambučius.

Simuliacijos#

Simuliacija – tai DI skambintojas, realiai kalbantis su jūsų agentu: tas pats telefonijos kelias, tikras nuorašas, tikras vertinimas, todėl galite testuoti prieš diegdami ir po diegimo. Nukreipkite ją į agentą arba telefono numerį, patys parašykite skambintojo scenarijų arba generuokite scenarijus naudodami DI pagal agento nurodymą (įskaitant ribinius atvejus, jei jų paprašysite) ir stebėkite skambutį realiuoju laiku.

Scenarijai grupuojami į rinkinius, kurie nustato minimalų sėkmės rodiklį ir gali blokuoti leidimus CI; regresijos, palyginti su priimta atskaitos būsena, pateikiamos kiekvienam scenarijui.

Valdymo skydelyje: Simuliacijos (/dashboard/simulations), taip pat mygtukas Simuliacija agento kūrimo priemonėje. Žr. Simuliuoti skambutį.

API: /v1/test-calls ir rinkinio vykdyklė – žr. Ištestuoti agentą nuo pradžios iki pabaigos.

Validavimo rinkiniai#

Validavimo rinkinys paverčia tikrus skambučių momentus pakartojamomis vieno ėjimo regresijos patikromis. Kiekviename pavyzdyje išsaugomas pokalbio kontekstas, susijęs skambintojo garso įrašas, pirminis atsakymas ir numatytas elgesys. Atkūrimai vykdomi su dabartiniu agento juodraščiu neatliekant kito skambučio, o diegimo dialoge gali būti rodoma, ar naujausias vykdymas vis dar atitinka tą juodraštį.

Valdymo skydelyje: Validavimo rinkiniai (/dashboard/validation) skirti organizacijos duomenų rinkiniui, o agento kūrimo priemonės skirtukas Validavimas – vykdymams. Žr. Validavimo rinkiniai.

API: /v1/validation-sets ir agento bei pavyzdžio atkūrimo galiniai taškai tame pačiame nuorodų puslapyje.

Eksperimentai#

Eksperimentas atlieka agento konfigūracijų A/B testavimą realiame sraute: apibrėžkite variantus (skirtingus nurodymus, variklius ar nustatymus), padalykite tarp jų srautą ir palyginkite kiekvieno varianto rezultatus. Naudokite jį vietoj rankinio segmentavimo logikos kūrimo žiniatinklio kabliuke.

Valdymo skydelyje: Eksperimentai (/dashboard/experiments) ir skirtukas A/B agento kūrimo priemonėje. Žr. Eksperimentai (A/B testavimas).

Problemos#

Problema – tai pažymėta konkretaus skambučio klaida, kurią užregistravo žmogiškasis vertintojas arba aptiko DI vertinimas. Problemos turi kritiškumą, šaltinį ir būseną, o puslapis Problemos yra pirminio vertinimo eilė: filtruokite, nagrinėkite probleminį skambutį ir stebėkite taisymus.

Valdymo skydelyje: Problemos (/dashboard/issues), taip pat žymėjimas kiekvienam skambučiui Skambučių istorijoje. Žr. Problemų pirminis vertinimas.

API: /v1/issue-reports.

Ataskaitos#

Ataskaita atsako į natūralios kalbos klausimą apie jūsų skambučių duomenis („Kokios buvo trys pagrindinės priežastys, dėl kurių skambintojai praėjusią savaitę prašė žmogaus?“) su DI parašyta analize, apribota jūsų pasirinktais agentais ir datų intervalu.

Valdymo skydelyje: Ataskaitos (/dashboard/reports). Žr. Ataskaitos.

Stebimumas#

Stebimumas yra metrikų sritis: skambučių apimtis, rezultatai ir kokybė laikui bėgant, filtruojami pagal agentą ir laikotarpį, su eksportu tolesnei analizei.

Valdymo skydelyje: Stebimumas (/dashboard/observability). Žr. Stebimumas.

Įspėjimai#

Įspėjimo taisyklė stebi metriką (sėkmės rodiklį, nesėkmių rodiklį, vidutinį balą, skambučių apimtį, rinkinio regresijas) per laikotarpį ir suaktyvinama, kai ji viršija jūsų slenkstį. Pranešimai siunčiami el. paštu ir į Slack, taip pat suaktyvinamas alert.triggered įvykis jūsų žiniatinklio kabliuko galiniams taškams.

Valdymo skydelyje: Organizacija → Įspėjimai. Žr. Įspėjimai.

Žiniatinklio kabliukai#

Kai skambučio metu ir po jo vyksta tam tikri veiksmai, ThunderPhone siunčia HTTP POST žiniatinklio kabliukus į jūsų serverį. Du pristatymo modeliai:

• Žiniatinklio kabliukų galiniai taškai (rekomenduojama): valdykite daug URL adresų /v1/developer/webhook-endpoints su atskirų galinių taškų slaptaisiais raktais ir atskirų galinių taškų įvykių prenumeratomis.
• Senas vieno URL žiniatinklio kabliukas: vienas URL adresas organizacijai. Valdomas per /v1/webhook arba skiltyje Organizacija → Bendrieji. Paliktas dėl atgalinio suderinamumo.

Įvykiai skirstomi į dvi klases:

• Blokuojantys įvykiai tikisi, kad jūsų serveris atsakys konfigūracija, kuri formuoja vykstantį skambutį — tai įeinančio skambučio įvykiai (telephony.incoming / web.incoming). Atsakymui turite iki 10 sekundžių; pasibaigus laikui skambutį tvarko statiškai priskirtas agentas.
• Neblokuojantys įvykiai yra siunčiami kaip pranešimai be laukiamo atsakymo ir pakartotinai bandomi taikant eksponentinį delsos didinimą — žr. pristatymo semantiką.

Kiekvienoje užklausoje pateikiamas HMAC-SHA256 parašas X-ThunderPhone-Signature. Žr. parašo tikrinimą.

Funkcijų įrankiai#

Funkcijos įrankis yra HTTP galinis taškas, kurį jūsų agentas gali iškviesti pokalbio metu. ThunderPhone pateikiate OpenAI stiliaus funkcijos schemą ir galinio taško URL; agentas nusprendžia, kada jį iškviesti, o ThunderPhone iš savo serverių pateikia pasirašytą HTTP užklausą ir perduoda rezultatą agentui.

Agentai taip pat turi integruotas skambučio galimybes — skambučio peradresavimą, klaviatūros (DTMF) įvesties siuntimą, skambučio užbaigimą, laukimo sulaikius skambutį funkciją — kurias įjungiate paprastomis raginimo eilutėmis, o ne įrankių apibrėžimais.

Valdymo skydelyje: kūrimo priemonės skiltis API ryšiai (žr. ryšius).

API: /v1/integrations ir Funkcijų įrankių specifikacija.

Komanda ir vaidmenys#

Kiekviena organizacija turi narių sąrašą su dviem vaidmenimis: Nariai kuria ir naudoja agentus; Administratoriai taip pat valdo komandą ir atsiskaitymą. Pakvieskite el. paštu — kvietimų galiojimas baigiasi po 7 dienų, juos galima atšaukti; ⋯ meniu nario eilutėje pakeičia vaidmenį arba pašalina narį. Vienkartinį prisijungimą galima sukonfigūruoti visai organizacijai — žr. SSO.

Valdymo skydelyje: Organizacija → Bendrieji. Žr. Pakvieskite savo komandą.

API: /v1/members, /v1/invites.

Atsiskaitymas#

ThunderPhone yra iš anksto apmokamas. Kiekviena organizacija turi balansą JAV doleriais; už skambučius iš jo nurašoma pagal agento minutės tarifą (variklio pakopa ir papildomi mokesčiai — kūrimo priemonė, keičiant nustatymus, tiesiogiai rodo bendrą tarifą, o pasirinktos papildomos kalbos prideda 3 ct./min.). Kai balansas pasiekia nulį, įeinantys skambučiai atmetami, o siunčiami skambučiai grąžina 402 Payment Required.

Papildykite balansą rankiniu būdu arba įjunkite automatinį papildymą su balanso riba, papildymo suma ir pasirinktiniu mėnesio išlaidų limitu — kad skambutis niekada nenutrūktų sakinio viduryje.

Valdymo skydelyje: Organizacija → Atsiskaitymo nustatymai ir Atsiskaitymo istorija. Žr. Pridėkite lėšų ir įjunkite automatinį papildymą, taip pat išsamų kainodaros aprašą.

API: /v1/billing.

Programėlėje esantis pagalbininkas#

Valdymo skydelyje yra integruotas pagalbininkas — paklauskite jo „kaip atlikti X“, ir jis atsakys remdamasis šia dokumentacija, pasiūlys nuoseklias instrukcijas su paryškintais tikraisiais valdikliais bei galės pakartoti bet kurią iš Interaktyvios apžvalgos. Tai greičiausias būdas rasti šiame puslapyje minimą valdiklį. Žr. Klauskite programėlėje esančio pagalbininko.

Sudedant viską kartu#