Рутины

Запускайте работу по расписанию или по вебхуку. Создайте рутину, добавьте триггеры, задайте переменные и правила наложения, запустите её вручную и посмотрите историю.

Veyra Docs TeamОбновлено 2 мин чтенияВерсия 2 · История

Рутина снова и снова создаёт задачу для агента: по расписанию, когда одна из ваших систем вызывает вебхук, или когда вы нажимаете Run now. Используйте её для ежедневных отчётов, еженедельных обзоров, реакций на оповещения — всего, что должно происходить без чьих-либо напоминаний.

Перед началом

Нужно право Manage routines (routines:manage) и хотя бы один агент.

Создайте рутину

  1. Откройте Routines и выберите New routine.
  2. Задайте название, агента, который будет выполнять работу, и при желании проект.
  3. Напишите запрос — описание задачи, которое агент получает при каждом запуске.
  4. Выберите 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

Создайте рутину, добавьте расписание и запустите её:

curl
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 и все методы в разделе Рутины.

ВебхукиРаботаРутины