Open in
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 kada | Zadrž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
| Polje | Značenje |
|---|---|
id | Obavezno. Mala slova, znamenke i podvlake, počinje slovom, do 40 znakova. Jedinstveno unutar agenta. |
name | Obavezan naziv za prikaz, od 1 do 80 znakova. |
instructions | Obavezno, do 20 000 znakova. Podržava {{var}} varijable poziva, kao i prompt. |
say | Neobavezna rečenica koja se izgovara doslovno pri ulasku u korak, do 1 000 znakova. Podržava {{var}}. |
tools | null 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. |
collect | Do 20 vrijednosti koje korak prikuplja. Svaka ima name, type, description i required (zadano true). |
on_enter_tool | Neobavezan naziv alata koji se automatski poziva pri ulasku u korak. Pogledajte Webhook koraci. |
transitions | Poredani popis mjesta na koja korak može prijeći. Pogledajte Prijelazi. |
global_when | Neobavezno. Omogućuje da korak bude dostupan iz bilo kojeg koraka. Pogledajte Globalni koraci. |
voice | Neobavezan 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 alatgo_to_stepkoji navodi korake u koje može prijeći, pri čemu je svakiwhenrazlog 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 prijelazconditionilialwaysima prednost, prije nego što model može odabratiwhen. Zato stavitealwaysnakon uvjeta kao njihovu pričuvnu opciju ili samostalno kako biste izravno povezali korak sa sljedećim. Korak salwaysnikada ne čeka odabirwhen.
condition je {"value": <collected name or dotted path>, "op": <op>, "target": <literal>}:
op | Istinito kada vrijednost |
|---|---|
eq, ne | jednaka je ili nije jednaka vrijednosti target |
lt, lte, gt, gte | manja je od, nije veća od, veća je od ili je najmanje target |
in, not_in | jest ili nije jedna od vrijednosti na popisu target |
exists, missing | jest 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:
- Svaka vrijednost
requiredu koraku mora biti prisutna. Ako neka nedostaje, modelu se navodi koja je to vrijednost te je traži od pozivatelja. - Vrijednosti se pohranjuju.
- Prijelazi
conditionialwaysprovjeravaju se redom. Prvo podudaranje ima prednost. - U suprotnom agent prelazi na korak koji je model odabrao.
- 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.
type | Sadrži |
|---|---|
string | Bilo koji tekst |
number | Broj |
boolean | true ili false |
date | Datum 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:
| Polje | Sadrži |
|---|---|
status | HTTP statusni kôd koji je vratio vaš krajnji punkt. |
response | Tijelo 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:
via | Značenje |
|---|---|
start | Poziv je započeo u ovom koraku. |
model | Model je odabrao korak putem go_to_step, when ili global_when. |
condition | Prijelaz condition ili always se podudarao. |
on_enter | Prijelaz se podudarao s rezultatom koraka webhooka. |
handoff | Drugi 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_idkoristi korake tog agenta.
Ograničenja
| Ograničenje | Vrijednost |
|---|---|
| Koraci po agentu | 100 |
| Prikupljene vrijednosti po koraku | 20 |
| Odredišta predaje po agentu | 8 |
| Agenti dostupni u jednom pozivu | 8 |
Veličina JSON-a steps | 200 KB |
instructions koraka | 20.000 znakova |
Redak say | 1.000 znakova |
Pohranjeni rezultat on_enter_tool | 4 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
Napišite zajedničke upute i upute za korake koje dobro funkcioniraju u telefonskim razgovorima.
Izradite alate koje pozivaju vaši koraci i koraci web-dojavnika.
Pokrenite iste scenarije za svaku granu prije implementacije.
Svako polje agenta, nacrt i implementacija.