Menggunakan fungsi khusus yang dibangunkan oleh pasukan MaviBot, chatbot AI anda boleh membaca nilai dari Google Sheet secara pintar dan menyimpannya dalam pembolehubah sistem dalam tetapan projek anda. Ini mewujudkan sumber data yang diselaraskan dan dinamik untuk pembantu anda.
Aplikasi praktikal
Keupayaan ini penting untuk senario seperti:
- Pembantu katalog produk: AI yang menasihati pelanggan tentang julat produk semasa, harga, dan ketersediaan anda secara masa nyata.
- Bot promosi pintar: bot yang mempromosikan tawaran anda dengan menyerlahkan ciri, spesifikasi, atau tawaran secara dinamik yang diambil terus dari helaian anda.
Cara menyediakan jadual anda untuk integrasi
Untuk memulakan, pergi ke bahagian helaian:

Seterusnya, anda akan melihat butang "Tambah helaian", yang membuka tetingkap modal di mana anda perlu memasukkan nama helaian:

Masukkan nama untuk helaian dan klik pada butang "Selesai". Kemudian helaian baru akan dibuat dalam projek dan akan muncul di bahagian "Helaian":

Tetapan helaian
Selepas membuat helaian, anda perlu menambah baris dan lajur. Untuk melakukan ini, cari butang "Pergi ke" pada kad helaian yang dikehendaki dan klik padanya.
Anda melihat tetapan seterusnya:

Untuk menambah lajur dengan nama, klik butang "+":

Apabila anda mengklik butang, tetingkap modal akan dibuka di mana anda boleh memasukkan nama untuk lajur baru.
Selepas memasukkan nama lajur, klik pada butang "Selesai", kemudian lajur baru akan ditambahkan ke helaian. Tambah bilangan lajur yang diperlukan dan kemudian baris.

Sekarang, helaian anda kelihatan seperti ini.

Salin (ingat) ID helaian: untuk melakukan ini, klik pada bar alamat:

Seterusnya, mari pergi ke mengkonfigurasi blok dalam pembina.
Bekerja dalam Pembina Chatbot
Fungsi get_records_from_table()
Untuk menggunakan fungsi get_info_from_table(), anda memerlukan satu blok dalam pembina chatbot.
Pergi ke tab yang sesuai di Mavibot dan buat blok dengan pencetus (Blok Mula atau Blok Pencetus):

Tentukan pembolehubah (ia akan digunakan untuk pengetahuan pembantu AI): dalam contoh ini, pembolehubah adalah 'record'.
Contoh kod dari Kalkulator
project.****record``=``get_records_from_table(1)
project. - adalah pembina untuk menetapkan pembolehubah dalam konfigurasi projek;record - nama pembolehubah;-
get_records_from_table(1) - fungsi, di mana parameter dihantar sebagai ID jadual.
get_records_from_table(table_id, start_row, count, start_col, end_col) – untuk mendapatkan rekod dari jadual
| Parameter | Penerangan | Nota |
|---|---|---|
| ! table_id | ID jadual (parameter wajib) | |
| start_row | parameter pilihan, integer. Menentukan baris permulaan julat | menerima nombor baris dari mana untuk mula membaca nilai jadual, termasuk. Mesti dinyatakan tanpa tanda petik |
| count | parameter pilihan, integer. Menentukan bilangan baris untuk diambil | nilai lalai: 1000. Maksimum: 5000. Mesti dinyatakan tanpa tanda petik |
| start_col | parameter pilihan, string. Menentukan lajur permulaan julat | menerima nama lajur dari mana untuk mula membaca nilai jadual, termasuk. Mesti dinyatakan dalam tanda petik |
| end_col | parameter pilihan, string. Menentukan lajur akhir julat | menerima nama lajur sehingga mana untuk membaca nilai jadual, termasuk. Mesti dinyatakan dalam tanda petik |
Untuk membaca semua data dari titik tertentu: Nyatakan hanya permulaan julat. Untuk membaca semua data sehingga titik tertentu: Nyatakan hanya akhir julat.
Daripada #{none}, kami akan menulis pembolehubah kami dalam mesej menggunakan binaan #{} untuk melihat secara visual data apa yang telah ditulis ke dalam pembolehubah projek.

Perhatian
Pembolehubah yang tertanam dalam mesej diperlukan untuk memeriksa sama ada bot membaca fungsi dengan betul. Apabila anda menjalankan blok dalam mod ujian, bot akan memaparkan nilai yang akan diberikan kepada pembolehubah.
Sila ambil perhatian
Selepas mengkonfigurasi panggilan blok dalam mod ujian dan menyimpan pembolehubah dalam tetapan projek, jangan padamkan blok ini.
Anda mungkin memerlukannya: sebagai contoh, jika anda telah menambah sebarang nilai lagi ke jadual, hanya lancarkan blok dalam mod ujian. Kemudian data dalam pembolehubah projek akan dikemas kini.
Nama pembolehubah boleh menjadi apa-apa nama yang anda suka.
Blok pemindahan data
Seterusnya, kami akan mencipta blok "Sembang" untuk memindahkan data ke kad pelanggan.

"Blok ini juga boleh menghantar mesej penutup dari bot, seperti: 'Saya menghantar maklumat kepada pengurus! Pengurus akan berhubung dalam masa 10 minit.'"
Seterusnya, salin ID blok. Anda akan memerlukannya untuk mengkonfigurasi pembantu AI dalam arahan "start_block_from_ai 11956" dan arahan ujian "Panggilan blok 11956", di mana daripada ID blok dari contoh, anda perlu memasukkan ID blok anda.
Sila ambil perhatian
Selepas ujian, gantikan "Panggilan blok 31241050" dengan arahan "start_block_from_ai 31241050".
Arahan "Panggilan blok 31241050" adalah penyahpepijatan dan membantu memahami data apa yang direkodkan oleh bot (lihat bahagian "Pengujian").
Untuk melancarkan bot untuk pelanggan, nyatakan arahan "start_block_from_ai 31241050".
Membaca jadual
- Navigasi ke mod pengujian bot.
- Lancarkan blok yang mengandungi pencetus untuk membaca data jadual.

Blok telah berfungsi dengan betul. Anda boleh melihat ini disahkan oleh nilai yang kini disimpan dalam pembolehubah yang sepadan dalam tetapan projek anda.
Untuk mengesahkan secara manual:
- Pergi ke bahagian Tetapan projek.
- Cari pembolehubah untuk melihat data semasanya.

Dalam tab "Pembolehubah" dalam tetapan projek, anda akan melihat pembolehubah anda dengan nilai yang ditambahkan di dalamnya dari jadual. Jadi sekarang, di dalam projek anda, terdapat pembolehubah dengan barang, kos, dan semua yang anda nyatakan dalam jadual.
Bekerja dalam pembantu AI
Pergi ke bahagian "Pembantu AI" dan mulakan chatbot dengan tetapan AI.
Anda perlu memilih peranan "Pembantu jualan":

Kami juga akan menetapkan tetapan tambahan:

Tetapan pembantu AI
Dalam tetapan bot tulis data berikut:
- Kedudukan dan arahan untuk bot.

- Arahan untuk memanggil blok dan memindahkan pembolehubah ke sistem ditulis seperti berikut:
"Jika semuanya betul, laksanakan arahan "start_block_from_ai 11956", di mana daripada N ID blok ditulis dengan mesej akhir: blok Sembang menghantar data ke kad pelanggan:

Pengetahuan bot
Dalam medan "Pengetahuan Bot", hantar pembolehubah yang sebelumnya dicache sebagai blok dengan pencetus.

Pengetahuan bot.

Dengan cara ini, bot akan mengambil maklumat dari pembolehubah dalam tetapan projek dan menasihati pelanggan anda tentang julat produk yang tersedia.
Format data
Dalam format data yang dihantar, anda nyatakan data yang anda kumpulkan sendiri (contohnya, produk), kemudian masukkan frasa dengan "kunci" dan berikan nilai kepada kunci.
nama pelanggan dengan kunci client_name, nombor telefon pelanggan dengan kunci phone_number, bandar dan alamat dengan kunci city_address, produk yang dipilih dengan kunci product, kuantiti produk dengan kunci quantity, jumlah pesanan keseluruhan dengan kunci total_amount.

Dengan cara ini, apabila memanggil blok, pembolehubah akan dihantar ke kad pelanggan: kemudian anda boleh bekerja dengan pembolehubah, sebagai contoh, dalam pembina chatbot:

Pada peringkat ini, persediaan pembantu AI selesai.
Parameter yang tinggal boleh ditetapkan mengikut budi bicara anda:

Menguji bot
"Jika anda sudah mempunyai bot yang berjalan, nyatakan dalam syarat pelancaran pembantu AI untuk bermula hanya dalam tetingkap ujian."
Langkah 1. Klik pada pembina pencetus

Langkah 2. Pilih tab dengan tetingkap ujian dan klik "Tambah pencetus":

Sekarang, dalam syarat pencetus, anda akan melihat nilai berikut:

Dengan cara ini, bot akan berjalan hanya dalam tetingkap ujian dan tidak di tempat lain.
Selepas menyahpepijat bot, keluarkan syarat ini.



Mesej ini dihantar dalam mod ujian disebabkan oleh arahan "Panggilan blok 3124105"

Selepas menguji dan menyahpepijat bot, tulis arahan dalam tetapan bot "start_block_from_ai 31241050".
Pendekatan ini membolehkan anda membina apa-apa jenis kedai dalam talian dan memanfaatkan sebarang nilai data yang disimpan dalam jadual anda.
Satu-satunya had sebenar adalah imaginasi anda.


