Agen multibahasa

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

Bahasa root dan khusus lokalitas

Ada dua kategori bahasa:

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

Beberapa bahasa berfungsi sebagai root dan khusus lokalitas. Ada perbedaan yang signifikan antara lokalitas untuk bahasa ini, sehingga lokalitas tidak dapat memiliki 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)

Anda harus mendesain agen terutama untuk bahasa root, dan hanya menyesuaikan untuk bahasa khusus lokalitas sesuai kebutuhan.

Menambahkan 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 Setelan Agen.
  6. Klik tab Bahasa.
  7. Tambahkan atau hapus bahasa sesuai kebutuhan.
  8. Klik Simpan.

Data khusus bahasa

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

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

Screenshot pilih bahasa

Misalnya, jenis entitas size di bawah digunakan untuk memesan kaus. Agen awalnya dikonfigurasi dalam bahasa Inggris, sehingga entitas memiliki entri seperti "S" dengan sinonim "small". Saat bahasa Spanyol ditambahkan sebagai bahasa, entity akan dibuat oleh Dialogflow untuk bahasa baru, tetapi Anda harus memberikan 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 Referensi halaman Referensi 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 guna mengakses semua data khusus bahasa. Jika panggilan API Anda memperbarui data umum bahasa, data tersebut akan diperbarui 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 informasi selengkapnya, lihat jenis Sessions.

Pilih protokol dan versi untuk referensi Sesi:

Protokol V3 V3beta1
REST Resource sesi Resource 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 bahasa otomatis

Jika bahasa kueri pengguna akhir berbeda dengan bahasa yang ditentukan dalam permintaan, Dialogflow dapat mendeteksinya dan otomatis beralih ke bahasa pengguna akhir. Lihat halaman referensi bahasa untuk mengetahui 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.

Mengaktifkan deteksi bahasa otomatis

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

  1. Buka Setelan agen, lalu pilih tab Bahasa.

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

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

  4. Di menu drop-down Languages, pilih bahasa yang Anda inginkan agar Dialogflow dapat merespons. Pastikan Anda hanya memilih bahasa yang didukung oleh fitur deteksi otomatis bahasa.

  5. Klik Simpan untuk menyimpan perubahan.

Permintaan yang tidak memberikan bahasa agen

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

  • Jika permintaan tidak memberikan bahasa, Dialogflow akan 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 menggunakan bahasa root.
  • Ekstraksi entity sistem adalah pengecualian untuk aturan sebelumnya. Ekstraksi entitas 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.