This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Recognizers

Aura Groot recognizers

Description of recognizers included in aura-groot

Introduction

The current documents describe the different recognizers that are part of aura-groot.

They are listed below:

1 - Domain recognizer

Domain recognizer

Description of domain-recognizer in charge of recognizing the user’s domain

Introduction

domain-recognizer is the aura-groot recognizer in charge of identifying the domain in the user’s input request.

This is possible thanks to the mapping of the list of channels and skills that is done at server start-up. A skill can have several associated channels, but a channel can only have one associated skill.

Example:

GOOD
channel1 => skill1
channel2 => skill1
channel3 => skill2

BAD
channel1 => skill1
channel2 => skill2
channel2 => skill1 -> This is not possible

When a user writes through a channel:

  • The domain to which the channel belongs is identified
  • The skill associated with that domain is executed
  • The domain is registered in KPIs

If the recognition of the domain fails, the user will be returned the error message root:skill.not.found.

2 - Intent result recognizer

Intent result recognizer

Description of intent-result-recognizer in charge of registering the intent result

Introduction

intent-result-recognizer is the recognizer in charge of the registration of the intent result.

This recognizer is executed after the execution of the middlewares and before sending a message to user. It is also in charge of registering the result of the intent in KPIs.

It receives information from the skill in the following way:

activity: {
    channelData: {
        payload: {
            skill: {
                intentResult: {
                    name: string,
                    entities: [
                        entity: string,
                        type: string
                    ]
                }
            }
        }
    }
}