Обзор архитектуры¶
Project Factory разделяет доверенный управляющий контур и одноразовый контур исполнения. AI-агент не управляет GitHub и облачной инфраструктурой напрямую: он формирует ограниченные запросы, которые проверяет и выполняет Agent Runner.
ДОВЕРЕННЫЙ КОНТУР
GitHub Issue ────────→ Agent Runner ────────→ GitHub API
│ │ │
│ │ состояние и журнал ├─ ветки
│ │ ├─ комментарии
│ ▼ └─ Pull Request
│ одноразовый запуск
│ │
│ ▼
│ Agent Worker
│ без GitHub-ключей
│ │
└────────────────────┴──→ ветка → preview → приёмка
Основные компоненты¶
| Компонент | Назначение |
|---|---|
| GitHub | Источник задач, обсуждений, кода и Pull Request |
| Agent Runner | Состояние процесса, проверка полномочий и внешние операции |
| Agent Worker | Одноразовая изолированная среда работы AI-агента |
| GitHub Event Service | Доставка изменений Issues и репозиториев |
| Preview Service | Временная среда для проверки конкретной задачи |
| Production Service | Доведение согласованной ревизии до настроенной среды |
Почему Worker одноразовый¶
Когда агент ждёт ответ человека, процесс не должен работать часами или днями. Состояние сессии сохраняется, Worker завершается, а после ответа создаётся новый запуск. Это снижает стоимость простоя и уменьшает продолжительность жизни среды, в которой исполняется код.
Где работает система¶
Worker может запускаться локально в Docker или как Cloud Run Job. Облачный контур использует управляемые сервисы GCP и по возможности масштабируется до нуля. Конкретная топология определяется при подключении проекта.