Архитектурная документация — одна из самых болезненных точек в разработке: код меняется ежедневно, а диаграммы устаревают за недели. Amazon Bedrock AgentCore предлагает подход, при котором агенты сами анализируют кодовую базу, генерируют диаграммы и поддерживают документацию в актуальном состоянии. В блоге AWS описан кейс глобального междилерского брокера, где такое решение работает в продакшене с Q1 2026 года.
Проблема, которую решает этот подход, знакома любой команде: ручное создание диаграмм в форматах UML или Mermaid требует часов работы, а результат устаревает почти сразу. Документация превращается в «чёрный ящик», когда ключевые сотрудники уходят, а новые разработчики вынуждены восстанавливать архитектуру по коду. В микросервисных системах это особенно критично — без понимания зависимостей сложно предотвратить каскадные сбои. Кроме того, устаревшие диаграммы создают риски для комплаенса: аудиторы и службы безопасности требуют актуальных схем.
| Компонент | Ответственность |
|---|---|
| Amazon Bedrock AgentCore | Серверless-среда для автономного агента, управление жизненным циклом, масштабирование |
| AWS CodePipeline | Оркестрация пайплайна от коммита до публикации документации |
| Amazon S3 | Хранение диаграмм, метаданных, векторное хранилище |
| AWS CodeBuild | Выполнение этапов пайплайна, установка зависимостей |
| Amazon Bedrock Knowledge Bases | Семантический поиск и запросы на естественном языке |
Предложенное решение использует AgentCore для создания автономного агента, который анализирует.NET-кодовую базу и генерирует диаграммы. Агент запускается в AWS CodePipeline, триггером служит коммит в AWS CodeCommit. Сгенерированные SVG-файлы, исходники Mermaid и метаданные сохраняются в Amazon S3, а затем индексируются в Amazon Bedrock Knowledge Bases с помощью модели Amazon Titan Text Embeddings. Это позволяет искать по документации на естественном языке и получать ответы о текущем состоянии архитектуры.
Ключевые компоненты решения: AgentCore обеспечивает серверless-среду для агента, автоматическое масштабирование и оркестрацию инструментов; AWS CodePipeline управляет пайплайном от коммита до публикации; Amazon S3 хранит диаграммы и служит векторным хранилищем; Amazon Bedrock Knowledge Bases отвечает за семантический поиск. Такой конвейер обновляет документацию при каждом изменении кода, что снимает проблему устаревания.
Для финансовой отрасли, где требования к документации особенно строгие, это означает снижение рисков комплаенса и ускорение онбординга. Пока что решение завязано на экосистему AWS, но подход — использование агентов для автоматизации рутинных задач документирования — применим и в других облаках. Интересно, что AWS делает ставку на агентов как на новый уровень автоматизации: AgentCore — часть более широкой стратегии Bedrock, которая включает инструменты для создания агентов с любой моделью и фреймворком.
