Sie können benutzerdefinierte Entitäten erstellen, um die für Ihren Agent spezifischen Daten abzugleichen.
Es ist zum Beispiel möglich, mit dem Entitätstyp vegetable alle Gemüsearten zu erfassen, die bei einem Lebensmittelhändler erhältlich sind.
Benutzerdefinierte Entitäten erstellen
So erstellen Sie eine benutzerdefinierte Entität:
Console
- Öffnen Sie die Dialogflow CX Console.
- Wählen Sie Ihr Google Cloud-Projekt aus.
- Wählen Sie den Agent aus.
- Wählen Sie den Tab Verwalten.
- Klicken Sie auf Entitätstypen.
- Klicken Sie auf Erstellen.
- Geben Sie Entitätstypen ein.
- Klicken Sie auf Speichern.
API
Verwenden Sie die Methode create von EntityType.
Wählen Sie ein Protokoll und eine Version für die EntityType-Referenz:
| Protokoll | V3 | V3beta1 |
|---|---|---|
| REST | EntityType-Ressource | EntityType-Ressource |
| RPC | EntityType-Schnittstelle | EntityType-Schnittstelle |
| C++ | EntityTypesClient | Nicht verfügbar |
| C# | EntityTypesClient | Nicht verfügbar |
| Einfach loslegen (Go) | EntityTypesClient | Nicht verfügbar |
| Java | EntityTypesClient | EntityTypesClient |
| Node.js | EntityTypesClient | EntityTypesClient |
| PHP | Nicht verfügbar | Nicht verfügbar |
| Python | EntityTypesClient | EntityTypesClient |
| Ruby | Nicht verfügbar | Nicht verfügbar |
Beschränkungen
Es gelten folgende Einschränkungen:
- Anzeigenamen für benutzerdefinierte Entitätstypen sind für jeden Agent eindeutig.
Anzeigenamen für Entitätstypen müssen mit einem Buchstaben beginnen und können die folgenden Zeichen enthalten:
A-Z,a-z,0-9,_(Unterstrich),-(Bindestrich). Für Entitätsreferenzen und Synonymwerte gilt keine solche Einschränkung.
Benutzerdefinierte Entitäten exportieren und importieren
Sie können Entitäten zur Freigabe zwischen Agents exportieren und importieren.
Eine der Optionen für das Exportformat ist das JSON-Paket. Dabei handelt es sich um eine ZIP-Datei, die eine Hierarchie von Verzeichnissen und JSON-Dateien enthält. Im Folgenden wird die Verzeichnisstruktur beschrieben:
entityTypes: Dieses Verzeichnis enthält Ihre Entitätstypen.<entity type name>: Eines oder mehrere dieser Verzeichnisse sind vorhanden und die Verzeichnisnamen entsprechen den Anzeigenamen des Entitätstyps.entities: Dieses Verzeichnis enthält Entitätseintragsdateien.<language tag>.json: Eine oder mehrere dieser Dateien sind vorhanden und die Dateinamen entsprechen den Sprach-Tags. Jede Datei enthält sprachspezifische Entitätseinträge.
<excludedPhrases>: Dieses Verzeichnis enthält Dateien mit ausgeschlossenen Wortgruppen.<language tag>.json: Eine oder mehrere dieser Dateien sind vorhanden und die Dateinamen entsprechen den Sprach-Tags. Jede Datei enthält sprachspezifische Ausschlüsse von Wortgruppen.
<entity type name>.json: Dieser Dateiname entspricht dem Anzeigenamen eines Entitätstyps. Die Datei enthält entitätstypspezifische Daten, die in anderen Dateien nicht vorhanden sind.
Beispiel:
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
Beim Importieren von Entitätstypen kann es zu Zusammenführungskonflikten kommen, wenn der Anzeigename eines Entitätstyps im vorhandenen Agent mit dem eines importierten Entitätstyps übereinstimmt. Sie können das Zusammenführungsverhalten steuern, wenn die Anzeigenamen von Entitätstypen übereinstimmen. Wählen Sie dazu eine der folgenden Optionen aus:
- Vorhandene Entitätstypen ersetzen: Ein importierter Entitätstyp überschreibt jeden gleich benannten Entitätstyp in Ihrem vorhandenen Agent.
- Mit vorhandenen Entitätstypen zusammenführen: Die Entitätseinträge eines importierten Entitätstyps werden dem vorhandenen Entitätstyp hinzugefügt. Existieren dieselben Entitätseinträge, werden sie nicht dupliziert und die Synonyme darunter werden zusammengeführt.
- Umbenennen und als neue Entitätstypen importieren: Der importierte Entitätstyp wird umbenannt, indem „_1“ an den Anzeigenamen angehängt wird.
- Entitätstypen überspringen: Der vorhandene Entitätstyp bleibt unverändert und der importierte Entitätstyp wird ignoriert.
So exportieren Sie Entitätstypen:
Console
- Öffnen Sie die Dialogflow CX Console.
- Wählen Sie Ihr Google Cloud-Projekt aus.
- Wählen Sie den Agent aus.
- Wählen Sie den Tab Verwalten.
- Klicken Sie auf Entitätstypen.
- Wählen Sie alle Entitätstypen aus, die Sie exportieren möchten.
- Klicken Sie auf Ausgewählte Entität exportieren.
- Wählen Sie das Format und das Ziel aus.
- Klicken Sie auf Senden.
So importieren Sie Entitätstypen:
Console
- Öffnen Sie die Dialogflow CX Console.
- Wählen Sie Ihr Google Cloud-Projekt aus.
- Wählen Sie den Agent aus.
- Wählen Sie den Tab Verwalten.
- Klicken Sie auf Entitätstypen.
- Klicken Sie auf Import (Importieren).
- Wählen Sie die Quelle und das Zusammenführungsverhalten aus.
- Klicken Sie auf Senden.
Entitätseinträge importieren
Sie können Entitätseinträge in einen vorhandenen Entitätstyp importieren.
Das Dateiformat zum Importieren von Entitätseinträgen entspricht dem Format, das zum Importieren von Entitätstypen verwendet wird. Die Importdatei darf jedoch nur einen Entitätstyp enthalten und alle untergeordneten Einträge werden in den ausgewählten Entitätstyp importiert. Existieren dieselben Entitätseinträge, werden sie nicht dupliziert und die Synonyme darunter werden zusammengeführt.
So importieren Sie Entitätseinträge für einen Entitätstyp:
Console
- Öffnen Sie die Dialogflow CX Console.
- Wählen Sie Ihr Google Cloud-Projekt aus.
- Wählen Sie den Agent aus.
- Wählen Sie den Tab Verwalten.
- Klicken Sie auf Entitätstypen.
- Wählen Sie ein Element aus.
- Klicken Sie auf In Entität importieren.
- Wählen Sie eine Datei aus.
- Klicken Sie auf Senden.