Entità Regexp

Alcune entità devono corrispondere a pattern anziché a termini specifici. Ad esempio numeri di documenti d'identità, documenti di identità, targhe e così via. Con le entità regexp, puoi fornire espressioni regolari per la corrispondenza.

Dove trovare questi dati

Quando crei un agente, è più comune utilizzare la console Dialogflow ES (visita la documentazione, apri la console). Le istruzioni riportate di seguito sono incentrate sull'utilizzo della console. Per accedere ai dati dell'entità:

1. Vai alla console di Dialogflow ES.
2. Seleziona un agente.
3. Seleziona Entità nel menu della barra laterale sinistra.

Se stai creando un agente utilizzando l'API anziché la console, consulta Riferimento per EntityType. I nomi dei campi dell'API sono simili a quelli della console. Le istruzioni riportate di seguito evidenziano eventuali differenze importanti tra la console e l'API.

Espressioni regolari composte

Ogni entità regexp corrisponde a un singolo pattern, ma puoi fornire più espressioni regolari se rappresentano tutte le varianti di un singolo pattern. Durante la formazione degli agenti, tutte le espressioni regolari di una singola entità vengono combinate con l'operatore di alternanza (|) per formare un'espressione regolare composta.

Ad esempio, se fornisci le seguenti espressioni regolari per un numero di telefono:

• ^[2-9]\d{2}-\d{3}-\d{4}$
• ^(1?(-?\d{3})-?)?(\d{3})(-?\d{4})$

L'espressione regolare composta diventa:

• ^[2-9]\d{2}-\d{3}-\d{4}$|^(1?(-?\d{3})-?)?(\d{3})(-?\d{4})$

L'ordine delle espressioni regolari è importante. Ciascuna delle espressioni regolari nell'espressione regolare composta viene elaborata in ordine. La ricerca si interrompe quando viene trovata una corrispondenza valida. Ad esempio, per un'espressione utente finale "Seattle":

• Sea|Seattle corrisponde a "Mare"
• Seattle|Sea corrisponde a "Seattle"

Gestione speciale per il riconoscimento vocale

Nota: è attivo l'adattamento vocale automatico consigliato quando si utilizzano entità regexp. Consulta anche le linee guida specifiche per le espressioni regolari per l'adattamento vocale.

Se l'agente utilizza il riconoscimento vocale (noto anche come input audio, conversione della voce in testo o STT), le espressioni regolari richiedono una gestione speciale per la corrispondenza di lettere e numeri. Un enunciato pronunciato dall'utente finale viene elaborato dal riconoscimento vocale prima che le entità vengano abbinate. Quando un'espressione contiene una serie di lettere o numeri, il sistema di riconoscimento potrebbe aggiungere spazi a ogni carattere. Inoltre, il riconoscitore potrebbe interpretare le cifre in forma di parola. Ad esempio, l'espressione di un utente finale "Il mio ID è 123" potrebbe essere riconosciuta come una delle seguenti:

• "Il mio ID è 123"
• "Il mio documento di identità è l'1 2 3"
• "Il mio documento di identità è uno due tre"

Per supportare numeri di tre cifre, puoi utilizzare le seguenti espressioni regolari:

\d{3}

\d \d \d

(zero|one|two|three|four|five|six|seven|eight|nine) (zero|one|two|three|four|five|six|seven|eight|nine) (zero|one|two|three|four|five|six|seven|eight|nine)

Crea un'entità regexp

Per creare un'entità regexp:

1. Apri un'entità esistente o creane una nuova.
2. Seleziona Entità Regexp.
3. Inserisci una o più espressioni regolari nella tabella delle voci.
4. Fai clic su Salva.

Se utilizzi l'API per creare o aggiornare entità, utilizza KIND_REGEXP per il campo del tipo di entità.

Limitazioni

Si applicano le seguenti limitazioni:

• La corrispondenza approssimativa non può essere attivata per le entità regexp. Queste funzionalità si escludono a vicenda.
• Ogni agente può avere un massimo di 50 entità regexp.
• L'espressione regolare composta per un'entità ha una lunghezza massima di 2000 caratteri.