Open in
Кораци агента и пренос позива
Поделите агента на кораке са сопственим упутствима, алатима и прикупљеним вредностима и преносите позиве између агената током позива.
Један упит даје моделу цео задатак одједном. Кораци му дају једну фазу позива у датом тренутку: сваки корак има сопствена упутства, сопствене алате, опционалну реплику која се изговара дословно и вредности које мора да прикупи пре наставка. Преноси омогућавају другом агенту у вашој организацији да преузме позив усред разговора, са сачуваним транскриптом, тако да позивалац никада не мора да се понавља.
Сваки агент почиње као један упит. Ништа се не мења док не додате кораке или преносе.
Кораци или један упит?
| Користите кораке када | Задржите један упит када |
|---|---|
| Позив има фазе које се морају одвијати редом: прво потврдите, затим закажите. | Разговор је отвореног типа: честа питања, рецепција, општа подршка. |
| Вредност мора бити прикупљена пре него што агент настави. | Ништа не мора да се прикупља фиксним редоследом. |
| Правило никада не сме да се прекрши, као што је „позиваоци млађи од 18 година иду код старатеља“. | Процена модела је довољно добра за сваку грану. |
| Претрага мора да се покрене у одређеном тренутку позива. | Алати се могу позвати кад год позивалац затражи. |
| Део позива припада другом агенту, са сопственим упитом и гласом. | Једна персона обрађује све. |
Кораци нису скриптовано стабло телефонског разговора. Унутар корака модел води разговор као и са једним упитом. Корак одређује на чему модел ради, које алате може да користи и шта му је потребно пре него што може да га напусти.
Како се гради агент са корацима
Када агент има кораке, његов prompt садржи заједничка упутства: персону и
правила која важе у сваком кораку. Сваки корак додаје сопствена упутства
поврх њих. У сваком потезу модел види заједничка упутства, назив и упутства
тренутног корака и до сада прикупљене вредности.
У алату за израду, пребаците агента са Један упит на Кораци. Добићете картицу за сваки корак са његовим називом, упутствима, репликом, алатима, прикупљеним вредностима и прелазима, бирачем преноса и графиком корака само за читање. Повратак на један упит нуди обједињени упит који спаја заједничка упутства и сваки корак.
Преко API-ја, steps и handoffs су поља
агента. Као и свако поље агента, PATCH их поставља
у нацрт; POST /v1/agents/{agent_id}/deploy их објављује. Слање
"steps": null враћа агента на један упит. Тест позиви и Разговор користе
нацрт.
Поља корака
| Поље | Значење |
|---|---|
id | Обавезно. Мала слова, цифре и доње црте, почевши словом, до 40 знакова. Јединствено у оквиру агента. |
name | Обавезан назив за приказ, од 1 до 80 знакова. |
instructions | Обавезно, до 20.000 знакова. Подржава {{var}} променљиве позива, као и prompt. |
say | Опционална реплика која се изговара дословно при уласку у корак, до 1.000 знакова. Подржава {{var}}. |
tools | null даје кораку сваки алат додељен агенту. Листа ограничава корак на те алате, према називу. Уграђене радње као што су end_call и transfer_call прате подешавања агента у сваком кораку. |
collect | До 20 вредности које корак прикупља. Свака има name, type, description и required (подразумевано true). |
on_enter_tool | Опциони назив алата, који се аутоматски позива при уласку у корак. Погледајте Webhook кораци. |
transitions | Уређена листа места на која корак може следеће да пређе. Погледајте Прелази. |
global_when | Опционо. Чини корак доступним из било ког корака. Погледајте Глобални кораци. |
voice | Опциони ИД гласа за овај корак. Занемарује се када агент користи прилагођену конфигурацију гласа. |
Сам график је {"start_step": "<step id>", "steps": [...]}. Позив
почиње у start_step.
Прелази
Сваки прелаз има to, идентификатор корака и тачно једно од следећег:
when: обичан језик, а модел одлучује. Агент добија уграђену алаткуgo_to_stepса списком корака на које може да пређе, при чему је свакиwhenразлог за његов избор.condition: правило над прикупљеним вредностима, а код одлучује. Модел не може да га прескочи нити да га заобиђе разговором."always": true: наставите без провере. Код прво одлучује: чим се уђе у корак или када се прикупе његове обавезне вредности, први одговарајући прелазconditionилиalwaysима предност, пре него што модел може да изабереwhen. Зато ставитеalwaysпосле услова као њихову резервну опцију или самостално да бисте повезали корак директно са следећим. Корак саalwaysникада не чека изборwhen.
condition је {"value": <collected name or dotted path>, "op": <op>, "target": <literal>}:
op | Тачно када вредност |
|---|---|
eq, ne | је једнака, односно није једнака, вредности target |
lt, lte, gt, gte | је мања од, највише, већа од, односно најмање вредност target |
in, not_in | јесте, односно није, једна од вредности на листи target |
exists, missing | је, односно није, прикупљена (без target) |
eq, ne, in и not_in упоређују текст без разликовања великих и малих слова, након уклањања
размака. Бројеви се упоређују као бројеви, а датуми као ниске YYYY-MM-DD. Вредност
која никада није прикупљена чини сваки оператор нетачним, осим missing.
Пишите when и global_when као услов, на пример „Позивалац жели да
закаже термин“, а не као нешто што треба изговорити. Агент их види као интерне
белешке за усмеравање и добија упутство да их никада не чита наглас нити помиње да
мења кораке.
Када модел позове go_to_step:
- Свака вредност
requiredу кораку мора бити присутна. Ако нека недостаје, моделу се каже која је то вредност и он је тражи од позиваоца. - Вредности се чувају.
- Прелази
conditionиalwaysпроверавају се редом. Прво подударање има предност. - У супротном, агент прелази на корак који је модел изабрао.
- Ако се ништа не подудара и модел није навео ниједан корак, агент остаје на тренутном месту.
Прелаз на глобални корак је изузетак: позивалац је променио тему, па се прелаз извршава чак и када у тренутном кораку и даље недостају обавезне вредности, и пре него што се провере услови тог корака.
Прелази condition и always такође се проверавају сваки пут када се уђе у корак,
тако да се низ корака о којима одлучује код извршава одједном. Ланац се прекида:
- на кораку који је већ посећен у овом извршавању;
- после 8 прелаза;
- на кораку који и даље има обавезне вредности за прикупљање, осим ако корак има
on_enter_tool(веб-хук корак се увек усмерава на основу свог резултата).
Изговара се само линија say корака на коме се ланац заустави.
Корак без прелаза је завршни. Агент се ту завршава и прекида или преусмерава позив својим уобичајеним уграђеним радњама.
Прикупљање вредности
Наведите шта је кораку потребно у collect. Модел прослеђује вредности када позове
go_to_step, а оне остају доступне до краја позива.
type | Садржи |
|---|---|
string | Било који текст |
number | Број |
boolean | true или false |
date | Датум у облику YYYY-MM-DD |
Прикупљене вредности су садржај позива. Приказују се уз позив поред транскрипта и подлежу истим правилима задржавања, брисања и редиговања. Када је снимање позива агента искључено, прикупљене вредности се нити чувају нити шаљу у веб-хуковима; временска линија корака се и даље чува. Погледајте Где то видети у позиву.
Изговорене линије
say се изговара тачно онако како је написано када агент уђе у корак. Модел
затим наставља у новом кораку у истом одговору, знајући да је линија управо
изговорена, па је не понавља. Користите say за поздраве, обавезна обавештења
и фиксне формулације, а остатак одговора препустите моделу.
say почетног корака је уводна линија агента када он први проговори, након
сваког обавештења о пристанку. Када позивалац први проговори, она отвара први
одговор агента особи, никада IVR систему или поздравној поруци говорне поште.
say корака се не изговара поново када се позив врати на њега преко
__previous__ или повратног предавања. Напишите га онако како треба да звучи:
словима напишите све што би глас могао погрешно да прочита. Изговорене линије
подржавају променљиве позива {{var}}, али не и прикупљене вредности.
Кораци веб-хука
Подесите on_enter_tool на један од алата агента и он се покреће чим се уђе у
корак, без чекања на модел. Његови аргументи су прикупљене вредности чија се
имена подударају са именима параметара алата. Резултат се чува као прикупљена
вредност под именом <tool>_result, скраћен на 4 KB, а прелази condition и
always корака се одмах проверавају, тако да претрага може сама да усмери
позив на основу сопственог резултата.
Сачувана вредност има два поља:
| Поље | Садржи |
|---|---|
status | HTTP статусни код који је вратила ваша крајња тачка. |
response | Тело одговора. |
Усмеравајте према пољу тела помоћу lookup_account_result.response.<field>, а
према статусном коду помоћу lookup_account_result.status.
Претрага се извршава до 8 секунди или до сопственог временског ограничења алата, ако је оно краће. Ако траје дуже од 3 секунде, агент изговара кратку линију како позивалац не би остао у тишини. Ако ваша крајња тачка врати статус 400 или већи, или не одговори на време, агент каже позиваоцу да то тренутно није могао да провери и наставља са оним што може да уради.
Глобални кораци
До корака са global_when може се доћи из било ког корака кад год тај опис
важи. Модел одлучује, као и код when. Користите га за теме које позивалац
може покренути у било ком тренутку: питања о наплати, захтев за особу или
жалбу.
Прелаз са "to": "__previous__" у глобалном кораку враћа позив на корак који
је био активан пре њега, тако да позивалац наставља тамо где је стао. Корак се
наставља: његов on_enter_tool се не покреће поново, његов say се не
понавља и агент га наставља без започињања испочетка.
Прослеђивања
handoffs наводи друге агенте у вашој организацији који могу преузети позив:
[{"agent_id": 413, "when": "The caller asks about billing or a refund"}]Агент добија уграђени алат hand_off са тим агентима и разлозима. Као и
код прелаза, сваки when је интерна напомена за усмеравање и никада се не
изговара наглас.
Када проследи позив, агент једном кратком реченицом обавештава позиваоца куда ће бити преусмерен, на пример „Наравно, пребацићу вас тиму за наплату”, својим гласом. Затим промпт, кораци, алати и глас циљног агента преузимају позив, који се наставља са истим транскриптом. Нови агент се укратко представља и одговара на последњи захтев позиваоца; не најављује преусмеравање. База знања циљног агента је од тог тренутка доступна.
Када позив први пут стигне до агента, започиње у start_step тог агента:
извршава се on_enter_tool корака и изговара се његов say. Када се позив
врати агенту који га је већ обрадио, тај агент наставља на кораку на ком је био,
без извршавања on_enter_tool, понављања свог say или поновног представљања.
Прикупљене вредности деле сви агенти у позиву.
- Циљни агент мора бити у истој организацији, а агент не може проследити позив самом себи.
- Све на нивоу позива остаје код агента који је одговорио: производ, језици, ко први говори, говорна пошта, обавештење о сагласности и сва остала подешавања позива.
- Циљни агенти могу даље прослеђивати позив, укључујући и назад. Један позив може обухватити до 8 агената.
- Пробни позив покреће нацрт агента који тестирате. Агенти којима он прослеђује позив покрећу своје објављене верзије.
- Ако два агента имају алат са истим именом и различитим дефиницијама, за позив се задржава само један, а увек има предност алат агента који је одговорио. Алат за израду вас упозорава када сачувате.
- Агент може имати прослеђивања без корака. Његов цео промпт се користи без измена.
go_to_step и hand_off су резервисани за агенте са корацима или
прослеђивањима, па ваши алати не могу користити та имена.
Где то видети у позиву
Отворите позив у Историји позива. Временска линија корака поред транскрипта приказује сваки корак у који је позив ушао и разлог за то, а уз њу су наведене прикупљене вредности.
Објекат позива и вебхук по завршетку
позива (telephony.complete / web.complete) садрже
исте податке као steps_trace и collected_values. Оба поља не постоје у
позивима без корака.
"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 је a иза којег следи ИД агента. via наводи шта је померило позив:
via | Значење |
|---|---|
start | Позив је започео у овом кораку. |
model | Модел је изабрао корак преко go_to_step, when или global_when. |
condition | Поклопио се прелаз condition или always. |
on_enter | Поклопио се прелаз на основу резултата корака вебхука. |
handoff | Други агент је преузео позив. |
Где се кораци извршавају
Кораци се изворно извршавају на сваком агенту (и на вредностима старијег производа), при долазним, одлазним и кампањским позивима, тестним позивима, као и веб и виџет позивима.
Свуда другде агент и даље ради, само без структуре: покреће изравнан промпт који редом обједињује заједничка упутства и сваки корак. То обухвата:
- Realtime сесије, укључујући сесије за сачуваног агента;
- инлајн конфигурације које враћа вебхук
динамичке конфигурације позива. Вебхук који
враћа
agent_idкористи кораке тог агента.
Ограничења
| Ограничење | Вредност |
|---|---|
| Корака по агенту | 100 |
| Прикупљених вредности по кораку | 20 |
| Циљева преусмеравања по агенту | 8 |
| Агената доступних у једном позиву | 8 |
Величина steps JSON-а | 200 KB |
Упутства корака instructions | 20.000 знакова |
Линија say | 1.000 знакова |
Сачувани резултат on_enter_tool | 4 KB |
Чување које крши правило враћа 400 са путањом неисправног поља, као што је
steps.steps[2].transitions[0].to. Називи алата у tools и
on_enter_tool морају бити алати повезани са агентом.
Језици по кораку, скриптовани кораци који прескачу модел и прикупљене вредности унутар линија say нису подржани.
Увезени агенти
Увоз из Retell, Bland, Vapi или ElevenLabs преноси агенте са више упита, токове, путање и радне процесе као кораке, а тимове и преносе агената као преусмеравања између увезених агената. Страница за преглед приказује обоје пре увоза.
Пример: пријем пацијента код зубара
Три корака редом: поздрав, прикупљање података о пацијенту, заказивање.
{
"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": []
}
]
}
}Припремите га помоћу PATCH /v1/agents/{agent_id}, испробајте га помоћу Разговор, а затим га објавите.
Корак details не може да пређе на заказивање док се не прикупе име, датум рођења
и разлог; new_patient је опционалан.
Пример: грана са условом старости
Модел може да разговара са било ким, али кôд одлучује ко ће бити заказан. Прикупите старост, а затим усмерите позив на основу ње пре него што се размотри сопствени избор модела.
{
"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"}
]
}Позивалац који каже петнаест прелази на guardian, без обзира на одлуку модела.
Сви остали прелазе на book. Оба су обични кораци на другом месту у графикону.
Пример: корак веб-хука за проналажење налога
Позивалац наводи број налога, претрага се покреће при уласку у следећи корак,
а њен резултат бира путању. Кораци not_found, collections и support
изостављени су ради сажетости.
[
{
"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 прима account_number јер његов параметар има то
име. Ако тело одговора садржи "found": false, позив прелази на
not_found. Ако је његов account_status past_due или suspended, прелази на
collections. Активан налог остаје у lookup, где модел помаже и
наставља на support. Да бисте неуспешну претрагу послали у засебан корак, прво додајте
услове за статус: одговор са грешком чува свој статусни кôд, па га
{"value": "lookup_account_result.status", "op": "gte", "target": 400}
обухвата, а истек времена или одсуство одговора чува "error", па
{"value": "lookup_account_result.status", "op": "eq", "target": "error"}
обухвата и тај случај.
Пример: рецепција до наплате
Два агента. Рецепција (агент 412) одговара на сваки позив и прослеђује питања о наплати
агенту за наплату (агент 413) са сопственим упутством, алатима и гласом.
На рецепцији:
{
"handoffs": [
{"agent_id": 413, "when": "The caller asks about a bill, a payment or a refund"}
]
}На агенту за наплату, како би могао да врати позиваоца:
{
"handoffs": [
{"agent_id": 412, "when": "The billing question is resolved and the caller needs something else"}
]
}Рецепција изговара кратку реченицу као што је „Повезаћу Вас са нашим тимом за наплату“, а агент за наплату се представља и наставља разговор тамо где га је рецепција прекинула. Када наплата врати позив, рецепција наставља тамо где је стала, без поновног поздрављања позиваоца. Производ позива, језици, обавештење о сагласности и друга подешавања позива остају на рецепцији, јер је она одговорила.
Ако наплати требају само сопствена упутства, а не и сопствени агент, уместо тога користите глобални корак на рецепцији. Када се на питање одговори, позив се враћа на корак у ком је позивалац био:
{
"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"
}Следећи кораци
Напишите заједничка упутства и упутства за кораке која добро функционишу преко телефона.
Направите алате које позивају Ваши кораци и кораци веб-куке.
Покрените исте сценарије за сваку грану пре примене.
Свако поље агента, нацрт и примена.