Используя специальную функцию, разработанную командой 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_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 блока. Он понадобится вам для настройки ИИ-ассистента в команде "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".
Такой подход позволяет вам создать любой тип интернет-магазина и использовать любые значения данных, хранящиеся в вашей таблице.
Единственное настоящее ограничение — это ваше воображение.