ThunderPhone v3 je dostupan.Postavite sve sami, već od 2 ¢/min.Pročitajte objavu

Using the dashboard

Koraci agenta i prijenosi poziva

Podijelite agenta na korake s vlastitim uputama, alatima i prikupljenim vrijednostima te tijekom poziva preusmjeravajte pozive između agenata.

Jedan prompt modelu odjednom daje cijeli zadatak. Koraci mu daju jednu fazu poziva odjednom: svaki korak ima vlastite upute, vlastite alate, neobaveznu rečenicu koja se izgovara doslovno i vrijednosti koje mora prikupiti prije nego što nastavi dalje. Predaje omogućuju drugom agentu u Vašoj organizaciji da preuzme poziv usred razgovora, uz očuvan prijepis, tako da pozivatelj ne mora ponavljati ono što je već rekao.

Svaki agent počinje kao jedan prompt. Ništa se ne mijenja dok ne dodate korake ili predaje.

Koraci ili jedan prompt?

Koristite korake kadaZadržite jedan prompt kada
Poziv ima faze koje se moraju odvijati redom: prvo provjera, zatim rezervacija.Razgovor je otvorenog tipa: česta pitanja, recepcija, opća podrška.
Vrijednost se mora prikupiti prije nego što agent nastavi dalje.Ništa se ne mora prikupiti fiksnim redoslijedom.
Pravilo se nikada ne smije zaobići, poput „pozivatelji mlađi od 18 godina preusmjeravaju se skrbniku”.Procjena modela dovoljno je dobra za svaku granu.
Pretraživanje se mora pokrenuti u određenom trenutku poziva.Alati se mogu pozvati kad god pozivatelj zatraži.
Dio poziva pripada drugom agentu, s vlastitim promptom i glasom.Jedna persona rješava sve.

Koraci nisu skriptirano telefonsko stablo. Unutar koraka model vodi razgovor kao i s jednim promptom. Korak određuje na čemu radi, koje alate može koristiti i što mu je potrebno prije nego što može izaći iz njega.

Kako se gradi agent s koracima

Kada agent ima korake, njegov prompt sadržava zajedničke upute: personu i pravila koja vrijede u svakom koraku. Svaki korak povrh toga dodaje vlastite upute. U svakom potezu model vidi zajedničke upute, naziv i upute trenutačnog koraka te dosad prikupljene vrijednosti.

U alatu za izradu prebacite agenta s Jedinstveni prompt na Koraci. Dobit ćete karticu za svaki korak s njegovim nazivom, uputama, rečenicom za izgovaranje, alatima, prikupljenim vrijednostima i prijelazima, odabirač predaja te graf toka koraka samo za čitanje. Povratak na jedan prompt nudi objedinjeni prompt koji spaja zajedničke upute i svaki korak.

Putem API-ja, steps i handoffs polja su na agentu. Kao i svako polje agenta, PATCH ih postavlja u nacrt; POST /v1/agents/{agent_id}/deploy objavljuje ih. Slanje "steps": null vraća agenta na jedan prompt. Testni pozivi i Razgovor koriste nacrt.

Polja koraka

PoljeZnačenje
idObavezno. Mala slova, znamenke i podvlake, počinje slovom, do 40 znakova. Jedinstveno unutar agenta.
nameObavezan naziv za prikaz, od 1 do 80 znakova.
instructionsObavezno, do 20 000 znakova. Podržava {{var}} varijable poziva, kao i prompt.
sayNeobavezna rečenica koja se izgovara doslovno pri ulasku u korak, do 1 000 znakova. Podržava {{var}}.
toolsnull koraku daje svaki alat povezan s agentom. Popis ograničava korak na te alate, prema nazivu. Ugrađene radnje poput end_call i transfer_call slijede postavke agenta u svakom koraku.
collectDo 20 vrijednosti koje korak prikuplja. Svaka ima name, type, description i required (zadano true).
on_enter_toolNeobavezan naziv alata koji se automatski poziva pri ulasku u korak. Pogledajte Webhook koraci.
transitionsPoredani popis mjesta na koja korak može prijeći. Pogledajte Prijelazi.
global_whenNeobavezno. Omogućuje da korak bude dostupan iz bilo kojeg koraka. Pogledajte Globalni koraci.
voiceNeobavezan ID glasa za ovaj korak. Zanemaruje se kada agent koristi prilagođenu konfiguraciju glasa.

Sam graf je {"start_step": "<step id>", "steps": [...]}. Poziv počinje u start_step.

Prijelazi

Svaki prijelaz ima to, ID koraka i točno jedno od sljedećeg:

  • when: običan jezik, a model odlučuje. Agent dobiva ugrađeni alat go_to_step koji navodi korake u koje može prijeći, pri čemu je svaki when razlog za njegov odabir.
  • condition: pravilo nad prikupljenim vrijednostima, a kôd odlučuje. Model ga ne može preskočiti ni zaobići razgovorom.
  • "always": true: nastavite bez provjere. Kôd odlučuje prvi: čim se uđe u korak ili kada se prikupe njegove obavezne vrijednosti, prvi podudarni prijelaz condition ili always ima prednost, prije nego što model može odabrati when. Zato stavite always nakon uvjeta kao njihovu pričuvnu opciju ili samostalno kako biste izravno povezali korak sa sljedećim. Korak s always nikada ne čeka odabir when.

condition je {"value": <collected name or dotted path>, "op": <op>, "target": <literal>}:

opIstinito kada vrijednost
eq, nejednaka je ili nije jednaka vrijednosti target
lt, lte, gt, gtemanja je od, nije veća od, veća je od ili je najmanje target
in, not_injest ili nije jedna od vrijednosti na popisu target
exists, missingjest ili nije prikupljena (bez target)

eq, ne, in i not_in uspoređuju tekst bez obzira na velika i mala slova nakon uklanjanja razmaka na početku i kraju. Brojevi se uspoređuju kao brojevi, a datumi kao nizovi YYYY-MM-DD. Vrijednost koja nikada nije prikupljena čini svaki operator netočnim, osim missing.

Napišite when i global_when kao uvjet, primjerice "Pozivatelj želi rezervirati termin", a ne kao nešto što treba izgovoriti. Agent ih vidi kao interne bilješke za usmjeravanje i upućen je da ih nikada ne čita naglas niti spominje da mijenja korake.

Kada model pozove go_to_step:

  1. Svaka vrijednost required u koraku mora biti prisutna. Ako neka nedostaje, modelu se navodi koja je to vrijednost te je traži od pozivatelja.
  2. Vrijednosti se pohranjuju.
  3. Prijelazi condition i always provjeravaju se redom. Prvo podudaranje ima prednost.
  4. U suprotnom agent prelazi na korak koji je model odabrao.
  5. Ako se ništa ne podudara, a model nije naveo nijedan korak, agent ostaje na trenutačnom koraku.

Prijelaz na globalni korak iznimka je: pozivatelj je promijenio temu, pa se prijelaz izvršava čak i ako trenutačnom koraku još nedostaju obavezne vrijednosti i prije provjere uvjeta tog koraka.

Prijelazi condition i always provjeravaju se i svaki put kada se uđe u korak, pa se niz koraka o kojima odlučuje kôd izvršava odjednom. Lanac se zaustavlja:

  • na koraku koji je već posjetio tijekom ovog izvođenja;
  • nakon 8 skokova;
  • na koraku koji još ima obavezne vrijednosti za prikupiti, osim ako korak ima on_enter_tool (webhook korak uvijek usmjerava prema rezultatu).

Izgovara se samo redak say koraka na kojem se lanac zaustavi.

Korak bez prijelaza je završni. Agent ondje završava te prekida ili preusmjerava poziv svojim uobičajenim ugrađenim radnjama.

Prikupljanje vrijednosti

Navedite što je potrebno koraku u collect. Model prosljeđuje vrijednosti kada pozove go_to_step, a one ostaju dostupne do kraja poziva.

typeSadrži
stringBilo koji tekst
numberBroj
booleantrue ili false
dateDatum u obliku YYYY-MM-DD

Prikupljene vrijednosti sadržaj su poziva. Prikazuju se uz transkript poziva i podliježu istim pravilima zadržavanja, brisanja i redakcije. Kada je snimanje poziva agenta isključeno, prikupljene vrijednosti ne pohranjuju se niti šalju u webhookovima; vremenska crta koraka i dalje se pohranjuje. Pogledajte Gdje to vidjeti u pozivu.

Izgovorene rečenice

say se izgovara točno kako je napisano kada agent uđe u korak. Model zatim nastavlja u novom koraku u istom odgovoru, znajući da je rečenica upravo izgovorena, pa je ne ponavlja. Upotrijebite say za pozdrave, obavezne obavijesti i nepromjenjive formulacije, a ostatak odgovora prepustite modelu.

say početnog koraka uvodna je rečenica agenta kada on prvi progovori, nakon svake obavijesti o privoli. Kada pozivatelj prvi progovori, ona otvara prvi odgovor agenta osobi, nikada IVR-u ili pozdravnoj poruci govorne pošte.

say koraka ne izgovara se ponovno kada se poziv vrati na njega putem __previous__ ili povratnog prijenosa. Napišite ga onako kako treba zvučati: slovkajte sve što bi glas mogao pogrešno pročitati. Izgovorene rečenice podržavaju varijable poziva {{var}}, ali ne i prikupljene vrijednosti.

Koraci web-dojavnika

Postavite on_enter_tool na jedan od alata agenta i on se pokreće čim se uđe u korak, bez čekanja na model. Njegovi argumenti prikupljene su vrijednosti čiji nazivi odgovaraju nazivima parametara alata. Rezultat se pohranjuje kao prikupljena vrijednost nazvana <tool>_result, skraćena na 4 KB, a prijelazi condition i always koraka odmah se provjeravaju, tako da pretraga može usmjeriti poziv na temelju vlastitog rezultata.

Pohranjena vrijednost ima dva polja:

PoljeSadrži
statusHTTP statusni kôd koji je vratio vaš krajnji punkt.
responseTijelo odgovora.

Usmjeravajte prema polju tijela pomoću lookup_account_result.response.<field>, a prema statusnom kôdu pomoću lookup_account_result.status.

Pretraga se izvršava najviše 8 sekundi ili do vlastitog vremenskog ograničenja alata, ako je ono kraće. Ako traje dulje od 3 sekunde, agent izgovara kratku rečenicu kako pozivatelj ne bi ostao u tišini. Ako vaš krajnji punkt vrati status 400 ili viši ili ne odgovori na vrijeme, agent pozivatelju kaže da to trenutačno nije mogao provjeriti i nastavlja s onime što može učiniti.

Globalni koraci

Korak s global_when može se dosegnuti iz bilo kojeg koraka kad god je taj opis ispunjen. Model odlučuje, kao i kod when. Upotrijebite ga za teme koje pozivatelj može pokrenuti u bilo kojem trenutku: pitanja o naplati, zahtjev za čovjekom, pritužbu.

Prijelaz s "to": "__previous__" u globalnom koraku vraća poziv na korak koji je bio aktivan prije njega, tako da pozivatelj nastavlja tamo gdje je stao. Korak se nastavlja: njegov on_enter_tool ne pokreće se ponovno, njegov say se ne ponavlja, a agent ga nastavlja bez ponovnog pokretanja.

Prosljeđivanja

handoffs navodi druge agente u Vašoj organizaciji koji mogu preuzeti poziv:

[{"agent_id": 413, "when": "The caller asks about billing or a refund"}]

Agent dobiva ugrađeni alat hand_off s tim agentima i razlozima. Kao i kod prijelaza, svaki when interna je napomena za usmjeravanje i nikada se ne izgovara.

Kada proslijedi poziv, agent izgovara jednu kratku rečenicu koja pozivatelju govori kamo ide, primjerice „Naravno, preusmjerit ću Vas našem timu za naplatu”, svojim glasom. Zatim prompt, koraci, alati i glas ciljnog agenta preuzimaju poziv, koji se nastavlja s istim transkriptom. Novi agent ukratko se predstavi i odgovori na posljednji zahtjev pozivatelja; ne najavljuje prijenos. Baza znanja ciljnog agenta od tada je dostupna.

Kada poziv prvi put dođe do agenta, započinje u start_step tog agenta: pokreće se on_enter_tool koraka i izgovara se njegov say. Kada se poziv vrati agentu kojeg je već posjetio, taj agent nastavlja u koraku na kojem je bio, bez pokretanja on_enter_tool, ponavljanja svojeg say ili ponovnog predstavljanja. Prikupljene vrijednosti dijele svi agenti u pozivu.

  • Ciljni agent mora biti u istoj organizaciji, a agent ne može proslijediti poziv samome sebi.
  • Sve na razini poziva ostaje kod agenta koji je odgovorio: proizvod, jezici, tko prvi govori, govorna pošta, obavijest o privoli i svaka druga postavka poziva.
  • Ciljni agenti mogu dalje prosljeđivati poziv, uključujući natrag. Jedan poziv može dosegnuti najviše 8 agenata.
  • Testni poziv pokreće nacrt agenta kojeg testirate. Agenti kojima on prosljeđuje poziv pokreću svoje objavljene verzije.
  • Ako dva agenta imaju alat s istim nazivom i različitim definicijama, za poziv se zadržava samo jedan, a uvijek prednost ima alat agenta koji je odgovorio. Alat za izradu upozorava Vas kada spremate.
  • Agent može imati prosljeđivanja bez koraka. Koristi se cijeli njegov prompt bez izmjena.

go_to_step i hand_off rezervirani su za agente s koracima ili prosljeđivanjima, pa Vaši alati ne mogu koristiti ta imena.

Gdje to vidjeti u pozivu

Otvorite poziv u odjeljku Povijest poziva. Vremenska crta koraka pokraj transkripta prikazuje svaki korak u koji je poziv ušao i zašto, a uz nju su navedene prikupljene vrijednosti.

Objekt poziva i webhook po završetku poziva (telephony.complete / web.complete) sadrže iste podatke kao steps_trace i collected_values. Oboje nedostaje u pozivima bez koraka.

"steps_trace": [
  {"t_ms": 0, "agent": "a412", "step": "greet", "via": "start"},
  {"t_ms": 51230, "agent": "a412", "step": "verify", "via": "model"},
  {"t_ms": 98410, "agent": "a412", "step": "minor", "via": "condition"}
],
"collected_values": {"full_name": "Dana Reyes", "dob": "2010-04-02", "age": 15}

agent je a iza kojeg slijedi ID agenta. via navodi što je premjestilo poziv:

viaZnačenje
startPoziv je započeo u ovom koraku.
modelModel je odabrao korak putem go_to_step, when ili global_when.
conditionPrijelaz condition ili always se podudarao.
on_enterPrijelaz se podudarao s rezultatom koraka webhooka.
handoffDrugi agent preuzeo je poziv.

Gdje se koraci pokreću

Koraci se izvorno pokreću na svakom agentu (i na starijim vrijednostima proizvoda), u dolaznim, odlaznim i kampanjskim pozivima, testnim pozivima te web i widget pozivima.

Posvuda drugdje agent i dalje radi, samo bez strukture: pokreće spojeni prompt koji redom objedinjuje zajedničke upute i svaki korak. To obuhvaća:

  • Realtime sesije, uključujući sesije za spremljenog agenta;
  • umetnute konfiguracije koje vraća webhook za dinamičku konfiguraciju poziva. Webhook koji vraća agent_id koristi korake tog agenta.

Ograničenja

OgraničenjeVrijednost
Koraci po agentu100
Prikupljene vrijednosti po koraku20
Odredišta predaje po agentu8
Agenti dostupni u jednom pozivu8
Veličina JSON-a steps200 KB
instructions koraka20.000 znakova
Redak say1.000 znakova
Pohranjeni rezultat on_enter_tool4 KB

Spremanje koje krši pravilo vraća 400 s putanjom neispravnog polja, kao što je steps.steps[2].transitions[0].to. Nazivi alata u tools i on_enter_tool moraju biti alati priloženi agentu.

Jezici po koraku, skriptirani koraci koji preskaču model i prikupljene vrijednosti unutar redaka say nisu podržani.

Uvezeni agenti

Uvoz iz Retella, Blanda, Vapija ili ElevenLabsa prenosi agente s više promptova, tokove, putanje i radne tijekove kao korake, a timove i prijenose agenata kao predaje između uvezenih agenata. Stranica za pregled prikazuje oboje prije uvoza.

Primjer: prijem pacijenta u stomatološkoj ordinaciji

Tri koraka redom: pozdravite, prikupite podatke o pacijentu, zakažite termin.

{
  "prompt": "You are Ava, the front desk assistant at Acme Dental. Be warm and brief. Ask one question at a time.",
  "steps": {
    "start_step": "greet",
    "steps": [
      {
        "id": "greet",
        "name": "Greeting",
        "instructions": "Greet the caller and ask how you can help.",
        "say": "Thanks for calling Acme Dental, this is Ava. How can I help you today?",
        "tools": null,
        "collect": [],
        "transitions": [
          {"to": "details", "when": "The caller wants to book an appointment"}
        ]
      },
      {
        "id": "details",
        "name": "Patient details",
        "instructions": "Ask for the caller's full name, date of birth and the reason for the visit. Read the date of birth back and ask the caller to confirm it.",
        "tools": null,
        "collect": [
          {"name": "full_name", "type": "string", "description": "Caller's full name", "required": true},
          {"name": "dob", "type": "date", "description": "Date of birth", "required": true},
          {"name": "reason", "type": "string", "description": "Reason for the visit", "required": true},
          {"name": "new_patient", "type": "boolean", "description": "First visit to the practice", "required": false}
        ],
        "transitions": [
          {"to": "book", "when": "The caller has confirmed their details"}
        ]
      },
      {
        "id": "book",
        "name": "Book",
        "instructions": "Offer the two earliest open slots from book_slot and book the one the caller picks. Confirm the date and time, then say goodbye and end the call.",
        "tools": ["book_slot"],
        "collect": [],
        "transitions": []
      }
    ]
  }
}

Postavite ga u pripremno okruženje pomoću PATCH /v1/agents/{agent_id}, isprobajte ga pomoću Razgovarajte, a zatim ga objavite. Korak details ne može se predati koraku za zakazivanje dok se ne prikupe ime, datum rođenja i razlog; new_patient nije obavezan.

Primjer: grana s dobnom granicom

Model može razgovarati sa svakim, ali kod odlučuje kome se zakazuje termin. Prikupite dob, a zatim prema njoj usmjerite poziv prije nego što se razmotri vlastiti odabir modela.

{
  "id": "verify",
  "name": "Verify age",
  "instructions": "Ask for the caller's age.",
  "tools": null,
  "collect": [
    {"name": "age", "type": "number", "description": "Caller's age in years", "required": true}
  ],
  "transitions": [
    {"to": "guardian", "condition": {"value": "age", "op": "lt", "target": 18}},
    {"to": "book", "when": "The caller has given their age"}
  ]
}

Pozivatelj koji kaže petnaest ide na guardian, bez obzira na odluku modela. Svi ostali idu na book. Oba su obični koraci na drugom mjestu u grafu.

Primjer: korak webhooka za pretraživanje računa

Pozivatelj daje broj računa, pretraživanje se pokreće pri ulasku u sljedeći korak, a njegov rezultat odabire putanju. Koraci not_found, collections i support izostavljeni su radi sažetosti.

[
  {
    "id": "identify",
    "name": "Identify",
    "instructions": "Ask for the caller's account number and read it back digit by digit.",
    "tools": null,
    "collect": [
      {"name": "account_number", "type": "string", "description": "Account number", "required": true}
    ],
    "transitions": [
      {"to": "lookup", "when": "The caller has confirmed their account number"}
    ]
  },
  {
    "id": "lookup",
    "name": "Look up account",
    "instructions": "Tell the caller what you found on their account and ask how you can help.",
    "tools": ["lookup_account"],
    "collect": [],
    "on_enter_tool": "lookup_account",
    "transitions": [
      {"to": "not_found", "condition": {"value": "lookup_account_result.response.found", "op": "eq", "target": false}},
      {"to": "collections", "condition": {"value": "lookup_account_result.response.account_status", "op": "in", "target": ["past_due", "suspended"]}},
      {"to": "support", "when": "The caller needs help with an active account"}
    ]
  }
]

lookup_account prima account_number jer njegov parametar ima taj naziv. Ako tijelo odgovora sadrži "found": false, poziv prelazi na not_found. Ako je njegov account_status past_due ili suspended, prelazi na collections. Aktivan račun ostaje u lookup, gdje model pomaže i nastavlja na support. Da biste neuspješno pretraživanje poslali u zaseban korak, najprije dodajte uvjete za status: odgovor s pogreškom pohranjuje svoj statusni kod, pa ga {"value": "lookup_account_result.status", "op": "gte", "target": 400} prepoznaje, a vremensko ograničenje ili izostanak odgovora pohranjuje "error", pa {"value": "lookup_account_result.status", "op": "eq", "target": "error"} prepoznaje to stanje.

Primjer: od recepcije do naplate

Dva agenta. Recepcija (agent 412) odgovara na svaki poziv i pitanja o naplati predaje agentu za naplatu (agent 413) s vlastitim upitom, alatima i glasom.

Na recepciji:

{
  "handoffs": [
    {"agent_id": 413, "when": "The caller asks about a bill, a payment or a refund"}
  ]
}

Na agentu za naplatu, kako bi mogao vratiti pozivatelja:

{
  "handoffs": [
    {"agent_id": 412, "when": "The billing question is resolved and the caller needs something else"}
  ]
}

Recepcija izgovara kratku rečenicu poput "Spojit ću vas s našim timom za naplatu", a agent za naplatu se predstavi i nastavlja razgovor ondje gdje ga je recepcija prekinula. Kada naplata vrati poziv, recepcija nastavlja ondje gdje je stala, bez ponovnog pozdravljanja pozivatelja. Proizvod poziva, jezici, obavijest o privoli i ostale postavke poziva ostaju na recepciji, jer je ona odgovorila.

Ako naplati trebaju samo vlastite upute, a ne i vlastiti agent, umjesto toga upotrijebite globalni korak na recepciji. Kada se odgovori na pitanje, poziv se vraća na korak u kojem se pozivatelj prethodno nalazio:

{
  "id": "billing",
  "name": "Billing questions",
  "instructions": "Answer questions about bills and payments. Offer to send a payment link by email.",
  "tools": null,
  "collect": [],
  "transitions": [
    {"to": "__previous__", "when": "The billing question is answered"}
  ],
  "global_when": "The caller asks about a bill or payment at any point"
}

Sljedeći koraci