Данные и переменные в агенте

Кратко

В инструкции агента можно использовать четыре вида данных:

• данные лида — системные поля текущего клиента: ID, имя, телефон, канал и другие сведения из карточки лида;
• переменные лида — собственные поля проекта, которые хранят отдельное значение для каждого клиента, например город или статус заказа;
• переменные диалога — поля одной переписки, например номер обсуждаемой сделки; у другого диалога того же клиента значение может быть иным;
• переменные проекта — одно общее значение для всего проекта, например адрес офиса или актуальный промокод.

В левом меню выберите «Агенты», найдите нужного агента в списке и откройте его настройки.

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

Откройте @ → «Переменные». В каталоге данные лида и собственные переменные разделены по областям.

Переменную проекта, лида или диалога можно создать из соответствующего раздела каталога @, если у участника есть право создания. После создания ссылка на неё появится в инструкции. Само поле создаётся сразу и останется в проекте, даже если затем отменить настройку агента.

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

Переменные проекта хранят постоянные общие данные: тарифы, ссылки, правила, контакты, адреса, промокоды или юридические условия. Значение {{project.имя_переменной}} одинаково для всех диалогов проекта.

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

Переменные лида — это собственные данные конкретного клиента: город, сегмент, статус заказа, интерес, последний продукт или дата следующего контакта. Значение {{lead.имя_переменной}} берётся у текущего лида.

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

Переменная диалога хранит значение для текущей переписки. Например, {{dialog.deal_id}} подставит номер сделки, которую обсуждают именно здесь. Значение сохраняется между ответами агента и запусками автоматизаций, но не переносится автоматически в другую переписку с тем же клиентом.

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

Проверьте и опубликуйте изменения

1. Дождитесь сохранения черновика агента после изменения инструкции или прав.
2. Протестируйте агента: задайте вопрос, для которого нужно выбранное поле, и проверьте результат. Если разрешена запись, используйте учебные данные — тест может изменить их.
3. Когда результат вас устраивает, опубликуйте новую версию. Сохранение окна переменных само по себе не обновляет опубликованного агента.

Для подстановки можно взять {{dialog.deal_id}}: сначала заполните номер сделки в нужном диалоге, затем отправьте в той же переписке вопрос о номере сделки. В другом диалоге этого значения может не быть. При тестировании в отдельной переписке проверьте её собственные данные.