Як використати дію action_fastline_pro в сценарії?

Дія action_fastline_pro дозволяє використовувати AI-агента або чат-бота, створеного в FastLinePro, у сценарії бота. Це дозволяє інтегрувати розумні відповіді AI в діалог з користувачем.

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

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

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

action_fastline_pro — дія для виклику AI-агента з FastLinePro.
Назва агента має повністю відповідати імені, вказаному у FastLinePro.
Conversation ID відповідає за збереження контексту діалогу.
Vision file дозволяє агенту обробляти зображення та файли.

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

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

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

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

{
  "agent_name": "Your company agent",
  "user_input": "{{question}}",
  "vision_file": true,
  "conversation_id": "fl_client_id",
  "save_response": "client_answer",
  "inputs": {
    "first_name": "Богдан"
  }
}

Параметри дії

agent_name — назва AI-агента, якого ви створили та підключили в інтерфейсі. Має повністю відповідати імені, вказаному у Fast Line Pro.
user_input — питання або запит користувача. Зазвичай ця змінна заповнюється на попередньому кроці сценарію, наприклад: {{question}}.
vision_file — логічний параметр, який визначає, чи має агент доступ до файлів, зображень та інших вкладень:
- true — агент бачить файли
- false — агент працює лише з текстом
conversation_id — назва константи для збереження ID розмови (для контексту). Обовʼязкова для підтримки історії — без неї кожен запит буде новою розмовою.
reset_conversation — якщо вказати значення (наприклад {{reset_conv}} або "1"), поточний діалог скидається і починається нова розмова. Зручно для кнопки «Новий чат».
save_response — назва змінної, у яку буде збережено відповідь агента. Наприклад: client_answer.
inputs — об'єкт, що містить усі змінні, які ви хочете передати агенту (мають бути попередньо створені у блоці "Змінні" агента).

Збережіть зміни в дії та сценарії.

Приклад використання

Сценарій:

Блок "Очікування відповіді" → користувач вводить питання, зберігається в {{question}}
Блок "Дія" з action_fastline_pro → агент відповідає, зберігається в {{client_answer}}
Блок "Повідомлення" → виводить {{client_answer}}

Що відбувається після

Після виконання дії AI-агент обробляє запит користувача та генерує відповідь на основі своїх інструкцій та бази знань (якщо підключена). Відповідь зберігається в змінну, вказану в save_response, та може використовуватися в наступних блоках сценарію.

Передача контексту між агентами

Функція вмикається на інстансі прапорцем ff_fastline_pro_context_summary. Доки його не ввімкнено, картка налаштувань не відображається.

Якщо в одному сценарії кілька дій action_fastline_pro з різними агентами, наступному агенту можна передати коротке саммарі попередньої розмови.

Відкрийте Налаштування → Боти і оберіть бота.
У картці Контекст між агентами Fastline Pro увімкніть Передавати контекст.
Оберіть Агента-саммарайзера (обов'язково) і, за потреби, додайте Додатковий промпт (до 4000 символів).
Виберіть Область дії: усі агенти сценарію або обрані.
За бажанням додайте Константи для передачі - імена констант сценарію (без фігурних дужок), значення яких буде додано до контексту.
Натисніть Зберегти.

Що отримає наступний агент: коли діалог переходить від агента A до агента B, запит до B починається з блоку [Контекст діалогу від попередніх агентів] із саммарі та значеннями обраних констант, далі йде оригінальне повідомлення. Якщо саммарі непорожнє, воно також передається агенту у вхід dialog_context_summary і записується в константу сценарію fastline_context_summary, тож у полях наступних вузлів сценарію можна використати {{fastline_context_summary}}.

Саммарі формується лише тоді, коли діалог переходить до іншого агента, тож на послідовних повідомленнях того самого агента затримки немає. Кожне формування саммарі — це окремий виклик агента-саммарайзера: він рахується у використанні AI так само, як звичайна відповідь агента. Якщо саммарайзер не відповів за 20 секунд або повернув помилку, наступний агент відповідає як зазвичай, без нового саммарі.

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

Перевірте, що назва агента в agent_name точно відповідає імені в FastLinePro.
Переконайтеся, що всі параметри вказані правильно.
Протестуйте сценарій та перевірте, що агент відповідає коректно.
Перевірте, що відповідь зберігається в змінну з save_response.