Entità Regexp

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

Dove trovare questi dati

Durante la creazione di un agente, è più comune utilizzare Dialogflow ES Console (consulta 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 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 per i tipi di entità. I nomi dei campi API sono simili a quelli dei campi 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 varianti 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 non appena viene trovata una corrispondenza valida. Ad esempio, per un'espressione di utente finale di "Seattle":

• Sea|Seattle corrisponde a "Celeste"
• Seattle|Sea corrisponde a "Seattle"

Gestione speciale per il riconoscimento vocale

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

Se l'agente utilizza il riconoscimento vocale (noto anche come input audio, conversione della voce in testo o STT), le tue espressioni regolari richiedono una gestione speciale per la corrispondenza di lettere e numeri. Un'espressione vocale dell'utente finale viene elaborata prima dal riconoscimento vocale prima che le entità corrispondano. Quando un'espressione contiene una serie di lettere o numeri, il riconoscimento può riempire ogni carattere con degli spazi. Inoltre, il riconoscimento può interpretare le cifre sotto forma di parole. Ad esempio, l'espressione dell'utente finale "Il mio ID è 123" può essere riconosciuta come uno dei seguenti:

• "Il mio ID è 123"
• "Il mio ID è 1 2 3"
• "Il mio ID è uno due tre"

Per inserire 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 come campo del tipo di entità.

Limitazioni

Si applicano le seguenti limitazioni:

• La corrispondenza parziale 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 1024 caratteri.