Penyiapan dan pembersihan Dialogflow ES

Panduan ini menyediakan semua langkah penyiapan yang diperlukan untuk mulai menggunakan Dialogflow. Layanan ini juga memberikan saran langkah-langkah pembersihan setelah mencoba atau menguji Dialogflow.

Sebelum memulai

Anda harus melakukan hal berikut sebelum membaca panduan ini:

1. Baca dasar-dasar Dialogflow ES.
2. Baca Edisi.

Tentang Konsol Google Cloud

Konsol Google Cloud (kunjungi dokumentasi, buka konsol) adalah Web UI yang digunakan untuk menyediakan, mengonfigurasi, mengelola, dan memantau sistem yang digunakan produk Google Clouds. Anda dapat menggunakan Konsol Google Cloud untuk menyiapkan dan mengelola resource Dialogflow.

Membuat project

Untuk menggunakan layanan yang disediakan oleh Google Cloud, Anda harus membuat project. Project menyusun semua resource Google Cloud Anda. Sebuah project terdiri dari sekumpulan kolaborator, API yang diaktifkan (dan resource lainnya), alat pemantauan, informasi penagihan, serta kontrol akses dan autentikasi. Anda dapat membuat satu project, atau membuat beberapa project dan menggunakannya untuk mengatur resource Google Cloud dalam hierarki resource. Saat membuat project, catat ID project. ID ini dibutuhkan untuk membuat panggilan API. Untuk mengetahui informasi selengkapnya tentang project, lihat dokumentasi Resource Manager.

Konsol Dialogflow ES (kunjungi dokumentasi, buka konsol) secara opsional dapat membuat project dasar untuk Anda saat membuat agen. Jika Anda berencana menggunakan project untuk lebih dari sekadar akses dasar ke edisi tanpa biaya, atau berencana menggunakan API, Anda harus membuat project dengan Konsol Google Cloud seperti yang dijelaskan di bawah.

Sebaiknya Anda membuat project terpisah untuk eksperimen, pengujian, dan produksi. Setiap project hanya dapat membuat satu Agen Dialogflow. Jika memerlukan beberapa agen, Anda harus membuat beberapa project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Peringatan: Jika project dihapus, agen yang ditautkan ke project tersebut tidak dapat dipulihkan.

Aktifkan penagihan

Catatan: Anda dapat melewati langkah ini jika menggunakan edisi Dialogflow yang tersedia tanpa biaya.

Akun penagihan digunakan untuk menentukan yang membayar serangkaian resource, dan dapat ditautkan ke satu atau beberapa project. Penggunaan project ditagihkan ke akun penagihan tertaut. Dalam sebagian besar kasus, Anda mengonfigurasi penagihan saat membuat project. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Penagihan.

Make sure that billing is enabled for your Google Cloud project.

Mengaktifkan API

Catatan: Anda dapat melewati langkah ini jika menggunakan Konsol Dialogflow untuk membuat project.

Anda harus mengaktifkan Dialogflow API untuk project Anda. Untuk mengetahui informasi selengkapnya tentang cara mengaktifkan API, lihat dokumentasi Penggunaan Layanan.

Enable the Dialogflow API.

Enable the API

Mengaktifkan log audit

Catatan: Anda dapat melewati langkah ini untuk agen non-produksi.

Aktifkan log audit Akses Data untuk Dialogflow API di project Anda. Hal ini dapat membantu Anda melacak perubahan waktu desain di agen Dialogflow yang ditautkan ke project ini.

Instal dan lakukan inisialisasi pada Google Cloud CLI

Catatan: Anda dapat melewati langkah ini jika tidak akan menggunakan API.

Jika berencana menggunakan Dialogflow API, Anda perlu menginstal dan melakukan inisialisasi pada Google Cloud CLI. gcloud CLI merupakan serangkaian alat yang dapat Anda gunakan untuk mengelola resource dan aplikasi yang dihosting Google Cloud.

Link berikut berisi petunjuk:

Install the Google Cloud CLI, then initialize it by running the following command:

gcloud init

Siapkan kontrol akses dan autentikasi

Catatan: Anda dapat melewati langkah ini jika tidak akan menggunakan API.

Jika berencana menggunakan Dialogflow API, Anda perlu menyiapkan autentikasi. Setiap aplikasi klien menggunakan API harus diautentikasi dan diberi akses ke resources yang diminta. Bagian ini menjelaskan konsep autentikasi penting dan memberikan langkah-langkah untuk menyiapkannya. Untuk informasi selengkapnya, lihat ringkasan autentikasi Google Cloud.

Autentikasi dengan akun pengguna

Akun pengguna adalah opsi autentikasi terbaik ketika mempelajari Dialogflow API dan untuk pengembangan lokal. Anda dapat memanfaatkan akun pengguna Anda untuk mengautentikasi eksekusi command line REST atau panggilan library klien.

Autentikasi akun pengguna command line REST

Catatan: Jika Anda menggunakan Cloud Shell, secara otomatis Anda akan login ke gcloud sehingga Anda tidak perlu menjalankannya gcloud auth login.

Untuk mengautentikasi panggilan command line REST, gunakan gcloud CLI. Perintah gcloud auth login membuat Anda login ke gcloud menggunakan akun pengguna Anda, yang harus dilakukan sebelum memanggil API. Perintah gcloud auth print-access-token digunakan diseluruh contoh command line REST pada dokumentasi ini untuk mengautentikasi panggilan REST.

Untuk membuat kredensial pengguna bagi lingkungan lokal Anda:

gcloud auth login

Autentikasi akun pengguna library klien

Untuk mengautentikasi panggilan library klien, Anda dapat menggunakan gcloud CLI. Perintah gcloud auth application-default login membuat Anda login ke gcloud untuk kredensial default aplikasi, menggunakan akun pengguna Anda yang harus dilakukan sebelum memanggil API. Perintah gcloud auth application-default set-quota-project harus digunakan untuk set project Anda untuk penagihan dan kuota yang terkait dengan panggilan API. Biasanya, project ini sama dengan project yang digunakan agen Anda, dan Anda memberikan ID project untuk project yang dibuat pada langkah-langkah di atas.

Variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS tidak boleh ditetapkan, agar kredensial default aplikasi Anda dapat digunakan oleh library klien.

Untuk membuat kredensial default aplikasi untuk lingkungan lokal Anda:

gcloud auth application-default login
gcloud auth application-default set-quota-project PROJECT_ID

Autentikasi dengan akun layanan

Akun layanan merupakan opsi autentikasi lain yang hanya boleh digunakan dalam lingkungan yang aman seperti produksi atau staging. Akun layanan memberikan kredensial untuk aplikasi, bukan untuk pengguna akhir. Akun layanan dimiliki oleh project, dan Anda dapat membuat banyak akun layanan untuk sebuah project. Untuk informasi selengkapnya, lihat:

• Ringkasan akun layanan
• Praktik terbaik akun layanan
• Membuat dan mengelola akun layanan
• Membuat dan mengelola kunci akun layanan
• Mengautentikasi dengan kunci akun layanan

Kontrol akses dengan peran

Saat akun utama (akun pengguna, akun layanan, dan sebagainya) memanggil API, Google Cloud mewajibkan akun utama memiliki izin yang sesuai. Anda dapat memberikan izin dengan memberikan peran ke akun utama. Untuk informasi selengkapnya, lihat ringkasan peran.

Jika Anda telah membuat project dengan menggunakan akun pengguna Anda, akun pengguna Anda memiliki Peran dasar pemilik untuk project tersebut. Peran ini memberikan akses untuk memanggil API apa pun untuk project. Namun, jika project dibuat dengan akun yang berbeda, Anda mungkin perlu memberi peran ke akun pengguna Anda sebelum Anda dapat memanggil API. Untuk mengetahui petunjuknya, lihat panduan kontrol akses Dialogflow.

Menginstal library klien Dialogflow

Catatan: Anda dapat melewati langkah ini jika tidak akan menggunakan API.

Anda memiliki tiga opsi untuk memanggil API: Library klien, REST, dan gRPC yang didukung Google.

Library klien tersedia untuk beberapa bahasa populer. Untuk petunjuk penginstalan, lihat bahasa yang Anda inginkan di Library klien.

Pembersihan

Setelah menyiapkan dan mencoba atau menguji Dialogflow, sebaiknya Anda menghapus resource yang Anda buat:

• Sebaiknya hapus agen Anda.
• Sebaiknya Anda menonaktifkan project.
• Jika Anda memanggil gcloud auth login, tindakan ini akan menyimpan kredensial di direktori pengguna pada komputer Anda. Anda dapat menghapus kredensial ini dengan memanggil:

  gcloud auth revoke

• Jika Anda memanggil gcloud auth application-default login, tindakan ini akan menyimpan kredensial di direktori pengguna pada komputer Anda. Anda dapat menghapus kredensial ini dengan memanggil:

  gcloud auth application-default revoke