AI 느낌이 없는 AWS 구성도 작성: AI 에이전트를 활용하는 실습 방법

AWS 구성도를 AI 에이전트에게 그리게 했다가, 어딘지 모르게 'AI 같은' 그림이 된 경험은 없으신가요? 애매한 화살표, 무너진 아이콘, 공식적인 느낌이 없는 디자인. 그 원인은 생성 방식을 선택하는 데 있습니다. 이 글에서는 AI 에이전트를 사용하여 실무에서 바로 사용할 수 있는 AWS 구성도를 만드는 구체적인 방법을 소개합니다.

이 글의 핵심 요약

• 'AI 같은' 느낌이 없는 AWS 구성도를 만들려면, 이미지 생성 AI가 아니라 diagrams-as-code 방식(Python의 diagrams 라이브러리나 Mermaid 등)으로 AI 에이전트에게 작성하게 하는 것이 효과적입니다.
• AWS 공식 아이콘 세트인 'AWS Architecture Icons'를 사용하면, AI가 생성한 코드라도 익숙한 구성도의 모양을 갖게 됩니다.
• AI 에이전트에게 구성도를 그리게 하는 작업은, 요구사항을 자연어로 전달하여 코드를 생성하게 하고, 출력물을 보고 미세 조정하는 반복 작업이 기본입니다.

이미지 생성 AI에 AWS 구성도를 맡기면 왠지 모르게 부자연스러운 그림이 됩니다. 이유는 간단합니다. 이미지 생성 AI는 구성도를 '그림'으로 생성하기 때문에, 올바른 아이콘의 형태나 배치 규칙을 보장할 수 없습니다. 로고가 무너지거나, 화살표의 의미가 파탄 나기도 합니다.

구성도는 본래 요소와 관계성을 나타내는 구조화된 데이터입니다. 픽셀 단위로 그리기보다는, 코드나 데이터로부터 그리는 방식이 더 적합합니다. 여기에 주목하느냐에 따라 결과물의 품질이 크게 달라집니다.

Python의 diagrams 라이브러리나 Mermaid, PlantUML 등, 텍스트로 구성을 정의하여 렌더링하는 방식입니다. AWS 공식 아이콘을 그대로 사용할 수 있는 라이브러리도 있어 시각적 통일감을 얻을 수 있습니다.

• diagrams (Python): https://github.com/mingrammer/diagrams
• Mermaid: https://mermaid.js.org/
• AWS Architecture Icons: https://aws.amazon.com/architecture/icons/

draw.io는 AWS 아이콘 라이브러리를 표준 탑재하고 있습니다. AI 에이전트에게 draw.io 형식의 XML을 생성하게 하는 방법도 있지만, 좌표 계산이 복잡하여 레이아웃이 무너지기 쉽다는 인상을 받았습니다.

• 구성 요구사항을 자연어로 전달합니다 (로드 밸런서, EC2, RDS 등)
• AI 에이전트에게 Python diagrams 코드를 생성하게 합니다
• 코드를 실행하여 PNG나 SVG를 출력합니다
• 출력물을 보고 클러스터 분류나 배치를 지시하며 재조정합니다

생성되는 코드 예시는 다음과 같습니다.

from diagrams import Diagram, Cluster
from diagrams.aws.compute import EC2
from diagrams.aws.network import ELB
...

Cluster로 요소를 그룹화하면 레이아웃 붕괴를 줄일 수 있습니다. AI 에이전트에게 요청할 때도

AWS 구성도를 AI에게 그리게 하는 가장 쉬운 방법은 무엇인가요?

Python의 diagrams 라이브러리 코드를 AI 에이전트가 생성하게 하는 방법이 간편합니다. AWS 공식 아이콘을 그대로 사용할 수 있습니다.

ChatGPT나 Claude에 직접 'AWS 구성도를 그려줘'라고 부탁하면 어떻게 되나요?

이미지 생성 모드로 요청할 경우, 아이콘이 무너진 AI 느낌의 그림이 되기 쉽습니다. 구조를 텍스트로 전달하고 코드를 생성하게 하는 것이 더 실용적입니다.

Mermaid로 그린 그림도 AWS 공식 아이콘이 될까요?

표준 Mermaid는 기하학적 도형 중심의 표현이라 AWS 공식 아이콘을 지원하지 않습니다(참고: https://mermaid.js.org/ ). 공식 아이콘이 필요하다면 Python의 diagrams 라이브러리가 적합합니다.

무료로 사용할 수 있는 AWS 구성도 자동 생성 도구가 있나요?

Python의 diagrams 라이브러리는 오픈 소스이며 무료입니다(참고: https://github.com/mingrammer/diagrams ).

구성 정보를 AI 에이전트에게 전달하는 것은 보안상 문제가 없나요?

IP 주소나 인증 정보 같은 기밀 정보는 전달하지 않고, 구성 요소의 종류와 관계성만 전달하는 것이 안전합니다.

손글씨 느낌으로 AI 느낌을 지우는 디자인적 장치가 있나요?

Excalidraw 같은 손글씨 스타일 렌더러를 결합하는 방식이 있는 것 같지만, 필자는 미검증입니다.

멀티 계정 같은 대규모 구성에도 사용할 수 있나요?

요소 수가 늘어나면 자동 레이아웃이 무너지기 쉬우므로, Cluster에서의 수동 그룹핑이 전제되어야 합니다.

구성도를 한 장, 실제로 diagrams-as-code로 다시 만들어보면, AI 에이전트에게 적합한 작업과 그렇지 않은 작업의 경계가 보입니다.