> ## Documentation Index
> Fetch the complete documentation index at: https://help.teable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Рутина

> Cuppy виконує промпт за розкладом, а результат кожного запуску видно в історії запусків.

<Note>Доступно на всіх хмарних тарифах; для self-hosted потрібен тариф Business або вищий.</Note>

Рутина передає промпт Cuppy і повторює його за розкладом. Це підходить для роботи, яку ніхто не має запускати вручну: щоденний звіт, регулярне прибирання застарілих записів, тижнева зведення. Кожен запуск — це повноцінний чат з ШІ, тож рутині доступне все те саме, що й чату: читання і запис таблиць, виклик навичок, створення файлів.

Рутина — це ресурс усередині бази, вона стоїть на лівій бічній панелі поруч із таблицями, застосунками та автоматизаціями.

<Info>Автоматизація спрацьовує на подію — зміну запису, надсилання форми, вебхук — і виконує наперед налаштовані кроки. Рутина спрацьовує лише за часом і виконує промпт, який агент тлумачить сам. Беріть автоматизацію, коли потрібні фіксовані кроки й передбачуваний результат; беріть рутину, коли агент має щоразу сам вирішувати, що робити з поточними даними.</Info>

## Створення рутини

<Steps>
  <Step title="Створити">
    На лівій бічній панелі натисніть **+** і виберіть **Нова рутина**.
  </Step>

  <Step title="Написати промпт">
    Опишіть у полі **Промпт**, що має робити кожен запуск. Промпт — це повна інструкція для запуску, тож зазначте джерело даних, порядок обробки та місце для результату. Наприклад: «Збери записи, додані вчора до таблиці Завдання, згрупуй їх за відповідальними і запиши зведення до таблиці Щоденний звіт».
  </Step>

  <Step title="Задати розклад">
    Виберіть частоту в розділі **Розклад** і за потреби вкажіть **Початок** та **Завершення (необов'язково)**.
  </Step>

  <Step title="Активувати">
    Натисніть **Активувати**. Конфігурація має бути збережена, а в розкладі має бути хоча б один майбутній запуск.
  </Step>
</Steps>

## Налаштування

Крім промпта й розкладу, форма містить такі налаштування:

| Налаштування                                 | Опис                                                                                                                                                                                                                 |
| -------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Модель**                                   | Модель і рівень інтелекту, на яких працює ця рутина. Залиште **Модель за замовчуванням**, щоб використати модель чату, задану в просторі                                                                             |
| **Максимальний час виконання (хвилини)**     | Запуск понад цю межу переривається і позначається як невдалий. Від 5 до 120 хвилин, за замовчуванням 30                                                                                                              |
| **Чат**                                      | **Новий чат для кожного запуску** лишає запуски незалежними один від одного; **Продовжити чат попереднього запуску** переносить контекст минулих запусків і підходить для роботи, якій потрібен попередній результат |
| **Початок** / **Завершення (необов'язково)** | Межі розкладу. Без часу завершення рутина працює безстроково                                                                                                                                                         |

Модель і рівень інтелекту фіксуються під час збереження, тому в історії запусків видно, на чому фактично працював кожен запуск.

### Розклад

Частоту можна вибрати з готових варіантів: **Щогодини** із зазначенням хвилини, **Щодня** і **У будні** із зазначенням часу, **Щотижня** із зазначенням дня тижня й часу, **Щомісяця** із зазначенням числа й часу.

Для точніших умов виберіть **Користувацька (RRULE)** і напишіть правило RFC 5545, наприклад `FREQ=DAILY;BYHOUR=9;BYMINUTE=0`. Користувацьке правило має такі обмеження:

* Частота має бути `HOURLY`, `DAILY`, `WEEKLY`, `MONTHLY` або `YEARLY`, а між двома запусками має бути щонайменше 1 година.
* Дозволені `INTERVAL`, `COUNT`, `BYDAY`, `BYMONTHDAY`, `BYMONTH`, а також по одному `BYMINUTE` і `BYHOUR`. Максимум для `COUNT` — 1000, а `COUNT` чи `INTERVAL` потребують заданого часу в полі **Початок**.
* Часовий пояс і межі задаються формою, тому `TZID`, `DTSTART`, `UNTIL` і `BYSECOND` відхиляються.

Розклад із єдиним запуском записують користувацьким правилом із `COUNT=1`.

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

## Чернетки, оновлення та запуск вручну

Нова рутина — це чернетка, і за розкладом вона не запускається, доки ви її не активуєте. Коли ви редагуєте активну рутину, зміна теж зберігається чернеткою, а робоча версія продовжує працювати з попередньою конфігурацією: натисніть **Оновити**, щоб застосувати її, або **Відхилити зміни**, щоб відмовитися.

**Запустити зараз** виконує рутину один раз, не чекаючи на розклад, — так зручно перевіряти промпт. Доки попередній запуск не завершився, запустити рутину вручну ще раз не вийде.

Щоб зупинити рутину, вимкніть перемикач. Розклад більше не спрацьовуватиме, а наявна історія запусків збережеться.

## Історія запусків

Відкрийте рутину і перейдіть на вкладку **Історія запусків**. Список запусків фільтрується за статусом і періодом, що допомагає знайти конкретний збій; у вибраного запуску видно запланований час, час початку й завершення, тривалість і повний чат цього запуску.

Запуски позначаються як **У черзі**, **Виконується**, **Завершено**, **Помилка** або **Скасовано**. **Скасовано** з'являється, коли запуск хтось перервав або коли рутину чи її базу було видалено.

Запуск зі статусом **Помилка** зазначає причину, і кожна причина потребує свого рішення:

| Повідомлення                                | Значення                                                         | Що робити                                                                                                       |
| ------------------------------------------- | ---------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| **Запуск завершився помилкою**              | Запуск почався, але натрапив на помилку                          | Відкрийте чат цього запуску і за місцем збою визначте, справа в промпті чи в даних                              |
| **Час виконання минув**                     | Запуск перевищив **Максимальний час виконання** і був перерваний | Збільште **Максимальний час виконання** або розбийте промпт на менші порції роботи                              |
| **Пропущено: недостатньо кредитів**         | Кредити скінчилися, запуск не почався                            | Поповніть кредити простору                                                                                      |
| **Пропущено: попередній запуск ще тривав**  | Попередній запуск не завершився, тому це спрацювання пропущено   | Зменште частоту або скоротіть обсяг роботи одного запуску                                                       |
| **Пропущено: минув час очікування в черзі** | Запуск задовго чекав у черзі й був пропущений                    | Поодинокий випадок нічого не потребує; якщо повторюється, на один час заплановано забагато — рознесіть розклади |

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

<Info>Для перегляду історії запусків потрібне право редагувати рутину. Власник і творець бази можуть створювати, редагувати та видаляти рутини; решта співавторів має доступ лише на читання.</Info>

## Сповіщення про помилки та автоматична зупинка

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

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

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

## Часті запитання

<AccordionGroup>
  <Accordion title="Чи витрачають рутини кредити?">
    Так. Кожен запуск — це чат з ШІ, він списується з кредитів простору за фактичною витратою і потрапляє до розділу **Кредити використання** на сторінці оплати під типом **Рутина**. За браку кредитів запуск пропускається і надходить сповіщення, а повторні пропуски призводять до зупинки рутини.
  </Accordion>

  <Accordion title="Чи вплине зміна промпта на запуск, що вже триває?">
    Ні. Зміна зберігається чернеткою і потрапляє до робочої версії лише після натискання **Оновити**. Запуск, що вже почався, лишається з тією конфігурацією, з якою стартував.
  </Accordion>

  <Accordion title="Чи запускаються самі рутини в базі, встановленій із шаблону?">
    Так. Після встановлення шаблону його рутини вмикаються так само, як і його робочі процеси. Розклад без майбутніх запусків лишається чернеткою.
  </Accordion>

  <Accordion title="Чи зростатиме контекст нескінченно, якщо продовжувати чат попереднього запуску?">
    Коли контекст наближається до межі, Teable ущільнює чат, тож запуски через це не перериваються. Виберіть **Новий чат для кожного запуску**, якщо кожен запуск має починатися з чистого контексту.
  </Accordion>
</AccordionGroup>
