Як переглянути історію змін агента Fast Line Pro і відкотити версію?
У редакторі агента є кнопка Історія. Вона показує кожне збереження налаштувань агента: хто, коли і звідки його зробив. Для кожної версії можна подивитися, що змінили, порівняти її з поточним агентом, переглянути й скопіювати інструкції та змінні, а за потреби — відновити версію.
Коли знадобиться
- Промпт агента змінився, і треба зрозуміти, хто і коли це зробив.
- Після зміни агент відповідає гірше, і потрібно повернути попередні інструкції чи модель.
- Треба скопіювати фрагмент старого промпту, не відкочуючи агента.
Що важливо знати
- Історія записується з моменту оновлення платформи. Зміни, зроблені раніше, у ній не з'являться.
- Версії зберігаються 180 днів, потім видаляються автоматично.
- Історія працює, коли в інстансі увімкнено журнал змін налаштувань (Settings Audit Trail). Якщо його вимкнено, кнопки Історія немає.
- Відкочуються: інструкції, змінні, модель (з параметрами), підключені бази знань разом із налаштуваннями пошуку по них (кількість результатів, поріг, переранжування) і завантаження зображень/файлів.
- Не відкочуються: інструменти агента (вбудовані, MCP, MCP Tool секції сценаріїв) і службові налаштування, яких немає в редакторі. Вони лишаються такими, як зараз. Зміни інструментів видно в історії та в Переглянути.
- Джерело версії — довідкова позначка:
- Інтерфейс — збереження з панелі Constructor. Так само позначаються зовнішні інтеграції, що надсилають запити із заголовком
X-CSRF-TOKEN. - API — запит з токеном у заголовку
Authorization: Bearer. Instance Agent, що працює без делегування (звичайним токеном входу), теж записується як API. - Instance Agent — зміна, яку Instance Agent зробив від імені користувача.
- MCP — запит з MCP-ключем.
- Система — зміна без користувача: застосування пакета Маркетплейсу, синхронізація чек-листа AI QA, прив'язка сценарію. У таких записів автора немає: «Система · Чек-лист AI QA» не означає людину, яка зберегла чек-лист.
- Інтерфейс — збереження з панелі Constructor. Так само позначаються зовнішні інтеграції, що надсилають запити із заголовком
- Правки, зроблені в обхід панелі (напряму в бекенді агента), в історію не потрапляють. Вони з'являться як частина наступної публікації і виглядатимуть як зміна того, хто опублікував.
- Версія записується одразу після публікації, але у фоні. Якщо платформу перезапустять саме в цю мить, запис може загубитися.
- Відкат публікує агента одразу: він почне відповідати за відновленою версією, зокрема в діалогах, що вже тривають.
Перед початком
Як переглянути історію
- Відкрийте агента: Fast Line Pro → Агенти → потрібний агент.
- Натисніть Історія поруч із назвою агента.
- У вкладці Налаштування агента побачите список версій — найновіші зверху. У кожному рядку: дата й час, автор, джерело. Для відкату є рядок «Відкат до версії від …».
- Натисніть Показати ще, щоб завантажити попередні версії (по 20).
Найстаріший запис може мати пункт Стан до першої зафіксованої зміни — це налаштування агента, якими вони були до першого збереження після оновлення платформи.
Що можна зробити з версією
| Дія | Що показує |
|---|---|
| Що змінили | Різницю між станом до і після цього збереження. Інструкції — построчно, модель — «параметр: було → стало», змінні, бази знань і файли — «Було / Стало», інструменти — «Додано / Прибрано / Змінено налаштування». Незмінені розділи згорнуті з позначкою «Без змін». |
| Порівняти з поточною | Різницю між версією і агентом зараз. |
| Переглянути | Версію повністю, лише для читання. Біля інструкцій і кожної змінної є Скопіювати. |
| Відновити цю версію | Відкат агента до версії (лише з правом на збереження). |
Значення *** — приховане (наприклад, ключ доступу). Воно не порівнюється і не вважається зміною.
Якщо попередній стан для версії не зафіксовано (наприклад, це перше збереження нового агента), Що змінили покаже плашку «Попередній стан не зафіксовано» і саму версію.
Як відновити версію
- У рядку версії натисніть Відновити цю версію.
- У вікні підтвердження перегляньте різницю з поточним агентом і попередження:
- скільки змін зроблено після цієї версії і ким — їх буде перезаписано;
- Інструменти не відкочуються — якщо набір інструментів у версії відрізняється від поточного;
- агентом керує чек-лист AI QA або його змінює Instance Agent — вони можуть перезаписати відкат;
- база знань із версії видалена або недоступна — її не буде підключено;
- модель із версії більше недоступна — лишиться поточна;
- незбережені зміни в редакторі буде втрачено.
- Натисніть Відновити.
Після відкату з'явиться повідомлення «Версію відновлено й опубліковано», редактор перечитає агента, а в історії з'явиться новий рядок «Відкат до версії від …». Відкат теж можна відкотити.
Історія змін бази знань
У тому самому вікні Історія є друга вкладка — База знань. Вона показує, хто, коли і звідки додав, змінив, увімкнув чи вимкнув або видалив документи й чанки баз знань, підключених до агента зараз.
У кожному рядку:
- дата й час, автор і джерело — ті самі позначки, що й у версій агента (Інтерфейс, API, Instance Agent, MCP, Система);
- дія: «Додано документ», «Перейменовано документ», «Увімкнено документ», «Вимкнено документ», «Видалено документ», «Додано чанк», «Змінено чанк», «Увімкнено чанк», «Вимкнено чанк», «Видалено чанк», «Завантажено чанки: нових N, змінено M», «Імпорт з файлу: застосовано N»;
- база знань і документ. Чанки, які записують через API чи MCP (наприклад, Instance Agent), потрапляють у службовий документ — у рядку він називається Чанки з API/MCP, а його технічну назву видно в підказці при наведенні;
- до 5 ідентифікаторів чанків чи документів і «і ще N», а також кількість.
Що важливо знати:
- Текст чанків не зберігається і не показується. Відновити чанк чи документ з історії не можна — лише побачити, хто і що змінив.
- Показано зміни лише баз знань, підключених до агента зараз. Якщо базу знань від'єднати, її рядки зі вкладки зникнуть, але залишаться в журналі змін налаштувань (типи Документи бази знань Fastline Pro і Чанки бази знань Fastline Pro).
- Імпорт чанків з файлу записується одним рядком «Імпорт з файлу: застосовано N» — без автора, з джерелом Система.
- Не записуються: застосування пакета Маркетплейсу і правки в обхід панелі.
- Якщо увімкнення чанків завершилося помилкою (наприклад, чанк не проіндексувався), такої зміни в історії може не бути.
- Історія бази знань теж записується з моменту оновлення платформи і зберігається 180 днів.
Де ще подивитися
Усі зміни однієї бази знань видно і на сторінці самої бази: Бази знань → потрібна база знань → кнопка Історія над списком документів. Відкриється вікно Історія змін бази знань з тими самими рядками, що й у вкладці агента, — але для цієї бази знань повністю: зокрема коли вона не підключена до жодного агента або її від'єднали. Фільтра за документом тут немає.
Як переконатися, що все працює
- Змініть рядок в інструкціях і натисніть Опублікувати → у Історії зверху з'явився рядок з вашим іменем і джерелом Інтерфейс.
- Що змінили для цього рядка показує лише змінений рядок інструкцій, решта розділів — «Без змін».
- У журналі змін налаштувань є запис типу Налаштування агента Fast Line Pro з посиланням «Детальніше — в історії агента».
- Відредагуйте чанк підключеної бази знань → Історія → База знань: зверху рядок «Змінено чанк» з вашим іменем, джерелом Інтерфейс, id чанка і «1 чанк».
Типові ситуації
| Ситуація | Що робити |
|---|---|
| «Агента вже змінили, поки ви переглядали» | Хтось опублікував агента, поки було відкрито вікно відкату. Натисніть Оновити, перегляньте різницю ще раз і повторіть відкат. |
| «Версію не знайдено» | Версія старша за 180 днів і видалена. |
| «Цю версію не можна відновити автоматично» | У версії є приховане значення, якого вже немає в агенті. Скопіюйте потрібні фрагменти через Переглянути і внесіть їх вручну. |
| «Не вдалося опублікувати агента» | Спробуйте пізніше; агент лишився без змін. |
| Кнопки Історія немає | Журнал змін налаштувань вимкнено в інстансі або немає права на перегляд Fast Line Pro. |
| Кнопки Відновити цю версію немає | Немає права на збереження Fast Line Pro. |