Нейросеть может помочь со схемой двумя принципиально разными способами. Первый — сгенерировать текстовое описание диаграммы в формате Mermaid или другом diagram-as-code синтаксисе. Второй — сразу создать картинку. Для технической документации чаще лучше код: его можно редактировать, хранить в Git и быстро обновлять вместе с системой.
Картинка удобнее для презентации или концепта, но хуже поддерживается. Если через неделю нужно поменять одну связь, проще исправить одну строку Mermaid, чем заново просить модель перерисовать весь макет.
Когда выбирать diagram-as-code
архитектура сервисов и интеграций
sequence diagram для API-взаимодействий
flowchart бизнес-процесса
ER-схема или логическая карта данных
документация, которая хранится рядом с кодом
Как составить запрос
Сначала опишите сущности и связи обычным текстом. Затем укажите тип диаграммы и формат ответа: только валидный Mermaid без объяснений. Чем точнее входные правила, тем меньше модель придумывает лишних блоков. Для сложной архитектуры лучше генерировать отдельные схемы по уровням, а не один огромный граф.
Пример постановки задачи: «Построй flowchart: клиент вызывает API Gateway, gateway проверяет JWT, затем отправляет запрос в Orders Service; сервис пишет заказ в PostgreSQL и публикует событие в Kafka. Верни Mermaid-код».
Где проверить Mermaid
Полученный код нужно открыть в редакторе, который умеет рендерить Mermaid. Подойдут Mermaid Live Editor, поддерживающие Markdown IDE и многие системы документации. Если код не рендерится, сначала исправьте синтаксис, а не просите модель полностью переписать схему.
Как проверить логику
каждая стрелка должна соответствовать реальному направлению вызова или зависимости
разделяйте синхронные запросы и асинхронные события
не позволяйте модели добавлять базы и очереди, которых нет в системе
проверяйте подписи протоколов: HTTP, gRPC, Kafka и другие механизмы
для sequence diagram сверяйте порядок сообщений с реальным сценарием
Когда нужна картинка, а не код
Для маркетинговой презентации, mind map или визуального концепта можно использовать генератор изображений или специализированный whiteboard AI. Но текст внутри изображений может искажаться. Если подписи важны, лучше сгенерировать структуру отдельно и собрать финальный дизайн в редакторе.
Итог
Для рабочих и технических схем используйте AI как помощника по структуре, а результат храните в редактируемом формате. Нейросеть ускоряет первый черновик, но связи и подписи должен проверить человек, который знает систему.