Архитектура

Создано для масштаба

13 крейтов рабочего пространства, иерархическая координация, долговечные сессии и надёжное хранение

12
workspace crates
51+11
built-in + browser & computer tools
7
search backends
20
parallel agents max

01Обзор системы

Один рантайм — любой интерфейс

Каждый слой создан под свою задачу. Вместе они образуют рантайм в вашем контуре для планирования, делегирования, инструментов, памяти, управления и интерфейсов оператора.

coreconfig · bootstrap · errors
llmprovider abstraction · streaming
agentloop · fan-out · goal mode
tools63 built-in + browser + computer (up to 75)
mcpclient + server
persistenceSQLite WAL
serverHTTP · SSE
tuiterminal UI
memorysemantic store
Tokio JoinSet Swarm Coordinator DAG

Fig 2.1 — Swarm Coordinator: Tokio JoinSet DAG execution across 4 parallel CPU worker pods with fair-share token budgeting and disk-spill memory scaling.

02Подробнее

14 столпов архитектуры

01

Мультиагентная оркестрация

Координатор разбивает сложные задачи на параллельные подзадачи. Специализированные воркеры одновременно выполняют исследования, пишут код и работают за компьютером, затем синтезируя единый структурированный результат.

Координатор → Исследователи × N → Автор
02

Управление контекстом

Двухфазное сжатие держит контекст чистым: микродедупликация убирает избыточные выводы инструментов, затем суммаризация с помощью LLM сжимает длинную историю. Защита от частых колебаний предотвращает быстрые изменения объёма токенов между ходами.

Микродедуп → Суммаризация LLM → Защита от колебаний
03

Безопасность

Встроенные SSRF-защиты блокируют доступ к внутренней сети. Детекция промпт-инъекций нейтрализует вредоносные вводы. Блокировка деструктивных команд предотвращает потерю данных. Детекция бесконечных циклов останавливает вышедшие из-под контроля агенты.

SSRF · Инъекции · Деструктивные · Бесконечные циклы
04

Постоянное состояние

SQLite в режиме WAL обеспечивает безопасное при сбоях хранение. Все контакты, сообщения и результаты исследований переживают перезапуск. TOCTOU-безопасная дедупликация исключает дубли даже при конкурентной записи.

SQLite WAL · Восстановление после сбоев · TOCTOU
05

Расширяемость

MCP (Model Context Protocol) позволяет подключать внешние инструменты и источники данных. Хуки жизненного цикла дают перехватывать действия агента. Свои поисковые движки подставляют ваши базы знаний.

MCP · Хуки · Свои движки
06

Наблюдаемость

Метрики, совместимые с Prometheus, раскрывают задержки, расход токенов и успешность. Структурированное JSON-логирование фиксирует каждое действие агента. SSE-поток даёт видимость выполняемых задач в реальном времени.

Prometheus · Структурированные логи · SSE
07

Изолированные рабочие процессы

Каждый агент работает как отдельный процесс ОС, а не поток. Воркеры общаются через Unix-сокеты, безопасно завершаются при утечке, а механизм восстановления после сбоя переподключает незавершённые подзадачи после стагнации — упавший прогон восстанавливается, а не перезапускается с нуля.

Процессы ОС · Unix IPC · восстановление после сбоя
08

Пакетное исполнение инструментов

Исполнитель автоматически разделяет вызовы инструментов на параллельные и последовательные группы. Файловые инструменты обнаруживают пересечения путей для предотвращения конфликтов записи. CPU-интенсивные инструменты работают на выделенных потоках, а I/O-инструменты распараллеливаются через async runtime.

Авто-разделение · Пересечения путей · Async I/O
09

Fail-Closed: безопасный режим отказа

Разрешение контекстного окна отслеживает качество доказательств: Подтверждено (из API), Заявлено (из конфига), Неизвестно. Выделение бюджета работает в отказоустойчивом режиме — если истинное окно модели не может быть доказано, используется консервативное значение по умолчанию.

Подтверждено · Заявлено · Неизвестно · Fail-closed
10

Бэклог самоулучшения

Агенты записывают кандидатов на улучшение в устойчивый Markdown-журнал. Повторное срабатывание той же проблемы увеличивает счётчик повторений вместо создания дубликата. Опциональный LLM-проход выполняет семантическую дедупликацию — переформулированные идеи сворачиваются в существующие записи.

Устойчивый журнал · Счётчик повторений · Семантический дедуп
11

Рефлексия и реестр паттернов

После каждого прогона координатор рефлексирует: что сработало, а что нет. Паттерны записываются в устойчивый реестр и подаются в будущие сессии. Прогоны для генерации лидов используют рефлексию на основе счёта для проверки прогресса квоты и планирования доборных раундов.

Рефлексия после прогона · Добор пробелов · Устойчивый реестр
12

Целевой режим

LLM-судья оценивает частичные результаты относительно исходной цели, решает, нужны ли дополнительные данные, и запускает дополнительные раунды (replan_rounds, по умолчанию 1). Агенты не останавливаются, пока цель не достигнута или бюджет не исчерпан.

LLM-судья · replan_rounds · С учётом бюджета
13

Кеширование промптов

Три уровня промптов — стабильный (система + инструменты), контекст (история сессии), изменчивый (последний ход) — собираются так, чтобы стабильные префиксы переиспользовали кешированные KV-блоки между ходами, снижая TTFT и стоимость на длинных сессиях.

Стабильный · Контекст · Изменчивый · KV reuse
14

Среда координации

IrcBus, AgentRegistry и обмен сообщениями hub связывают агентов. Операторы могут направлять прогоны, ставить агентов на паузу и возобновлять их, отправлять структурированные батчи, передавать сессии и управлять асинхронными задачами или демонами в процессе.

Hub · Управление · Пауза/возобновление · Задачи · Демоны

03Построен на

Боевой Rust-стек

tokioaxumratatuirusqlite (WAL)tokio-postgresscraperquick-xmltiktoken-rslopdfphonenumberlettrereqwest-eventsourceschemarsuuid v7

Rust workspace · edition 2021 · релизные сборки с LTO + strip · Elastic License 2.0

Готовы к более глубокому изучению?

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