Перейти к основному содержимому

Задачи

Задачи позволяют агентам и воркфлоу создавать follow-up действия: напоминания, поручения людям или автоматический запуск процессов по расписанию.

Основные возможности

  • Напоминания — агент ставит напоминание пользователю, которое приходит обратно в чат в указанное время
  • Поручения — назначить задачу на сотрудника с описанием и сроком
  • Автозапуск процессов — запланировать запуск воркфлоу на определённое время или по расписанию (cron)
  • Повторяющиеся задачи — cron-расписание для регулярных операций (заменяет раздел «Планировщик»)
  • Доставка результатов — результат выполнения может вернуться в тред агенту или на webhook

Кто создаёт задачи

ИсточникКакПример
АгентЧерез инструменты set_reminder, assign_task, schedule_workflow«Напомни мне через 10 минут про звонок»
ПользовательЧерез интерфейс (кнопка «Новая задача»)Вручную создать задачу на сотрудника
ВоркфлоуЧерез ноду «Задача» в визуальном редактореВоркфлоу обработки формы создаёт follow-up
APIPOST /api/organizations/{org_id}/tasksproject_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-расписание с поддержкой часовых поясов
  • Статистика запусков (всего / успешно / ошибок)
  • Авто-запуск привязанного воркфлоу
  • История выполнения

Доставка результатов

После завершения задачи результат может быть доставлен:

ДействиеОписание
НичегоТолько обновить статус задачи
В тредОтправить результат обратно в чат агенту — он сформулирует ответ пользователю
WebhookPOST на указанный URL с данными о результате

Доставка «В тред» работает через Published API — агент получает результат как сообщение в существующем треде и отвечает пользователю через тот же канал (Telegram, веб-чат, API).

Совет

Для напоминаний агент автоматически выбирает доставку «В тред» — результат вернётся в чат без дополнительной настройки.