Open in
Koraki agenta in predaje
Razdelite agenta na korake z lastnimi navodili, orodji in zbranimi vrednostmi ter med klicem predajajte klice med agenti.
En sam poziv modelu hkrati poda celotno nalogo. Koraki mu podajo po eno fazo klica: vsak korak ima svoja navodila, svoja orodja, izbirno vrstico, ki jo izgovori dobesedno, in vrednosti, ki jih mora zbrati pred nadaljevanjem. Predaje omogočajo, da med klicem prevzame drug agent v vaši organizaciji, pri čemer pogovor ostane ohranjen, zato se klicatelju nikoli ni treba ponavljati.
Vsak agent se začne kot en sam poziv. Nič se ne spremeni, dokler ne dodate korakov ali predaj.
Koraki ali en sam poziv?
| Uporabite korake, ko | Obdržite en sam poziv, ko |
|---|---|
| Klic vsebuje faze, ki se morajo zgoditi po vrsti: najprej preverjanje, nato rezervacija. | Pogovor nima vnaprej določenega poteka: pogosta vprašanja, recepcija, splošna podpora. |
| Je treba zajeti vrednost, preden agent nadaljuje. | Ničesar ni treba zbrati v določenem vrstnem redu. |
| Pravila ni dovoljeno nikoli prilagoditi, na primer »klicatelje, mlajše od 18 let, usmerite k skrbniku«. | Presoja modela zadostuje za vsako vejo. |
| Je treba iskanje izvesti na določeni točki klica. | Orodja je mogoče poklicati kadar koli klicatelj zaprosi zanje. |
| Del klica pripada drugemu agentu z lastnim pozivom in glasom. | Ena persona obravnava vse. |
Koraki niso skriptirano telefonsko drevo. Znotraj koraka model vodi pogovor enako kot pri enem samem pozivu. Korak določa, na čem dela, katera orodja lahko uporabi in kaj potrebuje, preden ga lahko zapusti.
Kako je zgrajen agent s koraki
Ko ima agent korake, njegov prompt vsebuje skupna navodila: persono in
pravila, ki veljajo v vsakem koraku. Vsak korak doda svoja navodila. Pri vsakem
obratu model vidi skupna navodila, ime in navodila trenutnega koraka ter doslej
zbrane vrednosti.
V gradniku preklopite agenta iz En sam poziv na Koraki. Za vsak korak dobite kartico z njegovim imenom, navodili, vrstico za izgovor, orodji, zbranimi vrednostmi in prehodi, izbirnikom predaj ter grafom poteka korakov, ki je samo za branje. Ob preklopu nazaj na en sam poziv je na voljo sploščen poziv, ki združi skupna navodila in vse korake.
Prek API-ja sta steps in handoffs polji za
agenta. Kot vsako polje agenta ju PATCH pripravi v
osnutku; POST /v1/agents/{agent_id}/deploy ju objavi. Pošiljanje
"steps": null preklopi agenta nazaj na en sam poziv. Testni klici in
Pogovor uporabljajo osnutek.
Polja koraka
| Polje | Pomen |
|---|---|
id | Obvezno. Male črke, števke in podčrtaji, začeti se mora s črko, največ 40 znakov. Enolično znotraj agenta. |
name | Obvezno prikazno ime, od 1 do 80 znakov. |
instructions | Obvezno, največ 20.000 znakov. Podpira spremenljivke klica {{var}}, tako kot prompt. |
say | Izbirna vrstica, izgovorjena dobesedno ob vstopu v korak, največ 1.000 znakov. Podpira {{var}}. |
tools | null koraku dodeli vsa orodja, pripeta agentu. Seznam korak omeji na navedena orodja po imenu. Vgrajena dejanja, kot sta end_call in transfer_call, v vsakem koraku upoštevajo nastavitve agenta. |
collect | Do 20 vrednosti, ki jih korak zbere. Vsaka ima name, type, description in required (privzeto true). |
on_enter_tool | Izbirno ime orodja, samodejno poklicanega ob vstopu v korak. Glejte Koraki spletnega kavlja. |
transitions | Urejen seznam mest, kamor lahko korak nadaljuje. Glejte Prehodi. |
global_when | Izbirno. Omogoči, da je korak dosegljiv iz katerega koli koraka. Glejte Globalni koraki. |
voice | Izbirni ID glasu za ta korak. Prezrto, kadar agent uporablja prilagojeno konfiguracijo glasu. |
Sam graf je {"start_step": "<step id>", "steps": [...]}. Klic se začne v
start_step.
Prehodi
Vsak prehod ima to, ID koraka in natanko eno od naslednjega:
when: običajen jezik, odloči pa se model. Agent dobi vgrajeno orodjego_to_step, ki navaja korake, na katere se lahko premakne, pri čemer je vsakwhenrazlog za njegovo izbiro.condition: pravilo za zbrane vrednosti, odloči pa se koda. Model ga ne more preskočiti ali se mu izogniti s pogovorom."always": true: nadaljujte brez preverjanja. Koda odloča najprej: takoj ko vstopite v korak ali ko so zbrane njegove zahtevane vrednosti, prevlada prvi ujemajoči se prehodconditionalialways, preden lahko model izberewhen. Zato postavitealwaysza pogoje kot njihovo privzeto možnost ali samostojno, da korak neposredno povežete z naslednjim. Korak zalwaysnikoli ne čaka na izbirowhen.
condition je {"value": <collected name or dotted path>, "op": <op>, "target": <literal>}:
op | Resnično, ko vrednost |
|---|---|
eq, ne | je enaka oziroma ni enaka target |
lt, lte, gt, gte | je manjša od, največ, večja od oziroma najmanj target |
in, not_in | je oziroma ni ena od vrednosti na seznamu target |
exists, missing | je oziroma ni bila zbrana (brez target) |
eq, ne, in in not_in primerjajo besedilo ne glede na velike in male
črke po odstranitvi presledkov na začetku in koncu. Števila se primerjajo kot
števila, datumi pa kot nizi YYYY-MM-DD. Vrednost, ki ni bila nikoli zbrana,
povzroči, da je vsak op neresničen, razen missing.
when in global_when napišite kot pogoj, na primer »Klicatelj želi
rezervirati termin«, ne kot nekaj, kar naj agent pove. Agent ju vidi kot
notranji opombi za usmerjanje in prejme navodilo, da ju nikoli ne prebere na
glas ali omeni, da spreminja korake.
Ko model pokliče go_to_step:
- Prisotna mora biti vsaka vrednost
requiredv koraku. Če katera manjka, model prejme informacijo, katera manjka, in zanjo vpraša klicatelja. - Vrednosti se shranijo.
- Prehodi
conditioninalwaysse preverijo po vrstnem redu. Prevzame prvi ujemajoči se prehod. - V nasprotnem primeru se agent premakne v korak, ki ga je izbral model.
- Če se nič ne ujema in model ni navedel koraka, agent ostane tam, kjer je.
Skok na globalni korak je izjema: klicatelj je spremenil temo, zato se izvede tudi, kadar v trenutnem koraku še manjkajo zahtevane vrednosti, in pred preverjanjem pogojev tega koraka.
Prehodi condition in always se preverijo tudi ob vsakem vstopu v korak,
zato se zaporedje korakov, o katerih odloča koda, izvede naenkrat. Veriga se
ustavi:
- pri koraku, ki ga je v tem izvajanju že obiskala;
- po 8 preskokih;
- pri koraku, ki ima še vedno zahtevane vrednosti za zbiranje, razen če ima
korak
on_enter_tool(korak webhook se vedno usmeri glede na svoj rezultat).
Izgovorjena je samo vrstica say koraka, kjer se veriga ustavi.
Korak brez prehodov je končni. Agent se tam zaključi ter konča ali prenese klic s svojimi običajnimi vgrajenimi dejanji.
Zbiranje vrednosti
V collect navedite, kaj korak potrebuje. Model posreduje vrednosti, ko pokliče
go_to_step, in ostanejo na voljo do konca klica.
type | Vsebuje |
|---|---|
string | Poljubno besedilo |
number | Število |
boolean | true ali false |
date | Datum v obliki YYYY-MM-DD |
Zbrane vrednosti so vsebina klica. Ob klicu se prikažejo ob prepisu in zanje veljajo enaka pravila hrambe, brisanja in prikrivanja podatkov. Ko je snemanje klica agenta izklopljeno, se zbrane vrednosti ne shranijo niti ne pošiljajo v spletne kljuke; časovnica korakov se še vedno shrani. Oglejte si Kje jih vidite v klicu.
Vrstice say
say se izgovori točno tako, kot je zapisano, ko agent vstopi v korak. Model
nato v istem odgovoru nadaljuje v novem koraku in ve, da je bila vrstica pravkar
izgovorjena, zato je ne ponovi. Uporabite say za pozdrave, obvezna obvestila
in nespremenljivo besedilo, preostanek odgovora pa prepustite modelu.
say začetnega koraka je uvodna vrstica agenta, kadar agent spregovori prvi, po
morebitnem obvestilu o soglasju. Kadar prvi spregovori klicatelj, ta odpre prvi
odgovor agenta osebi, nikoli sistemu IVR ali pozdravu glasovne pošte.
say koraka se ne izgovori znova, ko se klic vrne vanj prek
__previous__ ali predaje nazaj. Zapišite ga tako, kot naj zveni: vse, kar bi
glas lahko napačno prebral, izpišite v celoti. Vrstice say podpirajo klicne
spremenljivke {{var}}, ne pa zbranih vrednosti.
Koraki webhook
Nastavite on_enter_tool na eno od orodij agenta; zažene se takoj ob vstopu v
korak, ne da bi čakal na model. Njegovi argumenti so zbrane vrednosti, katerih
imena se ujemajo z imeni parametrov orodja. Rezultat se shrani kot zbrana
vrednost z imenom <tool>_result, skrajšana na 4 KB, prehoda condition in
always koraka pa se preverita takoj, zato lahko poizvedba usmeri klic glede na
lasten rezultat.
Shranjena vrednost ima dve polji:
| Polje | Vsebuje |
|---|---|
status | Kodo stanja HTTP, ki jo je vrnila vaša končna točka. |
response | Telo odgovora. |
Usmerjajte glede na polje telesa z lookup_account_result.response.<field> in
glede na kodo stanja z lookup_account_result.status.
Poizvedba se izvaja do 8 sekund oziroma do lastne časovne omejitve orodja, če je ta krajša. Če traja dlje kot 3 sekunde, agent izgovori kratko vrstico, da klicatelj ne ostane v tišini. Če vaša končna točka vrne stanje 400 ali višje oziroma ne odgovori pravočasno, agent klicatelju pove, da tega trenutno ni mogel preveriti, in nadaljuje s tem, kar lahko stori.
Globalni koraki
Korak z global_when je mogoče doseči iz katerega koli koraka, kadar ta opis
velja. Kot pri when odloči model. Uporabite ga za teme, ki jih lahko klicatelj
izpostavi kadar koli: vprašanja o obračunavanju, zahtevo za človeka, pritožbo.
Prehod z "to": "__previous__" v globalnem koraku vrne klic v korak, ki je bil
aktiven pred njim, tako da klicatelj nadaljuje tam, kjer je končal. Korak se
nadaljuje: njegov on_enter_tool se ne zažene znova, njegov say se ne ponovi,
agent pa ga nadaljuje brez ponovnega začetka.
Predaje
handoffs navaja druge agente v vaši organizaciji, ki lahko prevzamejo klic:
[{"agent_id": 413, "when": "The caller asks about billing or a refund"}]Agent prejme vgrajeno orodje hand_off s temi agenti in razlogi. Tako kot pri prehodih je vsak when interna opomba za usmerjanje in se nikoli ne prebere na glas.
Ko agent preda klic, v svojem glasu pove eno kratko poved, ki klicalcu pove, kam bo preusmerjen, na primer »Seveda, preusmeril vas bom naši ekipi za obračunavanje«. Nato poziv, koraki, orodja in glas ciljnega agenta prevzamejo klic, ki se nadaljuje z istim transkriptom. Novi agent se na kratko predstavi in odgovori na zadnjo zahtevo klicalca; ne napove prenosa. Od takrat je na voljo zbirka znanja ciljnega agenta.
Ko klic prvič doseže agenta, se začne v agentovem start_step: zažene se on_enter_tool koraka in izgovori se njegov say. Ko je klic predan nazaj agentu, ki ga je že obiskal, ta agent nadaljuje v koraku, v katerem je bil, brez zagona on_enter_tool, ponavljanja svojega say ali ponovnega predstavljanja. Zbrane vrednosti so v skupni rabi med vsemi agenti v klicu.
- Cilj mora biti agent v isti organizaciji, agent pa ne more predati klica samemu sebi.
- Vse nastavitve na ravni klica ostanejo pri agentu, ki je odgovoril: izdelek, jeziki, kdo govori prvi, glasovna pošta, obvestilo o soglasju in vse druge nastavitve klica.
- Ciljni agenti lahko klic predajo naprej ali nazaj. En klic lahko doseže do 8 agentov.
- Preizkusni klic zažene osnutek agenta, ki ga preizkušate. Agenti, katerim preda klic, zaženejo svoje objavljene različice.
- Če imata dva agenta orodje z istim imenom in različnima definicijama, se za klic ohrani samo eno, vedno pa prevlada tisto agenta, ki je odgovoril. Urejevalnik vas opozori, ko shranite.
- Agent ima lahko predaje brez korakov. Uporabi se celoten njegov poziv v nespremenjeni obliki.
go_to_step in hand_off sta rezervirana pri agentih s koraki ali predajami, zato vaša lastna orodja ne morejo uporabljati teh imen.
Kje to vidite v klicu
Odprite klic v Zgodovini klicev. Časovnica korakov ob transkriptu prikazuje vsak korak, v katerega je klic vstopil, in razlog zanj, ob njej pa so navedene zbrane vrednosti.
Objekt klica in webhook ob zaključku klica (telephony.complete / web.complete) vsebujeta iste podatke kot steps_trace in collected_values. Oboje ni prisotno pri klicih brez korakov.
"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, ki mu sledi ID agenta. via pove, kaj je premaknilo klic:
via | Pomen |
|---|---|
start | Klic se je začel v tem koraku. |
model | Model je izbral korak prek go_to_step, when ali global_when. |
condition | Ujemal se je prehod condition ali always. |
on_enter | Prehod se je ujemal z rezultatom koraka webhooka. |
handoff | Klic je prevzel drug agent. |
Kje se izvajajo koraki
Koraki se izvajajo izvorno v vsakem agentu (in pri vrednostih starejšega izdelka), pri dohodnih, odhodnih in kampanjskih klicih, preskusnih klicih ter klicih prek spleta in gradnikov.
Povsod drugje agent še vedno deluje, le brez strukture: zažene sploščen poziv, ki po vrsti združi skupna navodila in vsak korak. To vključuje:
- seje Realtime, vključno s sejami za shranjenega agenta;
- vdelane konfiguracije, vrnjene prek webhooka dinamične konfiguracije klica. Webhook, ki vrne
agent_id, uporabi korake tega agenta.
Omejitve
| Omejitev | Vrednost |
|---|---|
| Koraki na agenta | 100 |
| Zbrane vrednosti na korak | 20 |
| Cilji predaje na agenta | 8 |
| Agenti, dosegljivi v enem klicu | 8 |
Velikost JSON-a steps | 200 KB |
instructions koraka | 20.000 znakov |
Vrstica say | 1.000 znakov |
Shranjen rezultat on_enter_tool | 4 KB |
Shranjevanje, ki krši pravilo, vrne 400 s potjo neustreznega polja, na
primer steps.steps[2].transitions[0].to. Imena orodij v tools in
on_enter_tool morajo biti orodja, povezana z agentom.
Jeziki za posamezne korake, skriptirani koraki, ki preskočijo model, in zbrane vrednosti v vrsticah say niso podprti.
Uvoženi agenti
Uvažanje iz Retell, Bland, Vapi ali ElevenLabs prenese agente z več pozivi, tokove, poti in delovne tokove kot korake ter ekipe in prenose agentov kot predaje med uvoženimi agenti. Stran za pregled pred uvozom prikaže oboje.
Primer: sprejem pacientov v zobozdravstveni ordinaciji
Trije koraki po vrsti: pozdrav, zbiranje podatkov o pacientu, naročanje.
{
"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": []
}
]
}
}Pripravite ga z PATCH /v1/agents/{agent_id}, preizkusite z Pogovor, nato
ga uvedite. Korak details ne more nadaljevati k naročanju, dokler niso zbrani
ime, datum rojstva in razlog; new_patient ni obvezen.
Primer: veja z omejitvijo glede na starost
Model se lahko pogovarja s komer koli, vendar koda odloči, kdo se lahko naroči. Zberite starost, nato jo uporabite za usmerjanje, preden se upošteva lastna izbira 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"}
]
}Klicatelj, ki reče petnajst, preide na guardian, ne glede na odločitev
modela. Vsi drugi preidejo na book. Oba sta drugje v grafu običajna koraka.
Primer: korak spletnega kavlja za iskanje računa
Klicatelj poda številko računa, iskanje se izvede ob vstopu v naslednji korak,
njegov rezultat pa izbere pot. Koraki not_found, collections in support
so zaradi jedrnatosti izpuščeni.
[
{
"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 prejme account_number, ker ima njegov parameter to
ime. Če telo odgovora vsebuje "found": false, klic preide v
not_found. Če je njegov account_status past_due ali suspended, preide v
collections. Aktiven račun ostane v lookup, kjer model pomaga in nato
nadaljuje v support. Če želite neuspešno iskanje poslati v ločen korak, najprej dodajte
pogoje za stanje: odgovor z napako shrani svojo kodo stanja, zato jo
{"value": "lookup_account_result.status", "op": "gte", "target": 400}
zajame, časovna omejitev ali brez odgovora pa shrani "error", zato
{"value": "lookup_account_result.status", "op": "eq", "target": "error"}
zajame to stanje.
Primer: recepcija do obračunavanja
Dva agenta. Recepcija (agent 412) sprejme vsak klic in vprašanja o obračunavanju
preda agentu za obračunavanje (agent 413), ki ima svoj poziv, orodja in glas.
Na recepciji:
{
"handoffs": [
{"agent_id": 413, "when": "The caller asks about a bill, a payment or a refund"}
]
}Pri agentu za obračunavanje, da lahko klicatelja preda nazaj:
{
"handoffs": [
{"agent_id": 412, "when": "The billing question is resolved and the caller needs something else"}
]
}Recepcija pove kratko poved, na primer »Povezal vas bom z našo ekipo za obračunavanje«, agent za obračunavanje pa se predstavi in nadaljuje pogovor tam, kjer ga je recepcija končala. Ko obračunavanje preda klic nazaj, recepcija nadaljuje tam, kjer je bila, ne da bi klicatelja znova pozdravila. Produkt klica, jeziki, obvestilo o privolitvi in druge nastavitve klica ostanejo pri recepciji, ker je ona sprejela klic.
Če obračunavanje potrebuje le svoja navodila in ne svojega agenta, namesto tega uporabite globalni korak na recepciji. Ko je vprašanje odgovorjeno, se klic vrne v korak, v katerem je bil klicatelj:
{
"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"
}Naslednji koraki
Napišite skupna navodila in navodila za korake, ki dobro delujejo po telefonu.
Ustvarite orodja, ki jih kličejo vaši koraki in koraki webhookov.
Pred uvedbo izvedite enake scenarije za vsako vejo.
Vsako polje agenta, osnutek in uvedba.