Entità Regexp

Alcune entità devono corrispondere a pattern anziché a termini specifici. Ad esempio, numeri di identificazione nazionali, 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 (consulta la documentazione, apri la console). Le istruzioni riportate di seguito si concentrano sull'utilizzo della console. Per accedere ai dati delle entità:

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

Se stai creando un agente utilizzando l'API anziché la console, consulta il riferimento EntityTypes. I nomi dei campi API sono simili a quelli della console. Le istruzioni riportate di seguito evidenziano le 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 variazioni di un singolo pattern. Durante l'addestramento dell'agente, 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 una volta trovata una corrispondenza valida. Ad esempio, per l'espressione di un utente finale "Seattle":

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

Gestione speciale per il riconoscimento vocale

Nota: l'attivazione dell'adattamento automatico del parlato è consigliata quando utilizzi entità regexp. Consulta anche le linee guida specifiche per le espressioni regolari per l'adattamento del parlato.

Se il tuo agente utilizza il riconoscimento vocale (noto anche come input audio, conversione della voce in testo o STT), le tue espressioni regolari dovranno essere gestite in modo speciale quando corrispondono a lettere e numeri. Un'espressione dell'utente finale viene prima elaborata dal sistema di riconoscimento vocale prima che vengano trovate corrispondenze per le entità. Quando un'espressione contiene una serie di lettere o numeri, il sistema di riconoscimento potrebbe aggiungere spazi tra ogni carattere. Inoltre, il sistema di riconoscimento può interpretare le cifre in forma di parole. Ad esempio, l'espressione dell'utente finale "Il mio ID è 123" potrebbe essere riconosciuta come una delle seguenti:

• "Il mio ID è 123"
• "Il mio ID è 1 2 3"
• "Il mio ID è 123"

Per adattarsi ai numeri a 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 fuzzy non può essere abilitata 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.