개발자 하민아빠의 Dev & Money

기존 서비스에 AI 에이전트 도입하기: GraphDB로 토큰 아끼고 성능 높이

안녕하세요! 현업에서 치열하게 구르고 있는 4년 차 개발자입니다. 최근 저희 팀은 운영 중인 기존 서비스에 '시스템 모니터링 및 기능 추적을 위한 AI 에이전트'를 도입하는 프로젝트를 진행했습니다.서비스에 장애가 나거나 특정 기능을 수정해야 할 때, AI가 "이 UI에서 호출하는 API가 어떤 테이블을 수정하는지" 단번에 추적해서 알려주길 바랐거든요. 처음에는 아주 단순하게 생각했습니다."AI 에이전트한테 Git 저장소 조회 API 권한을 주고, 코드를 직접 읽어서 분석하게 하면 되지 않을까?" 하고요.하지만 결과는 처참했습니다.방대한 소스 코드와 참조 관계를 따라가다 보니 LLM의 컨텍스트 토큰은 순식간에 고갈되었고, 추적 성능은 바닥을 쳤습니다. 이 문제를 해결하기 위해 제가 찾은 돌파구는 바로 Gr..

INVALID_REQUEST_PARAMETER_ERROR의 진짜 원인: 공공데이터 API 2일간의 디버깅 기록

안녕하세요! 실무에서 치열하게 부딪히며 성장하고 있는 4년 차 개발자입니다. 😊 최근 사이드 프로젝트로 만들고 있는 Family Planner 앱의 백엔드(NestJS)를 개발하다가 정말 기묘한 버그를 만났습니다.공공데이터포털(data.go.kr)의 공휴일 API를 호출하는데, 자꾸만 400 INVALID_REQUEST_PARAMETER_ERROR 에러를 뱉어내는 것이었죠. 단순한 파라미터 에러인 줄 알았는데, 눈에 보이는 증거가 전혀 없어서 원인을 찾고 수정하느라 배포 커밋만 15번을 넘게 했고, 꼬박 2일이라는 시간을 쏟아부었습니다. 결론부터 말씀드리면 범인은 파라미터가 아니라 Sentry(모니터링 툴)가 몰래 주입한 HTTP 헤더 때문이었습니다.혹시 지금 저처럼 이유를 알 수 없는 공공 API 4..

안녕하세요! 실무에서 치열하게 고민하고 부딪히며 성장하고 있는 4년 차 개발자입니다. 😊 다들 사내 발표나 세미나를 준비하실 때 어떤 툴을 사용하시나요?아마 십중팔구 파워포인트(PPT)나 키노트를 떠올리실 텐데요.저 역시 항상 PPT로 발표 자료를 만들면서 '폰트 파일 챙겼나?', '발표장 PC에서 레이아웃이 깨지면 어떡하지?' 하는 불안감을 안고 살았어요. 다음 달에 사내에서 AI Agent 서비스 개발과 관련해 팀 빌딩 발표를 하게 되었는데, 명색이 최신 AI 기술을 발표하는 자리인데 구식 PPT 포맷을 쓰는 게 영 아쉽더라고요.그래서 과감하게 기존에 보유한 사업자 도메인에 HTML 기반의 웹 프레젠테이션을 올려보기로 결정했습니다. 결과적으로 바이브 코딩(Vibe Coding)을 활용해 PPT보다 ..

안녕하세요! 4년 차 실무 개발자입니다. 😊최근 AI Agent 챗봇 서비스를 개발하며 @microsoft/fetch-event-source를 이용해 실시간 스트리밍 채팅을 연동하고 있습니다.테스트를 진행하던 중 꽤 당황스러운 상황을 마주했는데요.채팅을 입력하는 순간 Access Token이 만료되면 401(Unauthorized) 에러가 발생하면서 채팅이 뚝 끊겨버리는 현상이었습니다. 보통 실무에서는 Axios 인터셉터(Interceptor)에서 이런 토큰 갱신(Refresh) 로직을 공통으로 처리하죠.하지만 스트리밍 API는 순수 fetch 기반이라 Axios 인터셉터를 타지 못한다는 사실을 잠깐 깜빡했던 겁니다. 🥲 게다가 화면이 복잡해지면서 동시에 여러 API가 호출되다 보니, 401 에러가 ..

안녕하세요! 'Family Planner(패밀리 플래너)'를 이용해 주셔서 진심으로 감사드립니다. Family Planner는 우리 가족의 소중한 일정, 육아 기록, 그리고 자산 현황까지 하나의 앱에서 편리하게 공유하고 관리할 수 있도록 만들어진 공간입니다. 앱을 사용하시면서 겪으신 불편한 점, 개선되었으면 하는 점, 혹은 궁금한 사항이 있으시다면 언제든지 편하게 의견을 남겨주세요. 여러분의 소중한 의견 하나하나가 앱을 더 나은 방향으로 발전시키는 데 큰 힘이 됩니다. 📌 문의 방법아래 두 가지 방법 중 가장 편하신 방법으로 문의를 남겨주시면, 확인 후 최대한 빠르게 답변 및 조치해 드리겠습니다. 1. 이메일 문의자세한 오류 상황이나 캡처 화면을 함께 첨부해 주시면 문제 해결에 큰 도움이 됩니다.이메일..

안녕하세요. 그룹 기반 일정 및 할 일 관리 앱 Family Planner를 이용해 주셔서 감사합니다.Family Planner는 사용자의 개인정보 보호와 데이터 권리를 최우선으로 생각합니다.기기에서 앱을 이미 삭제하셨거나 앱 내에서 직접 계정 탈퇴를 진행하기 어려운 경우, 아래의 절차에 따라 이메일로 계정 삭제를 요청하실 수 있습니다.📌 계정 삭제(회원 탈퇴) 요청 방법계정 삭제를 원하시는 경우, 가입 시 사용한 이메일 계정으로 아래 양식에 맞춰 메일을 보내주시면 확인 후 신속하게 처리해 드립니다.수신 이메일 주소: hmn.corp.dev@gmail.com이메일 제목: [Family Planner] 계정 삭제 요청이메일 내용 (필수 포함):가입 시 사용한 이메일 주소 또는 닉네임계정 삭제 요청 명시?..

안녕하세요! 오늘도 실무에서 부딪히며 열심히 성장하고 있는 5년 차 개발자입니다. 😊 최근 회사에서 B 프로젝트(MSA)를 진행하던 중, 갑자기 "파일 서버 기능이 필요하다"는 요구사항이 추가되었어요.개발자 입장에서는 당연히 B 프로젝트만을 위한 독립적인 파일 서버를 구축하는 것이 가장 깔끔한 설계겠죠? 하지만 현실은 늘 녹록지 않습니다. 😅요즘 사내 인프라 투자가 AI 쪽에 집중되면서 새로운 서버 자원을 할당받기 매우 어려운 상황이었거든요.결국, 기존 A 프로젝트에서 잘 사용하고 있던 파일 서버를 B 프로젝트의 MSA 환경에도 연동해야 하는 미션이 주어졌습니다. "물리적인 서버는 1대지만, 논리적으로는 완벽하게 2대의 서버처럼 동작하게 만들 수 없을까?"저와 같이 인프라 자원 부족 문제를 겪으며 우..

최근 여러 에이전트들을 조율해서 사용자의 질문에 맞는 적절한 에이전트로 작업을 넘겨주는 오케스트라형 Supervisor 에이전트를 LangGraph 기반으로 구현했습니다. 처음엔 "질문 의도만 잘 파악해서 라우팅하면 되겠지"라고 생각했는데, 실무에 적용하려다 보니 중요한 요구사항이 생겼어요.바로 "특정 에이전트는 A라는 권한을 가진 사용자만 접근할 수 있어야 한다"는 것이었죠.만약 권한이 없는 일반 사용자가 교묘한 프롬프트로 기밀 데이터를 다루는 에이전트에 접근한다면 큰 보안 사고로 이어질 수 있으니까요. 오늘은 기존 YAML 설정 방식을 유지하면서, LangGraph의 State를 활용해 안전하고 유연하게 에이전트 권한 체크와 동적 라우팅을 구현한 경험을 공유해 보려고 합니다.1. 문제 상황 및 목표우..

바쁜 일상 속에서 가족의 일정을 맞추고, 장볼 거리를 챙기고, 흩어진 자산까지 관리하는 것은 생각보다 많은 에너지를 필요로 합니다.각기 다른 앱을 넘나들며 정보를 파편적으로 관리하다 보면 놓치는 것들이 생기기 마련이죠. 이러한 현실적인 고민을 해결하기 위해, 가족의 모든 일상과 데이터를 한곳에서 완벽하게 공유할 수 있는 스마트 앱 'Family Planner'를 개발했습니다.다가오는 6월 정식 출시를 앞두고, 우리 가족의 삶을 한결 편안하게 만들어줄 핵심 기능들을 미리 소개합니다.1. 내 입맛대로 꾸미는 '나만의 홈 화면과 네비게이션'앱을 켰을 때 가장 먼저 보이는 화면은 사용자마다 필요한 정보가 다릅니다.Family Planner는 철저하게 사용자 중심의 커스터마이징을 지원합니다.홈 위젯 설정: 날씨,..

사이드 프로젝트로 앱 출시를 준비하다 보면 필연적으로 부딪히는 고민이 있습니다.바로 "테스트용 개발(Dev) 서버와 실제 서비스용 운영(Prod) 서버의 분리" 인데요. 안전한 라이브 서비스를 위해 환경 분리는 필수지만, 단순히 서버를 2벌로 복제하면 인프라 비용도 2배가 된다는 뼈아픈 문제가 생깁니다.저도 최근 'Family Planner'라는 앱의 런칭을 앞두고 이 문제로 꽤 골머리를 앓았어요. 하지만 약간의 꼼수(?)와 세팅을 더하면 비용을 획기적으로 줄이면서도 쾌적하게 환경을 분리할 수 있습니다.오늘은 제가 Railway와 GitHub Actions를 활용해 비용을 최소화하며 Dev/Prod 환경을 구축한 방법을 공유해 볼게요!1. 인프라 세팅: 비용은 줄이고, 효율은 높이고 (Railway)저는..