Як налаштувати змінні агента в FastLinePro?

Змінні агента — це параметри, які можна передавати до AI-агента через Action в сценарії. Після передачі вони стають доступними у промптах (інструкціях) у форматі {{назва_змінної}}.

Коли знадобиться

Потрібно передати додаткову інформацію агенту (ім'я користувача, контекст діалогу).
Треба персоналізувати відповіді агента на основі даних користувача.
Потрібно передати динамічні дані зі сценарію до агента.

Що важливо знати

Змінні — параметри, які передаються до AI-агента через Action.
Змінні доступні у промптах у форматі {{назва_змінної}}.
Якщо ви створюєте змінну, обов'язково передайте її в параметрах блоку в сценарії.
Без передачі в сценарії змінна не буде доступна в інструкціях.

Перед початком

Ви увійшли в систему з правами інтегратора або адміністратора.
Ви перейшли в модуль FastLinePro через меню Додатки -> FastLinePro.
У вас є створений AI-агент або ви створюєте новий.

Покрокова інструкція

Створення змінних в інтерфейсі агента

У модулі FastLinePro перейдіть до розділу "Агенти" або "Чат-боти".
Виберіть агента для редагування або створіть нового.
Знайдіть розділ "Змінні" (Variables) в налаштуваннях агента.
Натисніть кнопку "Додати змінну".
Введіть назву змінної (наприклад, first_name, user_id, order_number):
- Назва має бути латиницею
- Можна використовувати підкреслення
- Назва має бути унікальною для агента
Додайте опис змінної (необов'язково) для кращого розуміння її призначення.
Збережіть змінну.

Використання змінних у промпті

У розділі "Інструкції" (Prompt) агента використовуйте змінні у форматі {{назва_змінної}}.

Приклад промпту з змінними:

Ти - асистент підтримки клієнтів.

Користувач: {{first_name}}
ID користувача: {{user_id}}

Відповідай на питання користувача, звертаючись до нього по імені {{first_name}}.

Передача змінних в сценарії

У конструкторі сценаріїв додайте блок "Дія" з функцією action_fastline_pro.
У параметрах дії знайдіть поле "inputs" (або аналогічне).
Вкажіть змінні у форматі JSON:

{
  "agent_name": "support_agent",
  "user_input": "{{question}}",
  "inputs": {
    "first_name": "Богдан",
    "user_id": "12345"
  }
}

⚠️ Важливо: Якщо ви створюєте змінну в інтерфейсі агента, обов'язково передайте її в параметрах блоку в сценарії. Без цього змінна не буде доступна в інструкціях, і AI-агент не зможе її використовувати під час генерації відповідей.

Після налаштування змінних та їх передачі в сценарії змінні стають доступними у промпті агента. AI-агент зможе використовувати ці змінні для персоналізації відповідей та доступу до додаткової інформації.

Як переконатися, що все вдалось

Перевірте, що змінні створені в інтерфейсі агента.
Переконайтеся, що змінні використовуються у промпті у форматі {{назва_змінної}}.
Перевірте, що змінні передаються в параметрах дії action_fastline_pro в сценарії.
Протестуйте агента, щоб переконатися, що змінні працюють коректно.