Entità di sistema

Dialogflow fornisce molte entità di sistema per estrarre tipi comuni dalle espressioni degli utenti finali. Ad esempio, il tipo @sys.color può essere utilizzato per estrarre valori come "rosso" o "blu". Puoi trovare l'elenco completo delle entità di sistema nel riferimento per le entità di sistema.

Per la maggior parte delle applicazioni, i valori forniti dalle entità di sistema funzionano bene. Tuttavia, la tua applicazione potrebbe dover aggiungere valori aggiuntivi per le entità di sistema. Ad esempio, potresti voler aggiungere "blu-verde" all'elenco di valori per @sys.color. Alcune entità di sistema possono essere estese a questo scopo. Il riferimento per le entità di sistema elenca le entità di sistema che possono essere estese. Le sezioni rimanenti di questo documento descrivono come estendere le entità di sistema.

Il supporto delle entità di sistema varia in base alla lingua. Per maggiori dettagli, consulta le limitazioni delle entità di sistema.

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 entità di sistema per il tuo agente:

  1. Vai alla console Dialogflow ES.
  2. Seleziona un agente.
  3. Seleziona Entità nel menu della barra laterale a sinistra.
  4. Seleziona la scheda Sistema per le entità di sistema.

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.

Estendere un'entità di sistema dalla pagina delle entità

Nella pagina delle entità, puoi visualizzare le entità di sistema utilizzate dall'agente e estenderle seguendo questi passaggi:

  1. Utilizza l'entità di sistema in uno dei parametri.
  2. Seleziona Entità nel menu della barra laterale a sinistra.
  3. Seleziona la scheda Sistema per le entità di sistema.
  4. Vengono elencate le entità di sistema attualmente utilizzate dall'agente. Le entità mostrate con un colore di carattere grigio non sono estensibili, mentre quelle mostrate con un colore di carattere normale sono estensibili.
  5. Puoi selezionare un'entità estensibile e aggiornare i valori estesi.
  6. Fornisci le voci dell'entità utilizzando i valori con cui vuoi estenderla.

Screenshot della scheda delle entità di sistema

Estendere un'entità di sistema con l'API

Se utilizzi l'API per estendere le entità di sistema, crea estensioni di entità di sistema in modo simile a come crei entità personalizzate. Fornisci il nome dell'entità di sistema che vuoi estendere e i valori con cui vuoi estenderla. Se provi a estendere un'entità di sistema non estensibile, verrà visualizzato un messaggio di errore.

Estendere un'entità di sistema durante l'annotazione di una frase di addestramento

Nella sezione delle frasi di addestramento della pagina dell'intenzione, puoi estendere un'entità di sistema mentre annoti una frase di addestramento. Se annoti manualmente una parte della frase di addestramento con un'entità di sistema estensibile che non include il valore selezionato, ti verrà chiesto di aggiungerlo all'entità di sistema.