Документація
EN
Інструкція
Markdown статті

Use Case 9: Failsafe + reverse engineering

Рівень: базовий · Модулі: Scenario Builder

Необхідні права та доступ

Що потрібно Де в меню Навіщо
Scenario Builder Меню → Scenario Builder Аудит edges, Runs, RE lab

Якщо розділу немає в меню — перевірте права облікового запису або зверніться до підтримки ConnectiveOne.

Бізнес-контекст

Production-сценарій не повинен «замовкати» після помилки API, AI або connect. Інтегратор вміє читати чужий flow, знаходити необроблені edges і перевіряти сценарій перед публікацією.

Очікуваний результат

  • У навчальному сценарії (Use Case 1…4) кожна Action має обробку fallback / error / not_ok / limit.
  • Reverse engineering: опис data flow, необроблені edges, пропозиції покращень.
  • Чекліст перед публікацією пройдено self-check.

Архітектура flow (аудит)

Для кожної Action-ноди:
   Inspector → список edges → полотно → MessageKeyboard / fallback
   Якщо edge є в Inspector, але не з'єднаний → баг сценарію

Покрокова реалізація

Крок 1. Аудит edges (Use Case 1…4)

Пройдіть сценарії Use Case 1 … Use Case 4 і для кожної Action-ноди заповніть таблицю (у файлі результатів):

Action Очікувані edges Підключено? Куди веде Що бачить клієнт, якщо не підключено
action_fastline_pro fallback тиша
action_send_request not_ok, error тиша
operator_panel__connect… success, limit, error тиша
registered_users__get success, error тиша
custom_modules__set success, error тиша

Правило Use Case 9: якщо edge є в Inspector, але не з'єднаний на полотні — це баг сценарію, навіть якщо «рідко спрацьовує».

→ Edge-driven flow

Крок 2. Tooling tour — алгоритм дебагу

Пройдіть послідовно при будь-якій проблемі в сценарії:

Крок Інструмент Що робити
1 Runs Знайти виконання → крок зупинки → який edge спрацював
2 Runs — trace / лог Змінні та constants у проблемній ноді; текст помилки, якщо виконання failed
3 Node Inspector → «Тест дії» Ізольований тест Action (send_request, registered_users__get тощо)
4 Fast Line Pro → Тестування Окремо перевірити categorizer / FAQ-агента без сценарію
5 Канал на інстансі Telegram / widget — коли preview не відтворює keyboard, Registered Users між сесіями, connect
6 Operator Line (опційно E2E) Після connect — чи діалог у правильній темі / skill group 
1. Runs → знайти виконання
2. Крок зупинки + edge + змінні/constants
3. Лог/trace кроку (повідомлення помилки)
4. «Тест дії» в Inspector (Action) або тест агента в Fast Line Pro
5. Звірка alias / subject_alias з Settings
6. Канал на інстансі (Settings → Bots) — якщо preview недостатньо
7. Operator Line — опційно після connect

→ Як протестувати сценарій · Матриця тестування

Крок 3. Таблиця симптомів

Симптом Де шукати Що перевіряти
Бот замовк після Action Runs trace Edge error без обробки
{{змінна}} буквально в тексті Runs → variables Змінна не записана
Webhook 401 / not_ok Runs → constants save_responce, Instance Settings, URL
Scenario loop Runs count Exit point
CSAT INTEGER error Keyboard source-handle Не вести free-text у CD INTEGER

Крок 4. Reverse engineering lab

Пройдіть RE lab (~15 нод):

  1. Опишіть data flow (змінні, constants).
  2. Знайдіть 3 необроблені edges.
  3. Запропонуйте покращення (fallback, validation, alias).

Або проведіть audit власного capstone-сценарію (Use Case 13, просунутий рівень).

Крок 5. Чекліст перед публікацією (self-check)

Критерії приймання (self-check Runs)

Типові помилки

Симптом Причина Що зробити
«Рідко спрацьовує» — не фіксили Edge не підключений Підключити всі edges з Inspector
Audit пропустив connect Багато connect-блоків Однаковий chat_closed_alias, усі limit/error
RE lab — не знайшли edges Дивились лише happy path Inspector кожної Action
Публікували без Runs Немає trace Happy + negative path у Runs

Пов'язана документація

Працюєте з власним ШІ-агентом?Встановіть відкритий skill, щоб ваш ШІ-агент працював з актуальною офіційною документацією ConnectiveOne.Отримати skillПотрібна підтримка?Не знайшли відповідь або потрібна допомога команди ConnectiveOne? Створіть запит у Client Portal.Створити запит