Entità personalizzate

Puoi creare entità personalizzate per la corrispondenza dei dati specifici del tuo agente. Ad esempio, puoi definire un tipo di entità vegetable che può abbinare i tipi di verdure disponibili per l'acquisto con un agente di un supermercato.

Crea entità personalizzate

Per creare un'entità personalizzata:

Console

  1. Apri la console Dialogflow CX.
  2. Scegli il tuo progetto Google Cloud.
  3. Seleziona il tuo agente.
  4. Seleziona la scheda Gestisci.
  5. Fai clic su Tipi di entità.
  6. Fai clic su Crea.
  7. Inserisci i dati dell'entità.
  8. Fai clic su Salva.

API

Utilizza il metodo create di EntityType.

Seleziona un protocollo e una versione per il riferimento EntityType:

Protocollo V3 V3beta1
REST Risorsa EntityType Risorsa EntityType
RPC Interfaccia EntityType Interfaccia EntityType
C++ EntityTypesClient Non disponibile
C# EntityTypesClient Non disponibile
Vai EntityTypesClient Non disponibile
Java EntityTypesClient EntityTypesClient
Node.js EntityTypesClient EntityTypesClient
PHP Non disponibile Non disponibile
Python EntityTypesClient EntityTypesClient
Ruby Non disponibile Non disponibile

Limitazioni

Si applicano le seguenti limitazioni:

  • I nomi visualizzati dei tipi di entità personalizzati sono univoci per ogni agente. I nomi visualizzati dei tipi di entità devono iniziare con una lettera e possono contenere quanto segue: A-Z, a-z, 0-9, _ (trattino basso), - (trattino). I valori di riferimento dell'entità e dei sinonimi non hanno questa limitazione.

Esporta e importa entità personalizzate

Puoi esportare e importare entità per la condivisione tra gli agenti.

Una delle opzioni di formato di esportazione è il pacchetto JSON, che è un file ZIP contenente una gerarchia di directory e file JSON. Di seguito è descritta la struttura della directory:

  • entityTypes: questa directory contiene i tipi di entità.
    • <entity type name>: esistono una o più di queste directory, e i nomi delle directory corrispondono ai nomi visualizzati dei tipi di entità.
      • entities: questa directory contiene i file di voci delle entità.
        • <language tag>.json: esistono uno o più di questi file e i nomi dei file corrispondono ai tag lingua. Ogni file contiene voci di entità specifiche per la lingua.
      • <excludedPhrases>: questa directory contiene i file delle frasi escluse.
        • <language tag>.json: esistono uno o più di questi file e i nomi dei file corrispondono ai tag lingua. Ogni file contiene esclusioni di frasi specifiche per lingua.
      • <entity type name>.json: questo nome file corrisponde a un nome visualizzato del tipo di entità. Il file contiene dati specifici per tipo di entità non trovati in altri file.

Ad esempio:

 entityTypes
 ⤷  Entity Type A
    ⤷  entities
       ⤷  en.json
       ⤷  en-gb.json
       ⤷  en-ca.json
    ⤷  excludedPhrases
       ⤷  en.json
       ⤷  en-gb.json
       ⤷  en-ca.json
    ⤷  Entity Type A.json
 ⤷  Entity Type B
    ⤷  entities
       ⤷  en.json
       ⤷  en-gb.json
       ⤷  en-ca.json
    ⤷  excludedPhrases
       ⤷  en.json
       ⤷  en-gb.json
       ⤷  en-ca.json
    ⤷  Entity Type B.json

Quando importi i tipi di entità, possono verificarsi conflitti di unione quando il nome visualizzato di un tipo di entità nell'agente esistente corrisponde a quello di un tipo di entità importato. Puoi controllare il comportamento dell'unione quando i nomi visualizzati dei tipi di entità corrispondono selezionando una delle seguenti opzioni:

  • Sostituisci i tipi di entità esistenti: un tipo di entità importato sovrascrive qualsiasi tipo di entità con lo stesso nome nell'agente esistente.
  • Unisci con i tipi di entità esistenti: le voci di entità di un tipo di entità importato vengono aggiunte al tipo di entità esistente. Se esistono le stesse voci di entità, non verranno duplicate e i sinonimi al loro interno verranno uniti.
  • Rinomina e importa come nuovi tipi di entità: Il tipo di entità importato viene rinominato aggiungendo "_1" al nome visualizzato.
  • Salta i tipi di entità: Il tipo di entità esistente rimane invariato e il tipo di entità importato viene ignorato.

Per esportare i tipi di entità:

Console

  1. Apri la console Dialogflow CX.
  2. Scegli il tuo progetto Google Cloud.
  3. Seleziona il tuo agente.
  4. Seleziona la scheda Gestisci.
  5. Fai clic su Tipi di entità.
  6. Seleziona tutti i tipi di entità che vuoi esportare.
  7. Fai clic su Esporta entità selezionata.
  8. Seleziona il formato e la destinazione.
  9. Fai clic su Invia.

Per importare i tipi di entità:

Console

  1. Apri la console Dialogflow CX.
  2. Scegli il tuo progetto Google Cloud.
  3. Seleziona il tuo agente.
  4. Seleziona la scheda Gestisci.
  5. Fai clic su Tipi di entità.
  6. Fai clic su Importa.
  7. Seleziona l'origine e il comportamento di unione.
  8. Fai clic su Invia.

Importa voci di entità

Puoi importare le voci delle entità in un tipo di entità esistente.

Il formato del file utilizzato per l'importazione delle voci delle entità è lo stesso utilizzato per l'importazione dei tipi di entità. Tuttavia, il file di importazione può contenere un solo tipo di entità e tutte le voci al suo interno verranno importate nel tipo di entità selezionato. Se esistono le stesse voci di entità, non verranno duplicate e i sinonimi al loro interno verranno uniti.

Per importare le voci delle entità per un tipo di entità:

Console

  1. Apri la console Dialogflow CX.
  2. Scegli il tuo progetto Google Cloud.
  3. Seleziona il tuo agente.
  4. Seleziona la scheda Gestisci.
  5. Fai clic su Tipi di entità.
  6. Seleziona un'entità.
  7. Fai clic su Importa nell'entità.
  8. Seleziona un file.
  9. Fai clic su Invia.