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 CX:

  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 Save.

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 per bahasa. Saat membuat agen multibahasa, Anda harus memberikan 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 tertentu. 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 dibuat oleh Dialogflow untuk bahasa baru, tetapi Anda perlu menyediakan entri entity dalam bahasa Spanyol.

Screenshot entitas

AI membuat data khusus bahasa

Agen Percakapan (Dialogflow CX) memberi Anda opsi untuk mempercepat proses penambahan data khusus bahasa menggunakan pembuatan AI untuk memberikan data kepada Anda, bukan memasukkannya secara manual. Hal ini dapat dilakukan di tingkat intent, entity, dan fulfillment sebagai fitur Pratinjau.

Jika memilih untuk tidak menggunakan pembuatan AI, Anda masih dapat memasukkan data secara manual untuk bahasa non-default.

(Pratinjau) Pembuatan AI intent

Buat frasa pelatihan secara otomatis dalam bahasa non-default:

  1. Buka Setelan agen > Bahasa dan pastikan Anda mengaktifkan satu atau beberapa bahasa non-default untuk agen.
  2. Buka menu drop-down bahasa di bagian atas Konsol, lalu pilih bahasa non-default yang Anda pilih.
  3. Buka tab Kelola, lalu klik Intent dan pilih salah satu intent Anda. Pastikan kolom Deskripsi diisi dengan deskripsi tujuan intent. Deskripsi dapat dalam bahasa default atau dalam bahasa yang Anda lihat.
  4. Saat Anda mengaktifkan bahasa non-default, Agen Percakapan (Dialogflow CX) tidak menerjemahkan frasa pelatihan yang ada ke dalam bahasa baru. Untuk membuat frasa pelatihan baru dalam bahasa baru, klik tombol radial __ frasa yang baru dibuat LLM. Nilai defaultnya adalah 3. Untuk menyalin dan menerjemahkan frasa pelatihan yang ada secara otomatis, pilih Semua frasa pelatihan dari Bahasa Default Anda yang diterjemahkan oleh AI generation.
  5. Klik + Tambahkan. Jumlah frasa pelatihan yang Anda tentukan akan dibuat dan diisi ke dalam tabel dalam bahasa yang telah Anda pilih. Pastikan untuk meninjau semua frasa pelatihan yang dihasilkan untuk mengetahui keakuratannya.

(Pratinjau) Pembuatan AI entitas

Membuat dan menerjemahkan secara otomatis nilai referensi dan sinonim dalam bahasa non-default:

  1. Buka Setelan agen > Bahasa dan pastikan Anda mengaktifkan satu atau beberapa bahasa non-default untuk agen.
  2. Buka drop-down bahasa di bagian atas Konsol, lalu pilih bahasa non-default yang Anda pilih.
  3. Buka tab Kelola, lalu klik Jenis entity dan pilih salah satu jenis entity Anda.
  4. Saat Anda mengaktifkan bahasa non-default, Agen Percakapan (Dialogflow CX) tidak otomatis menerjemahkan nilai referensi dan sinonim yang ada. Untuk menerjemahkan nilai ini secara otomatis ke bahasa baru, klik + Salin dari bahasa default. Semua data asli dari jenis entitas bahasa default akan diterjemahkan ke dalam bahasa baru dan diisi dalam tabel. Perhatikan bahwa menerjemahkan lebih dari 50 item sekaligus dapat menyebabkan error. Setiap nilai referensi dan sinonim dihitung sebagai item.
  5. Anda juga dapat menambahkan nilai referensi baru dengan mengklik + Tambahkan entri baru. Anda dapat mengetik nilai referensi dalam bahasa default, dan nilai referensi serta sinonimnya akan otomatis diterjemahkan ke dalam bahasa baru.

(Pratinjau) Pembuatan AI fulfillment

Pembuatan AI tersedia untuk jenis fulfillment pengendali peristiwa, grup rute, dan rute. Untuk mengetahui informasi selengkapnya tentang jenis rute ini, lihat dokumentasi rute dan pengelola peristiwa.

Fitur ini hanya akan muncul jika Anda melihat agen dalam bahasa non-default, dan dalam salah satu jenis rute yang ditentukan. Buka bagian Fulfillment pada rute. Untuk otomatis menyalin dan menerjemahkan respons agen dari bahasa default Anda ke dalam bahasa yang sedang Anda lihat, klik Salin dan terjemahkan. Perhatikan bahwa menerjemahkan lebih dari 50 respons sekaligus dapat menyebabkan error.

Data khusus bahasa saat menggunakan API

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 menyediakan 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.