Entity kustom

Anda dapat membuat entity kustom untuk mencocokkan data khusus untuk agen Anda. Misalnya, Anda dapat menentukan jenis entity vegetable yang dapat mencocokkan jenis sayuran yang tersedia untuk dibeli dengan agen toko bahan makanan.

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

Membuat entitas 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 Entity Types.
6. Klik Buat.
7. Masukkan data entitas.
8. Klik Simpan.

API

Gunakan metode create EntityType. Buka referensi EntityType API

Pilih protokol dan versi untuk referensi EntityType:

Protokol	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 entitas harus diawali dengan huruf dan dapat berisi: A-Z, a-z, 0-9, _ (garis bawah), - (tanda hubung). Nilai referensi entity dan sinonim 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 dibagikan kepada agen lain.

Salah satu opsi format ekspor adalah Paket JSON, yang merupakan file zip yang berisi hierarki direktori dan file JSON. Berikut ini penjelasan struktur direktori:

• entityTypes: Direktori ini berisi jenis entity Anda.
  • <entity type name>: Satu atau beberapa direktori ini ada, dan nama direktori sesuai dengan nama tampilan jenis entity.
    • entities: Direktori ini berisi file entri entity.
      • <language tag>.json: Satu atau beberapa file ini ada, dan nama file sesuai dengan tag bahasa. Setiap file berisi entri entitas khusus bahasa.
    • <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 khusus bahasa.
    • <entity type name>.json: Nama file ini sesuai dengan nama tampilan jenis entity. File 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 jika nama tampilan jenis entity di agen yang ada cocok dengan jenis entity yang diimpor. Anda dapat mengontrol perilaku penggabungan saat nama tampilan jenis entity cocok dengan memilih salah satu opsi berikut:

• Mengganti jenis entity yang ada: Jenis entity yang diimpor akan menggantikan jenis entity dengan nama yang sama di agen yang ada.
• Gabungkan dengan jenis entity yang ada: Entri entity dari jenis entity yang diimpor ditambahkan ke jenis entity yang ada. Jika entri entitas yang sama ada, entri tersebut tidak akan diduplikasi, dan sinonim di bawahnya akan digabungkan.
• Ganti nama dan impor sebagai jenis entity baru: Jenis entity yang diimpor diganti namanya dengan menambahkan "_1" ke nama tampilan.
• Lewati jenis entitas: Jenis entitas yang ada tetap tidak berubah, dan jenis entitas yang diimpor 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 Entity Types.
6. Pilih semua jenis entitas yang ingin Anda ekspor.
7. Klik Ekspor entity yang dipilih.
8. Pilih format dan tujuan.
9. Klik Kirim.

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 Entity Types.
6. Klik Import.
7. Pilih sumber dan perilaku penggabungan.
8. Klik Kirim.

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 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 entitas dan semua entri di dalamnya akan diimpor ke jenis entitas yang dipilih. Jika entri entitas yang sama ada, entri tersebut tidak akan diduplikasi, dan sinonim di bawahnya 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 Entity Types.
6. Pilih entitas.
7. Klik Impor ke entity.
8. Pilih file.
9. Klik Kirim.