Агент: Диаграммы (draw.io)

Агент Диаграммы draw.io (slug: drawio) специализируется на проектировании, визуализации и обновлении архитектурных схем, диаграмм потоков данных (DFD), сетевых топологий и схем интеграций в формате .drawio.

---

Принцип работы

Ассистент оперирует семантическим представлением графа (узлы и связи), а движок Unishift компилирует его в валидный формат draw.io / diagrams.net:

• Узлы (nodes): поддерживают стандартные формы: box (компоненты/сервисы), process (действия), start / end (события), gateway (развилки), db (базы данных и очереди).
• Связи (edges): направленные стрелки с поясняющими подписями (label) протоколов или потоков данных (например, REST / gRPC, NATS Event, SQL Query).
• Интеграция с редактором: Созданный файл сохраняется в медиафайлы пространства. Его можно редактировать как через текстовые команды агенту, так и открыть в интерактивном визуальном редакторе draw.io в интерфейсе Unishift.

---

Набор инструментов агента

Инструмент	Назначение
create_drawio	Создает новую диаграмму из переданного графа и сохраняет в медиа пространства
read_drawio	Читает структуру существующей схемы для последующей доработки
update_drawio	Точечно применяет операции добавления, удаления или изменения узлов и связей
search_media	Находит ранее сохраненные диаграммы и графические файлы в текущем пространстве

---

Примеры использования

Создание новой архитектурной схемы

Запрос пользователя:«Нарисуй архитектурную схему микросервисов для обработки заказов: клиентское мобильное приложение обращается через Gateway к Order Service, который пишет в PostgreSQL и публикует событие в NATS для Notification Service.»

Что делает агент:

1. Выделяет ключевые узлы (Client, Gateway, Order Service, PostgreSQL, NATS, Notification Service).
2. Назначает подходящие формы (box, db, process).
3. Задает направленные связи с типами протоколов.
4. Вызывает create_drawio и прикрепляет файл orders_architecture.drawio к сообщению со ссылкой на скачивание.

---

Точечная модификация существующей диаграммы

Запрос пользователя:«Добавь на созданную схему кэш Redis между Gateway и Order Service и проведи стрелку чтения кэша.»

Что делает агент:

1. Из памяти сессии берет идентификатор созданной диаграммы.
2. Вызывает read_drawio для получения актуального графа.
3. Добавляет узел Redis формы db и необходимые ребра связи.
4. Вызывает update_drawio, не перерисовывая всю диаграмму с нуля.