Благодаря функции, разработанной командой Mavibot, AI-чатбот точно интерпретирует значения, введенные в таблицу, а затем сохраняет их в системную переменную в настройках проекта.
Например, это может понадобиться для AI-ассистента, который будет консультировать ваших клиентов по доступному ассортименту товаров в вашем интернет-магазине, а также рекламировать ваши возможности с помощью умного бота.
Как именно использовать бота для чтения Google-таблицы, решать вам, а мы, в свою очередь, покажем, как создать таблицу и настроить бота для работы с ней.
Подготовка Google-таблицы
Создание и заполнение
Откройте редактор таблиц:

Вам нужно заполнить строки категориями столбцов:

Поскольку AI может читать данные, он будет использовать функцию для записи значений из таблицы в переменную в настройках проекта, поэтому мы рекомендуем добавлять краткие и понятные названия категорий столбцов для вашего удобства и понимания логики бота.
Далее укажите необходимые названия в столбцах:

Рассмотрим категорию столбца "Единица измерения":

Единица измерения может включать:
- Количественный показатель в виде штук/единиц (одна единица товара, две единицы товара, одна штука и т.д.):

- Единицы измерения величин: литры, килограммы, граммы, метры:

Бот отлично поймет, что вы имели в виду, и использует значения, встроенные в слоты.
Последним шагом в заполнении Google-таблицы будет ввод цены за единицу измерения.

На этом этапе Google-таблица готова.
Настройки доступа
Чтобы AI-бот мог брать значения из таблицы, необходимо открыть настройки доступа:

Нажмите на настройки, и откроется следующее окно:

Здесь нужно изменить настройку с "Доступ ограничен" на "Все, у кого есть ссылка":

ID таблицы
Для работы с функцией get_info_from_table(!sheet_id, number_sheet, sheet_json_keys) нам понадобится ID таблицы, так как функция принимает sheet_id как обязательный параметр.
Чтобы получить ID, просто нажмите на адресную строку:

Вы увидите строку с адресом страницы:

Из которой нам понадобится набор символов и букв, который и является ID таблицы:

На этом работа с таблицей и ее настройка завершены.
Работа в конструкторе воронок
Использование функции get_info_from_table()
Чтобы использовать функцию get_info_from_table(), вам понадобится один блок в конструкторе воронок.
Перейдите на соответствующую вкладку в Mavibot и создайте блок проверки первичного условия:

Вместо #{none} мы напишем в сообщении уведомление для тестового режима после запуска этого блока и встроенную переменную через конструкцию #{}:

Обратите внимание!
Переменная, встроенная в сообщение, необходима для проверки того, что бот читает функцию.
При запуске блока в тестовом режиме бот покажет значения, которые будут вложены в переменную.
Обратите внимание!
После настройки вызова блока в тестовом режиме и сохранения переменной в настройках проекта не удаляйте этот блок.
Он может вам понадобиться: например, если вы добавили какие-либо значения в таблицу, просто запустите блок в тестовом режиме. Тогда данные в переменной проекта будут обновлены.
Имя переменной может быть любым, которое вам подходит.
Далее нам понадобится функция get_info_from_table(sheet_id, number_sheet, sheet_json_keys) — функция, предназначенная для чтения данных из таблицы.
Откройте калькулятор и введите ID таблицы, заключив его в переменную (например, sheet):

Затем присвойте переменную, указанную в сообщении блока, и присвойте ей значение в виде функции get_info_from_table() с обязательным параметром sheet_id (вместо которого вставьте переменную sheet, где находится ID таблицы):

Внимание! Перед переменной product_pay_info в калькуляторе напишите project. Это необходимо для того, чтобы ПЕРЕМЕННАЯ и ЗНАЧЕНИЯ из таблицы были внесены в настройки проекта (кэшированы):

Теперь напишите любое слово/цифры в условии блока:

Блок передачи данных
Далее создайте второй блок "Статус":

Этот блок "Статус" понадобится для передачи переменных в карточку клиента.
Вы также можете отправить финальное сообщение от бота в этом блоке, например, "Спасибо за заказ! Отправляю данные менеджеру по коммуникациям!":

Затем скопируйте ID блока — он понадобится для настройки AI-ассистента в команде "start_block_from_ai 31241050", где вместо ID из примера нужно вставить ID вашего блока.
Чтение таблицы
Теперь запустите блок в тестовой версии, чтобы чат-бот прочитал значения из таблицы и поместил их в вашу переменную в настройках проекта:

Таким образом, блок отработал корректно: вы видите значения, которые были прочитаны и находятся в переменной в настройках проекта.
Вы можете убедиться в этом, перейдя в соответствующий раздел:

Далее вы увидите вашу переменную со значениями, встроенными в нее из таблицы:

Итак, теперь внутри вашего проекта есть переменная с товарами, стоимостью и всем, что вы указали в таблице.
Работа AI-ассистента
Перейдите в раздел "AI-ассистент" и начните настройку искусственного интеллекта.
Роль ассистента: продавец

Также установим опции "Кнопки" и "Пошаговый ввод данных":

Кнопки понадобятся для визуально оформленных ответов бота, а также для удобства клиента (тогда вашему пользователю не нужно вручную вводить слова в диалоге); пошаговый ввод данных — для того, чтобы бот опрашивал формируемый заказ.
Настройки AI-ассистента
В настройках бота пишем следующие данные:
- Должность и инструкции для бота.
Пример:
<Вы продавец магазина "Все мелочи".
Ваша задача — спросить клиента, какой товар он хочет выбрать, сколько единиц товара, а затем рассчитать общую стоимость товара, равную одной единице товара, умноженной на стоимость.
После того как вы опросили клиента о его покупке, продублируйте заказ и спросите "Заказ верен?">.
Обратите внимание на строку "Рассчитать общую стоимость товара, равную единице товара, умноженной на стоимость" — эта строка отобразит конечный результат стоимости всех выбранных клиентом категорий:
Пример:
Клиент выбрал три кг одного товара. Бот, в свою очередь, рассчитывает общую стоимость:

- Команда для вызова блока и передачи переменных в систему записывается следующим образом:
<Если клиент написал "Заказ верен" или "Верно", то напиши "start_block_from_ai N">, где вместо N пишется ID блока с финальным сообщением: блок "Статус" передает данные в карточку клиента:

Команды в настройках AI-ассистента выглядят так:

Знания бота
В поле "Знания бота" передайте переменную, которая ранее была кэширована блоком проверки первичного условия:

Знания бота:

Таким образом, бот будет брать информацию из переменной в настройках проекта и консультировать ваших клиентов по доступному ассортименту товаров.
Формат данных
В формате передаваемых данных вы сами указываете собираемые данные (например, товар), затем вводите фразу с "ключом" и присваиваете значение ключу:

Пояснение
Строка 1: "Формат передаваемых данных: товар с ключом product, единица измерения с ключом thing, цена с ключом count, общая стоимость всех выбранных товаров с ключом result" — дает понять боту, какие данные и с каким значением необходимо передать в систему.
Эти переменные будут отображаться в карточке клиента:

- Если вам нужно, чтобы каждый выбранный клиентом товар отображался отдельно, добавьте вторую строку:
"Если клиент выбрал несколько товаров, то добавь первый товар с ключом product1, второй товар с ключом product2, третий товар с ключом product3 и так далее".
На этом настройка AI-ассистента завершена.
Остальные параметры можно настроить по своему усмотрению:

Тестирование бота
Используйте конструктор условий, чтобы добавить работу бота в тестовом окне:
Шаг 1. Нажмите на конструктор условий

Шаг 2. Выберите вкладку с текстовым полем и нажмите "Добавить":

Теперь в условии запуска вы видите следующее значение:

Таким образом, бот будет запускаться только в тестовом окне и нигде больше.
После отладки бота удалите это условие.
Теперь протестируем бота:
- Зададим боту контрольный вопрос об ассортименте товаров:

Бот показал разнообразие товаров, которые были введены в Google-таблицу, захватив значения из переменной, содержащейся в настройках проекта.
- Далее выберем товар и поговорим с умным ботом:

- Выберем другой товар:

Бот также корректно отображает информацию, показывая клиенту категории товаров для последующего выбора.
- Клиент выбрал несколько товаров и указал их количество:

Бот рассчитал стоимость выбранных позиций и вычислил общую стоимость.
- Отправка данных в систему:

Результат: после того как бот продублировал заказ и клиент ответил, что заказ верен, чат-бот на основе настроек вызвал блок "Статус диалога":

После этого данные, сформированные ботом в диалоге с клиентом, были отправлены в карточку клиента:
Бот все отработал корректно.
Таким образом, вы можете создать интернет-магазин любого типа и использовать любые необходимые значения внутри таблицы.
Главное ограничение — только ваше воображение!