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

Poin Penting: Sebagai praktik terbaik, Anda harus melengkapi agen dalam bahasa default sebelum menambahkan bahasa tambahan.

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

Catatan: Informasi di bagian ini berlaku untuk bahasa root dan khusus lokalitas. Misalnya; en, en-US, dan en-GB masing-masing memiliki data unik untuk frasa pelatihan intent.

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 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 yang diberikan. Berikut adalah daftar lengkap data khusus bahasa:

• frasa pelatihan intent
• respons fulfillment
• entri entity

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

Misalnya, jenis entity 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.

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

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

Tutup

Buka referensi Intent API

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

Tutup

Buka referensi Page API

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

Tutup

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. Buka referensi Session API

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

Tutup

Deteksi bahasa otomatis

Catatan: Fitur ini hanya tersedia untuk percakapan chat.

Catatan: Saat ini, deteksi bahasa hanya mendukung identifikasi bahasa dengan perbedaan struktural utama, dan bukan varian dari bahasa yang sama. Artinya, Dialogflow dapat membedakan antara bahasa seperti ["en", "pt-br"], tetapi tidak di antara varian bahasa yang sama seperti ["zh-tw", "zh-cn"] atau ["pt", "pt-br"].

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.