Entitas kustom

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.

Catatan: Saat membuat agen, sebaiknya tentukan entity Anda sebelum menambahkan frasa pelatihan ke intent Anda. Konsol akan otomatis menganotasi frasa pelatihan Anda dengan entity yang ada. Namun, jika membuat entity setelah frasa pelatihan, Anda dapat menganotasi frasa secara manual.

Membuat entity kustom

Untuk membuat entity kustom:

Konsol

1. Buka Konsol Dialogflow CX.
2. Pilih project Google Cloud Anda.
3. Pilih agen Anda.
4. Pilih tab Kelola.
5. Klik Jenis Entitas.
6. Klik Create.
7. Masukkan data entity.
8. Klik Simpan.

API

Gunakan metode create EntityType. Buka referensi EntityType API

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

Tutup

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

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

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

1. Buka Konsol Dialogflow CX.
2. Pilih project Google Cloud Anda.
3. Pilih agen Anda.
4. Pilih tab Kelola.
5. Klik Jenis Entitas.
6. Pilih semua jenis entity yang ingin diekspor.
7. Klik Ekspor entitas yang dipilih.
8. Pilih format dan tujuan.
9. Klik Submit.

Untuk mengimpor jenis entity:

Konsol

1. Buka Konsol Dialogflow CX.
2. Pilih project Google Cloud Anda.
3. Pilih agen Anda.
4. Pilih tab Kelola.
5. Klik Jenis Entitas.
6. Klik Import.
7. Pilih perilaku sumber dan gabungkan.
8. Klik Submit.

Mengimpor entri entity

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

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

1. Buka Konsol Dialogflow CX.
2. Pilih project Google Cloud Anda.
3. Pilih agen Anda.
4. Pilih tab Kelola.
5. Klik Jenis Entitas.
6. Pilih satu entitas.
7. Klik Import to entity.
8. Pilih file.
9. Klik Submit.