C4 Model и Architecture as Code для описания бизнеса и агентских сред

architecture c4-model agents business-architecture dochub gitops modified: 2026-09-07 21:40 · canonical

C4 Model и Architecture as Code для описания бизнеса и агентских сред

Концепция адаптации инженерного подхода C4 Model (Simon Brown) и методологии Architecture as Code / DocHub (Кирилл Ветчинкин) для формализации структуры корпорации, бизнес-процессов и мультиагентной среды «Гелиос».

---

📌 Проблема: Контекстная дезориентация AI-агентов

При создании и масштабировании мультиагентных систем в бизнесе ключевым ограничением становится отсутствие формализованной машиночитаемой онтологии компании: 1. Размытые границы ответственности: Агенты не понимают, где заканчиваются их полномочия и кому передавать результаты (delegate_task). 2. Раздувание промптов: Приходится передавать в системный контекст каждого агента массивные текстовые регламенты. 3. Дублирование сущностей: Без единого каталога разные команды создают агентов с пересекающимся функционалом.

---

🗺 Принцип Google Maps (Semantic Zoom) в бизнес-архитектуре

Подход C4 Model переносится с чисто программных компонентов на социотехнические системы (люди + отделы + AI-агенты + сервисы):

Уровень C4	Аналог в Google Maps	В классическом IT	В бизнес-архитектуре и среде «Гелиос»	Что видит агент на этом уровне
C1: System Context	Карта мира / Страна	Система и внешние пользователи	Корпоративный ландшафт: Холдинг/компания, внешние клиенты, регуляторы, поставщики, контрагенты.	Глобальную миссию компании, политики безопасности, внешние границы.
C2: Containers	Города / Районы	Приложения, БД, микросервисы	Бизнес-домены и департаменты: Продажи, HR, Склад, Бухгалтерия, IT-платформа.	Свой отдел, смежные домены, SLA и форматы обмена данными.
C3: Components	Здания / Улицы	Модули и контроллеры	Агенты и Сотрудники: Конкретный AI-агент, роль сотрудника (РОП, менеджер), MCP-серверы, БД.	Свои входные триггеры, коллег для делегирования, разрешенные инструменты.
C4: Code / Prompts	Интерьер комнат	Классы, методы	Исполняемый артефакт: System Prompt, YAML-конфиг скилов, JSON-схемы tool-call, RAG-индексы.	Точные сигнатуры функций, валидаторы входных параметров, системные ограничения.

---

🚀 Построение «1-го уровня наивности» из штатного расписания

Для быстрого старта без ручного проектирования сотен регламентов применяется конвейер автоматической генерации:

[Штатное расписание (XLSX / 1C / PDF)]
                 │
                 ▼
[Парсер & LLM-экстрактор ролей]
                 │
                 ▼
[YAML-манифесты C4 (DocHub / Structurizr format)]
         ┌───────┴───────┐
         ▼               ▼
[Интерактивный граф]    [Онтология для «Гелиос»]
(Карта для людей)       (Контекст для агентов)

1. Импорт оргструктуры (C1–C2): Из штатного расписания извлекается иерархия: Корпорация ➔ Дирекции ➔ Отделы ➔ Должности. 2. Декларативное описание в YAML (C3): Каждая бизнес-единица и агент фиксируются манифестом с явным указанием inputs, outputs, capabilities и contracts. 3. CI/CD и Arch-Review (GitLab/GitHub): Любое изменение регламентов или структуры проходит через Merge Request с автоматической проверкой целостности связей.

---

🔗 Связанные материалы

Агентская среда «Гелиос» Слотовая архитектура замещения операций и шкала наивности Конспект доклада: Архитектурный репозиторий на базе GitLab и C4 Model (Кирилл Ветчинкин) Мыслеформа Павла о среде «Гелиос» и замещении слотов Агентские системы Методология многоагентной разработки * Model Context Protocol (MCP)