AI-асистент із таблицями MaviBot
Використовуючи спеціальну функцію, розроблену командою MaviBot, ваш AI-чатбот може інтелектуально зчитувати значення з Google Sheet і зберігати їх у системну змінну в налаштуваннях вашого проєкту. Це створює синхронізоване, динамічне джерело даних для вашого асистента.
Практичне застосування
Ця можливість є важливою для таких сценаріїв, як:
Асистент каталогу товарів: AI, який консультує клієнтів щодо вашого поточного асортименту товарів, цін і наявності в режимі реального часу.
Розумний бот для промоакцій: бот, який просуває ваші пропозиції динамічно підсвічуючи функції, характеристики або акції, взяті безпосередньо з вашої таблиці.
Як підготувати вашу таблицю до інтеграції
Щоб почати, перейдіть до розділу таблиць:
Далі ви побачите кнопку "Додати таблицю", яка відкриває модальне вікно, де потрібно ввести назву таблиці:
Введіть назву таблиці та натисніть кнопку "Готово". Потім у проєкті буде створено нову таблицю, і вона з’явиться в розділі "Таблиці":
Налаштування таблиці
Після створення таблиці потрібно додати рядки та стовпці. Для цього знайдіть кнопку "Перейти до" на картці потрібної таблиці та натисніть її.
Далі ви бачите такі налаштування:
Щоб додати стовпець із назвою, натисніть кнопку "+":
Коли ви натиснете кнопку, відкриється модальне вікно, де можна ввести назву для нового стовпця.
Після введення назви стовпця натисніть кнопку "Готово", після чого новий стовпець буде додано до таблиці. Додайте потрібну кількість стовпців, а потім рядків.
Тепер ваша таблиця виглядає так.
Скопіюйте (запам’ятайте) ID таблиці: для цього натисніть на адресний рядок:
Далі перейдемо до налаштування блоків у конструкторі.
Робота в конструкторі чатбота
Функція get_records_from_table()
Щоб використовувати функцію get_info_from_table(), вам потрібен один блок у конструкторі чатбота.
Перейдіть до відповідної вкладки в Mavibot і створіть блок із тригером (стартовий блок або блок-тригер):
Визначте змінну (вона буде використовуватися для знань AI-асистента): у цьому прикладі змінна — 'record'.
Приклад коду з калькулятора
project.record = get_records_from_table(1)
project. - це конструктор для встановлення змінної в конфігурації проєкту;record - назва змінної;get_records_from_table(1) - функція, де параметр передається як ID таблиці.
Детальніше про функцію get_record_from_table()
get_records_from_table(table_id, start_row, count, start_col, end_col) – для отримання записів із таблиці
! table_id
ID таблиці (обов’язковий параметр)
start_row
необов’язковий параметр, ціле число. Визначає початковий рядок діапазону
приймає номер рядка, з якого почати читання значень таблиці, включно. Має бути вказано без лапок
count
необов’язковий параметр, ціле число. Визначає кількість рядків для отримання
значення за замовчуванням: 1000. Максимум: 5000. Має бути вказано без лапок
start_col
необов’язковий параметр, рядок. Визначає початковий стовпець діапазону
приймає назву стовпця, з якого почати читання значень таблиці, включно. Має бути вказано в лапках
end_col
необов’язковий параметр, рядок. Визначає кінцевий стовпець діапазону
приймає назву стовпця, до якого читати значення таблиці, включно. Має бути вказано в лапках
Щоб прочитати всі дані з певної точки: Вкажіть лише початок діапазону. Щоб прочитати всі дані до певної точки: Вкажіть лише кінець діапазону.
Замість #{none} ми запишемо нашу змінну в повідомленні за допомогою конструкції #{} , щоб візуально побачити, які дані були записані у змінну проєкту.
Увага
Змінна, вставлена в повідомлення, потрібна, щоб перевірити, чи бот правильно зчитує функцію. Коли ви запускаєте блок у тестовому режимі, бот покаже значення, які будуть призначені змінній.
Зверніть увагу
Після налаштування виклику блоку в тестовому режимі та збереження змінної в налаштуваннях проєкту не видаляйте цей блок.
Він може знадобитися: наприклад, якщо ви додали ще якісь значення до таблиці, просто запустіть блок у тестовому режимі. Тоді дані в змінній проєкту буде оновлено.
Ім’я змінної може бути будь-яким, яке вам подобається.
Блок передачі даних
Далі ми створимо блок "Чат" для передачі даних на картку клієнта.
"Цей блок також може передавати завершальне повідомлення від бота, наприклад: 'Я передаю інформацію менеджеру! Менеджер зв’яжеться протягом 10 хвилин.'"
Далі скопіюйте ID блоку. Він знадобиться вам для налаштування AI-асистента в команді "start_block_from_ai 11956" і тестовій команді "Block call 11956", де замість ID блоку з прикладу потрібно вставити ваш ID блоку.
Зверніть увагу
Після тестування замініть "Block call 31241050" на команду "start_block_from_ai 31241050".
Команда "Block call 31241050" є налагоджувальною і допомагає зрозуміти, які дані бот записує (див. розділ "Тестування").
Щоб запустити бота для клієнтів, вкажіть команду "start_block_from_ai 31241050".
Читання таблиці
Перейдіть до тестового режиму бота .
Запустіть блок, який містить тригер для читання даних таблиці.
Блок спрацював коректно. Ви можете переконатися в цьому за значеннями, які тепер збережені у відповідній змінній у налаштуваннях вашого проєкту.
Щоб перевірити вручну:
Перейдіть на вкладку Налаштування проєкту розділ.
Знайдіть змінну, щоб переглянути її поточні дані.
На вкладці "Змінні" в налаштуваннях проєкту ви побачите вашу змінну зі значеннями, доданими до неї з таблиці. Отже, тепер у вашому проєкті є змінна з товарами, вартістю та всім, що ви вказали в таблиці.
Робота в AI-асистенті
Перейдіть до розділу "AI-асистент" і запустіть чатбот із налаштуваннями AI.
Вам потрібно вибрати роль "Асистент з продажів":
Також ми встановимо додаткові налаштування:
Налаштування AI-асистента
У налаштуваннях бота запишіть такі дані:
Посада та інструкції для бота.
Команда для виклику блоку та передачі змінних у систему записується так:
"Якщо все правильно, виконайте команду "start_block_from_ai 11956", де замість N записано ID блоку з фінальним повідомленням: блок Chat передає дані на картку клієнта:
Знання бота
У полі "Знання бота" передайте змінну, яка раніше була кешована як блок із тригером.
Знання бота.
Таким чином, бот братиме інформацію зі змінної в налаштуваннях проєкту та консультуватиме ваших клієнтів щодо доступного асортименту товарів.
Формат даних
У форматі переданих даних ви самостійно вказуєте дані, які збираєте (наприклад, товар), потім вводите фразу з "ключем" і призначаєте значення цьому ключу.
ім’я клієнта з ключем client_name, номер телефону клієнта з ключем phone_number, місто та адресу з ключем city_address, обраний товар з ключем product, кількість товару з ключем quantity, загальну суму замовлення з ключем total_amount.
Таким чином, під час виклику блоку змінні будуть передані на картку клієнта: далі ви можете працювати зі змінними, наприклад, у конструкторі чатбота:
На цьому етапі налаштування AI-асистента завершено.
Інші параметри можна налаштувати на власний розсуд:
Тестування бота
"Якщо у вас уже запущені боти, вкажіть у умові запуску AI-асистента, щоб запуск відбувався лише у вікні тестування."
Крок 1. Натисніть на конструктор тригерів
Крок 2. Виберіть вкладку з тестовим вікном і натисніть "Додати тригер":
Тепер у умові тригера ви побачите таке значення:
Таким чином, бот запускатиметься лише у тестовому вікні й більше ніде.
Після налагодження бота видаліть цю умову.
Це повідомлення надсилається в tестовому режимі через команду "Block call 3124105
Після тестування та налагодження бота запишіть у налаштуваннях бота команду "start_block_from_ai 31241050".
Цей підхід дає вам змогу створювати будь-який тип інтернет-магазину та використовувати будь-які значення даних збережені у вашій таблиці.
Єдине справжнє обмеження — це ваша уява.
Last updated