Intent menentukan permintaan pengguna mana yang dipahami dan tindakan apa yang harus dilakukan. Pada umumnya, Anda akan menggunakan konsol Dialogflow ES untuk mengelola intent. Dalam skenario lanjutan, Anda mungkin ingin menggunakan API untuk mengelola maksud. Halaman ini menjelaskan cara membuat, mencantumkan, dan menghapus maksud menggunakan API.
Sebelum memulai
Anda harus melakukan hal berikut sebelum membaca panduan ini:
- Baca dasar-dasar Dialogflow.
- Lakukan langkah-langkah penyiapan.
Buat agen
- Buka konsol Dialogflow ES.
- Login ke konsol Dialogflow jika diminta. Untuk mengetahui informasi selengkapnya, lihat Ringkasan konsol Dialogflow.
- Di menu sidebar, luaskan Loading agents.
- Klik Create new agent.
- Masukkan nama agen, bahasa default, dan zona waktu default.
- Masukkan project yang ada. Agar konsol Dialogflow membuat project, pilih Buat project Google baru.
- Klik Create.
Mengimpor file contoh ke agen Anda
Langkah-langkah dalam panduan ini membuat asumsi tentang agen Anda, jadi Anda perlu mengimpor agen yang disiapkan untuk panduan ini. Saat mengimpor, langkah-langkah ini menggunakan opsi pulihkan, yang akan menimpa semua setelan, maksud (intent), dan entity agen.
Untuk mengimpor file, ikuti langkah-langkah berikut:
-
Download
room-booking-agent.zipfile. - Buka konsol Dialogflow ES.
- Pilih agen Anda.
- Klik tombol setelan settings di samping nama agen.
- Pilih tab Export and Import.
- Pilih Pulihkan Dari Zip dan ikuti petunjuk untuk memulihkan file zip yang Anda download.
Gunakan IntentView untuk menampilkan semua data intent
Saat membuat, mencantumkan, atau mendapatkan intent, data intent akan ditampilkan kepada pemanggil. Secara default, data yang ditampilkan ini disingkat. Contoh di bawah menggunakan nilai default ini.
Untuk mengambil semua data niat,
Anda harus menyetel parameter IntentView ke INTENT_VIEW_FULL.
Untuk mengetahui informasi selengkapnya, lihat metode untuk jenis
Intents.
Membuat intent
Contoh berikut menunjukkan cara membuat intent. Untuk mengetahui informasi selengkapnya, lihat Referensi maksud (Intents).
REST
Untuk membuat intent bagi agen Anda, panggil metode create pada resource intent.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- PROJECT_ID: Project ID Google Cloud Anda
Metode HTTP dan URL:
POST https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/agent/intents
Meminta isi JSON:
{
"displayName": "ListRooms",
"priority": 500000,
"webhookState": "WEBHOOK_STATE_UNSPECIFIED",
"trainingPhrases": [
{
"type": "EXAMPLE",
"parts": [
{
"text": "What rooms are available at 10am today?"
}
]
}
],
"action": "listRooms",
"messages": [
{
"text": {
"text": [
"Here are the available rooms:"
]
}
}
]
}
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
Anda akan melihat respons JSON seperti berikut:
Segmen jalur setelah intents berisi ID intent baru Anda.
Go
Untuk melakukan autentikasi ke Dialogflow CX, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk melakukan autentikasi ke Dialogflow CX, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk melakukan autentikasi ke Dialogflow CX, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk melakukan autentikasi ke Dialogflow CX, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Bahasa tambahan
C#: Ikuti Petunjuk penyiapan C# di halaman library klien, lalu buka Dokumentasi referensi Dialogflow CX untuk .NET.
PHP: Ikuti petunjuk penyiapan PHP di halaman library klien, lalu buka dokumentasi referensi Dialogflow CX untuk PHP.
Ruby: Ikuti Petunjuk penyiapan Ruby di halaman library klien, lalu buka Dokumentasi referensi Dialogflow CX untuk Ruby.
Membuat daftar intent
Contoh berikut menunjukkan cara membuat daftar maksud. Untuk mengetahui informasi selengkapnya, lihat Referensi maksud (Intents).
REST
Untuk mencantumkan maksud agen Anda, panggil metode list pada resource intents.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- PROJECT_ID: Project ID Google Cloud Anda
Metode HTTP dan URL:
GET https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/agent/intents
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
Anda akan melihat respons JSON seperti berikut:
{
"intents": [
{
"name": "projects/PROJECT_ID/agent/intents/5b290a94-55d6-4074-96f4-9c4c4879c2bb",
"displayName": "ListRooms",
"priority": 500000,
"action": "listRooms",
"messages": [
{
"text": {
"text": [
"Here are the available rooms:"
]
}
}
]
},
...
]
}
Segmen jalur setelah intents berisi ID niat Anda.
Go
Untuk melakukan autentikasi ke Dialogflow CX, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk melakukan autentikasi ke Dialogflow CX, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk melakukan autentikasi ke Dialogflow CX, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk melakukan autentikasi ke Dialogflow CX, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Bahasa tambahan
C#: Ikuti Petunjuk penyiapan C# di halaman library klien, lalu buka Dokumentasi referensi Dialogflow CX untuk .NET.
PHP: Ikuti petunjuk penyiapan PHP di halaman library klien, lalu buka dokumentasi referensi Dialogflow CX untuk PHP.
Ruby: Ikuti Petunjuk penyiapan Ruby di halaman library klien, lalu buka Dokumentasi referensi Dialogflow CX untuk Ruby.
Menghapus maksud
Contoh berikut menunjukkan cara menghapus intent. Untuk mengetahui informasi selengkapnya, lihat Referensi maksud (Intents).
REST
Untuk menghapus maksud agen Anda,
panggil metode delete pada resource intents.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- PROJECT_ID: Project ID Google Cloud Anda
- INTENT_ID: ID maksud Anda
Metode HTTP dan URL:
DELETE https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/agent/intents/INTENT_ID
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
Anda akan menerima kode status berhasil (2xx) dan respons kosong.
Go
Untuk melakukan autentikasi ke Dialogflow CX, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk melakukan autentikasi ke Dialogflow CX, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk melakukan autentikasi ke Dialogflow CX, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk melakukan autentikasi ke Dialogflow CX, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Bahasa tambahan
C#: Ikuti Petunjuk penyiapan C# di halaman library klien, lalu buka Dokumentasi referensi Dialogflow CX untuk .NET.
PHP: Ikuti petunjuk penyiapan PHP di halaman library klien, lalu buka dokumentasi referensi Dialogflow CX untuk PHP.
Ruby: Ikuti Petunjuk penyiapan Ruby di halaman library klien, lalu buka Dokumentasi referensi Dialogflow CX untuk Ruby.