• Věty pro definici intentu by měly obsahovat pouze důležité jádro sdělení. Je dobré z nich odstranit veškerý nadbytečný obsah a balast (jako pozdravy, oslovení apod.), který se opakuje u různých intentů.

• Odpovědi by měly být spíše krátké (do 20 slov), pokud jsou delší, je možné je rozdělit do samostatných vět. Jednak bude rychlejší odezva (převedení dlouhého textu na řeč trvá déle) a jednak lépe udržíte pozornost komunikujícího uživatele.

• Pokud je součástí reakce nějaká další akce, měl by o tom být uživatel informován i slovně, jako např. „Moment, už volám.“

• V případě navazujících scénářů, je třeba stále myslet na to, že mechanismus scénářů není kontextový. Proto doplňující otázku vždy formulovat jako otevřenou, aby se z případné odpovědi dal opět odvodit příslušný intent. Např. při představení firmy se nezeptám: „Chcete vědět více?“ protože případná odpověď ano/ne vyžaduje kontext, ale zeptám se raději: „Mohu vám povědět více o službách nebo projektech, ptejte se, co vás zajímá?“

• Doporučujeme scénáře sdružovat do kategorií podle toho, jaké obecné oblasti se týkají (Firma, Navigace, …) pomůže to k přehlednosti v udržování obsahu.

• Snažte se odpovědi psát konzistentně tak, aby odpovídaly požadované osobnosti recepční a udržovaly si integritu. Typicky není vhodné chvíli mluvit spisovně a chvíli slangem nebo střídat decentní výraz s nejnovějšími slovními novotvary adolescentů.

• <break strength="weak"/> mezera či klesnutí hlasem s udáním intenzity – možné hodnoty intenzity jsou od nejnižší k nejvyšší: "x-weak", weak", "medium", "strong", "x-strong"

• <break time="200ms"/> mezera na dobu stanovenou v milisekundách – vhodné třeba pro delší odmlky a dramatické pauzy

• <say-as interpret-as="ordinal">1</say-as> vysloví číslo jako číslovku řadovou: „první“

• <say-as interpret-as="characters">vut</say-as> hláskuje po jednotlivých písmenech. Stejný efekt lze docílit bez značky pouze zápisem velkými písmeny VUT či V.U.T.

• <say-as interpret-as="date" format="dmy">10-9-2021</say-as> vysloví jako datum „desátého září 2021“

• <say-as interpret-as="time" format="hms">14:30:25</say-as> vysloví jako čas tj. „14 hodin 30 minut 25 sekund“

html
https://cloud.google.com/text-to-speech

• $sys_date_time = datum a čas v následujícím formátu: 2021-02-02 14:42:22

• $sys_time = pouze čas v následujícím formátu: 14:42:22

• $sys_month = číslo měsíce v následujícím formátu: 2

• $sys_day_of_month = číslo dne v měsíci v následujícím formátu: 2

• $sys_day_of_week = číslo dne v týdnu v následujícím formátu: 2

• $sys_12_hour_period = příznak dopoledne/odpoledne v následujícím formátu: PM

• $sys_hour = aktuální hodina v následujícím formátu: 14

• $sys_minute = aktuální minuta v následujícím formátu: 42

• $sys_last_scenario = název posledního scénáře ve formátu: Úvodní scénář

• $terminal_sn = sériové číslo terminálu, na kterém právě daný scénář běží (pro rozlišení, pokud více terminálů používá stejného chatbota)

• {decline()} – příklad: decline($name, 4) – skloňování jména do čtvrtého pádu

• {secondsfrom(timestamp)} – příklad: secondsfrom(1555683122.0) – počet vteřin od zadaného okamžiku

• {date(locale, format)} – příklad: date(cs_CZ.utf8, %A %-d. %B) – datum v zadaném formátu

• {time} – aktuální čas ve formátu %H:%M

• {command=<UŽIVATELSKÝ_POŽADAVEK>} – spuštění uživatelského požadavku (viz dále) přímo z přednášeného textu např. {command=EMAIL delivery Pavel Novák}

html
https://emojipedia.org/

Poznámka: Dialogy jsou kontextové „scénáře“ které běžně uživatel nezadává a jsou předpřipraveny pro základní situace již z vývoje.

• Výraz v obličeji recepční

• Telefonické služby

• Videoterminál

• Emailové rozhraní

• Další služby a zařízení připojená v rámci integrace aReception u zákazníka

• VIDEOCONFERENCE– spustí videokonferenci přes VIDEOTEL

• CALL gradually – volá postupně lidem z předem nastaveného seznamu (lze použít jako záložní variantu v případě kdy nezvedal telefon uživatel ani back-office)

• CALL <general | meeting | delivery | interview> <full name> zavolá <full name> za účelem schůzky | pošty | pohovoru, příklad: "CALL meeting Tomáš Ondráček"

• CALL {"type": "gradually | general | meeting | delivery | interview", "name": "value", "people2call": ["value1","value2"], "location": "value"} – JSON notace příkazu CALL umožňující zadat rozšířenou sadu parametrů (např. lokaci či seznam kontaktů pro postupné volání).

• EMAIL delivery <full name>pošle e-mail o poště ve schránce na recepci pro <full name>, příklad: "EMAIL delivery Tomáš Ondráček" – je třeba mít v seznamu kontaktů k dispozici emailové adresy

• GET-CONTACT-INFO { "response-mapping": { "variable_name_without_dollar_prefix_1": "json_path_to_field_in_anwer_1", "variable_name_without_dollar_prefix_2": "json_path_to_field_in_anwer_2"}, “filter”:{"field_name": "filter_value_case_insensitive"}} - vrací příslušný kontakt / kontakty z databáze kontaktů administrované v admin rozhraní Návratové hodnoty: "--GET-CONTACT-INFO-OK--” "--GET-CONTACT-INFO-ERROR--” Příklad: GET-CONTACT-INFO { "response-mapping": { "first_contact": "$.result[0].email", "all_contacts":"$.result"}, “filter”:{"phoneNumber": "778031466"}} Příklad odpovědi v JSON formátu se všemi hodnotami: [{"id": 303, "note": "poznamka", "type": "zamestnanec", "email": "xxx@xxx.com", "office": "K125", "picture": "", "building": "D517", "idNumber": "123-987-AAD", "isActive": true, "language": "", "lastName": "Pavel", "location": "Ostrava", "firstName": "Jaroslav", "employment": "ekonom", "externalId": null, "phoneNumber": "+420111111111", "organizationUnit": "backoffice", "secondPhoneNumber": "+420999999999"}]

• END-CONVERSATION – ukončí konverzaci (na 10s nelze zahájit konverzaci - člověk musí mít čas odejít z kamery)

• SOS – uživateli vyskočí nápověda (stejná, jako když vlevo dole stiskne tlačítko otazník)

• KEYBOARD <keyboard_type> – zobrazí klávesnici pro dotykový vstup uživatele
• KEYBOARD - zobrazí se dotyková klávesnice pro výběr jména ze seznamu aktuálních kontaktů (vybrané jméno je posláno jako zpráva - tzn. skutečně simuluje klávesnici / zastupuje řeč)
• KEYBOARD contacts <text> - přednastaví text do klávesnice pro výběr jména
• KEYBOARD general – zobrazí se obecná klávesnice pro zadání libovolného textu se kterým se dále pracuje stejně, jako by jej uživatel řekl

• SHOW-URL <url>zobrazí okno s webovou stránkou, uživatel je může buď zavřít sám, nebo se automaticky uzavře při ukončení konverzace odchodem uživatele. Při ukončení se vyvolá systémový intent URL-CLOSED. Daná webová stránka musí jít zobrarazit v iframe.
• SHOW-URL {"url": "http://example.org", "sandbox": "..."}
• parametr sendbox je volitelný, pokud není zadán nebo je prázdný, je nejvíce restriktivní
• hodnota allow-all zruší všechy restrikce
• jednotlivé restrikce se ruší hodnotami popsanými na https://www.w3schools.com/tags/att_iframe_sandbox.asp
• pozor na povolení zobrazení odkazu v nové okně, které by překrylo okno s avatarem
• TIP: většina stránek dobře funguje s nastavením "sandbox": "allow-scripts allow-same-origin”

• SHOW-IMAGE <url>zobrazí okno s obrázkem načteným ze zadané internetové adresy, uživatel jej může buď zavřít sám, nebo se automaticky uzavře při ukončení konverzace odchodem uživatele. Při ukončení se vyvolá systémový intent IMAGE-CLOSED.

• READ-QRCODE <variable_name_without_$_sign> zobrazí obraz z pohledu kamery a uživatel může na kameru ukázat QR kód pro načtení. Po přečtení QR kódu se tento uloží do proměnné, jejíž název je předán jako parametr příkazu (bez úvodního znaku $). Návratové hodnoty (do chatbota): --QR-CODE-READ-- úspěšné načtení QR kódu --QR-CODE-CANCELLED-- přerušení načítání uživatelem (křížkem vpravo nahoře) --QR-CODE-NOT-READ-- vypršení časového limitu pro načtení QR kódu

• SWITCH-LANGUAGE <locale> - přepne jazyk, kterým recepční komunikuje (tento jazyk je třeba mít v provozu a mít tedy nastaveného příslušného chatbota v daném jazyce cs-CZ, en-US, …). Příklad: SWITCH-LANGUAGE en-US

• WAIT <nnn> - počká nnn milisekund (např. WAIT 2000 počká 2 selundy).

• WAIT-FOR-SPEECH-END – počká až do doby, kdy recepční dohovoří svůj text, pak vrátí hodnotu —SPEECH-FINISHED—. Použití např. pokud byste chtěli zobrazit webovou stránku (SHOW-URL) až poté, co dohovoří, jinak ji zobrazí už během mluvení.

• ASK-CENTRAL-CHATBOT – zavolá centrálního konverzačního chatbota a položí mu stejnou (poslední řečenou) otázku, nebo vstup zadaný za tímto uživatelským požadavkem. Centrální chatbot pak najde vhodnou obecnou odpověď místo lokálního chatbota a tou odpoví. Centrální konverzační chatbot je průběžně aktualizován o nová témata a konverzační scénáře a umí zodpovídat více obecných otázek než specializované instance chatbota pro konkrétní recepci. Typicky se dotázání centrálního chatbota volá v situaci, kdy lokální chatbot nezná odpověď na otázku (tj. v systémovém scénáři „Nerozpoznaná zpráva“), ale je možné využít i v jiných vhodných situacích. Tím je zajištěno, že jsou upřednostněny lokální konkrétnější odpovědi před těmi obecnými.

• ASK-CHATGPT <question> - předloží dotaz umělé inteligenci Chat GPT a zobrazí její odpověď. Parametr s otázkou je možné získat v konverzaci otázkou na systémovou entitu @sys-input a uložit ji do proměnné, která se pak předá do uživatelského požadavku.

• INVOKE-CHATGPT-API <input> - zavolá ChatGPT API a vrátí odpověď na vstup chatbota. Odpověď lze pak získat v systémové entitě @sys-input. V případě chyby vrátí text --INVOKE-CHATGPT-API-ERROR--. Příklad použití:

json
INVOKE-CHATGPT-API {
"model": "gpt-4o",
"messages": [
{
"role": "system",
"content": [
{
"type": "text",
"text": "Pokud vstup uživatele obsahuje nějaký cíl cesty, místo či lokaci, vrať tento cíl. Pokud ne, vrať NONE. Cíl cesty vrať v prvním pádě."
}
]
},
{
"role": "user",
"content": [
{
"type": "text",
"text": "$last_user_question"
}
]
}
],
"temperature": 0,
"max_tokens": 256,
"top_p": 1,
"frequency_penalty": 0,
"presence_penalty": 0
}

• GET-GPT-INTENT <text> - Lze využít jako alternativu k NLP v chatbotovi. Intenty se definují v administrátorské aplikaci v sekci “GPT intenty”. Rozpoznaný intent je vrácen na vstup chatbota. Následně jej lze získat v systémové entitě @sys-input.

• LOG <text> - při volání uživatelského požadavku LOG neprovede terminál žádnou specifickou akci. Hodnota <text> je vidět v historii konverzace v chatbotovi.

• RECOGNIZE-FACE - uživatelský požadavek provede rozpoznání obličeje osoby stojící před kamerou a vrátí hodnotu:
• --RECOGNIZE-SUCCESS-- pokud byl obličej rozpoznán
• --RECOGNIZE-FAILURE-- pokud se obličej rozpoznat nepodařilo
Jméno rozpoznané osoby včetně hodnoty nejistoty je vráceno v kontextové proměnné $fr_user.

• SET-CHATBOT-INPUT <text> - pošle zadaný <text> na vstup chatbota tak, jako by jej řekl uživatel do terminálu.

• MOOD <expression> <duration> <amplitude> nastaví výraz v obličeji (<expression>) na dobu <duration> sekund, s intenzitou výrazu <amplitude>
• <expression> ClosedSmile, OpenSmile, Sad, Angry, Fear, Disgust, Surprise, Thinking, Blush, LeftWink, RightWink, Blink, Scream
• <duration> čas, celé číslo, v sekundách
• <amplitude>amplituda výrazu - typicky 0-1, ale některé výrazy není problém nadsadit třeba na 1.2 (je třeba vyzkoušet, protože pro různé vyrazy obličeje se hodí jiná amplituda)
• příklad: "MOOD ClosedSmile 3 1.1" - úsměv se zavřenou pusou na 3 sekundy s "mírou" 1.1

json
HTTP-CALL <json-specification>

json
HTTP-CALL {   "method": <"POST"/“GET“/, …>   "url": <"service-url">,   "headers": {     <"header-key-1">: <"header-value-1">,     <"header-key-2">: <"header-value-2">,     …   },   "payload": <“text-payload“>,   "request-timeout-seconds": <time-in-seconds>,   "return-chatbot-message": <message-to-send-to-chatbot-after-finishing-call>,   "response-mapping": {     <"context-var-for-resultCode">: "RESULT_CODE",     <"context-var-for-resultMessage">: "RESULT_MESSAGE",     <"context-var-1">: <"json-path-1">,     <"context-var-2">: <"json-path-2">,     …   } }

json
HTTP-CALL

{

"method": "POST",

"url": "https://8c5dae17-0b31-45f9-be49-c0263cd2b6f6.mock.pstmn.io/testpath?param1=val1&param2=val2",

"headers": {

"Content-Type": "application/json",

"X-auth": "kjnm45531"

},

"payload": {

"state": "idle",

"data": {

"welcome_message": "Dobrý den,",

"messages": [

"msg1",

"msg2",

"msg3"

]

}

},

"request-timeout-seconds": 10,

"return-chatbot-message": "—HTTP-CALL-FINISHED--",

"response-mapping": {

"resultCode": "**RESULT_CODE**",

"resultMessage": "**RESULT_MESSAGE**",

"contextParam1": "$.key",

"contextParam2": "$.license.test"

}

}