Membuat agen pertama

Prasyarat

Buat agen Anda

Panduan ini akan memandu Anda dalam 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 memodifikasi aplikasi yang ada untuk menyertakan agen, sampel tersebut menawarkan model yang baik untuk logika aplikasi Anda.

Dalam panduan memulai ini, Anda akan melakukan hal berikut:

  • Daftar sebagai partner
  • Buat merek dan agen
  • Atau, jelajahi fitur dalam percakapan dengan Helper Bot Business Messages
  • Siapkan agen Anda untuk mengirim dan menerima pesan

Untuk membuat agen tanpa menggunakan sampel, lihat Membuat agen.

Daftar sebagai partner

  1. Buka Konsol Developer Komunikasi Bisnis.
  2. Di bagian Business Messages, klik Create partner account.

  3. Masukkan informasi partner Anda:

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

  4. Tinjau dan setujui Persyaratan Layanan Business Messages.

  5. Klik Create.

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

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

Membuat akun layanan

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

  3. Klik Create key, lalu klik Create.

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

Buat merek dan agen

Agen adalah representasi percakapan dari suatu merek—entitas percakapan yang berinteraksi dengan pengguna. Anda membuat merek untuk mewakili bisnis dan membuat agen sehingga konsumen dapat terhubung dengan percakapan.

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

Jika mengaktifkan Helper Bot Business Messages, Anda dapat langsung memulai percakapan. Jika tidak, lanjutkan ke 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 manfaat yang ditawarkan platform tersebut. Mengaktifkan Helper Bot bersifat opsional, tetapi sangat direkomendasikan saat membuat agen pertama Anda.

Helper Bot memungkinkan Anda untuk

  • Jelajahi berbagai fitur
  • Pelajari cara menerapkan fitur
  • Temukan referensi untuk penyiapan agen

Jika diaktifkan, Helper Bot akan mengirim dan menerima pesan untuk agen Anda, tidak perlu webhook. Anda harus menonaktifkan Helper Bot sebelum dapat menetapkan 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 langsung terbuka setelah pembuatan agen untuk membantu Anda memulai.

Untuk berinteraksi dengan Helper Bot, 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 Copy Android URL atau Copy iOS URL untuk menyalin URL pengujian agen.
    • Klik Kirim untuk mengirim URL ke alamat email Anda.

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

Menonaktifkan Helper Bot

Sebelum dapat menyesuaikan agen dan menyiapkannya untuk diluncurkan, Anda perlu menonaktifkan Helper Bot Business Messages.

Untuk menonaktifkan Helper Bot,

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

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 didesain untuk memproses pesan pengguna.

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

Anda akan menyelesaikan langkah-langkah berikut:

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

Di akhir panduan ini, agen 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 sampel Echo Bot ke webhook yang telah dikonfigurasi sebelumnya. Jika sudah memiliki infrastruktur web untuk memanfaatkan penerimaan pesan, Anda dapat membuat webhook baru di layanan web tersebut, tetapi Anda harus mengonfigurasi logika sendiri. Lihat Menetapkan webhook tingkat partner untuk mengetahui detailnya.

Membuat lingkungan Cloud

Anda memerlukan lingkungan cloud untuk men-deploy sampel 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.
    • Di kolom Location, klik Browse untuk menampilkan lokasi potensial untuk project Anda. Jika tidak dapat menemukan organisasi Google Workspace Anda, berarti Anda tidak login ke akun Google Workspace. Anda dapat membuat project tanpa organisasi, tetapi beberapa fitur dibatasi. Lihat Manfaat resource organisasi untuk informasi selengkapnya.

  4. Klik Create.

  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 sampel 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 Create a service account ke dalam folder resource sampel, lalu 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 sampel.

  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 pada 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 pada 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 pada dasbor project di Google Cloud.

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

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

Menyetel webhook Anda

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 Konfigurasikan.

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

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

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

  5. Di Konsol Play, klik Verifikasi.

    Saat Business Messages memverifikasi webhook Anda, dialog akan ditutup.

Untuk mengonfigurasi webhook dengan Business Communications API, lihat Contoh: Memperbarui 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.

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

  3. Perbarui nilai yang Anda sukai, 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. Pada URL pengujian Agen, klik tombol Android atau tombol 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 mengirim URL ke alamat email.

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

Pesan selamat datang agen Anda akan menyambut Anda. Pada tahap ini, Anda dapat berinteraksi dengan Echo Bot. Metode ini menggemakan pesan yang Anda kirim kembali kepada Anda. Selain itu, Anda dapat memanggil fitur kaya dengan mengirimkan string tertentu: “carousel”, “kartu”, “chip”.

Langkah berikutnya

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