Membuat agen pertama

Prasyarat

Membuat agen Anda

Panduan ini akan memandu Anda cara membuat agen menggunakan aplikasi contoh. Contoh ini memberikan cara cepat untuk menjelajahi fungsi agen dan dapat berfungsi sebagai titik awal untuk pengembangan agen Anda. Jika Anda ingin mengubah aplikasi yang ada untuk menyertakan agen, contoh ini menawarkan model yang baik untuk logika aplikasi Anda.

Dalam panduan memulai ini, Anda akan melakukan hal berikut:

  • Mendaftar sebagai partner
  • Membuat merek dan agen
  • Anda juga dapat menjelajahi fitur dalam percakapan dengan Helper Bot Business Messages
  • Menyiapkan agen Anda untuk mengirim dan menerima pesan

Untuk membuat agen tanpa menggunakan sampel, lihat Membuat agen Anda.

Mendaftar sebagai partner

  1. Buka Konsol Developer Business Communications.
  2. Di bagian Business Messages, klik Buat akun partner.

  3. Masukkan informasi partner Anda:

    Kolom Nilai
    Nama Anda Nama lengkap Anda
    Nama partner Nama organisasi Anda
    Situs partner Situs organisasi Anda
    Wilayah Region tempat Anda ingin menghosting layanan Business Messages

  4. Tinjau dan setujui Persyaratan Layanan Business Messages.

  5. Klik Buat.

Anda kini terdaftar sebagai partner Business Messages. Project Google Cloud baru telah dibuat untuk Anda dengan Business Messages API dan Business Communications API diaktifkan. Anda tidak memiliki akses ke project ini dan project ini tidak akan mengganggu project Google Cloud yang sudah ada.

Anda kini memiliki akses ke Business Messages API dan Business Communications API.

Membuat akun layanan

  1. Di halaman beranda Konsol Developer Komunikasi Bisnis, klik Setelan akun partner.
  2. Di navigasi kiri, klik Akun layanan.

  3. Klik Buat kunci, lalu klik Buat.

    Browser Anda akan mendownload kunci akun layanan. Simpan di lokasi yang aman. Anda akan memerlukan kunci ini nanti untuk men-deploy aplikasi web dan mengakses Business Messages API dan Business Communications API pada masa mendatang.

Membuat merek dan agen

Agen adalah representasi percakapan dari suatu merek—entitas percakapan yang berinteraksi dengan pengguna. Anda membuat merek untuk merepresentasikan bisnis dan membuat agen agar konsumen dapat terhubung dengannya melalui percakapan.

  1. Buka Konsol Developer Komunikasi Bisnis dan login dengan akun Google Business Messages Anda.
  2. Klik Create agent.
  3. Untuk Jenis agen, pilih Business Messages.
  4. Masukkan nilai untuk Nama merek dan Nama agen.
  5. Lakukan salah satu langkah berikut:
    • Untuk memulai percakapan dengan agen Anda dan menjelajahi fitur yang tersedia, pilih Aktifkan Helper Bot Business Messages.
    • Untuk menyesuaikan agen dan mempersiapkannya untuk penanganan pesan, batalkan pilihan Aktifkan Helper Bot Business Messages.
  6. Klik Create agent.

Jika Anda mengaktifkan Helper Bot Business Messages, Anda dapat memulai percakapan dengan segera. Jika tidak, lanjutkan untuk menyiapkan agen Anda untuk penanganan pesan.

Menjelajahi fitur dengan Helper Bot Business Messages

Helper Bot Business Messages memungkinkan Anda memulai percakapan secara cepat dengan agen sehingga Anda dapat merasakan apa yang ditawarkan platform ini. Mengaktifkan Helper Bot bersifat opsional, tetapi sangat direkomendasikan saat membuat agen pertama Anda.

Helper Bot memungkinkan Anda untuk

  • Menjelajahi fitur lengkap
  • Pelajari cara menerapkan fitur
  • Menemukan referensi untuk penyiapan agen

Jika diaktifkan, Helper Bot akan mengirim dan menerima pesan untuk agen Anda; webhook tidak diperlukan. Anda harus menonaktifkan Helper Bot sebelum dapat menyetel webhook atau mengaktifkan Dialogflow untuk menangani pesan pengguna.

Memulai percakapan dengan Helper Bot

Setelah mengaktifkan Helper Bot Business Messages, Anda dapat memulai percakapan. Dialog akan terbuka segera setelah pembuatan agen untuk membantu Anda memulai.

Untuk berinteraksi dengan Bot Bantuan, lakukan langkah-langkah berikut dari dialog ini:

  1. Akses URL pengujian agen. Ada beberapa cara untuk melakukannya:

    • Klik tombol Android atau tombol iOS. Kemudian, pindai kode QR dengan perangkat seluler yang sesuai dan klik Luncurkan. Atau, klik Salin URL Android atau Salin URL iOS untuk menyalin URL pengujian agen.
    • Klik Kirim untuk mengirimkan URL ke alamat email Anda.

  2. Buka URL di perangkat seluler Anda. (Perangkat iOS memerlukan aplikasi Google Maps.)

Menonaktifkan Helper Bot

Sebelum dapat menyesuaikan agen dan mempersiapkannya untuk peluncuran, Anda harus menonaktifkan Helper Bot Business Messages.

Untuk menonaktifkan Helper Bot:

  1. Buka Business Communications Developer Console.
  2. Pilih agen Anda.
  3. Di navigasi sebelah kiri, klik Integrasi.
  4. Untuk Helper Bot, klik Nonaktifkan.

Jika dinonaktifkan, Helper Bot tidak akan lagi mengirim dan menerima pesan untuk agen Anda. Sekarang Anda dapat menyiapkan agen untuk menangani alur pesan.

Menyiapkan agen untuk penanganan pesan

Dalam panduan ini, Anda akan men-deploy Echo Bot ke Google Cloud Platform (GCP) dengan webhook yang dirancang untuk memproses pesan pengguna.

Echo Bot adalah aplikasi contoh yang mengembalikan pesan ke pengguna. Fitur ini memungkinkan Anda bereksperimen dengan fitur lengkap, seperti tindakan yang disarankan dan kartu lengkap, dalam percakapan dengan agen Anda. Anda juga dapat menggunakan Echo Bot sebagai titik awal untuk mengembangkan agen Anda.

Anda akan menyelesaikan langkah-langkah berikut:

  • Men-deploy sampel Echo Bot ke GCP
  • Konfigurasi URL webhook untuk akun partner Business Messages Anda
  • Berikan informasi dasar tentang agen Anda

Di akhir panduan ini, agen Anda akan siap mengirim dan menerima pesan.

Men-deploy aplikasi web ke GCP

Business Messages meneruskan pesan dari pengguna ke webhook di infrastruktur Anda. Dalam panduan ini, Anda akan men-deploy kode sumber contoh Echo Bot ke webhook yang telah dikonfigurasi sebelumnya. Jika sudah memiliki infrastruktur web untuk dimanfaatkan dalam menerima pesan, Anda dapat membuat webhook baru di layanan web tersebut, tetapi Anda harus mengonfigurasi logikanya sendiri. Lihat Menetapkan webhook tingkat partner untuk mengetahui detailnya.

Membuat lingkungan Cloud

Anda memerlukan lingkungan cloud untuk men-deploy contoh Echo Bot.

Untuk membuat project GCP sebagai lingkungan cloud, ikuti langkah-langkah berikut:

  1. Buka Pemilih Project Google Cloud Console.

    Jika belum pernah membuat project Google Cloud, Anda harus Menyetujui Persyaratan dan Layanan.

  2. Klik Buat Project.

  3. Masukkan nama dan lokasi untuk project baru Anda

    • Project ID Anda dibuat secara otomatis dan muncul di bawah nama project Anda.
    • Di kolom Lokasi, klik Jelajah untuk menampilkan potensi lokasi project Anda. Jika Anda tidak dapat menemukan organisasi Google Workspace Anda, berarti Anda belum login ke akun Google Workspace. Anda dapat membuat project tanpa organisasi, tetapi beberapa fitur terbatas. Lihat Manfaat resource organisasi untuk mengetahui informasi selengkapnya.

  4. Klik Buat.

  5. Klik Menu.

  6. Klik Penagihan.

  7. Klik Tautkan Akun Penagihan.

  8. Buat akun penagihan baru atau tambahkan akun penagihan yang ada ke project. Lihat Fitur Program Gratis Google Cloud untuk memahami opsi pembayaran.

Men-deploy contoh Echo Bot

  1. Instal gcloud CLI. Anda akan menggunakannya untuk men-deploy kode contoh ke Google Cloud.

  2. Download dan ekstrak contoh Echo Bot (Node.js, Java, Python).

  3. Salin file kredensial JSON yang Anda download di Membuat akun layanan ke dalam folder resource sampel dan ganti nama kredensial menjadi "bm-agent-service-account-credentials.json". Jalur ke file kredensial ini bergantung pada contoh yang Anda download.

    Node.js

    ./bm-nodejs-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json

    Java

    ./bm-java-echo-bot/full_sample/src/main/resources/bm-agent-service-account-credentials.json

    Python

    ./bm-python-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json

  4. Di terminal, buka direktori full_sample contoh.

  5. Jalankan perintah berikut di terminal untuk men-deploy sampel:

    Node.js

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

    PROJECT_ID adalah project ID untuk project yang Anda buat di Membuat lingkungan Cloud. Project ID tercantum di dasbor project di Google Cloud.

    Java

    gcloud config set project PROJECT_ID
gcloud app create
mvn appengine:deploy

    PROJECT_ID adalah project ID untuk project yang Anda buat di Membuat lingkungan Cloud. Project ID tercantum di dasbor project di Google Cloud.

    Python

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

    PROJECT_ID adalah project ID untuk project yang Anda buat di Membuat lingkungan Cloud. Project ID tercantum di dasbor project di Google Cloud.

  6. Perhatikan URL aplikasi yang di-deploy dalam output perintah terakhir. Ini adalah dasar URL webhook Anda:

    Deployed service [default] to [https://PROJECT_ID.appspot.com]

Menetapkan webhook

Setelah Echo Bot di-deploy, Anda perlu menentukan URL webhook (yang Anda operasikan) untuk mulai menerima pesan.

  1. Buka Setelan akun di Konsol Developer Komunikasi Bisnis.
  2. Pastikan akun partner yang benar dipilih.
  3. Untuk URL webhook Business Messages, klik Konfigurasi.

  4. Untuk URL endpoint webhook, masukkan URL aplikasi Anda + "/callback".

    Endpoint Anda akan mengikuti format: "https://PROJECT_ID.appspot.com/callback".

    Endpoint ini telah ditentukan sebelumnya dalam logika aplikasi contoh yang Anda deploy ke GCP.

  5. Di Konsol Developer, klik Verifikasi.

    Saat Business Messages memverifikasi webhook Anda, dialog akan ditutup.

Untuk mengonfigurasi webhook dengan Business Communications API, lihat Contoh: Perbarui URL webhook.

Anda dapat menggunakan framework pengujian Business Messages untuk menguji apakah webhook Anda berhasil merespons payload Business Messages.

Masukkan informasi agen

Berikan beberapa informasi dasar untuk menyelesaikan penyiapan agen Anda.

  1. Buka Business Communications Developer Console.
  2. Di navigasi sebelah kiri, klik Informasi agen.

  3. Perbarui nilai sesuai keinginan Anda, atau gunakan saran berikut:

    Kolom Nilai
    Pesan selamat datang Selamat datang di percakapan Echo Bot.
    Kebijakan privasi https://policies.google.com/privacy

  4. Klik Simpan.

Mulai percakapan

Untuk berinteraksi dengan Echo Bot, ikuti langkah-langkah berikut:

  1. Buka Business Communications Developer Console.
  2. Di navigasi sebelah kiri, klik Informasi agen.
  3. Di bagian URL pengujian agen, klik tombol Android atau iOS.

  4. Pindai kode QR dengan perangkat seluler yang sesuai, atau klik Salin URL Android atau Salin URL iOS untuk menyalin URL pengujian agen.

    Anda juga dapat mengklik Kirim untuk mengirimkan URL ke alamat email Anda.

  5. Buka URL di perangkat seluler Anda. (Perangkat iOS memerlukan aplikasi Google Maps.)

Pesan selamat datang agen akan menyapa Anda. Pada tahap ini, Anda dapat berinteraksi dengan Echo Bot. Aplikasi ini akan mengembalikan pesan yang Anda kirim kepada Anda. Selain itu, Anda dapat memanggil fitur multimedia dengan mengirim string tertentu: “carousel”, “card”, “chips”.

Langkah berikutnya

Setelah membuat agen pertama, pelajari lebih lanjut Business Messages dan hal lain yang dapat Anda lakukan di platform ini.