Anda dapat membuat entity kustom untuk mencocokkan data khusus agen Anda.
Misalnya, Anda dapat menentukan jenis entitas vegetable
yang dapat mencocokkan jenis sayuran
yang tersedia untuk dibeli dengan agen toko bahan makanan.
Membuat entity kustom
Untuk membuat entity kustom:
Konsol
- Buka Konsol Dialogflow CX.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Kelola.
- Klik Jenis Entitas.
- Klik Create.
- Masukkan data entity.
- Klik Simpan.
API
Gunakan metode create
EntityType
.
Pilih protokol dan versi untuk referensi EntityType:
Protocol | V3 | V3beta1 |
---|---|---|
REST | Resource EntityType | Resource EntityType |
RPC | Antarmuka EntityType | Antarmuka EntityType |
C++ | EntityTypesClient | Tidak tersedia |
C# | EntityTypesClient | Tidak tersedia |
Go | EntityTypesClient | Tidak tersedia |
Java | EntityTypesClient | EntityTypesClient |
Node.js | EntityTypesClient | EntityTypesClient |
PHP | Tidak tersedia | Tidak tersedia |
Python | EntityTypesClient | EntityTypesClient |
Ruby | Tidak tersedia | Tidak tersedia |
Batasan
Batasan berikut berlaku:
- Nama tampilan jenis entity kustom bersifat unik untuk setiap agen.
Nama tampilan jenis entity harus diawali dengan huruf
dan dapat berisi:
A-Z
,a-z
,0-9
,_
(garis bawah),-
(tanda hubung). Nilai sinonim dan referensi entity tidak memiliki batasan tersebut.
Mengekspor dan mengimpor entity kustom
Anda dapat mengekspor dan mengimpor entity untuk berbagi di seluruh agen.
Salah satu opsi format ekspor adalah paket Json, yang merupakan file zip yang berisi hierarki direktori dan file JSON. Berikut adalah penjelasan struktur direktori:
entityTypes
: Direktori ini berisi jenis entity Anda.<entity type name>
: Ada satu atau beberapa direktori ini, dan nama direktori sesuai dengan nama tampilan jenis entity.entities
: Direktori ini berisi file entri entitas.<language tag>.json
: Satu atau beberapa file ini ada, dan nama file sesuai dengan tag bahasa. Setiap file berisi entri entity bahasa tertentu.
<excludedPhrases>
: Direktori ini berisi file frasa yang dikecualikan.<language tag>.json
: Satu atau beberapa file ini ada, dan nama file sesuai dengan tag bahasa. Setiap file berisi pengecualian frasa bahasa tertentu.
<entity type name>.json
: Nama file ini sesuai dengan nama tampilan jenis entity. File ini berisi data khusus jenis entitas yang tidak ditemukan di file lain.
Contoh:
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
Saat mengimpor jenis entity, mungkin ada konflik penggabungan saat nama tampilan jenis entity di agen yang ada cocok dengan jenis entity yang diimpor. Anda dapat mengontrol perilaku penggabungan jika nama tampilan jenis entity cocok dengan memilih salah satu opsi berikut:
- Mengganti jenis entity yang ada: Jenis entity yang diimpor akan menimpa jenis entity dengan nama yang sama di agen yang ada.
- Menggabungkan dengan jenis entity yang ada: Entri entity dari jenis entity yang diimpor akan ditambahkan ke jenis entity yang ada. Jika ada entri entity yang sama, entri entity tersebut tidak akan diduplikasi, dan sinonimnya akan digabungkan.
- Ganti nama dan impor sebagai jenis entitas baru: Jenis entitas yang diimpor diganti namanya dengan menambahkan "_1" ke nama tampilan.
- Lewati jenis entity: Jenis entity yang ada tetap tidak berubah, dan jenis entity yang diimpor akan diabaikan.
Untuk mengekspor jenis entity:
Konsol
- Buka Konsol Dialogflow CX.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Kelola.
- Klik Jenis Entitas.
- Pilih semua jenis entity yang ingin diekspor.
- Klik Ekspor entitas yang dipilih.
- Pilih format dan tujuan.
- Klik Submit.
Untuk mengimpor jenis entity:
Konsol
- Buka Konsol Dialogflow CX.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Kelola.
- Klik Jenis Entitas.
- Klik Import.
- Pilih perilaku sumber dan gabungkan.
- Klik Submit.
Mengimpor entri entity
Anda dapat mengimpor entri entity ke jenis entity yang sudah ada.
Format file yang digunakan untuk mengimpor entri entity sama dengan format yang digunakan untuk mengimpor jenis entity. Namun, file impor hanya dapat berisi 1 jenis entity dan semua entri di bawahnya akan diimpor ke jenis entity yang dipilih. Jika ada entri entity yang sama, entri entity tersebut tidak akan diduplikasi, dan sinonimnya akan digabungkan.
Untuk mengimpor entri entity untuk jenis entity:
Konsol
- Buka Konsol Dialogflow CX.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Kelola.
- Klik Jenis Entitas.
- Pilih satu entitas.
- Klik Import to entity.
- Pilih file.
- Klik Submit.