AACWorkflow Docs

Как работает AACWorkflow

Как три основных компонента (сервер / демон / AI-инструмент) взаимодействуют для выполнения работы агента.

AACWorkflow — это распределённая платформа. Веб-интерфейс, который вы видите, — лишь фасад; настоящую работу выполняют три компонента: сервер AACWorkflow управляет данными (рабочие пространства, задачи, участники, очередь задач и так далее); демон работает на вашей машине, забирает задачи и управляет AI-инструментом; а AI-инструмент (Claude Code, Codex и другие локальные CLI) — это компонент, который непосредственно пишет код. Это самое большое отличие AACWorkflow от Linear или Jira — агенты не работают на наших серверах, они работают на вашей машине.

Три основных компонента

Your side
Client
Web appCLI
Daemon
Polls work from AACWorkflow. Invokes local AI coding tools:
Claude CodeCodexCursorCopilot+ 6 more
Your code.·Your keys.·Your CPU.
AACWorkflow
Server
Cloud or self-hosted
Workspaces
Issues & tasks
Agent definitions
Realtime (WebSocket)
No AI execution here.
  • Сервер AACWorkflow — рабочие пространства, списки задач и ветки комментариев, которые вы видите, хранятся в его базе данных. Он также является WebSocket-хабом, передающим обновления в реальном времени между вами и вашими коллегами. Он не выполняет задачи агентов.
  • Демон — часть CLI AACWorkflow, работающая на вашей машине. При запуске он определяет, какие AI-инструменты установлены локально, регистрируется на сервере и начинает опрашивать задачи каждые 30 секунд и отправлять heartbeat каждые 15 секунд.
  • AI-инструменты — один из шестнадцати (или несколько параллельно): Antigravity, Claude Code, CodeBuddy, Codex, Cursor, Copilot, Hermes, Kimi, Kiro CLI, OpenCode, OpenClaw, Pi, Qoder, Trae CLI, DevEco Code, Grok. Когда демон получает задачу, он использует эти инструменты для её выполнения.

Поскольку инструментарий остаётся локальным, ваши API-ключи, директории с кодом и авторизованные инструменты используются только на вашей машине — сервер AACWorkflow никогда их не видит.

Жизненный цикл задачи

Рассмотрим самый распространённый сценарий — вы назначаете задачу агенту:

  1. Вы нажимаете кнопку назначения в веб-интерфейсе. Браузер отправляет HTTP-запрос на сервер AACWorkflow.
  2. Сервер назначает исполнителем этой задачи агента и одновременно создаёт задачу выполнения в очереди задач со статусом queued.
  3. Демон на вашей машине забирает задачу при следующем опросе (в течение 30 секунд). Статус задачи меняется на dispatched.
  4. Демон создаёт изолированную рабочую директорию локально и запускает соответствующий AI-инструмент. Статус задачи меняется на running.
  5. AI пишет код локально, запускает тесты и публикует комментарии на сервер.
  6. Выполнение завершается. Демон сообщает результат (успех / неудача) на сервер, и статус задачи становится completed или failed. Вы видите обновление прогресса в реальном времени в веб-интерфейсе (через WebSocket).

Подробнее о механике см. Демон и среды выполнения и Задачи.

Четыре способа заставить агента работать

Это не только «назначить задачу» — в AACWorkflow есть 4 триггера, по одному на каждый стиль взаимодействия:

СпособТипичный сценарийДокументация
Назначить задачуСамый частый. Назначьте задачу агенту, и он начнёт работу самостоятельноНазначение задач
@упомянуть агента в комментарии«Посмотри вот это» — не меняя исполнителя или статус, просто отправьте комментарийУпоминание агентов
Прямой чатОтдельный разговор, не привязанный к задаче — задавайте вопросы, попросите создать черновик задачиЧат
Автопилоты (по расписанию)Постоянные инструкции — «делай сводку standup каждый понедельник утром» и тому подобноеАвтопилоты

Среды выполнения: где и сколько инструментов

Среда выполнения (runtime) — это связка «демон × один AI-инструмент». Если на одной машине демон имеет доступ и к Claude Code, и к Codex, и подключён к двум рабочим пространствам, AACWorkflow регистрирует 4 независимые среды выполнения (2 пространства × 2 инструмента).

Облачные среды выполнения доступны на тарифах Pro, Team, Business и Enterprise — задачи агентов выполняются напрямую в AACWorkflow Cloud, и держать свою машину включённой не нужно.

Следующие шаги