Використовуючи спеціальну функцію, розроблену командою MaviBot, ваш AI-чатбот може інтелектуально зчитувати значення з Google Таблиці та зберігати їх у системній змінній у налаштуваннях вашого проєкту. Це створює синхронізоване динамічне джерело даних для вашого асистента.
Практичне застосування
Ця можливість є важливою для таких сценаріїв:
- Асистент каталогу товарів: 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 блоку з фінальним повідомленням: блок Чат передає дані в картку клієнта:
Знання бота
У полі "Знання бота" передайте змінну, яка раніше була кешована як блок з тригером.
Знання бота.
Таким чином, бот буде брати інформацію зі змінної в налаштуваннях проєкту та консультувати ваших клієнтів щодо доступного асортименту товарів.
Формат даних
У форматі переданих даних ви вказуєте дані, які збираєте самостійно (наприклад, товар), потім вводите фразу з "ключем" і присвоюєте значення ключу.
ім'я клієнта з ключем client_name, номер телефону клієнта з ключем phone_number, місто та адреса з ключем city_address, обраний товар з ключем product, кількість товару з ключем quantity, загальна сума замовлення з ключем total_amount.
Таким чином, при виклику блоку в картку клієнта будуть передані змінні: потім ви можете працювати зі змінними, наприклад, у конструкторі чатботів:
На цьому етапі налаштування AI-асистента завершено.
Інші параметри можна встановити на ваш розсуд:
Тестування бота
"Якщо у вас вже запущені боти, вкажіть в умові запуску AI-асистента запускатися лише в тестовому вікні."
Крок 1. Натисніть на конструктор тригерів
Крок 2. Виберіть вкладку з тестовим вікном і натисніть "Додати тригер":
Тепер в умові тригера ви побачите наступне значення:
Таким чином, бот буде запускатися лише в тестовому вікні і ніде більше.
Після налагодження бота видаліть цю умову.
Це повідомлення надсилається в тестовому режимі через команду "Block call 3124105
Після тестування та налагодження бота запишіть у налаштуваннях бота команду "start_block_from_ai 31241050".
Цей підхід дозволяє вам створити будь-який тип інтернет-магазину та використовувати будь-які значення даних, що зберігаються у вашій таблиці.
Єдиним справжнім обмеженням є ваша уява.