Puoi creare entità personalizzate per associare dati specifici per il tuo agente.
Ad esempio, puoi definire un tipo di entità vegetable
che può corrispondere ai tipi di verdure
disponibili per l'acquisto con l'agente di un negozio di alimentari.
Creare entità personalizzate
Per creare un'entità personalizzata:
Console
- Apri la console 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 |
| Go | 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 riferimenti alle entità e i valori dei sinonimi non hanno queste limitazioni.
Esportare e importare entità personalizzate
Puoi esportare e importare entità per la condivisione tra agenti.
Una delle opzioni di formato dell'esportazione è il pacchetto Json, un file ZIP che contiene una gerarchia di directory e file JSON. Di seguito viene 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 del tipo di entità.entities: questa directory contiene file di voci di entità.<language tag>.json: esistono uno o più di questi file e i nomi dei file corrispondono ai tag della lingua. Ogni file contiene voci di entità specifiche per la lingua.
<excludedPhrases>: questa directory contiene file di frasi escluse.<language tag>.json: esistono uno o più di questi file e i nomi dei file corrispondono ai tag della lingua. Ogni file contiene esclusioni di frasi specifiche per lingua.
<entity type name>.json: questo nome file corrisponde al nome visualizzato di un tipo di entità. Il file contiene dati specifici del 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 tipi di entità, potrebbero verificarsi conflitti di unione quando il nome visualizzato di un tipo di entità nel tuo 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à con lo stesso nome nell'agente esistente.
- Unisci a tipi di entità esistenti: le voci di entità di un tipo di entità importato vengono aggiunte al tipo di entità esistente. Se sono presenti le stesse voci di entità, non verranno duplicate e i sinonimi sottostanti verranno uniti.
- Rinomina e importa come nuovi tipi di entità: il tipo di entità importato viene rinominato aggiungendo "_1" al nome visualizzato.
- Ignora 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 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 tipi di entità:
Console
- Apri la console 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 entità
Puoi importare voci di entità in un tipo di entità esistente.
Il formato file utilizzato per importare le voci di entità è lo stesso formato utilizzato per importare i tipi di entità. Tuttavia, il file di importazione può contenere un solo tipo di entità e tutte le voci sottostanti verranno importate nel tipo di entità selezionato. Se sono presenti le stesse voci di entità, non verranno duplicate e i sinonimi sottostanti verranno uniti.
Per importare voci di entità per un tipo di entità:
Console
- Apri la console 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.