План книги¶
Я строю эту книгу как инженерное практическое руководство, а не как обзор фреймворков. Идея простая: каждая часть отвечает на один практический вопрос, который у тебя неизбежно возникнет, если ты попытаешься довести агентную систему до промышленного уровня.
Структура¶
Часть I. Основания¶
- Глава 1. Почему агенту нужна платформа, а не магия.
- Глава 2. Референсная архитектура безопасного агента.
Статус: часть написана и разбита на короткие главы.
Часть II. Контур безопасности¶
- Глава 3. Контур безопасности и границы доверия.
- Глава 4. Инструментальный шлюз, подтверждения и журнал аудита.
Часть III. Память и знания¶
- Глава 5. Зачем агенту память и почему она опасна.
- Глава 6. Краткосрочная, долгосрочная и профильная память.
- Глава 7. Извлечение контекста, уплотнение и фоновые обновления.
- Когда память писать в горячем контуре, а когда переносить в фоновые процессы.
Статус: три главы части написаны.
Часть IV. Инструменты и выполнение¶
- Глава 8. Модель выполнения и каталог инструментов.
- Глава 9. Песочница выполнения и MCP как интеграционный контракт.
- Глава 10. Идемпотентность, повторы, лимиты запросов и границы отката.
Статус: три главы части написаны.
Часть V. Надежность и наблюдаемость¶
- Глава 11. Трассы, спаны и структурированные события.
- Глава 12. SLO для агентных систем.
- Глава 13. Офлайн-оценки, онлайн-оценки и регрессионные шлюзы.
Статус: три главы части написаны.
Часть VI. Организационная модель¶
- Глава 14. Платформенная команда и продуктовые команды.
- Глава 15. Золотые пути, общие шлюзы и антизоопарк-подходы.
Статус: две первые главы части написаны.
Часть VII. Эталонная реализация¶
- Глава 16. Базовая схема рантайма.
- Глава 17. Слой политик и каталог возможностей.
- Глава 18. Чеклист промышленного запуска.
Статус: три главы части написаны.
Роадмап публикации¶
- Зафиксировать архитектурную рамку и терминологию.
- Дописать безопасность как отдельный слой, а не подпункт.
- Добавить опорные диаграммы, интерактивные схемы и эксплуатационные чеклисты.
- Подготовить практическую эталонную реализацию.
- Подключить примеры оценок и конфигураций политик.
Что уже готово¶
- Каркас сайта для GitHub Pages.
- Навигация и структура книги.
- Первые семь частей уже имеют рабочую структуру, и эталонная реализация уже началась.
- Базовый визуальный слой: Mermaid и интерактивные графики через Observable Plot.
- Отдельная страница со стеком публикации.
- База источников для дальнейших глав.