Щоб працював без вас

На цій сторінці ви налаштуєте агента так, щоб він прокидався сам: за розкладом, за сигналом із вашої системи або регулярно перевіряючи, чи щось змінилось.

Тригер — це причина прокинутись

Агент нічого не робить сам по собі. Щоразу його щось будить.

Для помічника на сайті таким «будильником» є саме повідомлення відвідувача — і ніяких налаштувань не треба. Але якщо агент має працювати вночі, поки ви спите, йому потрібен тригер.

Відкрийте агента → Тригери. Кнопка Додати тригер відкриває форму.

Тригерів може бути скільки завгодно й різних типів одночасно.

Чотири способи запуску

У формі перший вибір — Спосіб запуску:

Спосіб	Коли обирати
За розкладом	регулярна робота: щоранкові зведення, нічні звірки, нагадування
За сигналом ззовні	подія сталася у вашій системі, реагувати треба одразу
Регулярна перевірка	у джерела немає способу вас повідомити — доводиться питати самим
Тільки вручну	разова робота або перевірка: запускаєте кнопкою

Спільні поля

Назва. Так тригер буде видно у списку й у журналі. Наприклад, «Ранковий звіт про рахунки».

Задача запуску. Що саме агент має зробити, коли прокинеться. Це той самий текст, який ви написали б йому в розмові:

Перевір нові рахунки з учора й надішли підсумок у робочий чат

Тригер увімкнено. Вимкнений тригер зберігається, але агент за ним не прокидається.

Обидва перші поля обов'язкові — без них кнопка збереження неактивна.

Розклад

Оберіть За розкладом.

Готові розклади

Найпростіше — натиснути одну з готових кнопок:

• Щогодини
• Кожні 15 хвилин
• Щодня о 9:00
• Щобудня о 9:00
• Щопонеділка о 9:00
• 1 числа о 9:00

Під ними кабінет одразу пише звичайною мовою, що вийшло, і коли буде перший запуск. Якщо там написано щось несподіване — виправте, поки не збережено.

Свій розклад

Поле Власний вираз приймає розклад у стандартному записі з п'яти частин: хвилини, години, число, місяць, день тижня. Підпис під полем нагадує порядок.

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

Часовий пояс

Часовий пояс агента — за яким часом рахувати розклад. За замовчуванням Europe/Kyiv.

Часовий пояс агента може не збігатись із вашим

Якщо ви в іншому часовому поясі, кабінет так і попередить просто під полем: «Час на цьому екрані показано за часовим поясом агента, а не за вашим». «9:00» означатиме 9:00 у поясі агента.

Регулярна перевірка

Оберіть Регулярна перевірка. Це для випадку, коли у джерела немає способу вас повідомити — і доводиться питати самим.

У полі Перевіряти кожні вкажіть число й одиницю: секунд, хвилин або годин.

Кожна перевірка — це повноцінний запуск агента

І кожна списує кредити. Перевірка раз на хвилину — це 1440 запусків на добу. Ставте найбільший проміжок, який вас влаштовує.

Найменший дозволений проміжок — 30 секунд; менше кабінет не збереже. Під полем видно, скільки це секунд.

Щоб агент не обробляв те саме двічі, дайте йому право пам'ятати між запусками — див. Наскільки агент самостійний і розділ «Позначки між запусками» нижче.

Сигнал ззовні (вебхук)

Оберіть За сигналом ззовні.

Простими словами: ваша система смикає агента, коли щось сталося. Наприклад, у CRM з'явилось нове замовлення — CRM надсилає сигнал, агент прокидається й обробляє його.

Треба вибрати, що відповідати тому, хто надіслав сигнал:

Підтвердити одразу — відповідь приходить миттєво, агент працює далі сам. Підходить майже завжди.

Дочекатися відповіді агента — той, хто надіслав сигнал, чекає, доки агент завершить роботу, і отримує його відповідь. Довгі запуски можуть не вкластися в час очікування.

Посилання й секрет

Одразу після створення такого тригера кабінет покаже блок Посилання й секрет для зовнішнього сигналу.

Секрет показуємо один раз

Скопіюйте його зараз і збережіть там, звідки надсилатимете сигнал. Відновити його неможливо — якщо загубиться, доведеться створити тригер заново.

Посилання можна скопіювати й пізніше — воно видно в картці тригера у списку. Секрет — ні.

Щоб закрити блок, треба поставити галочку Секрет збережено в надійному місці. Це навмисно.

Що робити із секретом далі — див. «Для розробника» нижче: цю частину віддайте тому, хто налаштовує вашу систему.

Список тригерів

Кожен тригер у списку показує назву, тип, стан і — другим рядком — коли він спрацює: розклад людською мовою й наступний запуск, проміжок перевірки або «за сигналом ззовні».

Кнопки в рядку:

Кнопка	Що робить
Прогнати зараз	запускає агента негайно, не чекаючи розкладу
Призупинити / Увімкнути	тимчасово вимикає тригер, не видаляючи його
Змінити	відкриває форму редагування
Видалити	прибирає тригер; запуски, які він уже зробив, лишаються в журналі

Перевірити: «Прогнати зараз»

Не чекайте ранку, щоб дізнатись, чи працює нічний звіт.

1. Натисніть Прогнати зараз.
2. У полі Задача для цього запуску можна підправити текст — зміни діють лише на цей запуск, збережена задача тригера залишиться як була.
3. Натисніть Запустити.

Результат з'явиться тут же: відповідь агента або причина збою, а під нею — номер запуску, за яким його легко знайти в журналі.

Це справжній запуск

Він списує кредити так само, як звичайний, і робить усе, що написано в задачі: якщо агент має надіслати листа — надішле.

Автопауза після збоїв

П'ять невдалих запусків поспіль автоматично ставлять тригер на паузу.

Це захист: зламана задача інакше витрачала б кредити цілу ніч. У списку такий тригер має позначку на паузі після N збоїв поспіль, а під ним — пояснення.

Що робити:

1. Відкрийте Запуски й знайдіть невдалі — кнопка Причина біля рядка покаже текст помилки.
2. Виправте те, на що вона вказує: адресу, доступи, саму задачу.
3. Перевірте кнопкою Прогнати зараз.
4. Якщо запуск пройшов — натисніть Увімкнути.

Одиничні збої теж видно

Якщо тригер працює, але останні запуски падали, поруч буде жовта позначка з кількістю збоїв поспіль. Тригер ще живий, але варто зазирнути в журнал.

Журнал запусків

Розділ Запуски — це історія всіх пробудів агента. Кожен рядок: час, тригер, стан (успішно, збій, виконується), тривалість, кредити й токени.

Угорі — три плитки за обраний період: скільки було запусків, скільки витрачено кредитів, скільки збоїв. Період перемикається кнопками Сьогодні · 7 днів · 30 днів · Увесь час, а поруч — фільтр за станом.

Кнопка Деталі (або Причина для збою) розгортає рядок: номер запуску, точний час початку й завершення, токени запиту й відповіді.

Позначки між запусками

Розділ Стан — це місце, де агент лишає собі позначки між запусками: на чому він спинився минулого разу.

Наприклад, номер останнього опрацьованого рахунка — щоб наступного разу почати з наступного, а не з початку.

Зазвичай сюди не треба заходити взагалі: агент веде позначки сам. Але тут їх можна подивитись, виправити чи стерти.

Стерта позначка = робота заново

Якщо стерти позначку, агент вважатиме, що бачить дані вперше, і опрацює їх заново — з усіма повідомленнями та витратами, які з цього випливають.

Щоб змінити: правте поля, потім Зберегти стан. Кнопка Додати позначку створює новий рядок, Стерти всі — очищає все (зміни застосуються після збереження).

Якщо агент змінив стан, поки ви його редагували, кабінет попередить і запропонує Перечитати або Узяти значення з сервера. Ваші зміни при цьому нікуди не зникають.

---

Для розробника

Далі — для того, хто налаштовує систему, яка надсилатиме сигнал.

Формат розкладу

П'ять полів, розділених пробілами:

* * * * *
│ │ │ │ └── день тижня (0–6, неділя = 0)
│ │ │ └──── місяць (1–12)
│ │ └────── день місяця (1–31)
│ └──────── година (0–23)
└────────── хвилина (0–59)

Секунд немає. Скорочень на кшталт @daily теж немає — пишіть повний вираз.

Вираз	Коли спрацює
0 9 * * 1-5	о 9:00 з понеділка до п'ятниці
0 3 * * *	щоночі о 3:00
*/15 * * * *	кожні 15 хвилин
0 */4 * * *	кожні 4 години
30 8 1 * *	о 8:30 першого числа кожного місяця

Розклад рахується в часовому поясі агента, не в UTC.

Вхідний сигнал і підпис

Повний опис — Вебхуки. Коротко: сигнал надсилається на посилання тригера, підписується його секретом, а вхід запуску складається з вашої Задачі запуску плюс сире тіло сигналу.

Далі

Готові набори — щоб не збирати типовий хід із нуля.