Speechly can post-process some entity values so that they are returned in a more structured format. This is done by assigning the entity to have an appropriate Data Type in the Dashboard.
Unless otherwise specified, the entity values returned from the Speechly API are verbatim what the user said. If you have configured the template
*book book a flight for $SPEECHLY.DATE(departure)
and the user says “book a flight for july third twenty twenty one”, without using a Data Type the API returns
value: "july third twenty twenty one"
However, if you explicitly designate the entity departure to have Data Type Date in the Dashboard, the API returns
The Data Type of an entity thus determines what is done to the entity value after it has been recognized. While the default Data Type String returns the value verbatim, the other Data Types, such as Date, provide normalizations for the entities that make their further use easier. The Data Types are defined in the Speechly Dashboard when listing entities.
And while Standard Variables and Data Types can be used separately, the two features are best when combined.
Here are all Entity Data Types that we support, a brief description of what they do, and with what Standard Variable they are designed to work.
Date — expressions that define a date are converted into ISO-8601 as a string (e.g., January fifth twenty twenty → 2020-01-05). Relative expressions like tomorrow or next Friday are parsed relative to the current date. If the year is missing from the expression, the current year will be used. Works together with the $SPEECHLY.DATE standard variable.
Time - expressions that define a time of day are returned as a hh:mm formatted string using a 24-hour clock (e.g., three thirty pm → 15:30, quarter past two in the morning → 02:15, twenty past nine pm → 21:20). Works together with $SPEECHLY.TIME.
Number normalizes all numeric utterances into digits (e.g., five six four nine → 5649, seventeen point five → 17.5, three hundred thousand → 300000, three quarters → 0.75). Works together with $SPEECHLY.*_NUMBER standard variables.
Identifier should be used together with alphanumeric identifiers (sequences) that are spelled out one character at a time. Entities of this type are normalized into character sequences representing the identifier (e.g., zero zero seven x → 007x, one two seven dot zero dot zero dot one slash x y → 127.0.0.1/xy). Works together with $SPEECHLY.IDENTIFIER* standard variables.
Phone is the recommended data type for expressions that are phone numbers. Entities with this type are formatted according to common conventions for writing telephone numbers (plus four four two oh seven seven three oh one two three four → +44 207 730 1234). Works together with $SPEECHLY.PHONE_NUMBER standard variable.
Person Name is a data type that should be used with entities that are person names. The returned entity value should in most cases have appropriate capitalization, and parts of the name that were spelled letter by letter should be combined to a single word (c o n a n o’brien → Conan O’Brien). Works together with $SPEECHLY.PERSON_NAME standard variable.
Email formats the returned entity value as an email address (john dot smith at company dot com → email@example.com, this data type also supports spelling parts of the entity: a n t t i at speechly dot com → firstname.lastname@example.org). Works together with $SPEECHLY.EMAIL_ADDRESS standard variable.
Website formats the returned entity value as a website URL (h t t p s colon slash slash docs dot speechly dot com → https://docs.speechly.com). Works together with $SPEECHLY.WEB_ADDRESS standard variable.
Last updated by Antti Ukkonen on April 12, 2021 at 17:16 +0300
Found an error on our documentation? Please file an issue or make a pull request