Используя специальную функцию, разработанную командой MaviBot, ваш ИИ-чатбот может интеллектуально считывать значения из Google Sheets и сохранять их в системную переменную в настройках вашего проекта. Это создает синхронизированный, динамический источник данных для вашего ассистента.
Практическое применение
Эта возможность необходима для таких сценариев, как:
- Ассистент каталога товаров: ИИ, который консультирует клиентов по вашему текущему ассортименту, ценам и наличию в реальном времени.
- Умный бот для продвижения: бот, который продвигает ваши предложения, динамически выделяя характеристики, спецификации или акции, полученные непосредственно из вашей таблицы.
Как подготовить таблицу к интеграции
Для начала перейдите в раздел таблиц:
Затем вы увидите кнопку «Добавить таблицу», при нажатии на которую открывается модальное окно, где необходимо ввести название таблицы:
Введите название таблицы и нажмите кнопку «Готово». После этого в проекте будет создана новая таблица, которая появится в разделе «Таблицы»:
Настройки таблицы
После создания таблицы необходимо добавить строки и столбцы. Для этого найдите кнопку «Перейти» на карточке нужной таблицы и нажмите на нее.
Вы увидите следующие настройки:
Чтобы добавить столбец с названием, нажмите кнопку «+»:
При нажатии на кнопку откроется модальное окно, в котором можно ввести название нового столбца.
После ввода названия столбца нажмите кнопку «Готово», и новый столбец будет добавлен в таблицу. Добавьте необходимое количество столбцов, а затем строк.
Теперь ваша таблица выглядит так.
Скопируйте (запомните) ID таблицы: для этого нажмите на адресную строку:
Далее перейдем к настройке блоков в конструкторе.
Работа в конструкторе чатбота
Функция get_records_from_table()
Для использования функции get_info_from_table() вам понадобится один блок в конструкторе чатбота.
Перейдите на соответствующую вкладку в Mavibot и создайте блок с триггером (Стартовый блок или Блок-триггер):
Определите переменную (она будет использоваться для знаний ИИ-ассистента): в этом примере переменная называется '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 блока. Он понадобится вам для настройки ИИ-ассистента в команде «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».
Чтение таблицы
- Перейдите в режим тестирования бота.
- Запустите блок, содержащий триггер для чтения данных таблицы.
Блок сработал корректно. Вы можете убедиться в этом по значениям, которые теперь хранятся в соответствующей переменной в настройках вашего проекта.
Для ручной проверки:
- Перейдите в раздел Настройки проекта.
- Найдите переменную, чтобы просмотреть ее текущие данные.
На вкладке «Переменные» в настройках проекта вы увидите вашу переменную со значениями, добавленными из таблицы. Теперь внутри вашего проекта есть переменная с товарами, стоимостью и всем, что вы указали в таблице.
Работа в ИИ-ассистенте
Перейдите в раздел «ИИ-ассистент» и начните настройку чатбота с ИИ.
Вам нужно выбрать роль «Ассистент по продажам»:
Также мы установим дополнительные настройки:
Настройки ИИ-ассистента
В настройках бота укажите следующие данные:
- Должность и инструкции для бота.
- Команда для вызова блока и передачи переменных в систему записывается следующим образом:
«Если все верно, выполните команду "start_block_from_ai 11956", где вместо N указывается ID блока с финальным сообщением: блок «Чат» передает данные в карточку клиента:
Знания бота
В поле «Знания бота» передайте переменную, которая была предварительно кэширована как блок с триггером.
Знания бота.
Таким образом, бот будет брать информацию из переменной в настройках проекта и консультировать ваших клиентов по доступному ассортименту.
Формат данных
В формате передаваемых данных вы сами указываете собираемые данные (например, товар), затем вводите фразу с «ключом» и присваиваете значение ключу.
имя клиента с ключом client_name, номер телефона клиента с ключом phone_number, город и адрес с ключом city_address, выбранный товар с ключом product, количество товара с ключом quantity, общая сумма заказа с ключом total_amount.
Таким образом, при вызове блока в карточку клиента будут переданы переменные: затем вы можете работать с переменными, например, в конструкторе чатбота:
На этом этапе настройка ИИ-ассистента завершена.
Остальные параметры можно настроить по своему усмотрению:
Тестирование бота
«Если у вас уже запущены боты, укажите в условии запуска ИИ-ассистента запуск только в окне тестирования.»
Шаг 1. Нажмите на конструктор триггеров
Шаг 2. Выберите вкладку с окном тестирования и нажмите «Добавить триггер»:
Теперь в условии триггера вы увидите следующее значение:
Таким образом, бот будет запускаться только в окне тестирования и нигде больше.
После отладки бота удалите это условие.
Это сообщение отправляется в тестовом режиме из-за команды «Block call 3124105»
После тестирования и отладки бота напишите в настройках бота команду «start_block_from_ai 31241050».
Такой подход позволяет вам создать любой тип интернет-магазина и использовать любые значения данных, хранящиеся в вашей таблице.
Единственное реальное ограничение — это ваше воображение.