Esistono diverse opzioni di entità che modificano il comportamento della corrispondenza delle entità e dell'estrazione dei dati. Queste opzioni sono preconfigurate per le entità di sistema, pertanto non puoi modificarle per le entità di sistema. Tuttavia, puoi modificarli in base alle tue entità personalizzate. Puoi creare diversi tipi di entità, a seconda delle opzioni selezionate:
- Entità mappa
- Entità elenco
- Entità composita (un tipo speciale di entità elenco)
- Entità regexp
Esistono anche due opzioni che non determinano il tipo di entità, ma influiscono sul comportamento della corrispondenza delle entità:
Questo documento descrive ciascuna di queste opzioni.
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 riguardano l'utilizzo della console. Per accedere ai dati delle opzioni delle entità:
- Vai alla console Dialogflow ES.
- Seleziona un agente.
- Seleziona Entità nel menu della barra laterale a sinistra.
- Seleziona la scheda Personalizzata per le entità personalizzate definite per l'agente o la scheda Sistema per le entità di sistema utilizzate dall'agente.
- Consulta le seguenti opzioni della casella di controllo per le entità esistenti:
- Definire i sinonimi
- Entità regexp (solo entità personalizzate)
- Consenti l'espansione automatica (solo entità personalizzate)
- Corrispondenza parziale (solo entità personalizzate)
Se stai creando un agente utilizzando l'API anziché la console, consulta il riferimento EntityTypes. I nomi dei campi dell'API sono simili a quelli della console. Le istruzioni riportate di seguito mettono in evidenza eventuali differenze importanti tra la console e l'API.
Entità mappa
Le entità mappa forniscono una mappa dai valori di riferimento ai sinonimi per ciascun valore di riferimento.
Ogni voce dell'entità mappa contiene un singolo valore di riferimento
e un elenco di sinonimi.
Ad esempio, ciascuna delle seguenti righe è una voce dell'entità per un tipo di entità size:
| Valore di riferimento | Sinonimi |
|---|---|
| S | S, piccolo, minuscolo, poco |
| M | M, medio, nella media |
| L | L, grande, enorme, grosso |
Tieni presente che il valore di riferimento è incluso nell'elenco di sinonimi per ogni voce dell'entità sopra. Affinché un valore di riferimento venga associato, deve essere incluso come sinonimo. Quando inserisci inizialmente un valore di riferimento con la console, viene aggiunto automaticamente come sinonimo.
Se uno dei sinonimi corrisponde a una parte dell'espressione dell'utente finale, il valore di riferimento associato viene estratto per la corrispondenza e utilizzato per risolvere il valore del parametro associato.
È consentito omettere il valore di riferimento dall'elenco dei sinonimi. Ciò significa semplicemente che non corrisponde a una parte dell'espressione dell'utente finale, ma viene utilizzato come valore estratto quando viene associato uno dei suoi sinonimi. Questo è auspicabile quando utilizzi stringhe speciali per i valori di riferimento che non vengono digitati o pronunciati dagli utenti finali.
Molte entità di sistema sono entità mappa.
Ad esempio, l'entità di sistema @sys.date corrisponde a input di date comuni come "1° gennaio 2015" o "1° gennaio 2015".
Entrambi gli input sono mappati a un valore di riferimento in formato ISO-8601:
"2015-01-01T12:00:00-03:00".
Per creare un'entità mappa:
- Nella console, deseleziona l'opzione Entità regexp e seleziona l'opzione Definisci sinonimi.
- Utilizzando l'API, imposta il campo
EntityTypekindsuKIND_MAP.
Entità elenco
Le entità elenco forniscono un elenco di voci di entità con un solo valore.
Non hanno valori di riferimento e sinonimi.
Ad esempio, ciascuna delle seguenti righe è una voce dell'entità per un tipo di entità material:
| Valore |
|---|
| tessuto |
| legno |
| metallo |
Se viene trovato un valore corrispondente per una parte dell'espressione dell'utente finale, il valore viene estratto per la corrispondenza e utilizzato per risolvere il valore del parametro associato.
Molte entità di sistema sono entità di elenco.
Ad esempio, l'entità di sistema @sys.color corrisponde agli input di colore comuni come "rosso" o "blu".
Quando viene trovata una corrispondenza per un colore, il valore estratto non viene mappato a nessun valore di riferimento.
Ad esempio, le sfumature di rosso, come "scarlatto" o "cremisi",
non vengono mappate a "rosso" e vengono estratte
come i valori originali "scarlatto" e "cremisi".
Per creare un'entità elenco:
- Nella console, deseleziona l'opzione Entità espressione regolare e l'opzione Definisci sinonimi.
- Utilizzando l'API, imposta il campo
EntityTypekindsuKIND_LIST.
Entità composita
Un'entità composita è un tipo speciale di entità elenco. Le voci delle entità per le entità di elenco in genere contengono parole o frasi semplici, ma possono contenere anche altri tipi di entità. Quando un tipo di entità viene fatto riferimento in un altro tipo di entità, il riferimento viene chiamato alias. Quando un'entità elenco contiene alias di altri tipi di entità, viene chiamata entità composta.
Quando crei un alias, fornisci il nome del tipo di entità a cui fai riferimento e un nome della proprietà a tua scelta. Quando un'entità composita viene associata in fase di esecuzione, il valore estratto viene restituito come oggetto JSON, con i nomi delle proprietà dell'alias utilizzati come nomi delle proprietà JSON. Il formato per inserire un alias è:
@entity-name:property-name
Ad esempio, puoi creare un tipo di entità place corrispondente a una città o a uno stato con le seguenti voci di entità:
| Valore |
|---|
| @sys.geo-city:city |
| @sys.geo-state:state |
Se un'espressione dell'utente finale contiene la parte "Nashville", viene eseguito il matching del tipo di entità place.
Il valore estratto viene restituito come:
{"city": "Nashville"}.
Puoi anche utilizzare più alias di entità in una voce dell'entità.
Prendi in considerazione il seguente tipo di entità personalizzata move che contiene alias per un tipo di entità direction e il tipo di entità di sistema @sys.number:
Tipo di entità della mappa personalizzata per le indicazioni stradali:
| Valore di riferimento | Sinonimi |
|---|---|
| avanti | avanti |
| indietro | indietro |
Sposta il tipo di entità dell'elenco personalizzato:
| Valore |
|---|
| @sys.number:steps passi @direction:direction |
Se l'entità move viene associata
a un'espressione dell'utente finale che contiene "cinque passi indietro",
l'entità move verrà associata.
Il valore estratto viene restituito come:
{"steps": 5, "direction": "back"}.
Molte entità di sistema sono entità composite.
Ad esempio, l'entità di sistema @sys.unit-currency viene utilizzata per abbinare gli importi in denaro a un nome di valuta.
Corrisponde a espressioni dell'utente finale come "50 euro" o "venti dollari e cinque centesimi".
Il valore estratto viene restituito come oggetto JSON come segue:
{"amount": 50, "currency": "EUR"}
Entità Regexp
Con le entità regexp, puoi fornire espressioni regolari per la corrispondenza. Per ulteriori informazioni, consulta Entità Regexp.
Per creare un'entità regexp:
- Nella console, seleziona l'opzione Entità regexp.
- Utilizzando l'API, imposta il campo
EntityTypekindsuKIND_REGEXP.
Espansione automatica
Puoi attivare l'espansione automatica per un tipo di entità personalizzata. Se questa opzione è attivata, l'agente può riconoscere i valori che non sono stati forniti esplicitamente. Ad esempio, prendiamo in considerazione un tipo di entità elenco della spesa:
| Valore |
|---|
| pane |
| burro |
| latte |
| apple |
| gelato |
Se l'espressione di un utente finale è"Devo comprare delle carote", "carote" verrà associato a questo tipo di entità, anche se non è fornito. L'agente riconosce che "carote" è contestualmente simile ad altri valori.
Quando valuti l'espansione automatica, devi seguire le best practice:
- L'attivazione dell'espansione automatica non garantisce l'estrazione delle entità. Per un elenco finito, devi fornire l'elenco completo instead of providing a partial list and enabling automated expansion.
- Se attivi l'espansione automatica in più di un'entità, potrebbero verificarsi conflitti e risultati di classificazione imprevisti.
- Per garantire una migliore qualità dell'estrazione dei parametri, è fondamentale fornire dati di addestramento diversi che coprono tutti i casi d'uso in cui una determinata entità può essere trovata nel traffico dell'agente previsto. Se gli esempi non sono sufficienti, l'espansione automatica delle entità potrebbe non funzionare come previsto.
Per attivare l'espansione automatica:
- Nella console, seleziona l'opzione Consenti espansione automatica.
- Utilizzando l'API, imposta il campo
EntityTypeautoExpansionModesuAUTO_EXPANSION_MODE_DEFAULT.
Corrispondenza parziale
Puoi attivare la corrispondenza approssimativa per un'entità personalizzata. Con la corrispondenza approssimativa attivata, l'ordine delle parole in un valore o in un sinonimo non è importante. Per ulteriori informazioni, consulta la sezione Corrispondenza approssimativa.
Per attivare la corrispondenza approssimativa:
- Nella console, seleziona l'opzione Corrispondenza approssimativa.
- Utilizzando l'API, imposta il campo
EntityTypeenableFuzzyExtractionsutrue.