Демон и среды выполнения
Агенты не работают на серверах AACWorkflow — они работают на ваших собственных машинах.
В AACWorkflow агенты не работают на наших серверах — они работают на ваших собственных машинах, управляемые небольшой программой под названием демон, которая запускает инструменты AI-разработки, установленные локально. Сервер AACWorkflow только координирует: он хранит issues, ставит задачи в очередь и отправляет их в нужную среду выполнения (среда выполнения = демон × один инструмент AI-разработки).
Эта архитектура — главное отличие AACWorkflow от Linear / Jira: ваши API-ключи, инструменты и директории с кодом остаются на вашей машине — сервер AACWorkflow никогда их не видит. Поэтому «мой агент не работает» почти всегда локальная проблема — демон не запущен, инструмент AI не установлен, ключ истёк. Проверяйте локально в первую очередь; см. Устранение неполадок.
Запуск демона
Демон — часть CLI AACWorkflow. После установки CLI AACWorkflow запустите на своей машине:
aacworkflow daemon startПри запуске он делает четыре вещи:
- Читает учётные данные, сохранённые при входе
- Обнаруживает инструменты AI-разработки, установленные в
PATH(16 встроенных: Antigravity, Claude Code, CodeBuddy, Codex, Cursor, Copilot, Hermes, Kimi, Kiro CLI, OpenCode, OpenClaw, Pi, Qoder, Trae CLI, DevEco Code, Grok) - Регистрируется на сервере вместе со средой выполнения для каждого обнаруженного инструмента
- Опрашивает сервер каждые 30 секунд на наличие задач и отправляет heartbeat каждые 15 секунд
Основные команды:
| Команда | Назначение |
|---|---|
aacworkflow daemon start | Запуск (по умолчанию в фоне; добавьте --foreground для запуска на переднем плане) |
aacworkflow daemon stop | Остановка |
aacworkflow daemon restart | Перезапуск |
aacworkflow daemon status | Показать статус |
aacworkflow daemon logs | Показать логи (добавьте -f для отслеживания) |
Полная справка CLI в CLI commands.
Десктопное приложение поставляется с демоном. Если вы используете десктопное приложение, вам не нужно запускать aacworkflow daemon start вручную — оно запускает демон автоматически при старте. См. страницу Десктопное приложение для выбора подходящего варианта.
Почему на одной машине несколько сред выполнения
Среда выполнения — это не сервер и не контейнер — это комбинация «демон × один инструмент AI-разработки». Например: вы запускаете демон на MacBook с установленными Claude Code и Codex, и вы участник двух рабочих пространств. AACWorkflow регистрирует 4 среды выполнения:
Ключевые моменты:
- Один демон может соответствовать нескольким средам выполнения — по одной на каждую комбинацию установленного инструмента и рабочего пространства
- Один и тот же демон, рабочее пространство и инструмент дают ровно одну среду выполнения — перезапуск демона никогда не создаёт дубликатов
- Страница Среды выполнения в интерфейсе AACWorkflow показывает эти строки
Облачные среды выполнения уже в разработке, сейчас на стадии листа ожидания. Когда они станут доступны, вы сможете выполнять задачи агентов напрямую в AACWorkflow Cloud без запуска локального демона. Запишитесь с помощью email на странице загрузки, чтобы получить уведомление.
Когда среда выполнения помечается как офлайн
AACWorkflow использует heartbeat-ы для определения, в сети ли среда выполнения. Три ключевых значения:
| Событие | Порог |
|---|---|
| Частота heartbeat демона | Каждые 15 секунд |
| Помечается как отсутствующая | Нет heartbeat 45 секунд (3 пропущенных сигнала) |
| Автоудаление | Отсутствует без связанных агентов более 7 дней |
Статус «отсутствует» не постоянен — как только демон отправляет следующий heartbeat, он возвращается в онлайн, и запись среды выполнения сохраняется. Перезапуск демона не приводит к потере сред выполнения.
Задачи, выполняющиеся на отсутствующей среде выполнения, помечаются как failed (причина сбоя runtime_offline). Для источников с повтором (issues, чат) AACWorkflow автоматически переставляет их в очередь; задачи, запущенные Автопилотом, не повторяются автоматически. См. Задачи → Какие сбои повторяются автоматически.
Сколько задач может выполняться параллельно
AACWorkflow применяет ограничения параллелизма на двух уровнях:
- Уровень демона: 20 одновременных задач по умолчанию (настраивается через переменную окружения
AACWORKFLOW_DAEMON_MAX_CONCURRENT_TASKS) - Уровень агента: 6 одновременных задач на агента по умолчанию (настраивается для каждого агента)
Побеждает более жёсткое из двух. Если ваш демон уже выполняет 20 задач, новые задачи ждут, даже если у агента ещё есть запас.
Если вы видите задачи, застрявшие в queued и не переходящие в dispatched, обычно исчерпан один из этих двух лимитов.
Что происходит с выполняемыми задачами после сбоя демона
Когда демон падает или принудительно завершается, задачи, которые он взял, остаются в статусе dispatched или running. При следующем запуске демон сообщает серверу: «эти задачи больше не мои, пожалуйста, пометь их как failed». Сервер переводит их в failed с причиной runtime_recovery — для источников с повтором задачи автоматически переставляются в очередь.
Даже если этот шаг не сработает из-за сетевой проблемы, есть серверная проверка каждые 30 секунд в качестве подстраховки: любая среда выполнения без heartbeat более 45 секунд помечается как отсутствующая, и её задачи возвращаются вместе с ней.
Устранение неполадок с неработающими агентами
Когда вы сталкиваетесь с проблемой «мой агент не работает», выполните эту трёхшаговую проверку:
- Выполните
aacworkflow daemon status— убедитесь, что демон запущен и в сети - Выполните
aacworkflow daemon logs -f— проверьте наличие ошибок - Откройте страницу Среды выполнения в интерфейсе AACWorkflow — убедитесь, что ваша среда выполнения показывает «онлайн»
Больше сценариев в Устранение неполадок.
Далее
- Задачи — полный жизненный цикл задачи после того, как демон её подхватывает
- Матрица инструментов — различия в возможностях между 12 инструментами AI-разработки
Отряды (Squads)
Отряд — это группа агентов (и, опционально, людей-участников) под руководством одного назначенного агента-лидера. Назначьте задачу отряду, и лидер решит, кто возьмёт её в работу.
Установка среды выполнения агента
AACWorkflow управляет любыми AI-инструментами для кодинга, установленными на вашей машине. Эта страница показывает, как установить каждый из 16 поддерживаемых инструментов, чтобы демон мог их обнаружить.