Триггеры и каналы

В узле trigger (DAG) или в определении Orchestrator задаётся trigger_kind:

• manual — ручной запуск через интерфейс (кнопка «Запустить»)
• webhook — HTTP POST на endpoint системы
• email — при новом письме в папке IMAP; нужен provider_credential_uuid и mailbox
• telegram — при сообщении в Telegram; нужен provider_credential_uuid (Telegram-бот)
• cron — по расписанию; нужен cron_schedule (формат: минута час день месяц день_недели)

UUID учётных данных получают в разделе Учётные данные или через Setup Assistant (setup_list_provider_credentials).

При получении сообщения в Telegram бота система автоматически проверяет, какие системы агентов используют этот бот, и создаёт запуск для каждой из них. Во вход (run.input) попадают message, chat_id и метаданные триггера.

Настройка в DAG:

{
  "id": "trigger_1",
  "type": "trigger",
  "data": {
    "trigger_kind": "telegram",
    "provider_credential_uuid": "uuid-telegram-бота"
  }
}

Настройка в Orchestrator: в definition укажите trigger_kind: "telegram" и provider_credential_uuid.

Один и тот же Telegram-бот может использоваться и чат-агентом (через каналы), и системами агентов — оба механизма работают параллельно.

Письма опрашиваются по расписанию (каждые 5 минут). При появлении новых писем в указанной папке IMAP создаётся запуск системы. Во вход попадают email (subject, from, body_text и др.) и trigger.

Настройка в DAG:

{
  "id": "trigger_1",
  "type": "trigger",
  "data": {
    "trigger_kind": "email",
    "provider_credential_uuid": "uuid-imap-учётки",
    "mailbox": "INBOX"
  }
}

Поддерживаются учётные данные типа email_imap, gmail_imap, yandex_imap. Папка mailbox по умолчанию — INBOX.

Системы с trigger_kind: "cron" и заполненным cron_schedule проверяются фоновым заданием. В заданное время создаётся запуск с input["message"].

Формат: минута час день_месяца месяц день_недели, например 0 9 * * * — каждый день в 9:00.

Для систем с trigger_kind: "webhook" доступен endpoint, принимающий HTTP POST. Тело запроса становится run.input. URL и детали см. в разделе API и на странице системы агентов.