Регулярные задачи
Регулярная задача принадлежит одному агенту и одному человеку — вызывающему. Пути указаны
относительно /api/workspaces/{workspaceId}/agents/{agentId}.
| Метод | Путь | Что делает |
|---|---|---|
GET |
/routines/ |
Ваши регулярные задачи у этого агента |
POST |
/routines/ |
Создать |
GET |
/routines/{routineId} |
Прочитать одну |
PATCH |
/routines/{routineId} |
Изменить |
DELETE |
/routines/{routineId} |
Удалить |
GET |
/routines/{routineId}/runs |
История запусков |
POST |
/routines/{routineId}/runs |
Запустить сейчас |
Создать регулярную задачу
Заголовок раздела «Создать регулярную задачу»curl -X POST https://<host>/api/workspaces/{workspaceId}/agents/{agentId}/routines/ \ -H "Authorization: Bearer $KATA_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "name": "Утренние обращения", "instruction": "Кратко перескажи новые обращения в поддержку со вчерашнего дня.", "triggers": [{ "kind": "schedule", "spec": { "cron": "0 9 * * MON-FRI" } }] }'| Поле | Обязательное | Примечания |
|---|---|---|
name |
да | |
instruction |
нет | Что агент делает при каждом запуске |
active |
нет | false — приостановить |
triggers |
нет | Расписания: { "kind": "schedule", "spec": { "cron": "…" } } |
Выражения cron проверяются (0 25 * * * отклоняется; @daily и MON-FRI работают) и
вычисляются в часовом поясе пространства.
Запустить сейчас
Заголовок раздела «Запустить сейчас»POST /routines/{routineId}/runs запускает регулярную задачу тем же путём, что и планировщик.
Добавьте ?dryRun (или { "dryRun": true }), чтобы пройти её, ничего не делая
по-настоящему. Возвращается запуск — со статусом 500, если он завершился ошибкой.