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 Business Messages Helper Bot
  • 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 Buat.

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. Simpan di tempat yang aman lokasi HTTP/HTTPS. Anda akan membutuhkan kunci ini nanti untuk men-deploy aplikasi web dan untuk mengakses Business Messages dan Business Communications API pada masa mendatang.

Menciptakan brand dan agen

Agen adalah representasi percakapan dari suatu brand—entity percakapan yang berinteraksi dengan pengguna. Anda menciptakan sebuah {i>brand<i} (merek) untuk mewakili bisnis dan membuat agen sehingga konsumen dapat terhubung dengannya melalui percakapan.

  1. Buka Business Communications Developer Konsol dan 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 langkah berikut:
    • Untuk berdiskusi dengan agen guna menjelajahi fitur yang tersedia, pilih Aktifkan Helper Bot Business Messages.
    • Guna menyesuaikan agen 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 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 sehingga Anda dapat merasakan apa yang ditawarkan platform tersebut. Mengaktifkan Bantuan 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

Jika diaktifkan, Helper Bot akan mengirim dan menerima pesan untuk agen Anda; webhook. Anda perlu menonaktifkan Helper Bot sebelum Anda 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. Lalu pindai kode QR dengan perangkat seluler yang sesuai, lalu klik Launch. Atau, klik Salin URL Android atau Salin URL iOS untuk menyalinnya URL pengujian agen.
    • Klik Kirim untuk mengirim URL ke alamat email Anda.

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

Nonaktifkan 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 Konsol Google Cloud.
  2. Pilih agen Anda.
  3. Di navigasi kiri, klik Integrations.
  4. Untuk Helper Bot, klik Nonaktifkan.

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

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. Ini memungkinkan Anda bereksperimen dengan beragam fitur, seperti saran tindakan dan kartu informasi, dalam percakapan dengan agen Anda. Anda juga dapat menggunakan {i>Echo Bot<i} sebagai permulaan 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 dalam infrastruktur Anda. Dalam panduan ini, Anda akan men-deploy sampel Echo Bot ke webhook yang telah dikonfigurasi sebelumnya. Jika Anda sudah memiliki infrastruktur web untuk digunakan untuk menerima pesan, Anda dapat membuat webhook baru di web tersebut layanan, tetapi Anda harus mengkonfigurasi logikanya 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 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 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 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 Buat akun layanan ke dalam folder resource contoh dan ganti nama kredensialnya 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 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. 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 ) untuk memulai 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: &quot;https://PROJECT_ID.appspot.com/callback&quot;.

    Endpoint ini telah ditentukan sebelumnya dalam logika aplikasi dari contoh yang Anda di-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: 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 Konsol Google Cloud.
  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 Simpan.

Mulai percakapan

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

  1. Buka Business Communications Developer Konsol Google Cloud.
  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 Google Maps.)

Anda menerima pesan selamat datang dari agen. Pada tahap 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 Anda, pelajari Business Messages lebih lanjut dan hal apa lagi yang dapat Anda lakukan di platform ini.