ilboard

RAG 시스템에서 청크 크기가 왜 중요한가 — 최적화 전에 알아야 할 기본 원리RAG를 처음 구현해보면 결과가 생각보다 별로일 때가 있다. 문서는 다 넣었고 임베딩도 됐는데, 엉뚱한 내용을 가져오거나 답변이 어딘가 어긋난다. 이 시점에서 대부분은 프롬프트를 손보거나 모델을 교체할 생각을 먼저 한다. 그런데 실제로 파고들면 원인의 상당 부분이 청크 설정에 있는 경우가 많다.이 글은 RAG 파이프라인에서 청크 크기가 어떤 역할을 하는지, 왜 이 값 하나가 검색 품질과 비용을 동시에 좌우하는지를 다룬다. 최적화 수치보다는 "왜 이게 중요한가"를 먼저 이해하는 것이 목적이다. 수치를 바꾸기 전에 원리를 알고 있어야 실험 결과도 해석할 수 있기 때문이다.RAG 파이프라인에서 청킹이 하는 역할RAG는 크게 두 단계..

ChatGPT 커스텀 GPT 만들기 — 처음 시작하는 사람을 위한 입문 가이드생각보다 금방 만들 수 있었다. "코딩 없이 나만의 AI 챗봇"이라는 말이 과장처럼 들렸는데, 실제로 해보면 설정 몇 가지 채우고 10분 안에 초안이 나온다.다만 그냥 대화창에서 쓰는 ChatGPT와 커스텀 GPT의 차이를 모르고 시작하면 금방 막힌다. "어디에 뭘 넣어야 하는지", "이 설정이 실제로 뭘 바꾸는지" 감이 없는 상태에서 만들면 그냥 기본 ChatGPT랑 별 차이가 없어 보이기 때문이다.이 글은 커스텀 GPT를 처음 만드는 사람이 헷갈리는 부분, 설정별로 실제로 달라지는 것들, 그리고 쓸만한 활용 예시까지 정리한 글이다. 2026년 기준 최신 인터페이스와 기능을 기준으로 작성했다.커스텀 GPT가 뭔지 먼저 정리하고..

Docker 컨테이너 외부 접속 안 될 때 — 초보 개발자를 위한 네트워크 문제 해결 가이드Docker를 처음 쓰기 시작하면 거의 모두가 한 번씩 겪는 상황이 있다. 분명히 컨테이너는 뜨고 있는데, 브라우저에서 접속하면 "연결 거부"가 뜨거나 아무것도 안 열린다. docker ps를 쳐보면 컨테이너는 멀쩡히 실행 중이고, 컨테이너 내부에서 curl localhost를 치면 응답이 오는데, 외부에서는 접근이 안 된다.이 글에서는 Docker 컨테이너 외부 접속이 안 되는 원인을 유형별로 정리하고, 각각 어떻게 해결하는지를 설명한다. 원인은 대부분 몇 가지로 좁혀지는데, 알고 나면 별거 아니다.Docker 네트워크가 기본적으로 격리되는 이유부터 알아야 한다Docker를 설치하면 docker0이라는 가상 네트..

VS Code 사용자를 위한 Git Merge Conflict 해결 가이드: 내장 에디터 200% 활용법git pull을 눌렀는데 터미널에 CONFLICT가 뜨는 순간, 손이 멈추는 경험을 한 번쯤은 해봤을 거다. 특히 팀 프로젝트에서 브랜치를 오래 유지하다 머지하면 충돌 파일이 수십 개씩 쏟아지기도 한다. 그때마다 하나씩 파일을 열어 , =======, >>>>>>> 마커를 눈으로 찾아 지우고 있다면, 꽤 비효율적인 방식을 쓰고 있는 거다.VS Code에는 충돌 해결을 위한 도구가 기본으로 내장되어 있다. 인라인 에디터부터 3-Way Merge Editor까지, 제대로 쓰면 충돌 해결 시간을 절반 이상 줄일 수 있다. 이 글에서는 VS Code 내장 에디터를 실제 충돌 상황에서 어떻게 쓰는지, 설정은 ..

GitHub Copilot Chat, 개발 효율 2배 높이는 첫걸음: VS Code에서 바로 시작하는 방법Copilot Chat을 쓰기 시작한 뒤로 구글링하는 횟수가 눈에 띄게 줄었다. 정확히 말하면 없어진 게 아니라, 검색하기 전에 먼저 Copilot한테 물어보게 됐다. 그게 전부인데, 생각보다 이 작은 습관 변화가 실제 작업 속도에는 꽤 영향을 줬다.물론 처음부터 잘 쓴 건 아니다. 설치는 했는데 탭 자동완성만 쓰다가 "이거 그냥 IntelliSense랑 비슷하네"라고 생각하고 방치한 기간이 꽤 됐다. Copilot Chat을 제대로 쓰기 시작한 건 Inline Chat 단축키 하나 알고 나서부터다.이 글은 Copilot Chat을 설치하는 것부터, 실제로 개발 흐름에서 어떻게 쓰면 효율이 오르는지까..

Nginx Proxy Manager vs 수동 설정: Docker 프록시 구축, 나에게 맞는 방법은?Docker로 서비스 여러 개를 돌리다 보면 결국 이 문제에 부딪힌다. 포트를 일일이 외부에 열어두는 방식은 언젠가 한계가 온다. app1:3000, app2:5000, app3:8080 — 각자 포트가 다르고, HTTPS는 따로 처리해야 하고, 뭔가 정리가 안 되는 느낌이 든다.그때 보통 두 가지 선택지가 앞에 놓인다. Nginx Proxy Manager(이하 NPM)를 쓰느냐, 직접 Nginx 설정 파일을 건드리느냐.써봤는데, 둘 다 쓸 만하다. 다만 상황에 따라 맞는 쪽이 확연히 갈린다. "NPM이 무조건 편하다"거나 "수동이 진짜 방식이다"는 식의 편 가르기보다, 실제로 어떤 구조이고 어디서 차이가..

GitHub Actions로 FastAPI 앱 자동 배포 파이프라인 만들기FastAPI 프로젝트를 처음 서버에 올릴 때는 SSH로 접속해서 git pull하고 서버 재시작하는 방식으로 버텼다. 작업이 하루에 몇 번 없을 때는 괜찮은데, 배포 빈도가 늘어나면 이 과정이 생각보다 귀찮아진다. 브랜치 잘못 올리거나, 테스트 안 돌리고 배포해서 장애 낸 적도 한 번씩은 있을 것이다.GitHub Actions를 이용한 CI/CD 파이프라인은 이 반복 작업을 완전히 없애준다. main 브랜치에 푸시하면 테스트가 자동으로 돌고, 통과하면 서버에 배포까지 끝난다. 이 글에서는 FastAPI 앱을 기준으로, 테스트 → 도커 빌드 → EC2 서버 자동 배포까지 이어지는 파이프라인 전체를 단계별로 정리한다.CI/CD가 Fa..

1인 개발자 프로젝트 아이디어, 막막할 때 시도하는 5단계 발상법아이디어가 없는 게 아니라, 아이디어를 고르는 법을 모르는 거다.사이드 프로젝트를 시작하려는 개발자 대부분이 비슷한 패턴을 보인다. "뭔가 만들고 싶다" → "뭘 만들지?" → 며칠 고민 → 포기. 기술은 있고 시간도 쪼갤 수 있는데, 시작점을 못 찾는 거다. 그리고 그 상태에서 구글에 "사이드 프로젝트 아이디어"를 검색하면, 나온다. "투두앱 만들기", "날씨앱 만들기". 아무도 원하지 않는 클론 목록.이 글은 그 상황에서 벗어나기 위한 발상 과정을 정리한 것이다. 아이디어를 '떠올리는' 방법이 아니라, 아이디어를 '발굴하고 걸러내는' 5단계 흐름이다. 직접 써봤고, 실제로 진행까지 이어진 방식들만 담았다.1단계 — "불편함 일지"를 2주..

Python으로 ColBERT RAG 시스템 직접 구축하기: 핵심 모듈별 구현 가이드RAG 시스템을 처음 구성하면 대부분 OpenAI의 text-embedding 모델이나 sentence-transformers 기반의 단일 벡터 검색을 쓴다. 빠르게 돌아가고 설정도 간단하다. 그런데 실제로 운영하다 보면 비슷한 문제에 부딪힌다. 쿼리와 문서의 의미는 겹치는데 검색이 빠져버리거나, 단어 하나 차이로 전혀 다른 결과가 나오는 상황이다.ColBERT는 이 문제를 다른 방식으로 접근한다. 문서 전체를 하나의 벡터로 압축하지 않고, 토큰 단위 임베딩을 그대로 유지한다. 쿼리도 마찬가지다. 그 둘을 나중에 비교(Late Interaction)하는 구조 덕분에, 단일 벡터 방식보다 정밀한 매칭이 가능하다.이 글에서는..

Cursor IDE AI 핵심 기능 정리 — 입문자가 처음 써야 할 것들처음 써봤을 때 "그냥 VS Code에 채팅창 붙인 거 아니야?"라고 생각했다. 그런데 하루 쓰다 보니 생각이 조금 달라졌다. 자동완성 품질이 GitHub Copilot보다 나은 케이스가 분명히 있었고, 특히 여러 파일에 걸친 수정 작업에서 차이가 느껴졌다. 물론 단순히 코드 몇 줄 완성하는 용도로만 쓴다면 굳이 환경을 바꿀 이유는 없다. 하지만 "이 기능 추가해줘" 한 줄로 관련 파일 여러 개를 한꺼번에 수정해주는 걸 보면, 이건 그냥 자동완성 도구가 아니라는 걸 알게 된다.이 글은 Cursor를 처음 쓰기 시작한 사람을 위해 실제로 자주 쓰는 기능 위주로 정리했다. 설치부터 Agent Mode까지, 처음에 뭘 써야 할지 막막한 분..