# AI-ассистент с google-таблицами С помощью функции, разработанной командой Salebot, чат-бот ИИ прекрасно понимает введенные в таблицу значения, а затем записывает их в системную переменную в настройках проекта. Например, это может понадобится для AI-ассистента, который будет консультировать ваших клиентов по имеющемуся ассортименту товаров в вашем интернет-магазине, а также для рекламы умным ботом ваших возможностей. Как именно использовать чтение google-таблицы ботом - решать только Вам, а мы в свою очередь покажем, как оформить таблицу и настроить бота на работу с ней. ## Подготовка google-таблицы ### Создание и заполнение Откройте редактор таблицы:
Вам необходимо заполнить строки с обозначениями категорий столбцов:
Поскольку ИИ может считывать данные, с помощью функции он запишет значения из таблицы в переменную в настройках проекта, поэтому советуем добавлять лаконичные и понятные наименования категорий столбцов для вашего удобства и понимания поведения бота. Далее укажите в столбцах необходимые наименования:
Разберемся с категорией столбца "Единица измерения":
В единицу измерения можно вложить: 1. Количественный показатель в виде штук/единиц (одна единица товара, две единицы товара, одна штука и т.д.):
2. Единицы измерения величин: литры, килограммы, граммы, метры:
{% hint style="success" %} Бот прекрасно поймет, что вы имели ввиду и будет пользоваться значениями, вложенными в слоты. {% endhint %} Последним шагом в заполнении google-таблицы будет цена за единицу измерения:
На данном этапе google-таблица заполнена. ### Настройки доступа Для того чтобы бот с ИИ смог взять значения из таблицы, необходимо открыть настройки доступа:
Нажмите на настройки, после чего откроется следующее окно:
Здесь необходимо изменить настройку вместо "Доступ ограничен" на "Все, у кого есть ссылка":
### ID таблицы Чтобы работать с функцией get\_info\_from\_table(!sheet\_id, number\_sheet, sheet\_json\_keys), нам понадобится ID таблицы, так как обязательным параметром функция принимает sheet\_id. Чтобы получить ID, достаточно кликнуть по адресной строке:
Вам откроется строка с адресом страницы:
Из которой нам понадобится набор символов и букв, как раз и являющийся ID таблицы:
На этом работа c таблицей и ее настройка завершена. ## Работа в конструкторе воронок ### Использование функции get\_info\_from\_table() Для того чтобы использовать функцию get\_info\_from\_table(), понадобится один блок в конструкторе воронок. Перейдите в соответствующую вкладку в Salebot и создайте блока с условием (стартовое условие или не состояние с условием):
Пропишем в сообщении вместо #{none} уведомление для тестового режима после запуска данного блока и вложенную переменную через конструкцию #{}:
{% hint style="warning" %} Обращаем внимание! Переменная, вложенная в сообщении, необходима для проверки чтения ботом функции. При запуске блока в режиме тестирования бот покажет значения, которые будут вложены в переменную. {% endhint %} {% hint style="success" %} Обращаем внимание! После настроек вызова блока в режиме тестирования и сохранения переменной в настройках проекта, не удаляйте данный блок. Он может понадобится: например, если вы добавили еще какие-либо значения в таблицу, просто запустите блок в тестовом режиме. Тогда данные в переменной проекта обновятся. {% endhint %} {% hint style="info" %} Название переменной может быть любое, удобное вам. {% endhint %} Далее нам понадобится функция get\_info\_from\_table(sheet\_id, number\_sheet, sheet\_json\_keys) - функция предназначена для чтения данных из таблицы.
параметрыописание
! sheet_idid google-таблицы
number_sheetНомер листа в таблице; по умолчанию = 1
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-ассистента В настройках бота прописываем следующие данные: 1. Должность и инструкции для бота. Пример: <*Ты продавец магазина "Все мелочи.* \ *Твоя задача спросить у клиента, какой товар он хочет выбрать, сколько единиц товара, а далее высчитать итоговую стоимость товара, равную единице товара, умноженное на стоимость.* *После того, как ты опросил клиента по поводу его покупки, продублируй ему заказ и спроси "Верно ли составлен заказ?"*>. **Обращаем внимание** на строку "Высчитать итоговую стоимость товара, равную единице товара, умноженную на стоимость" - данная строка выведет итоговый результат стоимости всех выбранных категорий клиентом: Пример: Клиент выбрал три кг одного товара. Бот, в свою очередь, рассчитывает итоговую стоимость:
2. Команда для вызова блока и передачи переменных в систему прописывается следующим образом: <Если клиент написал "Заказ составлен верно" или "Верно", то напиши "start\_block\_from\_ai N">, где вместо N прописывается ID блока с завершающим сообщением: блок Состояние передает данные в карточку клиента:
Команды в настройках AI-ассистента выглядят следующим образом:
### Знания бота В поле "Знания бота" передайте переменную, которую ранее закешировали блоком Первостепенной проверки условия:
Знания бота:
Так бот будет брать информацию из переменной, лежащей в настройках проекта, и консультировать ваших клиентов по поводу имеющегося ассортимента. ### Формат данных В формате передаваемых данных вы прописываете собственно сами собираемые данные (например, товар), далее прописывается фразу с "ключом" и присваиваете значение ключу:
#### Объяснение Строка 1: "Формат передаваемых данных: товар с ключом product, единица измерения с ключом thing, цена с ключом count, общая стоимость всех выбранных товаров с ключом result" - дает боту понять, какие данные и с каким значением необходимо передать в систему. Данные переменные будут отображаться в карточке клиента:
2. Если вам необходимо, чтобы каждый выбранный клиентом товар отображался отдельно, добавьте второй строкой: "Если клиент выбрал несколько товаров, то запиши первый товар с ключом product1, второй товар с ключом product2, третий товар с ключом product3 и так далее". На этом настройка AI-ассистента завершена. Остальные параметры можно выставить по-своему усмотрению:
## Тестирование бота Добавьте через конструктор условий работу бота в тестовом окне: Шаг 1. Кликните по конструктору условий
Шаг 2. Выберите вкладку с тестовым окном и кликните "Добавить":
Теперь в условии для запуска вы видите следующее значение:
{% hint style="info" %} Так бот будет запускаться только в тестовом окне и нигде больше. После отладки работы бота, уберите данное условие. {% endhint %} Теперь протестируем бота: 1. Зададим контрольный вопрос боту об ассортименте товаров:
Бот показал ассортимент товаров, которые были введены в google-таблице, захватывая значения из переменной, содержащейся в настройках проекта. 2. Далее выберем товар и поговорим с умным ботом:
3. Выберем другой товар:
Бот также отображает корректно, показывая клиенту уже категории товаров для последующего выбора. 4. Клиент выбрал несколько товаров и выбрал их количество:
Бот высчитал стоимость выбранных единиц товара и рассчитал итоговую стоимость. 5. Отправляем данные в систему:
Итог: после того, как бот продублирован заказ и клиент ответил, что заказ составлен верно, чат-бот, опираясь на настройки, вызвал блок "Состояние диалога":
После чего данные, сформированные ботом в диалоге с клиентом, направились в карточку клиента:
Бот отработал все корректно. {% hint style="success" %} Таким образом вы можете создать интернет-магазин любого вида, использовать любые необходимые значения внутри таблицы. Основное ограничение - только Ваша фантазия! {% endhint %} ## Видеогид {% embed url="" %}