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.

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.

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

  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

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.