Динамические переменные¶

Динамические переменные позволяют параметризировать поведение агента — подставлять данные в системный промпт, первые сообщения и URL инструментов при каждом запуске.

Синтаксис¶

Переменные используют синтаксис двойных фигурных скобок:

{{имя_переменной}}

При запуске сессии платформа заменяет переменные на переданные значения.

Где использовать¶

Системный промпт¶

Ты — оператор поддержки компании {{company_name}}.
Клиент: {{customer_name}}, заказ: {{order_id}}.

Первые сообщения¶

Здравствуйте, {{customer_name}}! Чем могу помочь?

URL инструментов¶

https://api.example.com/orders/{{order_id}}/status

Тело инструментов¶

{
  "customer_id": "{{customer_id}}",
  "language": "{{preferred_language}}"
}

Свойства переменной¶

Каждая переменная определяется набором свойств:

Управление переменными¶

Переменные создаются и редактируются на странице агента:

1. Откройте страницу агента
2. Перейдите на вкладку Variables
3. Нажмите Add Variable
4. Заполните свойства переменной
5. Сохраните изменения

Передача значений¶

Через API¶

При создании сессии через API передайте значения переменных в теле запроса:

{
  "agent_id": "...",
  "variables": {
    "customer_name": "Иван Петров",
    "order_id": "ORD-12345",
    "is_vip": true
  }
}

Через URL-параметры (виджет)¶

При использовании встраиваемого виджета переменные передаются как query-параметры URL страницы:

https://yoursite.com/support?customer_name=Иван&order_id=ORD-12345

Виджет автоматически считывает параметры из URL и передаёт их агенту при запуске.

Через элементы кампании¶

В исходящих кампаниях значения переменных задаются для каждого контакта через маппинг колонок Excel-файла. Подробнее — в разделе Исходящие кампании.

Примеры использования¶

Персонализированная поддержка:

# Системный промпт
Ты — оператор поддержки {{company_name}}.
Клиент: {{customer_name}} ({{customer_tier}}).
Номер обращения: {{ticket_id}}.

Если клиент VIP (tier = premium), предложи приоритетное решение.

Обзвон с напоминанием:

# Первое сообщение
Здравствуйте, {{customer_name}}! Напоминаю, что у вас запланирована встреча
на {{appointment_date}} в {{appointment_time}}.
Подтверждаете ли вы визит?