Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
SAP Conversational AI
Document Version: 1.2 – 2019-10-07
The table below shows the new features and enhancements for each release of SAP Conversational AI.
Available as
Release What's New Description Type of
1909 Single Sign-on You can configure single sign-on or authentica New October 7,
(SSO) or end user tion for your end users. Once authenticated, the 2019
authentication business user can interact with the chatbot with
out providing their credentials on each log on.
1909 SAP Conversational You can integrate the SAP Conversational AI Web New October 7,
AI Web Client Client with your web solution based in SAP Cloud 2019
(linked with SSO) Platform. The Web Client adheres to the SAP Fiori
Design guidelines and respects enterprise prod
uct standards. It reuses the authentication of the
embedding platform to provide a single sign-on
experience.
1909 Connect to external During a conversation, you most likely want to re New October 7,
API services (linked trieve business information or connect to an ex 2019
with SSO) ternal system to perform actions. Besides using
webhooks, you now have greater flexibility in re
trieving and using data from API service re
sponses (JSON object).
1909 Support for Secon Besides the REQUIRED INFORMATION that is Enhancement October 7,
dary Information on necessary for your skill to work, you can also de 2019
Requirements tab fine the SECONDARY INFORMATION on the
Requirements tab. The additional pieces of infor
mation that the user might provide are consid
ered as optional and are defined under
SECONDARY INFORMATION, and can be used to
further filter the data
1909 Updated instruc The instructions for integrating your bot with Enhancement October 7,
tions for integrating Slack, Facebook Messenger and SAP CoPilot 2019
your bot with Slack, have been updated as per the latest changes in
Facebook Messen the user interface of these channels.
ger and SAP CoPilot
channels
1909 Bot versioning acti When you create a new bot, by default, your bot Enhancement October 7,
has only one main version v1 and is assigned to
vated by default 2019
the DEVELOPMENT environment. This allows you
to manage and update large, complex chatbots in
an organized way that doesn’t expose working
drafts of a chatbot to users.
1909 Support for If you have integrated your bot with the Slack Enhancement October 7,
app_mention event
channel and you want your users to directly ad 2019
in Slack
dress your bot with its name, they can do this by
typing @botname.
1909 Disablement of con From 1909 release onwards, you will not be able Deprecation October 7,
nector creation for to create connectors for the following channels: 2019
Callr, Cisco Spark, Callr, Cisco Spark, Kik, and Twitch. Please migrate
Kik, and Twitch to other channels for an uninterrupted experience
of SAP Conversational AI. Contact us if you
are using these channels productively.
Note
Twilio is no longer planned for deprecation
(as mentioned in 1906). You can continue to
integrate your bots with this channel until fur
ther notice.
1909 Sunset of Open- As of 1911 release, you will not be able to use the Deprecation October 7,
source Bot Connec Open-source Bot Connector to run a chatbot 2019
tor within a virtual network. If you are running a
standard or customized version of open source
bot connector on your platform, please migrate
to the bot connector available on our bot building
platform (hosted in on SAP Cloud Platform),
which offers integration with a wide range of
channels, governed by secure data processing as
per SAP product standards.
1909 Deprecation of To simplify the bot menu, the Code tab has been Deprecation October 7,
Code tab deprecated from 1909 onward. The information in 2019
this tab is available in Connect to external service
in Concepts of SAP Conversational AI.
1909 Duplicate Entity Val From 1912 release onwards, all duplicate entity Deprecation October 7,
ues for an Entity values for a given entity will be removed, and no 2019
distinction made between lowercase and upper
case. Users will no longer see duplicates. This will
have no impact on entity detection.
1909 Version one (v1) of From 1912 release onwards, version one of the Deprecation October 7,
the Builder builder (Builder v1) will no longer be sup 2019
ported. Please switch to the new version of the
builder. You can do this by creating a bot and re
porting all the changes.
1909 act and type de From 1912 release onwards, actand type detec Deprecation October 7,
tection tion will no longer be supported for the following 2019
API's:
1909 Token referenced by From 1911 release onwards, tokens will no longer Deprecation October 7,
ID be referenced by ID, but by index in the source ex 2019
pression or log. As a consequence, the route to
update an expression no longer accepts an id
parameter in tokens, but accepts a new ind pa
rameter instead.
1906 Enrichments for Lo When the location (gold entity) is detected, New July 1, 2019
cation (gold entity) the JSON returned by the API is enriched with ad
ditional information about the entity: place, street
name, street number, postal code, city, state,
country.
1906 Assign Base Per If you are the administrator of an organization, or New July 1, 2019
missions and Team if you have Read and Write permissions for the
Permissions on Bot Settings module, you can assign one of the follow
Level ing permissions as the base permission to all
members of the organization or to a team for a
given bot.
● Read only
● Read and write
1906 word_id From end of August 2019, the following route to Deprecation July 1, 2019
update expressions will only accept word names.
It will no longer accept word IDs: https://
api.cai.tools.sap/train/v2/users/
$USER_SLUG/bots/$BOT_SLUG/
versions/$VERSION_SLUG/dataset/
intents/$INTENT_SLUG/expressions/
$EXPRESSION_ID.
Creating an expression
https://api.cai.tools.sap/
train/v2/users/$USER_SLUG/bots/
$BOT_SLUG/versions/$VERSION_SLUG/
dataset/intents/$INTENT_SLUG/
expressions
https://api.cai.tools.sap/
train/v2/users/$USER_SLUG/bots/
$BOT_SLUG/versions/$VERSION_SLUG/
dataset/intents/$INTENT_SLUG/
expressions/bulk_create
1906 Refactor Routes From end of September 2019, all routes starting Deprecation July 1, 2019
Starting with /v2 with /v2 that are not prefaced with /train will
be deprecated. Please use /train/v2 instead.
For example, https://
api.cai.tools.sap/train/v2/users/
$USER_SLUG/bots/$BOT_SLUG/
versions/$VERSION_SLUG/dataset/
bulk_creations
1906 API to Retrieve All From October 2019, the following API to retrieve Deprecation July 1, 2019
Entities all entities will no longer be supported:
https://api.cai.tools.sap/
train/v2/entities. Entities will no longer
be global labels and will instead belong to a bot.
To get all entities for a given bot, please use the
following API: https://
api.cai.tools.sap/train/v2/
users/:user_id/bots/:bot_id/
versions/:version_id/dataset/
entities.
1906 Community sup Community support on Slack will no longer be Migration July 1, 2019
port available after June 2019. Please address your
questions to the community on https://
answers.sap.com/ .
1906 Fork Intent The dropdown menu to choose the bot, while Fix July 1, 2019
forking an intent, now opens on the click of the ar
row.
1906 SAP Customer En The SAP Customer Engagement Center has Fix July 1, 2019
gagement Center been renamed to SAP Contact Center.
1903 New Intent Classifi A new intent classification algorithm is now avail New April 5, 2019
cation Algorithm able that improves your bot's understanding and
provides a better confidence score when an in
tent is detected. You can switch to the new algo
rithm in your bot's settings. If you switch to the
new algorithm, you can't switch back to the old
one.
● No access
● Read only
● Read and write
● Create bot (+ Read and write)
1903 Markdown in Mes When creating text messages or quick replies on New April 5, 2019
sages the Actions tab or Requirements tab of a skill, you
can now opt to use markdown to format text as
bold, italics, or as a hyperlink . For a preview of
how your text message or quick reply will be ren
dered, simply save it.
1903 Context Manage When a user is conversing with your bot in Eng New April 5, 2019
ment for Descrip lish, French, or Spanish, and your bot replies with
tions a list, carousel, quick replies, or buttons, the user
can now refer to an item in the message using a
superlative like cheapest or most expensive or us
ing an ordinal like first or second. For example, if
the bot displays a list of flights, the user can tell
the bot to book the cheapest flight or to book the
last flight.
1903 Set Time Zone in Under Preferences in your user settings, you can New April 5, 2019
User Settings now set your time zone. This time zone is then
used as the default time zone when you set filters
in your log feed, usage metrics, and training ana
lytics.
1903 Default Matching When you create a new bot, the matching strict New April 5, 2019
Strictness in Natu ness in NLP is now set to 50 by default. You can
ral Language Proc adjust it in your bot's settings.
essing (NLP)
1903 Email Verification You may remember that we mentioned in the New April 5, 2019
What's New for the 1901 release that you'll be
asked to confirm your email address when you
next log in to SAP Conversational AI in order to
continue to access the platform. If you've not
confirmed your email address already, you must
do so now. You only need to do this once.
1902 Alert to New Prod When a new product release is out, you're now New February 21,
uct Release alerted in your profile. From the alert, you can 2019
open the changelog in a new window and get the
rundown on all the new features, enhancements,
and fixes.
1902 Training Analytics ● For you to run a benchmark, your bot now Enhancement February 21,
only needs to have at least 4 intents. Previ 2019
ously, it needed to have at least 5.
● You can now filter your benchmarks by envi
ronment, version, language, and datetime.
● The new page design lets you run a new
benchmark with or without a validation file
more easily.
● The time-remaining information is now more
precise.
● The Accuracy metric has been removed be
cause it was the same metric as Recall.
● The following metric has been added when
you compare two benchmarks: Size.
● When you click a single intent or entity in
your benchmark, the same lines are now in
focus in your confusion matrix.
● In your confusion matrix, the colors now
more clearly show the percentage differen
ces.
1902 Usage Metrics For quicker loading, the default time range for Enhancement February 21,
fetching your metrics is now last week, and not all 2019
time. As before, you can change the time range by
clicking SHOW FILTERS and then specifying a
time range. Also for better loading, the metrics
are fetched asynchronously.
1902 Log Feed For security, when you download your logs in CSV Enhancement February 21,
format, all user inputs that start with characters 2019
like +, -, =, etc. are now prepended with a back
slash (\) to prevent the characters from being
processed in Microsoft Excel with unanticipated
consequences.
1901 Enrichments for When a gold entity is detected, the JSON re New January 23,
Custom Entities turned by the NLP API is enriched with additional 2019
information about the entity. Although you can't
change the enrichments for gold entities, you can
now create enrichments for custom entities. This
means that you can create keys that appear in the
JSON when a custom entity is detected. The keys
are then populated with the correct values, de
pending on the configuration.
1901 Open-Source Bot The Bot Connector already enables you to con New January 23,
Connector nect your bot to multiple messaging channels. 2019
The code to run the Bot Connector is now hosted
publicly at https://github.com/SAPConversatio
nalAI/bot-connector . This means that you or
your enterprise can now download the Bot Con
nector and run a chatbot within a virtual network.
This is especially useful if you're apprehensive
about opening your internal network to the inter
net. You can also vote for the next channels you
want us to implement, or you can contribute
yourself!
1901 Email Verification When you next log in to SAP Conversational AI, New January 23,
you'll be asked to confirm your email address. You 2019
only need to do this once. However, you must do
so by March 22, 2019 in order to continue to ac
cess the platform.
1901 Delete Your SAP In your settings, you can now delete your SAP New January 23,
Conversational Conversational AI account. Note that this will also 2019
AIAccount delete all bots that you created with this account,
except for bots that you created from within an
organization if there are still members of that or
ganization (including another administrator). To
delete your account, click your avatar at the top
right of the page, choose Settings, and then click
DELETE YOUR ACCOUNT.
1901 Suggested Expres If you've added the languages English, French, Enhancement January 23,
sions German, or Spanish to an intent, and enter a new 2019
expression for the intent in any of those lan
guages, the platform already automatically sug
gests additional expressions in those languages.
We've enhanced that capability to now vary the
sentence structure and also the vocabulary of the
suggested expressions. This enables you to build
a higher quality training dataset very quickly and
enables your bot to understand its users more
precisely.
1901 Entities On the Train tab, we’ve made two enhancements Enhancement January 23,
to entities: 2019
1901 Training Analytics We've improved the csv upload of your validation Fix January 23,
file and fixed the issue that caused the bench 2019
mark to be stuck at 99% for some bots.
1901 Usability For links and buttons, we’ve added tooltips with Enhancement January 23,
helpful information around the platform to help 2019
you to better understand each step.
The table below shows the new features and enhancements for each release of SAP Conversational AI in 2018.
W
h
a
t
'
s
N
e
Release w
Description Type Available as of
1812 R
This new feature helps you to ensure that your training data New December 21,
eset represents reality as far as possible. 2018
a
After uploading a validation file, you can get metrics about
l
how close your training dataset is to reality (from your vali
i
dation file), as well as suggestions to improve your dataset.
t
For example, you can find the length of the expressions in
y
your training dataset compared with the medium length of
C
the sentences sent by your users. You can also find the most
h
important words in an intent compared with the most impor
e
tant words when your users chat. If some words are missing
c
in your dataset, or if some words are never used by your
k
users, we provide tips to help you solve the issue.
i
nFor more information, see Training analytics in the User
TGuide to Concepts of SAP Conversational AI.
r
a
i
n
i
n
g
A
n
a
l
y
t
i
c
1812 A
You can now add a delay of up to 5 seconds between each New December 21,
dmessage in a group of messages. For example, this enables 2018
dyou to ensure that users have enough time to read the first
amessage before sending the next one.
D
For more information, see Messages and Send rich mes
e
sages in the User Guide to Concepts of SAP Conversa
l
tional AI.
a
y
B
e
t
w
e
e
n
M
e
s
s
a
g
e
s
1812 S
Due to General Data Protection Regulation (GDPR) require New December 21,
pments, you now need to select the type of data processed by 2018
eyour bot (non-personal, personal, sensitive personal, or
chealth) and type of end users (non-vulnerable or vulnerable)
iwhen creating a new bot. For existing bots, you need to add
fthis information by the end of 2019.
y
t
h
e
T
y
p
e
o
f
D
a
t
a
a
n
d
T
y
p
e
o
f
E
n
d
U
s
e
r
s
1812 U
In your settings, you can now update your personal data, for New December 21,
pexample, your email address or username. Click your avatar 2018
dat the top right of the page and choose Settings.
a
t
e
y
o
u
r
p
e
r
s
o
n
a
l
d
a
t
a
1812 O
When calling a webhook, you can now choose OAuth 2 au Enhancement December 21,
pthentication. Previously, you could choose between no au 2018
tthentication or basic authentication. With OAuth 2 authenti
ication, a client ID, client secret, and authorization URL are
opassed with the request.
n
o
f
O
A
u
t
h
2
A
u
t
h
e
n
t
i
c
a
t
i
o
n
W
h
e
n
C
a
l
l
i
n
g
a
W
e
b
h
o
o
k
1812 IThe cookie consent banner on our website now lets you Enhancement December 21,
m
choose the type of cookies that you want to accept: Func 2018
ptional (mandatory), Performance (selected by default), and
rMarketing.
o
v
e
d
C
o
o
k
i
e
M
a
n
a
g
e
m
e
n
t
1811 C
For users to meaningfully converse with your chatbot using New November 29,
onatural language, your bot needs to be able to recognize pro 2018
nnouns (like it or that) and map them to entities (for example,
ta name or product) previously mentioned in the conversa
etion. You can now enable your bot to do this in the settings
xfor your bot.
t
For more information, see Entities in the User Guide to
M
Concepts of SAP Conversational AI and scroll down to Refer
a
ences between entities.
n
a
g
e
m
e
n
t
f
o
r
P
r
o
n
o
u
n
s
1811 B
When creating a chatbot, you can now tag your bot with up New November 29,
oto six topics (for example, Customer Support, HR, Payments, 2018
tetc.). By categorizing your bot in this way, we can suggest
Tmore appropriate training data to improve it later on.
o
You can also add/remove topics when editing your bot, as
p
well as add topics to a bot that you created prior to this re
i
lease.
c
s
1811 M
You can now send custom data from your website to your New November 29,
echatbot, like the name of the logged in user, their ID, and the 2018
m
page they are currently viewing (for example, to send prod
ouct suggestions). You do this by defining a
rwindow.webchatMethods.getMemory function. The
ywebchat calls this function before sending user messages. It
M
then sends your arbitrary payload along with the message to
athe bot.
n
If you use the Bot Builder, your payload is put in the conver
a
sation memory. This enables you to access this data in the
g
Bot Builder. For example, if you send { "userName":
e
"Dominik", "userId": 123456 } as the payload,
m
eyou can then send Hello {{ memory.userName }}!
nHow do you do? as a greeting message.
t
For more information, see Webchat in the User Guide to
i
Concepts of SAP Conversational AI.
n
W
e
b
c
h
a
t
1811 EPreviously, when you created or edited a bot, the Train tab Enhancement November 29,
nwas primarily sorted by intents. This made entity analysis 2018
tand detection tricky. Now, the Train tab is clearly organized
iinto intents and entities, so that you can easily sort the enti
tties and accelerate the training of your bot.
y
For more information, see Entities in the User Guide to
F
Concepts of SAP Conversational AI.
i
l
t
e
r
s
1811 TOn the Monitor tab of your chatbot, the Training Analytics Enhancement November 29,
rsection now provides you with information about your entity 2018
adetection as well as tips to improve entity detection.
i
For more information, see Training analytics in the User
n
Guide to Concepts of SAP Conversational AI.
i
n
g
A
n
a
l
y
t
i
c
s
1810 V
You can now version your chatbot and easily deploy it to spe New October 29, 2018
ecific environments. For example, you may want to create a
rnew version of your bot prior to major updates to your train
sing dataset or skills, and test the new version in a staging en
ivironment before moving it to the production environment.
oAlternatively, you may want to create two or more variants of
nthe same core bot for different audiences. A bot can have up
ito five versions. Each version is independent of the others,
nso you can update the new version and original version sepa
grately.
1810 TOn the Monitor tab of your chatbot, we’ve added a new New October 29, 2018
rTraining Analytics section to help you build a great dataset
afor your bot. Your dataset (that is, all the intents and entities
ithat you’ve created and trained) is key to your bot’s success.
nIf your bot isn't well-trained (meaning your dataset isn't well-
istructured or is incomplete), your bot won't be able to cor
nrectly understand its users, resulting in a disappointing con
gversational experience.
A
To measure the performance of your dataset, you can run a
n
benchmark. It will give you insights into how to improve your
a
dataset. We also provide suggestions to help you.
l
yFor more information, see Training Analytics in the User
tGuide to Concepts of SAP Conversational AI.
i
c
s
1810 P
If you connect your chatbot to Webchat and/or Messenger, Enhancement October 29, 2018
eyou can now create a menu that is always available, so that
rusers can quickly trigger certain skills at any point in the
sconversation. This reduces the back-and-forth required to
icarry out common actions and gives users a better overview
sof your bot’s capabilities.
t
e
n
t
M
e
n
u
i
n
W
e
b
c
h
a
t
a
n
d
F
a
c
e
b
o
o
k
M
e
s
s
e
n
g
e
r
1809 S
If you've added the languages English, French, German, or New September 26,
uSpanish to an intent, and enter a new expression for the in 2018
gtent in any of those languages, the platform now automati
gcally suggests additional expressions in those languages.
eYou can quickly and easily add the suggested expressions to
sthe intent. This increases the size of the training dataset, en
tabling your bot to understand its users more precisely.
e
d
E
x
p
r
e
s
s
i
o
n
s
1809 R
On the Actions tab in the Bot Builder, you can now easily re New September 26,
eorder message groups by drag and drop. 2018
o
For more information, see Actions in the User Guide to
r
Concepts of SAP Conversational AI.
d
e
r
i
n
g
A
c
t
i
o
n
s
i
n
t
h
e
B
o
t
B
u
i
l
d
e
r
1809 LFor improved monitoring of your bot’s usage, as well as to Enhancement September 26,
osimplify training, you can now filter your logs by intent, lan 2018
gguage, date, and strictness. You can also download all your
Flogs as a .csv file.
e
New Features in Webchat
e
dWe've added the following new features to Webchat – the
messaging channel developed by the SAP Conversational AI
team:
1807 U
You now have access to usage metrics detailing how your New July 20, 2018
schatbot is used, for example, the number of conversations
aand users, how many messages are sent every day, month,
gand year, and which skills or intents are used the most.
e
All metrics are extracted through the Bot Builder from the
M
conversations that users have with your chatbot. The met
e
rics are filtered by language (except for some graphs) and a
t
time range that you can select.
r
iFor more information, see Usage Metrics in the User
cGuide to Concepts of SAP Conversational AI.
s
1807 IYou can now create a chatbot in SAP Conversational AI and New July 20, 2018
ndeploy it to SAP CoPilot. To make your chatbot callable on
tCoPilot, you need to configure it in CoPilot. To help you,
ewe've added a short step-by-step procedure in the Bot Con
gnector.
r
For example, you create a chatbot called “C4C chatbot” in
a
SAP Conversational AI. Once you’ve configured it in CoPilot,
t
you can open the CoPilot app and say something like “Ask
i
my C4C bot how many sales I made in 2017”. CoPilot then
o
routes the conversation to your C4C chatbot, and the con
n
versation is executed in SAP Conversational AI.
w
i
t
h
S
A
P
C
o
P
i
l
o
t
1807 IYou can now connect your chatbot to Amazon Alexa as an New July 20, 2018
nAlexa skill. To help you, we've added a short step-by-step
tprocedure in the Bot Connector.
e
g
r
a
t
i
o
n
w
i
t
h
A
m
a
z
o
n
A
l
e
x
a
1807 W
You could already use webhooks in the previous release to Enhancement July 20, 2018
eretrieve business information or connect to an external sys
btem to perform actions. In this release, you can configure
hthe authentication, header content, and body content of the
owebhook.
o
For more information, see Custom code and webhooks in
k
the User Guide to Concepts of SAP Conversational AI.
s
Hyperlinks
Some links are classified by an icon and/or a mouseover text. These links provide additional information.
About the icons:
● Links with the icon : You are entering a Web site that is not hosted by SAP. By using such links, you agree (unless expressly stated otherwise in your
agreements with SAP) to this:
● The content of the linked-to site is not SAP documentation. You may not infer any product claims against SAP based on this information.
● SAP does not agree or disagree with the content on the linked-to site, nor does SAP warrant the availability and correctness. SAP shall not be liable for any
damages caused by the use of such content unless damages have been caused by SAP's gross negligence or willful misconduct.
● Links with the icon : You are leaving the documentation for that particular SAP product or service and are entering a SAP-hosted Web site. By using such
links, you agree that (unless expressly stated otherwise in your agreements with SAP) you may not infer any product claims against SAP based on this
information.
Example Code
Any software coding and/or code snippets are examples. They are not for productive use. The example code is only intended to better explain and visualize the syntax
and phrasing rules. SAP does not warrant the correctness and completeness of the example code. SAP shall not be liable for errors or damages caused by the use of
example code unless damages have been caused by SAP's gross negligence or willful misconduct.
Gender-Related Language
We try not to use genderspecific word forms and formulations. As appropriate for context and readability, SAP may use masculine word forms to refer to all genders.
SAP and other SAP products and services mentioned herein as well as
their respective logos are trademarks or registered trademarks of SAP
SE (or an SAP affiliate company) in Germany and other countries. All
other product and service names mentioned are the trademarks of their
respective companies.