Архитектура

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

Обзор протокол-ориентированной архитектуры среды выполнения агентов Protocore.

Исходная предпосылка

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

Это описание текущей архитектуры программного обеспечения, а не заявление о производительности. Количественные результаты приведены в датированных публикациях вместе с их методами.

Поток зависимостей среды выполнения — зависимости направлены вниз через порты протоколов; чистое ядро никогда не импортирует слои над собой.

Чистое ядро, явные адаптеры

Ядро определяет семантику исполнения и контракты, не импортируя пакеты сервисов, фронтенда или инфраструктуры. Провайдеры моделей, персистентность, распределённая координация, исполнение в песочнице и продуктовые API — это забота адаптеров. Тест на границу импортов защищает это направление зависимостей.

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

Прогон — это конечный автомат

Среда выполнения запроса продвигается через наблюдаемые решения, а не оборачивает один непрозрачный вызов модели:

запрос
  → загрузка устойчивого состояния сессии
  → построение текущего представления инструментов и памяти
  → потоковый вывод модели
  → проверка и исполнение запрошенных инструментов
  → сохранение событий, сообщений и артефактов
  → продолжить, финализировать или остановиться по явной политике

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

Инструменты — это слоистая поверхность

Инструмент должен существовать сразу в нескольких местах, прежде чем агент сможет надёжно им пользоваться:

Определение — схема, описание и контракт валидации.
Доступность — инструменты, разрешённые для текущего пользователя, проекта и прогона.
Исполнение — локальная, удалённая или изолированная реализация, которая выполняет операцию и возвращает структурированный результат.

Динамическая федерация инструментов расширяет эту поверхность во время исполнения, сохраняя те же границы валидации и авторизации.

Состояние, память и артефакты

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

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

Потоковая передача — это контракт среды выполнения

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

Границы репозиториев

Инсталляция разделена по ответственности:

protocore владеет чистой средой выполнения и контрактами.
protocore-enterprise реализует сервисные и инфраструктурные адаптеры.
protocore-autonomous владеет фоновым исполнением задач.
protocore-sandbox управляет изолированным исполнением.
protocore-chat и protocore-dashboard — продуктовые интерфейсы поверх API и потоковых событий.
пакеты инструментов, SDK инструментов и федерации инструментов владеют поверхностью расширяемости.

Исходный код является проприетарным. Исследовательские артефакты, опубликованные на этом сайте, распространяются только на условиях, указанных вместе с каждым артефактом.