Membuat agen pertama

Prasyarat

Buat agen Anda

Panduan ini membahas 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 memodifikasi aplikasi yang sudah 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
  • Menciptakan brand dan agen
  • Anda juga dapat menjelajahi fitur dalam percakapan dengan Helper Bot Business Messages
  • Siapkan agen untuk mengirim dan menerima pesan

Untuk membuat agen tanpa menggunakan contoh, lihat Membuat agen.

Mendaftar sebagai partner

  1. Buka Konsol Developer Komunikasi Bisnis.
  2. Pada 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 Wilayah tempat Anda ingin menghosting layanan Business Messages

  4. Tinjau dan setujui Persyaratan Layanan Business Messages.

  5. Klik Create.

Anda kini 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 Anda yang sudah 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 akan mendownload kunci akun layanan. Simpanlah di lokasi yang aman. Anda akan memerlukan kunci ini nanti untuk men-deploy aplikasi web serta mengakses Business Messages dan Business Communications API pada masa mendatang.

Menciptakan brand dan agen

Agen adalah representasi percakapan dari suatu brand, yakni entity percakapan yang berinteraksi dengan pengguna. Anda membuat brand untuk mewakili bisnis dan membuat agen sehingga konsumen dapat terhubung dengannya melalui percakapan.

  1. Buka Konsol Developer Komunikasi Bisnis, lalu login dengan Akun Google Business Messages Anda.
  2. Klik Buat agen.
  3. Untuk Jenis agen, pilih Business Messages.
  4. Masukkan nilai untuk Brand name dan Agent name.
  5. Lakukan salah satu hal berikut:
    • Untuk merasakan percakapan dengan agen guna menjelajahi fitur yang tersedia, pilih Aktifkan Helper Bot Business Messages.
    • Guna menyesuaikan agen Anda dan menyiapkannya untuk penanganan pesan, batalkan pilihan Aktifkan Helper Bot Business Messages.
  6. Klik Buat agen.

Jika mengaktifkan Helper Bot Business Messages, Anda dapat segera memulai percakapan. 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 dengan cepat dengan agen sehingga Anda dapat merasakan manfaat yang ditawarkan platform. Mengaktifkan Helper Bot bersifat opsional, tetapi sangat direkomendasikan saat membuat agen pertama Anda.

Helper Bot memungkinkan Anda

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

Saat diaktifkan, Helper Bot akan mengirim dan menerima pesan untuk agen Anda; tidak diperlukan 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 segera 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, lalu klik Launch. 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 memerlukan aplikasi Google Maps.)

Nonaktifkan Helper Bot

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

Untuk menonaktifkan Helper Bot,

  1. Buka Konsol Developer Komunikasi Bisnis.
  2. Pilih agen Anda.
  3. Di navigasi kiri, klik Integrations.
  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.

{i>Echo Bot<i} adalah aplikasi contoh yang menggemakan pesan kembali kepada pengguna. Anda dapat bereksperimen dengan fitur lengkap, seperti tindakan yang disarankan dan kartu informasi, dalam percakapan dengan agen Anda. Gunakan Echo Bot sebagai titik awal untuk mengembangkan agen.

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 untuk 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 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 Project Selector di Konsol Google Cloud.

    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 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 ada beberapa fitur yang terbatas. Lihat Manfaat resource organisasi untuk mengetahui 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 Membuat akun layanan ke dalam folder resource contoh 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, arahkan ke direktori {i>full_sample<i} 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 bagian 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 bagian 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 bagian Membuat lingkungan Cloud. Project ID tercantum pada dasbor project di Google Cloud.

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

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

Tetapkan webhook Anda

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

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

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

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

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

  5. Di Konsol Play, klik Verifikasi.

    Saat Business Messages memverifikasi webhook Anda, dialog akan ditutup.

Untuk mengonfigurasi webhook Anda 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 Anda.

  1. Buka Konsol Developer Komunikasi Bisnis.
  2. Di navigasi sebelah kiri, klik Informasi agen.

  3. Perbarui nilainya 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 Save.

Mulai percakapan

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

  1. Buka Konsol Developer Komunikasi Bisnis.
  2. Di navigasi sebelah kiri, klik Informasi agen.
  3. Di bagian 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 mengirimkan URL ke alamat email Anda.

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

Anda menerima pesan selamat datang dari agen. Pada titik ini, Anda dapat berinteraksi dengan Echo Bot. Ia akan mengirimkan kembali pesan yang Anda kirim kepada Anda. Selain itu, Anda dapat memanggil fitur lengkap dengan mengirimkan string tertentu: “carousel”, “card”, “chip”.

Langkah berikutnya

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