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. La Riferimento dell'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 a seconda della lingua. Consulta le limitazioni relative alle entità del sistema per maggiori dettagli.

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 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 sinistra.
  4. Seleziona la scheda Sistema per le entità di sistema.

Se stai creando un agente utilizzando l'API anziché la console, consulta Riferimento per EntityType. I nomi dei campi delle API sono simili a quelli dei campi 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à

Dalla pagina Entità, puoi visualizzare le entità di sistema utilizzate dall'agente ed estenderle seguendo questi passaggi:

  1. Utilizza l'entità di sistema in una delle tue parametri.
  2. Seleziona Entità nel menu della barra laterale 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 carattere grigio non sono estensibili. e le entità mostrate in un colore 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

Estendi un'entità di sistema con l'API

Se usi l'API per estendere le entità di sistema, creare estensioni di entità di sistema simili a quelle entità personalizzate. Fornisci il nome dell'entità di sistema che vuoi estendere, e specificare 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 aggiungere questo valore all'entità di sistema.