Intent menentukan permintaan pengguna mana yang dipahami dan tindakan apa yang harus dilakukan. Dalam sebagian besar kasus, Anda menggunakan konsol Dialogflow ES untuk mengelola intent. Dalam skenario lanjutan, Anda dapat menggunakan API untuk mengelola maksud. Dokumen ini menjelaskan cara membuat, mencantumkan, dan menghapus maksud menggunakan API.
Sebelum memulai
Sebelum memulai, selesaikan langkah-langkah berikut:
- Baca dasar-dasar Dialogflow.
- Lakukan langkah-langkah penyiapan.
Buat agen
- Buka konsol Dialogflow ES.
- Login ke konsol 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.
Gunakan IntentView untuk menampilkan semua data intent
Secara default, API menampilkan data maksud yang disingkat saat Anda membuat, mencantumkan, atau mendapatkan maksud. Contoh berikut menggunakan nilai default ini.
Untuk mengambil semua data niat, Anda harus menyetel parameter IntentView ke
INTENT_VIEW_FULL. Untuk mengetahui informasi selengkapnya tentang data intent, lihat metode
untuk jenis Intents.
Membuat intent
Contoh berikut menunjukkan cara membuat intent. Untuk mengetahui informasi selengkapnya tentang maksud, lihat Referensi maksud.
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 mencantumkan 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 intent untuk 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.