EntityRecognizer class

Pacchetto:

botbuilder

Classe di utilità usata per analizzare & risolvere entità comuni come datetime ricevute da LUIS.

Metodi

expandChoices(string | Object | string[])	Converte un set di scelte in una matrice espansa.
findAllEntities(IEntity[], string)	Trova tutte le occorrenze di un tipo di entità specifico all'interno di un set.
findAllMatches(string | Object | string[], string, number)	Trova tutte le possibili corrispondenze per un'espressione degli utenti in base a un elenco di scelte.
findBestMatch(string | Object | string[], string, number)	Trova la corrispondenza migliore per un'espressione degli utenti in base a un elenco di scelte.
findEntity(IEntity[], string)	Cerca la prima occorrenza di un tipo di entità specifico all'interno di un set.
parseBoolean(string)	Analizza un valore booleano da un'espressione degli utenti.
parseNumber(string | IEntity[])	Analizza un numero da un'espressione di testo degli utenti o da un set di entità.
parseTime(string | IEntity[])	Analizza una data da un'espressione di testo degli utenti o da un set di entità.
recognizeTime(string, Date)	Riconosce un'ora da un'espressione degli utenti. L'espressione viene analizzata usando la libreria chrono .
resolveTime(IEntity[])	Calcola una data da un set di entità datetime.

Dettagli metodo

expandChoices(string | Object | string[])

Converte un set di scelte in una matrice espansa.

static function expandChoices(choices: string | Object | string[])

Parametri

choices

string | Object | string[]

• scelte:{string} - Elenco di valori delimitato da pipe ('|').
• scelte:{Object} - Oggetto usato per generare l'elenco di scelte. I nomi dei campi degli oggetti verranno usati per compilare l'elenco di scelte.
• scelte:{string[]} - Matrice di stringhe. Verrà restituito come output.

Restituisce

string[]

findAllEntities(IEntity[], string)

Trova tutte le occorrenze di un tipo di entità specifico all'interno di un set.

static function findAllEntities(entities: IEntity[], type: string)

Parametri

entities

IEntity[]

Set di entità da cercare.

type

string

Tipo di entità da trovare.

Restituisce

IEntity[]

findAllMatches(string | Object | string[], string, number)

Trova tutte le possibili corrispondenze per un'espressione degli utenti in base a un elenco di scelte.

static function findAllMatches(choices: string | Object | string[], utterance: string, threshold?: number)

Parametri

choices

string | Object | string[]

• scelte:{string} - Elenco delimitato da pipe ('|') di valori da confrontare con l'espressione degli utenti.
• scelte:{Object} - Oggetto usato per generare l'elenco di scelte. I nomi dei campi degli oggetti verranno usati per compilare l'elenco di scelte.
• scelte:{string[]} - Matrice di stringhe da confrontare con l'espressione degli utenti.

utterance

string

Espressione di testo da analizzare.

threshold

number

(Facoltativo) punteggio minimo necessario per prendere in considerazione una corrispondenza. Il valore predefinito è 0,6.

Restituisce

IFindMatchResult[]

findBestMatch(string | Object | string[], string, number)

Trova la corrispondenza migliore per un'espressione degli utenti in base a un elenco di scelte.

static function findBestMatch(choices: string | Object | string[], utterance: string, threshold?: number)

Parametri

choices

string | Object | string[]

• scelte:{string} - Elenco delimitato da pipe ('|') di valori da confrontare con l'espressione degli utenti.
• scelte:{Object} - Oggetto usato per generare l'elenco di scelte. I nomi dei campi degli oggetti verranno usati per compilare l'elenco di scelte.
• scelte:{string[]} - Matrice di stringhe da confrontare con l'espressione degli utenti.

utterance

string

Espressione di testo da analizzare.

threshold

number

(Facoltativo) punteggio minimo necessario per prendere in considerazione una corrispondenza. Il valore predefinito è 0,6.

Restituisce

IFindMatchResult

findEntity(IEntity[], string)

Cerca la prima occorrenza di un tipo di entità specifico all'interno di un set.

static function findEntity(entities: IEntity[], type: string)

Parametri

entities

IEntity[]

Set di entità da cercare.

type

string

Tipo di entità da trovare.

Restituisce

IEntity

parseBoolean(string)

Analizza un valore booleano da un'espressione degli utenti.

static function parseBoolean(value: string)

Parametri

value

string

Espressione di testo da analizzare.

Restituisce

boolean

Valore booleano valido in caso contrario non definito.

parseNumber(string | IEntity[])

Analizza un numero da un'espressione di testo degli utenti o da un set di entità.

static function parseNumber(value: string | IEntity[])

Parametri

value

string | IEntity[]

• valore:{string} - Espressione di testo da analizzare.
• valore:{IEntity[]} - Set di entità da risolvere.

Restituisce

number

Un numero valido in caso contrario Number.NaN.

parseTime(string | IEntity[])

Analizza una data da un'espressione di testo degli utenti o da un set di entità.

static function parseTime(value: string | IEntity[])

Parametri

value

string | IEntity[]

• valore:{string} - Espressione di testo da analizzare. L'espressione viene analizzata usando la libreria chrono .
• valore:{IEntity[]} - Set di entità da risolvere.

Restituisce

Date

Oggetto Date valido se l'utente ha parlato un'ora altrimenti null.

recognizeTime(string, Date)

Riconosce un'ora da un'espressione degli utenti. L'espressione viene analizzata usando la libreria chrono .

static function recognizeTime(utterance: string, refDate?: Date)

Parametri

utterance

string

Espressione di testo da analizzare.

refDate

Date

(Facoltativo) data di riferimento utilizzata per calcolare la data finale.

Restituisce

IEntity

Un'entità contenente la data risolta se ha esito positivo o null se non è stato possibile determinare una data.

resolveTime(IEntity[])

Calcola una data da un set di entità datetime.

static function resolveTime(entities: IEntity[])

Parametri

entities

IEntity[]

Elenco di entità da cui estrarre la data.

Restituisce

Date

Data calcolata correttamente o null se non è stato possibile determinare una data.