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