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.