Сохранение переменных

«Сохранение переменных» — это инструмент, с помощью которого агент сам собирает данные клиента прямо в диалоге и записывает их в «Карточку клиента»: имя, телефон, город, бюджет, email — всё, что вы попросите собрать.

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

Что нужно сделать, чтобы инструмент заработал

1. Включить инструмент на вкладке «Инструменты».
2. Создать переменные — то есть перечислить, какие данные агент должен собирать.
3. Написать к каждой переменной инструкцию для агента — что именно в неё сохранять.

Ниже разберём каждый шаг.

Как включить инструмент

1. Откройте агента → вкладка «Инструменты».
2. В карточке «Сохранение переменных» переведите переключатель слева во включённое положение — он станет зелёным.
3. Нажмите кнопку «Настройка» справа, чтобы перейти на страницу инструмента.

Общие настройки инструмента

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

1. Статус инструмента — переключатель включения и выключения инструмента.
2. Триггер — ситуация (правило), при которой должен сработать инструмент «Сохранение переменных», т.е. при которой агент должен собирать данные клиента. Поле уже заполнено готовым промптом, и в большинстве случаев менять его не нужно.

Если вы изменили текст триггера, под полем появится кнопка «Сохранить триггер» — изменения применятся только после нажатия.

Переменные для сохранения

Второй блок страницы — «Переменные для сохранения». Это перечень данных о пользователе, которые агент должен извлекать из диалога.

1. Нажмите кнопку «Создать новую переменную» — в таблице появится новая строка с двумя полями.

2. Название переменной - короткое имя, по которому вы узнаете данные в карточке клиента: имя, телефон, город, бюджет, phone, email.

3. Инструкция для сохранения переменной

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

• имя → «Имя клиента, которым он представился»
• телефон → «Номер телефона для связи, который оставил клиент»
• город → «Город, в котором находится клиент»
• бюджет → «Сумма, которую клиент готов потратить»

Чем понятнее инструкция, тем точнее агент заполняет переменную.

Изменение инструкции и удаление переменной

• Вы можете изменить «Инструкцию для сохранения переменной» в любой момент. Введите новую инструкцию в поле ввода - изменения сохраняются автоматически: как только вы уходите из поля или нажимаете Enter.
• Изменить «Название» уже созданной переменной нельзя — переменную необходимо удалить и создать заново.
• Чтобы удалить переменную, нажмите значок корзины в конце строки и подтвердите удаление.

Где смотреть собранные данные

Всё, что агент собрал, видно в разделе «Сообщения от пользователей» в левом меню кабинета.

1. Откройте нужный диалог.
2. Нажмите «Карточка клиента» — справа выдвинется панель со списком переменных и их значениями.

Карточка ведётся отдельно для каждого диалога: у каждого клиента свой набор значений.

В самой переписке в момент срабатывания инструмента появляется серая плашка «вызван инструмент: Сохранение переменных», а второй строкой — перечень того, что записалось: «сохранены переменные: name». Название инструмента в плашке кликабельно и ведёт на вкладку «Инструменты».

Ручное редактирование карточки

Карточку клиента менеджер может заполнять самостоятельно — это удобно, когда менеджер узнал что-то в разговоре по телефону или в переписке:

• Изменить значение — нажмите на него, впишите новое и уйдите из поля: значение сохранится само.
• Добавить переменную в карточку — кнопка «Добавить переменную» внизу панели: в списке будут переменные, созданные на вкладке «Инструменты».
• Создать новую переменную — если нужной переменной нет, её можно быстро создать из карточки клиента.
• Удалить переменную из карточки — значок корзины в строке.

Зачем это нужно агенту

Собранные данные о каждом клиенте агент видит во время диалога с ним. Поэтому агент:

• не переспрашивает то, что клиент уже сказал;
• обращается к клиенту по имени (если данное правило задано в промпте);
• учитывает город, бюджет и другие переменные в своих ответах.

Кроме того, переменные можно использовать в двух других инструментах:

• «Отправить уведомление менеджеру» — уведомление приходит в Telegram в момент, когда агент впервые заполняет нужную переменную (например, получил телефон), а значения переменных можно подставить прямо в текст уведомления.
• «Назначение тегов» — теги и переменные дополняют друг друга: переменные хранят данные, теги делят клиентов на группы.

Проверка в тестовом чате

Инструмент удобно проверить на вкладке «Тестовый чат»: напишите агенту так, как написал бы клиент, и посмотрите, появится ли плашка «вызван инструмент: Сохранение переменных».

Если сохранение переменных не работает

Проверьте по порядку:

1. Инструмент включён — переключатель на вкладке «Инструменты» зелёный.
2. Переменные созданы и у каждой есть инструкция (нет оранжевого значка).
3. Инструкция понятная — если написано слишком общо («данные клиента»), агент не поймёт, что именно записывать.
4. Клиент действительно назвал данные — агент сохраняет только то, что прозвучало в диалоге, и ничего не придумывает.
5. Статус агента на вкладке «Настройки» — он должен быть «Включен».
6. Баланс платформы — при нулевом балансе агент перестаёт отвечать, а значит, и собирать данные.