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.

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

API

Gunakan metode create EntityType.

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

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 hal berikut: 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 dibagikan kepada semua agen.

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 ini berisi data khusus jenis entity 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 dari opsi berikut:

  • Ganti jenis entity yang ada: Jenis entity yang diimpor akan menimpa jenis entity bernama 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 ada entri entitas yang sama, entri tersebut tidak akan diduplikasi, dan sinonim di bawahnya akan digabungkan.
  • Ganti nama dan impor sebagai jenis entity baru: Jenis entity yang diimpor akan diganti namanya dengan menambahkan "_1" ke nama tampilan.
  • Lewati jenis entitas: Jenis entitas yang ada tidak akan berubah, dan jenis entitas 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 Entity Types.
  6. Pilih semua jenis entitas yang ingin diekspor.
  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

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 bawahnya akan diimpor ke jenis entitas yang dipilih. Jika ada entri entitas yang sama, 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.