Coba Gemini 1.5 Pro, model multimodal kami yang paling canggih di Vertex AI, dan lihat apa yang dapat Anda bangun dengan jendela konteks token 1 juta. Coba Gemini 1.5 Pro, model multimodal kami yang paling canggih di Vertex AI, dan lihat apa yang dapat Anda bangun dengan jendela konteks token 1 juta.

Halaman ini diterjemahkan oleh Cloud Translation API.

Intent

Intent mengategorikan intent pengguna akhir untuk satu giliran percakapan.

Intent berisi data berikut:

Istilah	Definisi
Nama tampilan	Nama yang ditampilkan di konsol untuk intent.
Label	Label yang membantu mengategorikan intent. Misalnya: intent kepala.
Frasa latihan	Frasa pelatihan adalah contoh frasa untuk apa yang mungkin diketik atau diucapkan pengguna akhir, yang dikenal sebagai input pengguna akhir. Jika input pengguna akhir menyerupai salah satu frasa ini, Agen Percakapan (Dialogflow CX) akan mencocokkan intent. Anda tidak perlu menentukan setiap kemungkinan contoh, karena machine learning bawaan Agen Percakapan (Dialogflow CX) akan memperluas daftar Anda dengan frasa lain yang serupa.
Parameter	Anda menentukan frasa pelatihan untuk menggunakan parameter guna mengekstrak nilai dari bagian tertentu input pengguna akhir.
Pola DTMF	Lihat DTMF untuk integrasi telepon.

Pencocokan intent

Saat pengguna akhir memasukkan input (teks, ucapan, atau penekanan tombol telepon), Agen Percakapan (Dialogflow CX) akan membandingkan input dengan frasa pelatihan intent untuk menemukan kecocokan terbaik. Proses ini disebut pencocokan intent. Pencocokan intent hanya dapat terjadi untuk intent yang terkait dengan rute intent (pengendali status dengan persyaratan intent) dalam cakupan.

Input penekanan tombol dicocokkan sesuai dengan pola DTMF. Namun, saat menelusuri intent yang cocok dengan teks, Agen Percakapan (Dialogflow CX) akan memberikan skor kecocokan potensial dengan keyakinan deteksi intent, yang juga dikenal sebagai skor keyakinan. Nilai ini berkisar dari 0,0 (sepenuhnya tidak pasti) hingga 1,0 (sepenuhnya pasti). Setelah intent diberi skor, ada dua kemungkinan hasil:

Jika intent dengan skor tertinggi memiliki skor keyakinan lebih besar dari atau sama dengan setelan batas klasifikasi, intent tersebut akan ditampilkan sebagai kecocokan.
Jika tidak ada intent yang memenuhi nilai minimum, peristiwa tidak cocok akan dipanggil.

Frasa latihan

Frasa pelatihan adalah contoh frasa untuk apa yang mungkin diketik atau diucapkan pengguna akhir, yang disebut sebagai input pengguna akhir. Untuk setiap intent, Anda membuat banyak frasa pelatihan. Saat input pengguna akhir menyerupai salah satu frasa ini, Agen Percakapan (Dialogflow CX) akan mencocokkan intent.

Misalnya, frasa pelatihan "Saya ingin pizza" melatih agen Anda untuk mengenali input pengguna akhir yang mirip dengan frasa tersebut, seperti "Dapatkan pizza" atau "Pesan pizza".

Anda tidak perlu menentukan setiap kemungkinan contoh, karena machine learning bawaan Agen Percakapan (Dialogflow CX) akan memperluas daftar Anda dengan frasa lain yang serupa. Anda harus membuat setidaknya 10-20 (bergantung pada kompleksitas intent) frasa pelatihan, sehingga agen Anda dapat mengenali berbagai input pengguna akhir. Misalnya, jika ingin intent mengenali input pengguna akhir tentang warna favorit mereka, Anda dapat menentukan frasa pelatihan berikut:

"Saya suka warna merah"
"Warna favorit saya adalah kuning"
"black"
"Biru adalah warna favorit saya"
...

Menganotasi frasa pelatihan

Anda mengontrol cara data pengguna akhir diekstrak dengan menambahkan anotasi pada bagian frasa pelatihan dan mengonfigurasi parameter terkait.

Misalnya, pertimbangkan frasa pelatihan seperti "Bagaimana prakiraan cuaca besok untuk Tokyo?" Anda harus menganotasi "tomorrow" dengan parameter date dan "Tokyo" dengan parameter location. Saat Anda menganotasi bagian frasa pelatihan, Agen Percakapan (Dialogflow CX) akan mengenali bahwa bagian ini hanyalah contoh nilai sebenarnya yang akan diberikan oleh pengguna akhir saat runtime. Untuk input pengguna akhir seperti "Bagaimana prakiraan cuaca di Sydney pada hari Jumat?", Agen Percakapan (Dialogflow CX) akan mengekstrak parameter date dari "Jumat" dan parameter location dari "Sydney".

Anda harus menganotasi semua bagian frasa pelatihan yang dimaksudkan untuk diekstrak sebagai parameter. Jika tidak, Dialogflow tidak akan mengekstrak nilai.

Saat mem-build agen dengan konsol, sebagian besar anotasi dibuat secara otomatis untuk Anda saat menambahkan frasa pelatihan yang berisi bagian yang dapat dicocokkan dengan jenis entity yang ada. Bagian ini ditandai di konsol. Anda dapat mengedit anotasi dan parameter ini sesuai kebutuhan.

Untuk menganotasi frasa pelatihan secara manual dengan konsol:

Pilih bagian frasa pelatihan yang ingin Anda anotasikan.
Pilih jenis entitas yang diinginkan dari daftar.
Parameter akan dibuat untuk Anda di tabel parameter di bawah.

Saat mem-build agen dengan API, Anda harus menganotasi bagian frasa pelatihan secara manual. Lihat jenis TrainingPhrase yang digunakan oleh jenis Intent.

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

Entitas implisit yang dibuat oleh frasa pelatihan

Sebagian besar entity kustom ditentukan secara eksplisit dengan membuat jenis entity dan menambahkan entri entity. Namun, entity kustom juga dapat berisi nilai implisit. Hal ini terjadi saat Anda menganalisa teks frasa pelatihan, dengan teks yang dianotasi bukan merupakan nilai yang ditentukan oleh jenis entitas yang dipilih. Teks yang dianotasi menjadi nilai referensi entity untuk entri entity yang ditambahkan secara implisit. Jika jenis entity adalah entity peta, teks juga menjadi sinonim untuk entri entity.

Intent selamat datang default

Saat Anda membuat agen, intent sambutan default akan dibuat untuk Anda. Untuk beberapa bahasa, intent memiliki frasa pelatihan sederhana seperti "Halo" atau "Hai" yang dimaksudkan untuk mencocokkan input awal pengguna akhir. Anda dapat mengedit intent ini sesuai keinginan.

Saat menggunakan API, Anda dapat mereferensikan intent ini dengan ID intent berikut:

00000000-0000-0000-0000-000000000000

Jika agen memulai percakapan, Anda dapat memicu intent ini menggunakan API. Gunakan nilai projects/<PROJECT_ID>/locations/<LOCATION_ID>/agents/<AGENT_ID>/intents/00000000-0000-0000-0000-000000000000 di kolom QueryInput.intent.intent saat memanggil metode detectIntent atau streamingDetectIntent.

Intent negatif default

Saat Anda membuat agen, intent negatif default akan dibuat untuk Anda. Anda dapat menambahkan frasa pelatihan ke intent ini yang berfungsi sebagai contoh negatif. Mungkin ada kasus saat input pengguna akhir memiliki sedikit kemiripan dengan frasa pelatihan dalam intent normal, tetapi Anda tidak ingin input ini cocok dengan intent normal.

Misalnya, agen pemesanan kamar mungkin memiliki frasa pelatihan seperti "Saya ingin memesan kamar". Jika pengguna akhir ingin membeli buku tentang kamar, mereka dapat mengatakan "Saya ingin membeli buku tentang kamar". Untuk memastikan bahwa input pengguna akhir tidak cocok dengan intent Anda, Anda dapat menambahkan frasa tersebut sebagai contoh negatif.

Selain itu, Anda harus menambahkan kemungkinan frasa yang berada di luar cakupan agen, sehingga tidak akan cocok dengan intent apa pun. Namun, hindari menambahkan frasa ini dalam jumlah yang sangat besar. Misalnya, jika Anda menentukan 10.000 frasa intent negatif default, hal ini akan berdampak negatif pada pencocokan intent normal.

Anda harus meninjau frasa ini secara rutin, karena beberapa frasa ini mungkin awalnya berada di luar cakupan agen, tetapi kemudian ditambahkan ke intent.

Intent negatif default memiliki dampak di semua pencocokan intent. Frasa yang Anda tambahkan dapat menguntungkan pencocokan untuk satu intent, tetapi merugikan pencocokan untuk intent lainnya. Misalnya, Anda dapat menambahkan "panggilan internasional" ke intent negatif default untuk menghindari pencocokan intent perjalanan internasional. Namun, hal ini juga akan mencegah frasa tersebut cocok dengan intent panggilan internasional.

Saat menggunakan API, Anda dapat mereferensikan intent ini dengan ID intent berikut:

00000000-0000-0000-0000-000000000001

Membatalkan intent

Selama percakapan, pengguna akhir mungkin ingin membatalkan topik percakapan saat ini. Misalnya, halaman yang saat ini aktif mungkin meminta tanggal untuk janji temu baru, tetapi pengguna akhir telah memutuskan untuk tidak membuat janji temu baru. Pengguna akhir dapat mengucapkan sesuatu seperti "batalkan" atau "Saya tidak ingin janji temu baru". Untuk menangani situasi ini, Anda dapat membuat satu atau beberapa intent pembatalan untuk agen Anda. Anda dapat memberi nama intent pembatalan ini sesuai keinginan, tetapi biasanya menyertakan "cancel" dalam namanya. Anda harus mengaitkan intent pembatalan ini dengan rute intent yang berada dalam cakupan pada titik yang relevan dalam percakapan. Rute intent ini harus bertransisi ke halaman yang sesuai untuk menangani pembatalan.

Frasa pelatihan untuk intent pembatalan harus menangani upaya pembatalan umum dan khusus topik. Contoh:

Batal
Hentikan
Saya berubah pikiran
Tidak jadi
Kembali
Kembali
Saya tidak ingin janji temu baru
Membatalkan janji temu baru
Menghapus janji temu baru

Membuat intent

Untuk membuat intent:

Konsol

Buka konsol Dialogflow CX.
Pilih project Google Cloud Anda.
Pilih agen Anda.
Pilih tab Kelola.
Klik Intent.
Klik +Create.
Masukkan data intent.
Klik Simpan.

API

Lihat metode create untuk jenis Intent.

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

Menghapus intent

Untuk menghapus intent:

Konsol

Buka konsol Dialogflow CX.
Pilih project Google Cloud Anda.
Pilih agen Anda.
Pilih tab Kelola.
Klik Intent.
Arahkan kursor ke intent yang ingin dihapus.
Klik tombol hapus .

API

Lihat metode delete untuk jenis Intent.

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

Mengakses data intent

Untuk mengakses data intent:

Konsol

Buka konsol Dialogflow CX.
Pilih project Google Cloud Anda.
Pilih agen Anda.
Pilih tab Kelola.
Klik Intent.
Klik intent yang ingin Anda akses.
Melihat atau memperbarui data intent.
Klik Simpan untuk menyimpan perubahan.

API

Lihat metode get dan patch/update untuk jenis Intent.

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

Saran intent

Dialogflow secara otomatis menganalisis kemunculan tidak cocok selama percakapan dan dapat menyarankan intent baru atau merekomendasikan frasa pelatihan tambahan untuk intent yang ada. Menerima saran ini dapat membantu menghindari terjadinya ketidakcocokan di masa mendatang.

Saat menggunakan saran, Anda dapat menyesuaikan Ukuran Cluster. Nilai ukuran cluster yang lebih kecil menunjukkan lebih banyak intent dengan lebih sedikit frasa pelatihan per intent. Nilai ukuran cluster yang lebih besar menunjukkan lebih sedikit intent dengan lebih banyak frasa pelatihan per intent.

Untuk menerima saran intent:

Konsol

Buka konsol Dialogflow CX.
Pilih project Google Cloud Anda.
Pilih agen Anda.
Pilih tab Kelola.
Klik Intent.
Klik tab Saran.
Sesuaikan Ukuran Cluster sesuai keinginan.
Pilih saran.
Pilih frasa pelatihan yang Anda inginkan.
Untuk intent target, tambahkan frasa pelatihan ke intent yang ada atau yang baru.
Klik Simpan atau Buat Baru untuk menyimpan perubahan. Saat Anda menerima saran intent, intent akan tetap ada dalam daftar saran.

Memisahkan intent

Anda dapat membagi satu intent menjadi dua intent menggunakan konsol. Antarmuka ini memungkinkan Anda memilih frasa pelatihan dari intent sumber dan memindahkannya ke intent baru:

Konsol

Buka konsol Dialogflow CX.
Pilih project Anda.
Pilih agen Anda.
Pilih tab Kelola.
Klik Intent.
Pilih intent yang ingin Anda pisahkan.
Klik Pisahkan.
Pilih intent dari intent sumber.
Klik Pindahkan ke kanan.
Berikan detail lain untuk intent target.
Klik Pisahkan.

Membandingkan dan menggabungkan intent

Anda dapat membandingkan atau menggabungkan dua intent menjadi satu intent menggunakan konsol:

Konsol

Buka konsol Dialogflow CX.
Pilih project Anda.
Pilih agen Anda.
Pilih tab Kelola.
Klik Intent.
Pilih dua intent yang ingin dibandingkan atau digabungkan.
Klik Bandingkan.
Frasa pelatihan ditampilkan berdampingan untuk perbandingan.
Untuk menggabungkan kedua intent, klik Gabungkan.

Mengekspor dan mengimpor intent

Anda dapat mengekspor dan mengimpor intent untuk dibagikan di seluruh agen.

Salah satu opsi format ekspor adalah CSV, yang memiliki kolom berikut:

Nama Tampilan Intent
Bahasa
Frasa

Setiap entri berisi nama tampilan, bahasa, dan frasa pelatihan pertama; atau hanya frasa pelatihan untuk intent yang dideklarasikan sebelumnya. Dialogflow mengenkode anotasi dalam frasa pelatihan yang diekspor, sehingga anotasi dipulihkan saat mengimpor. Format untuk encoding ini adalah:

(annotated part)[entity, parameter]

Contoh:

Intent Display Name,Language,Phrase
Shirt Selection,en,I want a (green)[@sys.color, color] shirt
,,I would like a (yellow)[@sys.color, color] shirt
Store Hours,en,When are you open?
,,What are your hours?

Saat mengimpor intent, mungkin ada konflik penggabungan jika nama tampilan untuk intent di agen yang ada cocok dengan intent yang diimpor. Anda dapat mengontrol perilaku penggabungan saat nama tampilan intent cocok dengan memilih salah satu dari berikut:

Mengganti intent yang ada: Intent yang diimpor akan menimpa intent dengan nama yang sama di agen yang ada.
Ganti nama dan impor sebagai intent baru: Intent yang diimpor diganti namanya dengan menambahkan "_1" ke nama tampilan.
Gabungkan dengan intent yang ada: Frasa pelatihan intent yang diimpor ditambahkan ke intent yang ada. Jika frasa pelatihan yang sama ada, frasa tersebut tidak akan diduplikasi.
Mempertahankan intent asli: Intent yang ada tetap tidak berubah, dan intent yang bertentangan akan diabaikan. Intent yang tidak bertentangan akan diimpor.

Untuk mengekspor intent:

Konsol

Buka konsol Dialogflow CX.
Pilih project Google Cloud Anda.
Pilih agen Anda.
Pilih tab Kelola.
Klik Intent.
Pilih setiap intent yang ingin diekspor.
Klik Ekspor intent yang dipilih.
Pilih format dan tujuan yang diinginkan.
Klik Kirim.

Untuk mengimpor intent:

Konsol

Buka konsol Dialogflow CX.
Pilih project Google Cloud Anda.
Pilih agen Anda.
Pilih tab Kelola.
Klik Intent.
Klik Import.
Pilih sumber.
Jika ada konflik, jendela dialog akan ditampilkan yang memungkinkan Anda memilih perilaku penggabungan.
Klik Kirim.

Mengekspor dan mengimpor frasa pelatihan

Anda dapat mengekspor dan mengimpor frasa pelatihan untuk intent yang ada.

Format file untuk impor adalah CSV tanpa judul kolom dan satu kolom. Contoh:

"I want a pony"
"I need a pony"
"I must have a pony"

Saat mengimpor frasa pelatihan, Anda dapat memilih salah satu mode impor berikut:

Import as new training phrases: Frasa dalam file ditambahkan ke daftar frasa yang ada.
Mengganti frasa pelatihan yang ada: Frasa pelatihan yang ada akan dihapus, dan frasa pelatihan dari file akan ditambahkan.

Secara default, frasa pelatihan yang diimpor akan otomatis dianotasi. Anda dapat menonaktifkan perilaku ini dengan memilih Lewati anotasi otomatis.

Untuk mengekspor frasa pelatihan untuk intent:

Konsol

Buka konsol Dialogflow CX.
Pilih project Google Cloud Anda.
Pilih agen Anda.
Pilih tab Kelola.
Klik Intent.
Pilih intent.
Scroll ke bawah ke bagian Frasa pelatihan.
Pilih frasa pelatihan yang ingin diekspor.
Klik Ekspor.

Untuk mengimpor frasa pelatihan untuk intent:

Konsol

Buka konsol Dialogflow CX.
Pilih project Google Cloud Anda.
Pilih agen Anda.
Pilih tab Kelola.
Klik Intent.
Pilih intent.
Scroll ke bawah ke bagian Frasa pelatihan.
Jika ingin, pilih lewati anotasi otomatis.
Klik tombol impor tepat di atas daftar frasa pelatihan.
Pilih file dan mode impor.
Klik Kirim.

Intent utama dan tambahan

Saat mendesain agen, terkadang ada baiknya untuk menganggap intent sebagai intent utama atau intent tambahan.

Intent utama mengidentifikasi tujuan utama pengguna akhir untuk berinteraksi dengan agen. Intent tambahan mengidentifikasi pertanyaan berikutnya dari pengguna akhir yang terkait dengan intent utama. Pertanyaan berikutnya ini dapat memberikan konteks tambahan untuk kebutuhan pengguna akhir, atau dapat berupa pertanyaan lanjutan yang membantu pengguna akhir mengklarifikasi atau lebih memahami sesuatu.

Intent utama biasanya merupakan salah satu intent pertama yang cocok dalam percakapan, dan pertanyaan pengguna akhir lebih lanjut cocok dengan intent tambahan. Contoh:

Dialog	Penjelasan
Pengguna akhir: Mengaktifkan ponsel baru Agen: Tentu, saya dapat membantu Anda. Berapa 4 digit terakhir nomor telepon yang ingin Anda aktifkan?	Niat header cocok
Pengguna akhir: 1234 Agen: Apakah Anda siap mengaktifkan ponsel sekarang?	Parameter ditetapkan
Pengguna akhir: Apakah semua pesan saya akan ditransfer ke ponsel baru saya? Agen: ...	Intent tambahan cocok