Задачи
Задачи позволяют агентам и воркфлоу создавать follow-up действия: напоминания, поручения людям или автоматический запуск процессов по расписанию.
Основные возможности
- Напоминания — агент ставит напоминание пользователю, которое приходит обратно в чат в указанное время
- Поручения — назначить задачу на сотрудника с описанием и сроком
- Автозапуск процессов — запланировать запуск воркфлоу на определённое время или по расписанию (cron)
- Повторяющиеся задачи — cron-расписание для регулярных операций (заменяет раздел «Планировщик»)
- Доставка результатов — результат выполнения может вернуться в тред агенту или на webhook
Кто создаёт задачи
| Источник | Как | Пример |
|---|---|---|
| Агент | Через инструменты set_reminder, assign_task, schedule_workflow | «Напомни мне через 10 минут про звонок» |
| Пользователь | Через интерфейс (кнопка «Новая задача») | Вручную создать задачу на сотрудника |
| Воркфлоу | Через ноду «Задача» в визуальном редакторе | Воркфлоу обработки формы создаёт follow-up |
| API | POST /api/organizations/{org_id}/tasks (с project_id в body) | Внешняя интеграция |
Страница задач
Раздел Задачи доступен в боковом меню внутри проекта. На странице отображается таблица всех задач с фильтрами.
Колонки таблицы
| Колонка | Описание |
|---|---|
| Название | Название задачи + индикаторы (cron, авто) |
| Статус | Текущее состояние задачи |
| Приоритет | Низкий / Средний / Высокий / Срочный |
| Исполнитель | Имя человека или название процесса |
| Срок / Расписание | Дата или cron-выражение |
| Запуски | Статистика успешных/неуспешных запусков |
| Источник | Кто создал: Агент / Вручную / Процесс |
Статусы задач
| Статус | Описание |
|---|---|
| Открыта | Задача создана, ожидает выполнения |
| В работе | Задача взята в работу |
| Заблокирована | Выполнение приостановлено |
| На проверке | Задача выполнена, ожидает проверки |
| Выполнена | Задача завершена |
| Отменена | Задача отменена |
Фильтры
- Все статусы / конкретный статус
- Все задачи / Мои задачи (назначенные на текущего пользователя)
- Поиск по названию
История запусков
Для задач с автозапуском или повторяющихся задач доступна история запусков — раскройте строку задачи в таблице. По каждому запуску видны статус, время старта/завершения и Execution ID. Execution ID кликабелен — клик открывает трейс этого запуска в разделе Трассировка. Кнопка Показать ещё подгружает более ранние запуски.
Создание задачи
Нажмите Новая задача в правом верхнем углу. Форма в боковой панели подстраивается под выбранный тип исполнителя — лишние поля не показываются.
Шаг 1. Тип исполнителя
Вверху — переключатель Процесс | Человек (по умолчанию выбран «Процесс»). От него зависит набор полей:
- Человек — задача-поручение: только исполнитель, название, описание, приоритет и срок.
- Процесс — задача запускает воркфлоу: дополнительно появляются настройки процесса, повторение и доставка результата.
Общие поля
- Исполнитель — сотрудник организации (для «Человек») или процесс проекта (для «Процесс»). Для процесса поле обязательно — без выбранного воркфлоу задачу не создать.
- Название — что нужно сделать (обязательно).
- Описание — подробности.
- Приоритет — Низкий / Средний / Высокий / Срочный (визуальная метка; на порядок запуска не влияет).
- Срок выполнения — дата и время. Нельзя выбрать прошедшее время.
Настройки процесса
Раздел виден только для типа «Процесс» (важные поля показаны сразу, без сворачивания):
- Авто-запуск — автоматически запустить воркфлоу по наступлению срока или расписания. Без авто-запуска процесс-задача сама не стартует — её можно запустить только вручную кнопкой «Запустить сейчас».
- Параметры процесса (JSON) — входные данные для воркфлоу (доступны как
variables.input).
Повторение
Переключатель Повторять (только для «Процесс») раскрывает поля расписания:
- Шаблон — быстрый выбор частоты, который заполняет cron-выражение.
- Cron-выражение — расписание в формате cron; синтаксис проверяется прямо в форме. Подробнее — Cron-конфигурация.
- Часовой пояс — для корректного расчёта времени.
- Параллельный запуск — «Пропустить» (по умолчанию) или «Разрешить».
Доставка результата
Только для типа «Процесс»:
- Ничего не делать — только обновить статус задачи.
- Ответить в тред агенту — вернуть результат в чат (используется для напоминаний).
- Webhook — POST на указанный URL. Адрес проверяется: внутренние и приватные адреса (loopback, локальная сеть, cloud-метаданные) запрещены.
Название — всегда. Исполнитель — для типа «Процесс». Cron-выражение — при включённом повторении. Webhook URL — при доставке «Webhook». Срок выполнения, если задан, не может быть в прошлом.
Просмотр и редактирование задачи
Кликните на задачу в таблице — откроется боковая панель с деталями. В шапке — название и теги статуса/приоритета в одну строку.
Действия
- Запустить сейчас — для процесс-задач: немедленно запустить воркфлоу вручную, не дожидаясь срока или расписания. Создаётся запись в истории запусков.
- Выполнить / Остановить — пометить задачу выполненной. Для повторяющейся задачи кнопка называется «Остановить»: пометка как выполненной снимает её с расписания — cron больше не сработает.
- Изменить статус — выбрать любой статус из выпадающего списка.
- Переименование — клик по карандашу рядом с названием; описание редактируется кликом по тексту.
Удаление задач делается со страницы списка: отметьте строки галочками и нажмите «Удалить» (в детальной карточке кнопки удаления нет).
Ниже в карточке — основная информация (исполнитель, срок, приоритет, источник, автор), статистика запусков (всего / успешно / ошибок) и сворачиваемые технические детали: параметры процесса, расписание и адрес webhook.
Инструменты агента
Когда в настройках агента включены задачи, агент получает три инструмента:
set_reminder
Создаёт напоминание, которое вернётся в чат в указанное время.
Пользователь: Напомни мне через 30 минут про встречу
Агент: [вызов set_reminder] → Напоминание создано на 14:30
... через 30 минут ...
Агент: Напоминание: у вас встреча через 30 минут
assign_task
Назначает задачу на сотрудника.
Пользователь: Поставь задачу Ивану — подготовить отчёт до пятницы
Агент: [вызов assign_task] → Задача создана и назначена на Ивана
schedule_workflow
Планирует запуск процесса на определённое время.
Пользователь: Запусти процесс генерации отчёта завтра в 9 утра
Агент: [вызов schedule_workflow] → Процесс запланирован на 09:00
Повторяющиеся задачи (cron)
Задачи могут выполняться по расписанию с помощью cron-выражений. Подробнее — в разделе Cron-конфигурация.
Повторяющиеся задачи заменяют раздел «Планировщик» (Schedules) и предоставляют те же возможности:
- Cron-расписание с поддержкой часовых поясов
- Статистика запусков (всего / успешно / ошибок)
- Авто-запуск привязанного воркфлоу
- История выполнения
Доставка результатов
После завершения задачи результат может быть доставлен:
| Действие | Описание |
|---|---|
| Ничего | Только обновить статус задачи |
| В тред | Отправить результат обратно в чат агенту — он сформулирует ответ пользователю |
| Webhook | POST на указанный URL с данными о результате |
Доставка «В тред» работает через Published API — агент получает результат как сообщение в существующем треде и отвечает пользователю через тот же канал (Telegram, веб-чат, API).
Для напоминаний агент автоматически выбирает доставку «В тред» — результат вернётся в чат без дополнительной настройки.