Search
K

Semantic Parser

In this section we will be showcasing the semantic parser, which is a very important module of EDDI that plays the part of the engine that parses the semantics introduced in EDDI Chabot's definitions.
We will need regular dictionaries in order to store our custom words and phrases .
First, we will make a POST to /regulardictionarystore/regulardictionaries with a JSON in the body like this:
{
"language": "en",
"words": [
{
"word": "hello",
"expressions": "greeting(hello)",
"frequency": 0
}
],
"phrases": [
{
"phrase": "good afternoon",
"expressions": "greeting(good_afternoon),language(english)"
}
]
}
The API should return with 201 with a URI referencing the newly created dictionary :
eddi://ai.labs.regulardictionary/regulardictionarystore/regulardictionaries/<UNIQUE_ID>?version=<VERSION>
This URI will be used in the parser configuration.
The next step is to create a parser configuration, including the reference to the previously created dictionary .
A POST to /parserstore/parsers must be performed.
Submit this type of JSON
Important: Don't forget to replace the <UNIQUE_ID> and <VERSION> !

Example of a parser configuration

{
"extensions": {
"dictionaries": [
{
"type": "eddi://ai.labs.parser.dictionaries.integer"
},
{
"type": "eddi://ai.labs.parser.dictionaries.decimal"
},
{
"type": "eddi://ai.labs.parser.dictionaries.punctuation"
},
{
"type": "eddi://ai.labs.parser.dictionaries.email"
},
{
"type": "eddi://ai.labs.parser.dictionaries.time"
},
{
"type": " eddi://ai.labs.parser.dictionaries.ordinalNumber"
},
{
"type": "eddi://ai.labs.parser.dictionaries.regular",
"config": {
"uri": "eddi://ai.labs.regulardictionary/regulardictionarystore/regulardictionaries/<UNIQUE_ID>?version=<VERSION>"
}
}
],
"corrections": [
{
"type": "eddi://ai.labs.parser.corrections.stemming",
"config": {
"language": "english",
"lookupIfKnown": "false"
}
},
{
"type": "eddi://ai.labs.parser.corrections.levenshtein",
"config": {
"distance": "2"
}
},
{
"type": "eddi://ai.labs.parser.corrections.mergedTerms"
}
]
},
"config": null
}

Description of Semantic Parser types

Type
EDDI URI
Description
Integer
eddi://ai.labs.parser.dictionaries.integer
Matches all positive integers
Decimal
eddi://ai.labs.parser.dictionaries.decimal
Matches decimal numbers with . as well as , as a fractional separator
Punctuation
eddi://ai.labs.parser.dictionaries.punctuation
Matches common punctuation:
!(exclamation_mark)
? (question_mark)
. (dot)
, (comma)
: (colon)
; (semicolon)
Email
eddi://ai.labs.parser.dictionaries.email
Matches an email address with regex (\b[A-Z0-9._%+-]+@[A-Z0-9.-]+.[A-Z]{2,4}\b)
Time
eddi://ai.labs.parser.dictionaries.time
Matches the following time formats: e.g : 01:20 , 01h20 , 22:40 , 13:43:23
Number
eddi://ai.labs.parser.dictionaries.ordinalNumber
Ordinal numbers in English language such as 1st, 2nd, 3rd, 4th, 5th, ...
Regular
eddi://ai.labs.parser.dictionaries.regular
URI to a regular dictionary resource: eddi://ai.labs.regulardictionary/regulardictionarystore/regulardictionaries/<UNIQUE_ID>version <VERSION>
In order to use the parser based on the created configurations, we will have to make a POST to /parser/<PARSER_ID>?version=<VERSION>
In the body just put plain text, it is what you would like to be parsed.
The parser will return expressions representing the elements from your plain text
Note: Keep in mind that this parser is made for human dialog, not parsing (full-text) documents.