Agen multibahasa

Dialogflow mendukung banyak bahasa. Untuk mengetahui daftar lengkapnya, lihat halaman referensi bahasa. Bahasa yang Anda pilih saat membuat agen akan ditetapkan sebagai bahasa default, dan Anda dapat menambahkan bahasa lainnya.

Bahasa root dan lokalitas tertentu

Ada dua kategori bahasa:

  • Bahasa root: Bahasa ini adalah bahasa seperti Inggris (en) yang tidak menentukan lokalitas.
  • Bahasa khusus lokal: Bahasa ini adalah bahasa seperti English-US (en-US) yang menentukan lokalitas sebagai wilayah atau negara tertentu.

Beberapa bahasa bertindak sebagai root dan khusus lokalitas. Ada perbedaan yang signifikan di antara lokalitas untuk bahasa ini, sehingga lokalitas tidak dapat menggunakan bahasa root yang sama. Contoh:

  • China-Kanton (zh-HK)
  • China Aksara Sederhana (zh-CN)
  • China Aksara Tradisional (zh-TW)
  • Portugis-Brasil (pt-BR)
  • Portugis-Portugal (pt)

Utamanya, sebaiknya Anda mendesain agen untuk bahasa root, dan hanya menyesuaikannya untuk bahasa khusus lokalitas sesuai kebutuhan.

Tambahkan bahasa

Untuk menambahkan bahasa atau lokalitas dengan Konsol Dialogflow:

  1. Buka Konsol Dialogflow CX.
  2. Pilih project Google Cloud untuk agen.
  3. Temukan agen dalam daftar.
  4. Klik nama tampilan agen.
  5. Klik Agent Settings.
  6. Klik tab Languages.
  7. Tambahkan atau hapus bahasa sesuai kebutuhan.
  8. Klik Save.

Data spesifik per bahasa

Sebagian besar data agen bersifat umum untuk semua bahasa agen multibahasa. Namun, teks yang digunakan untuk berinteraksi dengan pengguna akhir adalah bahasa tertentu. Saat membuat agen multibahasa, Anda harus menyediakan data spesifik bahasa ini untuk setiap bahasa. Saat Anda memilih bahasa dari konsol atau memberikan bahasa ke API, Anda dapat mengakses data spesifik bahasa ini untuk bahasa tertentu. Berikut adalah daftar lengkap data spesifik per bahasa:

Untuk mengakses data bahasa tertentu dengan konsol, klik tombol bahasa di bagian atas konsol.

Screenshot Pilih bahasa

Misalnya, jenis entitas size di bawah ini digunakan untuk memesan kaos. Agen ini awalnya dikonfigurasi dalam bahasa Inggris, sehingga entity memiliki entri seperti "S" dengan sinonim "small". Saat bahasa Spanyol ditambahkan sebagai bahasa, entity dibuat oleh Dialogflow untuk bahasa baru, tetapi Anda perlu menyediakan entri entity dalam bahasa Spanyol.

Screenshot entitas

Untuk mengakses data khusus bahasa dengan API, berikan parameter languageCode saat mendapatkan, membuat, atau memperbarui jenis EntityType, Intent, atau Page.

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

Pilih protokol dan versi untuk referensi Intent:

Protokol V3 V3beta1
REST Resource intent Resource intent
RPC Antarmuka Intent Antarmuka Intent
C++ IntentsClient Tidak tersedia
C# IntentsClient Tidak tersedia
Go IntentsClient Tidak tersedia
Java IntentsClient IntentsClient
Node.js IntentsClient IntentsClient
PHP Tidak tersedia Tidak tersedia
Python IntentsClient IntentsClient
Ruby Tidak tersedia Tidak tersedia

Pilih protokol dan versi untuk referensi Halaman:

Protokol V3 V3beta1
REST Resource halaman Resource halaman
RPC Antarmuka halaman Antarmuka halaman
C++ PagesClient Tidak tersedia
C# PagesClient Tidak tersedia
Go PagesClient Tidak tersedia
Java PagesClient PagesClient
Node.js PagesClient PagesClient
PHP Tidak tersedia Tidak tersedia
Python PagesClient PagesClient
Ruby Tidak tersedia Tidak tersedia

Anda harus melakukan panggilan API terpisah untuk setiap bahasa agar dapat mengakses semua data untuk bahasa tertentu. Jika API Anda memanggil data generik bahasa, data tersebut akan diupdate untuk semua bahasa.

Menguji di simulator

Saat menggunakan simulator, pilih bahasa yang ingin Anda gunakan dengan memilihnya di bawah nama agen.

Menyediakan bahasa menggunakan API

Saat mengirim permintaan melalui API, tetapkan kolom queryInput.languageCode dari metode detectIntent. Untuk mengetahui informasi selengkapnya, lihat jenis Sessions.

Pilih protokol dan versi untuk Referensi sesi:

Protokol V3 V3beta1
REST Referensi sesi Referensi sesi
RPC Antarmuka sesi Antarmuka sesi
C++ SessionsClient Tidak tersedia
C# SessionsClient Tidak tersedia
Go SessionsClient Tidak tersedia
Java SessionsClient SessionsClient
Node.js SessionsClient SessionsClient
PHP Tidak tersedia Tidak tersedia
Python SessionsClient SessionsClient
Ruby Tidak tersedia Tidak tersedia

Deteksi otomatis bahasa

Jika bahasa kueri pengguna akhir berbeda dengan bahasa yang ditentukan dalam permintaan, Dialogflow dapat mendeteksinya dan secara otomatis beralih ke bahasa pengguna akhir. Lihat halaman referensi bahasa untuk melihat daftar bahasa yang tersedia untuk fitur ini. Kolom LanguageInfo di WebhookRequest mengidentifikasi bahasa input, bahasa yang di-resolve, dan skor keyakinan saat deteksi bahasa diaktifkan.

Aktifkan deteksi otomatis bahasa

Anda harus mengaktifkan deteksi otomatis bahasa di tingkat agen dan alur.

  1. Buka Setelan agen, lalu pilih tab Language.

  2. Centang kotak di samping Aktifkan deteksi dan pengalihan otomatis bahasa untuk mengaktifkan fitur ini bagi agen. Klik Simpan untuk menyimpan perubahan.

  3. Pilih salah satu alur dan buka Setelan alur. Di panel setelan alur, centang kotak di samping Aktifkan deteksi dan pengalihan otomatis bahasa.

  4. Di menu drop-down Languages, pilih bahasa yang ingin Anda gunakan untuk merespons Dialogflow. Pastikan Anda hanya memilih bahasa yang didukung oleh fitur deteksi otomatis bahasa.

  5. Klik Simpan untuk menyimpan perubahan.

Permintaan yang tidak menyediakan bahasa agen

Saat Dialogflow menerima permintaan yang tidak menyediakan bahasa yang didukung oleh agen, aturan berikut akan berlaku:

  • Ketika permintaan tidak menyediakan bahasa, Dialogflow secara otomatis menentukan bahasa input dan merespons dalam bahasa tersebut jika deteksi bahasa otomatis diaktifkan. Jika deteksi bahasa otomatis dinonaktifkan, Dialogflow akan menangani permintaan menggunakan bahasa default.
  • Jika permintaan menyediakan bahasa khusus lokalitas yang tidak didukung oleh agen, tetapi bahasa root terkait didukung oleh agen, Dialogflow akan menangani permintaan tersebut menggunakan bahasa root.
  • Ekstraksi entity sistem merupakan pengecualian dari aturan sebelumnya. Ekstraksi entity sistem menggunakan bahasa khusus lokalitas yang disediakan, meskipun bahasa khusus lokalitas tidak didukung oleh agen.

Integrasi

Interaksi agen melalui integrasi berbasis teks hanya menggunakan bahasa default agen.