Використовуючи спеціальну функцію, розроблену командою 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_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](/docs/chatbot-ai-assistant#data-transfer-format)
Після тестування та налагодження бота запишіть команду в налаштуваннях бота "start_block_from_ai 31241050".
Цей підхід дозволяє вам створити будь-який тип інтернет-магазину та використовувати будь-які значення даних, що зберігаються у вашій таблиці.
Єдиним справжнім обмеженням є ваша уява.