Завдяки функції, розробленій командою Mavibot, AI-чатбот точно інтерпретує значення, введені в таблицю, а потім зберігає їх у системну змінну в налаштуваннях проєкту.
Наприклад, це може знадобитися для AI-асистента, який консультуватиме ваших клієнтів щодо наявного асортименту товарів у вашому інтернет-магазині, а також для реклами ваших можливостей за допомогою розумного бота.
Як саме використовувати бота для читання Google-таблиці, вирішувати вам, а ми, у свою чергу, покажемо, як створити таблицю та налаштувати бота для роботи з нею.
Підготовка Google-таблиці
Створення та заповнення
Відкрийте редактор таблиць:

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

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

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

Одиниця виміру може включати:
- Кількісний показник у вигляді штук/одиниць (одна одиниця товару, дві одиниці товару, одна штука тощо):

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

Бот чудово зрозуміє, що ви мали на увазі, і використає значення, вбудовані в слоти.
Останнім кроком у заповненні 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-асистента
У налаштуваннях бота пишемо наступні дані:
- Позиція та інструкції для бота.
Приклад:
<Ви продавець магазину "Всі дрібниці.
Ваше завдання - запитати клієнта, який товар він хоче вибрати, скільки одиниць товару, а потім розрахувати загальну вартість товару, яка дорівнює одній одиниці товару, помноженій на вартість.
Після того, як ви опитали клієнта про його покупку, продублюйте замовлення для нього і запитайте "Чи правильне замовлення?">.
Зверніть увагу на рядок "Розрахувати загальну вартість товару, яка дорівнює одиниці товару, помноженій на вартість" - цей рядок відображатиме кінцевий результат вартості всіх вибраних клієнтом категорій:
Приклад:
Клієнт вибрав три кг одного товару. Бот, у свою чергу, розраховує загальну вартість:

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

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

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

Знання бота:

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

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

- Якщо потрібно, щоб кожен вибраний клієнтом товар відображався окремо, додайте другий рядок:
"Якщо клієнт вибрав кілька товарів, то додайте перший товар з ключем product1, другий товар з ключем product2, третій товар з ключем product3 і так далі".
На цьому налаштування AI-асистента завершено.
Інші параметри можна встановити на ваш розсуд:

Тестування бота
Використовуйте конструктор умов, щоб додати роботу бота в тестовому вікні:
Крок 1. Натисніть на конструктор умов

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

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

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

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

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

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

Бот розрахував вартість вибраних позицій і обчислив загальну вартість.
- Надсилання даних у систему:

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

Після цього дані, згенеровані ботом у діалозі з клієнтом, були надіслані в картку клієнта:
Бот все відпрацював правильно.
Таким чином ви можете створити інтернет-магазин будь-якого типу та використовувати будь-які необхідні значення всередині таблиці.
Головне обмеження - це лише ваша уява!


