Завдяки функції, розробленій командою Mavibot, AI-чатбот точно інтерпретує значення, введені в таблицю, а потім зберігає їх у системну змінну в налаштуваннях проєкту.

Наприклад, це може знадобитися для AI-асистента, який консультуватиме ваших клієнтів щодо наявного асортименту товарів у вашому інтернет-магазині, а також для реклами ваших можливостей за допомогою розумного бота.

Як саме використовувати бота для читання Google-таблиці, вирішувати вам, а ми, у свою чергу, покажемо, як створити таблицю та налаштувати бота для роботи з нею.

Підготовка Google-таблиці

Створення та заповнення

Відкрийте редактор таблиць:

Необхідно заповнити рядки категоріями стовпців:

Оскільки AI може читати дані, він використовуватиме функцію для запису значень з таблиці у змінну в налаштуваннях проєкту, тому ми рекомендуємо додавати лаконічні та зрозумілі назви категорій стовпців для вашої зручності та розуміння логіки бота.

Далі вкажіть необхідні назви в стовпцях:

Розглянемо категорію стовпця "Одиниця виміру":

Одиниця виміру може включати:

  1. Кількісний показник у вигляді штук/одиниць (одна одиниця товару, дві одиниці товару, одна штука тощо):

  1. Одиниці виміру величин: літри, кілограми, грами, метри:

Бот чудово зрозуміє, що ви мали на увазі, і використає значення, вбудовані в слоти.

Останнім кроком у заповненні Google-таблиці буде введення ціни за одиницю виміру.

На цьому етапі Google-таблиця готова.

Налаштування доступу

Щоб AI-бот міг брати значення з таблиці, потрібно відкрити налаштування доступу:

Натисніть на налаштування, і відкриється наступне вікно:

Тут потрібно змінити налаштування з "Доступ обмежено" на "Усі, хто має посилання":

ID таблиці

Для роботи з функцією get_info_from_table(!sheet_id, number_sheet, sheet_json_keys) нам знадобиться ID таблиці, оскільки функція приймає sheet_id як обов'язковий параметр.

Щоб отримати ID, просто натисніть на адресний рядок:

Ви побачите рядок з адресою сторінки:

З якого нам знадобиться набір символів і літер, який і є ID таблиці:

На цьому робота з таблицею та її налаштування завершена.

Робота в конструкторі воронок

Використання функції get_info_from_table()

Щоб використовувати функцію get_info_from_table(), вам знадобиться один блок у конструкторі воронок.

Перейдіть на відповідну вкладку в Mavibot і створіть блок перевірки первинної умови:

Замість #{none} ми напишемо в повідомленні сповіщення для тестового режиму після запуску цього блоку та вбудовану змінну через конструкцію #{}:

Зверніть увагу!

Змінна, вбудована в повідомлення, необхідна для перевірки того, що бот читає функцію.

Під час запуску блоку в тестовому режимі бот покаже значення, які будуть вкладені у змінну.

Зверніть увагу!

Після налаштування виклику блоку в тестовому режимі та збереження змінної в налаштуваннях проєкту не видаляйте цей блок.

Він може вам знадобитися: наприклад, якщо ви додали будь-які додаткові значення в таблицю, просто запустіть блок у тестовому режимі. Тоді дані в змінній проєкту будуть оновлені.

Ім'я змінної може бути будь-яким, яке вам підходить.

Далі нам знадобиться функція get_info_from_table(sheet_id, number_sheet, sheet_json_keys) - функція, призначена для читання даних з таблиці.

Відкрийте калькулятор і введіть ID таблиці, помістивши його в змінну (наприклад, sheet):

Далі призначте змінну, вказану в повідомленні блоку, і надайте їй значення у вигляді функції get_info_from_table() з необхідним параметром sheet_id (замість якого вставте змінну sheet, де знаходиться ID таблиці):

Увага! Перед змінною product_pay_info в калькуляторі напишіть project. Це необхідно для того, щоб ЗМІННА та ЗНАЧЕННЯ з таблиці були внесені в налаштування проєкту (кешовані):

Тепер напишіть будь-яке слово/цифри в умові блоку:

Блок передачі даних

Далі створіть другий блок "Статус":

Цей блок "Статус" знадобиться для передачі змінних у картку клієнта.

Ви також можете надіслати фінальне повідомлення від бота в цьому блоці, наприклад, "Дякую за замовлення! Надсилаю дані менеджеру з комунікацій!":

Далі скопіюйте ID блоку - він знадобиться для налаштування AI-асистента в команді "start_block_from_ai 31241050", де замість ID з прикладу потрібно вставити ID вашого блоку.

Читання таблиці

Тепер запустіть блок у тестовій версії, щоб чатбот прочитав значення з таблиці та помістив їх у вашу змінну в налаштуваннях проєкту:

Таким чином, блок спрацював правильно: ви бачите значення, які були прочитані та які знаходяться у змінній в налаштуваннях проєкту.

Ви можете переконатися в цьому, перейшовши до відповідного розділу:

Далі ви побачите вашу змінну зі значеннями, вбудованими в неї з таблиці:

Отже, тепер усередині вашого проєкту є змінна з товарами, вартістю та всім, що ви вказали в таблиці.

Робота AI-асистента

Перейдіть до розділу "AI-асистент" і почніть налаштування штучного інтелекту.

Роль асистента: продавець

Також встановимо опції "Кнопки" та "Покрокове введення даних":

Кнопки знадобляться для візуально оформлених відповідей бота, а також для зручності клієнта (тоді вашому користувачеві не потрібно буде вручну вводити слова в діалозі); покрокове введення даних - для того, щоб бот опитував замовлення, що формується.

Налаштування AI-асистента

У налаштуваннях бота пишемо наступні дані:

  1. Позиція та інструкції для бота.

Приклад:

<Ви продавець магазину "Всі дрібниці.
Ваше завдання - запитати клієнта, який товар він хоче вибрати, скільки одиниць товару, а потім розрахувати загальну вартість товару, яка дорівнює одній одиниці товару, помноженій на вартість.

Після того, як ви опитали клієнта про його покупку, продублюйте замовлення для нього і запитайте "Чи правильне замовлення?">.

Зверніть увагу на рядок "Розрахувати загальну вартість товару, яка дорівнює одиниці товару, помноженій на вартість" - цей рядок відображатиме кінцевий результат вартості всіх вибраних клієнтом категорій:

Приклад:

Клієнт вибрав три кг одного товару. Бот, у свою чергу, розраховує загальну вартість:

  1. Команда для виклику блоку та передачі змінних у систему записується наступним чином:

<Якщо клієнт написав "Замовлення правильне" або "Правильно", то напишіть "start_block_from_ai N">, де замість N вказується ID блоку з фінальним повідомленням: блок "Статус" передає дані в картку клієнта:

Команди в налаштуваннях AI-асистента виглядають так:

Знання бота

У полі "Знання бота" передайте змінну, яка раніше була кешована блоком перевірки первинної умови:

Знання бота:

Таким чином, бот братиме інформацію зі змінної в налаштуваннях проєкту та консультуватиме ваших клієнтів щодо наявного асортименту товарів.

Формат даних

У форматі переданих даних ви вказуєте дані, які збираєте самостійно (наприклад, товар), потім вводите фразу з "ключем" і призначаєте значення ключу:

Пояснення

Рядок 1: "Формат переданих даних: товар з ключем product, одиниця виміру з ключем thing, ціна з ключем count, загальна вартість усіх вибраних товарів з ключем result" - дає зрозуміти боту, які дані та з яким значенням потрібно передавати в систему.

Ці змінні будуть відображатися в картці клієнта:

  1. Якщо потрібно, щоб кожен вибраний клієнтом товар відображався окремо, додайте другий рядок:

"Якщо клієнт вибрав кілька товарів, то додайте перший товар з ключем product1, другий товар з ключем product2, третій товар з ключем product3 і так далі".

На цьому налаштування AI-асистента завершено.

Інші параметри можна встановити на ваш розсуд:

Тестування бота

Використовуйте конструктор умов, щоб додати роботу бота в тестовому вікні:

Крок 1. Натисніть на конструктор умов

Крок 2. Виберіть вкладку з текстовим полем і натисніть "Додати":

Тепер в умові запуску ви бачите наступне значення:

Таким чином, бот запускатиметься лише в тестовому вікні і більше ніде.

Після налагодження бота видаліть цю умову.

Тепер протестуємо бота:

  1. Поставимо боту контрольне запитання про асортимент товарів:

Бот показав різноманітність товарів, які були введені в Google-таблицю, захопивши значення зі змінної, що міститься в налаштуваннях проєкту.

  1. Далі виберемо товар і поговоримо з розумним ботом:

  1. Виберемо інший товар:

Бот також правильно відображає, показуючи клієнту категорії товарів для подальшого вибору.

  1. Клієнт вибрав кілька товарів і вказав їх кількість:

Бот розрахував вартість вибраних позицій і обчислив загальну вартість.

  1. Надсилання даних у систему:

Результат: після того, як бот продублював замовлення і клієнт відповів, що замовлення правильне, чатбот на основі налаштувань викликав блок "Статус діалогу":

Після цього дані, згенеровані ботом у діалозі з клієнтом, були надіслані в картку клієнта:

Бот все відпрацював правильно.

Таким чином ви можете створити інтернет-магазин будь-якого типу та використовувати будь-які необхідні значення всередині таблиці.

Головне обмеження - це лише ваша уява!

Відео-посібник

https://youtu.be/LTEmRgbRp8M