Päivitä Diamond ja rakennamme sinulle oman sovelluksen Androidille tai iOS: lle
Docs : Käyttöohje : Response List

Vastausluettelo

Yleiskatsaus

Vastausluettelo on Bot Libren tekstitiedostomuoto botin vastausten määrittämiseksi. Vastausluettelo on kysymys-vastausparien luettelo. Jokainen lause erotetaan uudella rivillä, ja jokainen kysymys-/vastausluettelo erotetaan tyhjällä rivillä. Voit myös merkitä vastaukset metatietojen, kuten avainsanojen, avulla, jotka vaikuttavat vastaukseen. Vastauslistat ovat suositeltava tapa kouluttaa bottia. Botti löytää automaattisesti parhaan vastaavan vastauksen mihin tahansa kysymykseen, kysymysten ei tarvitse olla tarkkoja vastakohtia, vain riittävän samankaltaisia tai sisältää avainsanan.

Vastaustunnisteet

Päivä Kuvaus
Kysymys: Määrittää kysymyksen. Tätä ei tarvita, koska tyhjän rivin jälkeen ensimmäisen rivin oletetaan olevan uusi kysymys.
Malli: Määrittää kysymyksen kaavaksi. Kuvioiden avulla voidaan käyttää yleismerkkiä * ja muita yleismerkkejä.
Vastaus: Määrittää vastauksen. Tätä ei tarvita, koska kysymyksen jälkeen ei tarvita rivejä, kuten oletetaan vastauksista.
Malli: Määrittää vastausmallin. Näin voit upottaa itsekoodin {} hakasulkeisiin dynaamisia vastauksia varten.
Tunteita: Voit liittää tunteen (hyvä / huono) lauseeseen.
Kunnossa: Vaihtoehtoisesti voit antaa itsekoodin ehdon, jonka on oltava tosi, jotta vastaus voidaan käyttää.
Ajatella: Vaihtoehtoisesti voit antaa itse "ajattele" -koodin, joka arvioidaan, kun vastausta käytetään.
Komento: Voit halutessasi antaa JSON-komennon (Itsekoodi), joka arvioidaan ja palautetaan asiakkaalle pelien ja virtuaaliavun tueksi.
Aihe: Voit halutessasi antaa aiheen vastauksen luokittelemiseksi alle.
vaadi aihe: Jos aihe on pakollinen, vastausta käytetään vain, kun aihe on aktiivinen.
yksinomainen aihe: Jos aihe on yksinomainen, vain aihetta jakavia vastausita käytetään aiheen ollessa aktiivinen.
Label: Voit halutessasi antaa selitteen, jonka mukaan vastausta voidaan käyttää uudelleen nimellä.
Avainsanat: Voit halutessasi antaa avainsanoja kysymyksestä, joka vaikuttaa vastausvastaavuusin.
Tarvitaan: Voit halutessasi antaa tarvittavat sanat kysymyksestä, jota tarvitaan vastausvastaavuuden saamiseksi.
Tunteita: Voit liittää tunteen vastaukseen.
Toimia: Voit liittää toiminnon vastaukseen.
Aiheuttaa: Voit liittää poseerauksen vastaukseen.
toistetaan: Voit halutessasi antaa vastauksen käytettyihin, jos nykyistä vastausta on jo käytetty tässä keskustelussa.
ei toistoa: Vaadi, että vastausta tai lausetta käytetään vain kerran.
Edellinen: Voit halutessasi antaa aiemman vastauksen, joka antaa vastaukselle kontekstin.
vaatia edellistä: Vaadi, että vastausta käytetään vain, jos edellinen vastaus vastaa jotakin aiemmista vastauksista.
Luottamusta: Luottamusta voidaan käyttää, jos vastaus ei ole varma. Käytetään vastetta, jolla on suurin luottamus.

question:

Vastauskysymys voi olla lause, joka vastaa automaattisesti samankaltaisia kysymyksiä tai voi olla kuvio. Kuviot täsmäävät kirjaimellisesti kuvion sanojen järjestyksessä, ja ne voivat sisältää yleismerkkejä, kuten *, ja ne voivat sisältää myös säännöllisiä lausekkeita. Yleensä on parasta käyttää lausetta ja antaa botin päättää, vastaako kysymys, voit myös lisätä avainsanoja ja tarvittavia sanoja parantaaksesi, kun kysymys vastaa. Jos haluat syöttää kuvion, käytä kuviota: tunniste.

what is your name
question: what is your name
pattern: What is *

response:

Vastaus voi olla lause, se voi sisältää HTML-sisältöä tai rikasta sisältöä, kuten kuvia, videoita ja painikkeita, tai vastaus voi olla malli. Malli on vastaus, joka voi sisältää jonkin verran itsekoodia. Kaikki mallin {} sisällä olevat koodit suoritetaan ja tulos tulostetaan vastaukseen. Jos haluat syöttää mallin, käytä mallia: merkitse ja kirjoita oma koodi hakasulkeisiin {} .

My name is Julie.
My name is <b≷Julie</b≷.
response: My name is Julie.
template: My name is {#self.name}.
template: The date is {Date.date()}.

keywords:

Keywords are important words in the question that should influence when the response is used.

// Keywords are used to allow this response to be used for any questions on hockey or spinach.
question: do you like hockey
response: Hockey is my favorite sport.
keywords: hockey

question: what do you love
response: I love hockey!
keywords: love luv like adore

question: do you like field hockey
response: I only play ice hockey.
keywords: "field hockey"

question: i love spinach
response: Spinach is is my favorite food.
keywords: spinach

A keyword will be used by the bot to select the best response. Keywords let some words count for more than other words. In the example, the bot knows two responses, how will it respond to the phrase "I love hockey"? Without the keywords the bot would probably match this question with "I love spinach", but since hockey is a keyword, it will instead match it with "Do you like hockey?".

If the response has no defined required words, then the keywords will also be required for the response match. So "I love hockey" would not be matched with "I love spinach." because it is missing the keyword.

If you keywords has many similar words. You can list them all as keywords to match any of the words. You could also define these words a synonyms, which may be a better option.

You can also use compound words are keywords. A compound keyword must have all the words in the order to be used. For a compound keyword just wrap the words in "quotes".

Be careful using too many keywords. If every word is a keyword, then their value is diminished. Never make common words like "the", "a", "he", "what" keywords, if you require one of these words for a match use a required word instead.

You can also review all of your bot's keywords by searching for 'words' and restrict to 'keywords'. This lets you remove a word from being a keyword if you added it by mistake.

required:

A required word is a word that is required to be in the question for a specific response.

// This example requires the words 'like' and 'hockey'.
question: do you like hockey
response: Yes, I like hockey.
required: like hockey

// This example requires the compound word 'ice hockey'.
question: do you like ice hockey
response: Yes, I like ice hockey.
required: "ice hockey"

// This example requires one of the words 'like' or 'love', and 'hockey'.
question: do you like ice hockey
response: Yes, I like ice hockey.
required: (like love) hockey

// This example requires a pattern.
question: are you okay
response: Yes, I am okay.
required: Pattern("^ are you (ok okay)")

A required word can be used to ensure the bot does not choose a response if the required word is missing from the question. For example the question "Do you play hockey?" would normally be matched to this response, but because it is missing the required word "like", it will not be considered as a match.

All of the required words must be contained in the question in order for the response to be used. Required words also supports lists, compound words, and patterns. To require one of a set of words a list can be used using brackets i.e. (like love). To require a compound word quotes are used i.e. "hello world". To require a pattern enter the pattern i.e. Pattern("what is *").

Previous

A previous responses is the bot's preceding response. Previous responses can be used to give a response a context.

// This example uses previous to give different answers to 'yes' depending on the context.
question: yes
response: Great, wanna go out sometime?
require previous: Are you single?

question: yes
response: I am please to hear that.
require previous: Are you happy?

The question "Yes" has multiple responses. The bot can use the previous response to choose the best response. You can also invalidate a previous response to ensure the bot does not use a response if the previous response was preceding.

A previous response can either be 'required' or optional. If required, the response will never be used unless one of the previous response matches. If optional (default) the response is given precedence if the previous response matches, but can still be used if the previous does not match.

topic:

A topic is the general topic category for the response. For example a response on a hockey related question would belong to the "hockey" topic. You can use topics to categories your responses and give the bot additional context. If the bot has multiple responses to a question, it will use the one that matches the current topic.

Topics can be either optional or required. The response topic is optional by default, it you click on 'Require Topic', then the response will only be used if that topic is active in the conversation. If optional the topic will be set as active for the conversation, until a new topic is set.

Topics can also be defined as exclusive. An exclusive topic defines an isolated conversational space. For a normal topic that is not exclusive the bot can still use responses that do not have the same topic, but responses with the active topic will be given precedence over responses without a topic. For exclusive topics only response that have the same topic as the active topic will be used. No other responses will be used (other than possibly the default response if there is no topic default).

Topics can also be set on greetings to start the conversation with a topic. Topics can be set on default responses to provide a different response when that topic is active.

// Categorizes the product response.
question: what are your products
response: Our products include ACME CRM and ACME ERP.
topic: products

// Use an exclusive topic to define a joke conversational dialog.
question: joke
response: Knock knock.
exclusive topic: joke

question who is there
response: Boo.
require topic: joke

question: boo who
response: Don't cry. lol
require topic: joke
think: conversation.topic = null;

default: Say 'Who is there?'
require topic: joke

default: Say 'Boo who?'
require topic: joke
previous: boo

label:

A response can be given an intent label to let you reuse the same response in other questions. You can also use labels in a response's previous.

// Use a label to reuse the common products response.
question: products
response: Our products include ACME CRM and ACME ERP.
label: #products

question: what are your products
response: #products

question: what software do you sell
response: #products

question: are they good
response: Our products are the best in the world.
previous: #products

on repeat:

If the user asks the same question, or similar questions multiple times, you may want your bot to give a different response the second time. On repeat lets you set one or many responses to use the second time that response is triggered in the same conversation. You can also set 'No Repeat' to never repeat the response in the same conversation.

// Offer to escalate the issue if the user repeatedly asks for help.
question: help
response: How can I help you?
on repeat: What is the issue that you are having?
on repeat: Would you like me to have a support staff contact you?

question: goodbye
response: Before you go, would you like to take a survey?
no repeat:

question: goodbye
response: Goodbye.

condition:

Conditions let you enter Self code that must evaluate to true for the response to be used. This is an advanced properties as it requires you understand Self (a dialect of JavaScript), but can be used to do very powerful things.

// Response to goodbye differently based on the time of day.
question: goodbye
response: Goodnight.
condition: Date.get(#hour, Date.time()) > 18

question: goodbye
response: Goodbye.

think:

Think let you enter Self code that is executed when the response is used. This is an advanced properties as it requires you understand Self (a dialect of JavaScript), but can be used to do very powerful things.

// Track the user's name.
pattern: my name is *
template: Pleased to meet you {star}.
think: speaker.name = star;

question: what is my name
template: Your name is {speaker.name}.

question: can we change the subject
response: Sure, what would you like to talk about?
think: conversation.topic = null;

confidence:

You can enter multiple responses for the same question. The bot will use the response that it is the most confident in for the current conversational context. By default a response is given a confidence level of 90%, but you can customize the value. Note that in a group discussion such as when the bot is added to a chatroom, or on Twitter, the bot will only use responses that have >=90% confidence.

sentiment:

You can associate a user question or phrase, or individual words with sentiment (good vs bad). Sentiment can be used to track how the user is feeling about the current conversation. The sentiment statistic is tracked by your bot daily and can be graphed from its Analytics page.

question: thank you
response: You are most welcome.
keywords: thank
sentiment: good

question: you suck
response: Sorry, I am doing my best. Would you like me have someone contact you via email?
keywords: suck
sentiment: bad

word: suck
sentiment: bad

word: great
sentiment: great

Seuraava ja keskusteluvirrat

Seuraavien vastauskysymysten avulla voidaan käsitellä seurantakysymyksiä ja keskusteluvirtoja. Voit aloittaa keskusteluvirran sisentää vastauksen seuraavan seurantakysymyksen. Voit käyttää sisennyksissä välilehtiä tai 4 välilyöntiä. Voit myös sisentää useita tasoja keskustelupuun määrittäminen.

Seuraava kysymys määrittää erillisen keskustelutilan. Botti valitsee seuraavan vastauksensa vain annetuista vastauksista. Jos haluat määrittää oletusvastauksen, käytä oletusarvoa: tag. Jos botti ei pysty vastaamaan käyttäjän kysymykseen seuraavalla kysymyksellä, se etsii vastausten vanhemmasta, muuten käyttää botin oletusvastausta.

Seuraava on samanlainen kuin edellinen, mutta toisin kuin edellinen, se on eristetty vastaukseen. Seuraavan vastauksen yhteydessä botti ei koskaan käytä mitään vastauksiaan seuraavan vastauksen kontekstin ulkopuolella. Tämän ansiosta on helppo määritellä yksittäisiä ja sisäkkäisiä keskusteluja.

question: help
response: Do you want help with <button>web</button> or <button>mobile</button>
keywords: help

	question: web
	response: Is you issue with <button>HTML</button> or <button>JavaScript</button>?

		question: html
		response: See https://www.w3schools.com/html

		question: javascript
		response: See https://www.w3schools.com/js

	question: mobile
	response: Are you using <button>Android</button> or <button>iOS</button>?

		question: android
		response: See https://www.android.com

		question: ios
		response: See https://developer.apple.com/ios

	question: quit
	response: Okay. Let me know if you need further help.

	default: Please specify <button>web</button> or <button>mobile</button>, or type <button>quit</button> if you do not need help.

Terveisiä

Tervehdys on botin ensimmäinen vastaus uudessa keskustelussa. Tervehdyksillä voi olla suurin osa samoista tunnisteista kuin vastauksissa. Tervehdyksen määrittämiseen käytetään tunnistetta.

greeting: Welcome to my website. I am Julie, how may I be of service?

Oletusvastaukset

Jos botti ei löydä hyvää vastinta käyttäjän syötteelle, se käyttää oletusvastaustaan. Oletusvastauksilla voi olla suurin osa samoista tunnisteista kuin vastauksilla. Oletusvastauksen määrittämiseen käytetään oletusarvoa: tunnistetta.

default: Sorry, I do not understand.
			
default: Sorry, I do not understand. Please email [email protected] for more information.
topic: Sales

Lauseita

Lauseet voidaan määritellä yhdistämään tunteet, tunteet, toiminta tai poseeraus lauseeseen.

thanks for the help
sentiment: good

you are not helping me
sentiment: bad

Sanoja

Sana voidaan määritellä yhdistämään tunteet, tunteet ja synonyymit. Sana voi olla myös avainsana, aihe tai yksinomainen aihe.

word: good
sentiment: good
synonyms: great wonderful cool amazing 

word: bad
sentiment: bad
synonyms: sucks terrible horrible

word: aiml
keyword: true
topic: true

Word-tunnisteet

Päivä Kuvaus
Sana: Määritä sana.
Tunteita: Vaihtoehtoisesti voit liittää tunteen sanaan.
Tunteita: Vaihtoehtoisesti voit liittää tunteen sanaan.
Avainsanan: Määritä sana avainsanaksi.
Synonyymit: Vaihtoehtoisesti voit antaa sanalle synonyymin, jotta kysymyksen samankaltaiset sanat käynnistävät saman vastauksen.
Aihe: Määritä aiheeksi sana.
yksinomainen aihe: Määritä sana yksinomaiseksi aiheeksi.

Katso myös