Завдяки функції, розробленій командою 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) — функція, призначена для читання даних з таблиці.
| параметри | опис |
|---|---|
| **!** sheet_id | id google-таблиці |
| number_sheet | Номер аркуша в таблиці; за замовчуванням = 1 |
| sheet_json_keys | Необов'язковий параметр, ключ доступу до даних таблиці |
Відкрийте калькулятор і введіть ID таблиці, помістивши його в змінну (наприклад, sheet):

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

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

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

Блок передачі даних
Далі створіть другий блок «Статус».
Цей блок «Статус» знадобиться для передачі змінних у картку клієнта.
Ви також можете надіслати фінальне повідомлення від бота в цьому блоці, наприклад, «Дякую за замовлення! Надсилаю дані менеджеру з комунікацій!»:

Далі скопіюйте ID блоку — він знадобиться для налаштування AI-асистента в команді «start_block_from_ai 49018», де замість 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-таблицю, взявши значення зі змінної, що міститься в налаштуваннях проєкту.
- Далі виберемо товар і поговоримо з розумним ботом:

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

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