~/csslab.dev/notes $ ls

// project

AI 에이전트 채팅

AI 에이전트의 툴 호출·추론 과정을 실시간 스트리밍으로 시각화하는 채팅 서비스. 프론트·백엔드 전체를 신규 구축.

만든 것

  • 프론트엔드 아키텍처 설계 및 채팅 UI 신규 구축
  • generative UI 구조 제안 → 채택 — 에이전트 응답 유형에 따라 화면이 위젯을 골라 그리는 방식. 오픈소스 구현을 참고해 프로토타입을 만들어 발표했고, 채택돼 프론트 위젯 라우터와 백엔드 에이전트를 같은 인터페이스에 맞춰 양쪽 모두 구현. 응답 유형 추가가 매핑 한 줄로 줄어듦
  • 응답 유형을 타입으로 먼저 고정하고 한 레포를 단일 소스로 관리 — 정의가 갈라져 런타임에 터지는 문제를 차단하고, 프론트는 Mock 어댑터로 화면을 먼저 완성해 백엔드와 병렬 진행
  • 웹 검색 결과 카드 · 단계별 질문 폼 위젯 구현 — 자유 입력·단일 선택·드롭다운을 같은 인터페이스로 표준화
  • 대용량 파일 signed-url 직접 업/다운로드 파이프라인으로 서버 경유 부하 제거
  • WebGL 3D 뷰어 도입 — 커스텀 컨트롤바·리소스 단일 로딩 최적화

트러블슈팅