Переменные в агенте

Кратко

В форме агента можно включить переменные проекта и переменные лидов, а затем отдельно ограничить чтение и запись для каждого источника запроса.

Переменные проекта

• постоянные данные проекта;
• примеры: тарифы, ссылки, правила, контакты, адреса, промокоды, юридические условия.

Переменные лида

• данные конкретного клиента;
• примеры: имя, город, сегмент, статус заказа, интерес, последний продукт, дата следующего контакта.

Личные и групповые диалоги

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

Если нужно прочитать или изменить данные определённого участника, назовите его либо ответьте на его сообщение. Агент работает только с лидом, который действительно участвовал в этом диалоге. Если участника нельзя определить однозначно, данные не должны изменяться: сначала нужно уточнить, о ком идёт речь.

Переменные проекта от участника не зависят и остаются общими для всего проекта.

Вставка переменных в инструкцию

В редакторе инструкции агента кнопка переменных открывает список данных проекта и лида. Найдите нужную переменную и выберите способ вставки:

• «Значение» — подставить значение прямо в текст инструкции;
• «Условие» — использовать один фрагмент, если значение заполнено, и другой, если оно отсутствует. Ветку для отсутствующего значения можно оставить пустой.

Вставка в инструкцию не выдаёт агенту доступ автоматически. Для выбранного типа переменных всё равно настройте права чтения или записи ниже и опубликуйте агента.

Для каждого типа переменных можно настроить доступ

• нет доступа;
• только чтение;
• чтение и запись.

Доступ бывает из двух источников

• включите переменные проекта, затем отдельно задайте доступ из инструкции и доступ по запросу клиента;
• включите переменные лидов, затем отдельно задайте доступ из инструкции и доступ по запросу клиента.

Что означают два источника доступа

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

«По запросу клиента» применяется, когда человек сам просит показать или изменить данные. Для «Какой у меня статус заказа?» достаточно чтения переменных лида по запросу клиента, а для «Измени мой город на Казань» нужна запись по запросу клиента.

Настраивайте эти источники отдельно и выдавайте минимально необходимый доступ. Право на запись разрешает изменение, но не является командой менять данные без подходящего правила или явной просьбы.

Почему переменная не изменилась

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

1. Нужный тип переменных включён в черновике агента.
2. Определение переменной создано в «Настройки» -> «Переменные».
3. Для источника запроса выбран режим «Чтение и запись», а не «Только чтение».
4. В групповом чате или комментариях однозначно указан нужный участник.
5. Изменения агента сохранены и опубликованы; рабочий диалог использует новую версию.

Если участник или право записи не определены однозначно, безопасный результат — не менять значение и объяснить, что нужно уточнить.

Если агенту нужно запоминать данные о клиенте

• включите переменные лида;
• дайте агенту доступ на запись;
• создайте определения переменных лида в "Настройки" -> "Переменные";
• укажите в инструкции, какие данные и когда нужно сохранять.

Если агенту нужно подставлять постоянные данные компании

• создайте переменную проекта;
• включите переменные проекта в агенте;
• дайте доступ на чтение;
• опишите в инструкции, как использовать значение.

Где это в интерфейсе

Основные элементы раздела:

• форма настроек агента
• список агентов
• пункт «Агенты» в боковом меню