Флоу агентов
Как работает агент
Агент это схема из узлов и связей. Схема не исполняется как жёсткая программа: это бриф для ИИ-оркестратора. Оркестратор читает схему, выполняет шаги по порядку, вызывает навыки, выбирает ветку по условию и отмечает каждый пройденный узел. Поэтому шаг можно описать обычными словами, а оркестратор сам подставит аргументы навыкам.
Один запуск агента это отдельная служебная сессия с рабочей папкой. Всё, что агент создаёт, остаётся в результатах запуска.
Узлы
| Узел | Подсказка в палитре | Что настраивается |
|---|---|---|
| Старт | Запуск агента | Описание старта для оркестратора |
| Шаг | Инструкция агенту | Инструкция обычными словами |
| Навык | Вызов кода | Способность из реестра, бриф, аргументы: подставит ИИ или фиксированные |
| Условие | Ветка да / нет | Вопрос или условие. Два выхода: да и нет |
| Ветвление | Несколько выходов | Выходы с подписью и условием для ИИ, выход «иначе» |
| Ожидание | Пауза, затем продолжить | Длительность паузы и комментарий |
| Финиш | Завершение графа | Что резюмировать на финише |
Узлы добавляются кликом или перетаскиванием из палитры. Связь удаляется кликом и клавишей Delete или двойным кликом.
Пример
Как агент запускается
Вручную
Кнопка Запустить в карточке агента или пробный запуск в Студии.
По расписанию
Каждые N минут, ежедневно, по дням недели или по числу месяца в заданное время.
По вебхуку
Внешняя система вызывает адрес агента с секретным токеном.
Из фонового сервиса
Сервис вызывает ctx.startAgentJob, например на новое письмо.
Из чата
Ассистент поручает задачу агенту как саб-агенту и ждёт результат.
Расписание задаётся формой, а не строкой cron: интервал в минутах, время для ежедневного запуска, дни недели и время, число месяца и время.
Что доступно оркестратору
- Навыки пакетов со scope
agent. - Инструменты MCP, правила и файлы рабочей папки.
- Запуск другого агента как саб-агента. Саб-агент не запускает своих саб-агентов.
- Служебные инструменты флоу: состояние графа, отметка шага, пауза до времени, прерывание запуска.
Статусы запуска
| Статус | Что значит |
|---|---|
| queued | В очереди |
| running | Выполняется |
| waiting | Пауза на узле «Ожидание» |
| succeeded | Успешно |
| failed | Ошибка |
| cancelled | Отменён |
Сохранение и ревизии
У агента нет черновика и публикации. Сохранение сразу обновляет схему и увеличивает номер ревизии. Следующий запуск пойдёт по новой схеме.
Пробный запуск
Блок Пробный запуск в редакторе запускает агента на платформе. Кнопка Открыть полный прогон показывает ход оркестратора, отмеченные узлы и артефакты.
Настройки агента
Агент может ссылаться на ключи реестра настроек. При запуске значения приходят в контекст как ctx.settings. В карточке агента видно, каких записей в реестре не хватает.