Entità di sistema

Dialogflow fornisce molte entità di sistema per estrarre tipi comuni dalle espressioni dell'utente finale. Ad esempio, il tipo @sys.color può essere usato per estrarre valori come "rosso" o "blu". Puoi visualizzare l'elenco completo delle entità di sistema nel riferimento delle entità di sistema.

Per la maggior parte delle applicazioni, i valori forniti dalle entità di sistema funzionano bene. Tuttavia, l'applicazione potrebbe dover aggiungere altri valori per le entità di sistema. Ad esempio, potresti voler aggiungere "blu-verde" all'elenco dei valori di @sys.color. Alcune entità di sistema possono essere estese a questo scopo. Il Riferimento 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 per ogni lingua. Per i dettagli, consulta i limiti delle entità di sistema.

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 delle entità di sistema per l'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 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.

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

Nella pagina delle entità puoi visualizzare le entità di sistema utilizzate dal tuo agente ed estenderle seguendo questi passaggi:

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

Screenshot della scheda delle entità di sistema

Estendi un'entità di sistema con l'API

Se utilizzi l'API per estendere le entità di sistema, crea estensioni delle entità di sistema in modo simile alle entità personalizzate. Specifica il nome dell'entità di sistema che vuoi estendere e i valori con cui vuoi estenderlo. Se tenti di estendere un'entità di sistema non estendibile, verrà visualizzato un errore.

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

Dalla sezione della frase di addestramento della pagina dell'intent, puoi estendere un'entità di sistema e annotare una frase di addestramento. Se annota manualmente una parte della frase di addestramento con un'entità di sistema estendibile che non include il valore selezionato, ti verrà chiesto di aggiungere questo valore all'entità di sistema.