Рутины
Запускайте работу по расписанию или по вебхуку. Создайте рутину, добавьте триггеры, задайте переменные и правила наложения, запустите её вручную и посмотрите историю.
Рутина снова и снова создаёт задачу для агента: по расписанию, когда одна из ваших систем вызывает вебхук, или когда вы нажимаете Run now. Используйте её для ежедневных отчётов, еженедельных обзоров, реакций на оповещения — всего, что должно происходить без чьих-либо напоминаний.
Перед началом
Нужно право Manage routines (routines:manage) и хотя бы один агент.
Создайте рутину
- Откройте Routines и выберите New routine.
- Задайте название, агента, который будет выполнять работу, и при желании проект.
- Напишите запрос — описание задачи, которое агент получает при каждом запуске.
- Выберите Create. Рутина создана, но ничего не делает, пока у неё нет триггера или вы не запустите её сами.
Переменные
Чтобы объявить переменную, напишите в запросе {{name}}, например Summarize tickets from {{week}}. У каждой переменной может быть подпись, тип (текст, число, да/нет, выбор, дата), значение по умолчанию и переключатель Required. Запуск должен передать каждую обязательную переменную без значения по умолчанию.
Добавьте триггер
Откройте раздел рутины Triggers и выберите Add trigger.
| Тип | Когда запускает | Настройки |
|---|---|---|
| Schedule | Когда наступает время по cron-выражению в выбранном часовом поясе. | Cron-выражение, часовой пояс. |
| Webhook | Когда ваша система отправляет подписанный запрос на URL триггера. | Режим подписи, окно защиты от повторов. |
| API | Когда кто-то вызывает метод запуска с этим триггером. | Нет. |
Расписание 0 9 * * 1-5 с часовым поясом Europe/Istanbul срабатывает в 09:00 по стамбульскому времени каждый будний день.
Для вебхука консоль показывает URL и — один раз — секрет. Отправитель подписывает им каждый запрос. Вебхукам посвящена отдельная страница: Вебхук запуска рутины.
Когда запуски накладываются
Выберите, что делать, если подошло время нового запуска, а предыдущий ещё работает:
| Настройка | Результат |
|---|---|
| Coalesce if active | Новый запуск объединяется с активным вместо того, чтобы начинать ещё один. |
| Skip if active | Новый запуск пропускается и записывается как пропущенный. |
| Always enqueue | Каждый запуск сохраняется и начинается в свою очередь. |
И что делать с запусками, пропущенными, пока рутина была приостановлена:
| Настройка | Результат |
|---|---|
| Skip missed | Пропущенные запуски отбрасываются. |
| Enqueue missed (with a cap) | Пропущенные запуски создаются при возобновлении — до заданного предела. |
Запуск вручную
Выберите Run now, заполните переменные, если они есть, и подтвердите. Запуск сразу создаёт свою задачу.
Что делает запуск
Каждый запуск создаёт одну задачу, назначенную агенту рутины (или агенту, выбранному для этого запуска), и будит этого агента. Задача обычная: за ней можно следить, отвечать в ней и видеть её стоимость. Ограничения приостановки, доступа и бюджета по-прежнему действуют, поэтому рутина никогда не тратит больше бюджета.
История и ревизии
- Runs перечисляет все запуски с источником (расписание, вебхук, API или вручную), статусом и созданной задачей.
- History перечисляет версии настроек: каждое изменение запроса, агента или триггеров создаёт ревизию, которую можно восстановить.
Приостановка и архивирование
Установите статус Paused, чтобы остановить новые запуски, сохранив триггеры, или Archived, чтобы вывести рутину из работы. Вызовы вебхука к приостановленной или архивной рутине отклоняются с кодом 409.
Через API
Создайте рутину, добавьте расписание и запустите её:
ROUTINE_ID=$(curl -s -X POST "https://intelligence-api.veyra.so/api/companies/$COMPANY_ID/routines" \
-H "Authorization: Bearer $VEYRA_API_KEY" -H "Content-Type: application/json" \
-d '{"title": "Weekly support summary", "description": "Summarize tickets from {{week}}.", "assigneeAgentId": "'"$AGENT_ID"'"}' | jq -r .id)
curl -X POST "https://intelligence-api.veyra.so/api/routines/$ROUTINE_ID/triggers" \
-H "Authorization: Bearer $VEYRA_API_KEY" -H "Content-Type: application/json" \
-d '{"kind": "schedule", "cronExpression": "0 9 * * 1", "timezone": "Europe/Istanbul"}'
curl -X POST "https://intelligence-api.veyra.so/api/routines/$ROUTINE_ID/run" \
-H "Authorization: Bearer $VEYRA_API_KEY" -H "Content-Type: application/json" \
-d '{"source": "api", "variables": {"week": "2026-W46"}, "idempotencyKey": "support-2026-w46"}'Повторный idempotencyKey возвращает первый запуск вместо нового, поэтому повторы безопасны.
См. Create a routine, Create a routine trigger, Manually run a routine и все методы в разделе Рутины.