Beépített eszközök

Utasítsa a ThunderPhone ügynökeit a hívások befejezésére, a hívók átirányítására, a billentyűzetek használatára, várakoztatásra, tudásanyagok keresésére, hangok lejátszására és e-mailek küldésére.

A beépített eszközök lehetővé teszik, hogy egy ügynök gyakori hívásműveleteket végezzen el saját API csatlakoztatása nélkül. A legtöbb automatikusan elérhető; az e-mail, a hangok és a tudáskeresés csak a kapcsolódó beállítás vagy forrás konfigurálása után jelenik meg. Az ügynök promptjában adja meg, mikor használja az egyes műveleteket.

end_call#

Lezárja az aktuális hívást, amikor a prompt erre utasítja a modellt. Alapértelmezés szerint elérhető, és nincs ügynökbeállítása.

Írja a feltételt és az esetlegesen szükséges elköszönést a promptba:

When the caller confirms they need nothing else, say goodbye and end the call.

Egy modell által befejezett hívás end_reason: "ai_hangup" értéket kap, beleértve azt is, amely a hívásidő-korlátra vonatkozó figyelmeztetés után ér véget. A hívás csak akkor ér véget max_duration értékkel, ha előbb eléri az időkorlátot, és balance_exhausted értékkel, ha az előre feltöltött egyenleg elfogy.

transfer_call#

Telefonáló átirányítása a modell által megadott rögzített számra. A hideg átirányítás azonnali. A szűrt meleg átirányítás a felek összekapcsolása előtt privát módon felhívja a célállomást. A meleg átirányításhoz ellenőrzött, importált VoIP-szám szükséges, amely képes kimenő hívásokat kezdeményezni.

Adja meg a célállomás számát és a pontos útválasztási feltételt a promptban:

If the caller asks for billing, transfer them to +15551234567.

A sikeres hideg átirányítás end_reason: "ai_transfer" értékkel rendelkezik; a befejezett meleg átadás end_reason: "ai_warm_transfer" értékkel rendelkezik. Sikertelen meleg kísérlet esetén a vezérlés visszakerül az ügynökhöz, ezért a hívás későbbi lezárása határozza meg a lezárási okát. Nem telefonos munkamenetekben az átirányítási kérés ehelyett lezárja a munkamenetet.

A kezelőfelületi és API-beállításokról, útválasztásról, szűrésről, hibakezelésről, korlátokról és tesztelésről lásd a Hívások átirányítása útmutatót.

send_keypad_input#

DTMF (telefonbillentyűzet) számjegyeket (0–9, * és #) küld egy telefonvonalra. A modell ezt IVR-ben, vagyis abban az automatizált menüben való navigálásra használja, amely arra kéri a hívókat, hogy gombokat nyomjanak meg. Alapértelmezés szerint elérhető, és nincs ügynökbeállítása.

Mondja meg a modellnek, mely menükben navigálhat, és honnan származnak a kért értékek. Ne kérje meg, hogy találgassa a menüopciókat:

Follow the phone menu for account status. Press a key only after the menu
states what that key does. Enter the account number supplied by the caller.

A platform eltávolítja a nem támogatott karaktereket, és a megfelelő számjegyeket sorrendben küldi el. Ha nem marad megfelelő számjegy, vagy a hívás nem tud billentyűzetbemenetet küldeni, a rendszer visszaadja a hibát az ügynöknek, hogy helyreállhasson.

no_response#

Csendben tartja az AI-ügynököt, amíg egy automatizált rendszer még beszél vagy arra kéri, hogy tovább figyeljen, illetve amíg a hívó hangosan gondolkodik („ööö, hadd nézzem”) vagy valaki máshoz fordul beszélni. Amikor a hívó arra kéri az AI-ügynököt, hogy várjon, amíg valamit elintéz („egy pillanat”, „hadd ellenőrizzem”, „tud várni egy pillanatot?”), és nem ad más megválaszolandó információt, az AI-ügynök csak annyit mond: „Rendben.” (nem azt, hogy „Nyugodtan, ráér.”), majd megvárja, amíg a hívó ismét megszólal. Az AI-ügynök csend közbeni visszakérdezései továbbra is működnek, és mindig elhangzanak, ha a vonal csendben marad. Ez nem élő személy üdvözlésére, kérdésére vagy tényleges várakoztatási sorra szolgál. Alapértelmezés szerint elérhető, és nincs hozzá AI-ügynök-beállítás.

Ha a prompt meghatározza, mit mondjon az AI-ügynök, amikor a hívó egy pillanatot kér, a prompt élvez elsőbbséget.

Általában elegendő a beépített leírás. Sok IVR-t használó hívásoknál erősítse meg a határt a promptban:

Stay silent while a phone menu is still speaking. Answer a live person as soon
as they address you.

Ez a művelet nem zárja le a hívást.

wait_on_hold#

Csendes várakoztatási állapotba helyez egy kimenő hívásban működő ügynököt, amíg egy élő személy vissza nem tér. A modell csak akkor használja, miután a másik fél kifejezetten közölte, hogy várakoztatásba helyezi az ügynököt. Kimenő hívásoknál automatikusan elérhető, és nincs hozzá irányítópulti beállítás.

If a person explicitly puts you on hold, wait silently. When they return,
continue from the question you were discussing.

Ne utasítsa az ügynököt arra, hogy IVR „kérem, várjon” üzenetéhez használja. A várakoztatás alapértelmezés szerint legfeljebb 15 percig tart. Normál kimenő hívásoknál a POST /v1/call pozitív egész max_hold_seconds értéket fogad el; a beágyazott Realtime a max_hold_seconds értékét 10–900 másodpercre korlátozza. Ha a személy visszatér, az ügynök a hívás befejezési okának módosítása nélkül folytatja. Ha a korlát lejár, a platform a következővel fejezi be a hívást: end_reason: "ai_hangup".

search_knowledge_base#

Megkeresi az ügynökhöz csatolt dokumentumokat, és releváns részleteket ad vissza. Csatoljon tudásbázist vagy különálló tudásdokumentumokat az engedélyezéséhez, majd mondja meg a modellnek, mely válaszoknak kell ezekből a forrásokból származniuk:

Search the knowledge base before answering policy questions. If the first
search is inconclusive, try once more with different key terms.

Ha a keresés sikertelen, az eredmény visszakerül az ügynökhöz. Az irányítópulti és API-beállításokról lásd: Tudásbázis.

play_sound#

Az ügynök konfigurált értesítési hangját játssza le ugyanabban a körben elhangzott bármely beszéd után. Az irányítópulton állítsa a Speciális → Eszközhang értékét Chime, Ding vagy Beep értékre, majd telepítse az ügynököt. A Nincs eltávolítja az eszközt.

Az Agents API használatával állítsa a play_sound_asset értékét "chime", "ding" vagy "beep" értékre, majd telepítse. Az eszköz letiltásához állítsa "" értékre.

After confirming that an appointment was saved, say "You're all set" and play
the notification sound.

A lejátszási hiba visszakerül az ügynökhöz, és nem fejezi be a hívást.

send_email#

Egyszerű szöveges e-mailt küld az ügynök tulajdonosa által konfigurált egyetlen címzettnek. A modell adja meg a tárgyat és a törzset. Soha nem lát címzettparamétert, és nem választhatja ki vagy módosíthatja a címet.

Az irányítópulton engedélyezze a Speciális → E-mail küldése lehetőséget, mentsen egy címzettcímet, majd telepítse az ügynököt. Az Agents API használatával állítsa be a send_email_enabled: true értéket és egy nem üres send_email_recipient értéket, majd telepítse. Határozza meg a promptban az eseményindítót és a kötelező tartalmat:

When the caller asks to leave a message, collect their name, callback number,
and message. Read the details back for confirmation, then email them.

Egy hívás legfeljebb három e-mail-küldést kísérelhet meg. Minden tárgy legfeljebb 300 karakterből, minden törzs pedig legfeljebb 20 000 karakterből állhat. A hiányzó konfiguráció, az érvénytelen tartalom, a hívásonkénti korlát és a kézbesítési hibák visszakerülnek az ügynökhöz. A sikertelen kézbesítés is felhasznál egyet a három kísérletből.

Széles körű telepítés előtt teszteljen ellenőrzött címzettel. A böngészős Talk és a szimulációk valódi e-mailt küldenek; nincs próbaüzemi mód.

Kompatibilitási megjegyzés#

A Speciális → Megszakíthatatlan tájékoztatások beállítás és a régi speak_uninterruptible_enabled mező kompatibilitási okokból megmarad, de engedélyezésüknek nincs hatása. Hagyja kikapcsolva a beállítást; egyetlen prompt sem aktiválhatja ezt az eszközt.

Kötelező, hívásnyitó tájékoztatóhoz használja a Hozzájárulási közlemény lehetőséget. Ez szó szerint lejátszásra kerül a normál beszélgetés előtt, és nem szakítható meg. Lásd: Hívásrögzítési hozzájárulásra vonatkozó jogszabályok.

Beépített eszközök tesztelése és figyelése#

A promptok, a tudásbázis-keresés, a hangok és az e-mail ellenőrzéséhez használja a böngészős Talkot vagy egy szimulációt. Ezek a környezetek nem képesek reprodukálni a telefonhálózati viselkedést. A billentyűzetes navigációt és a várakoztatást kimenő telefonhívásban tesztelje, és egy teljes meleg átadást is teszteljen valódi hívásban, megfelelő importált VoIP-szám használatával. A Realtime támogatása a fenti táblázatban látható módon korlátozott.

Hívások, díjszabás és webhookok#

A beépített műveletek használatánkénti eszközdíj nélkül érhetők el. A szokásos hívás- és szolgáltatói díjak továbbra is érvényesek; lásd: Díjszabás. Hívásaik és eredményeik megjelenhetnek a befejezett átiratban, de nem küldenek telephony.tool vagy web.tool eseményeket. Ezek az események a felhasználó által definiált függvényekhez tartoznak. Csak a befejezett bontás vagy átirányítás módosítja a hívás end_reason értékét; az egyéb hibák az AI-ügynökhöz kerülnek vissza. A hívási rekordért lásd a Befejezési webhookok oldalt.