Puoi creare entità personalizzate per associare dati specifici al 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.
Creare entità personalizzate
Per creare un'entità personalizzata:
Console
- Apri la console di Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona l'agente.
- Seleziona la scheda Gestisci.
- Fai clic su Tipi di entità.
- Fai clic su Crea.
- Inserisci i dati dell'entità.
- Fai clic su Salva.
API
Usa 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). Il riferimento dell'entità e i valori dei sinonimi non hanno questo tipo di limitazioni.
Esporta e importa entità personalizzate
Puoi esportare e importare entità per la condivisione tra gli agenti.
Una delle opzioni del formato di esportazione è il pacchetto Json, un file ZIP che contiene 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ù 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 di tipo 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à, potrebbero 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 di unione quando i nomi visualizzati del tipo di entità corrispondono selezionando una delle seguenti opzioni:
- Sostituisci tipi di entità esistenti: un tipo di entità importato sovrascrive qualsiasi tipo di entità un tipo di entità con lo stesso nome nell'agente esistente.
- Unisci con tipi di entità esistenti: Le voci di un'entità di un tipo di entità importato vengono aggiunte all'entità esistente di testo. Se esistono le stesse voci di entità, queste non saranno duplicate, i relativi sinonimi 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
- Apri la console di Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona l'agente.
- Seleziona la scheda Gestisci.
- Fai clic su Tipi di entità.
- Seleziona tutti i tipi di entità che vuoi esportare.
- Fai clic su Esporta entità selezionata.
- Seleziona il formato e la destinazione.
- Fai clic su Invia.
Per importare i tipi di entità:
Console
- Apri la console di Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona l'agente.
- Seleziona la scheda Gestisci.
- Fai clic su Tipi di entità.
- Fai clic su Importa.
- Seleziona l'origine e il comportamento di unione.
- 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à, queste non saranno duplicate, i relativi sinonimi verranno uniti.
Per importare le voci di entità per un tipo di entità:
Console
- Apri la console di Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona l'agente.
- Seleziona la scheda Gestisci.
- Fai clic su Tipi di entità.
- Seleziona un'entità.
- Fai clic su Importa nell'entità.
- Seleziona un file.
- Fai clic su Invia.