아프니까 개발자다 아프니까 개발자다

Python으로 LLM 에이전트나 웹 API를 만들다 보면 Pydantic BaseModel이라는 이름을 자주 만난다. LangChain의 도구 정의에서도, FastAPI의 요청 본문에서도, 설정 파일 로딩에서도 BaseModel이 등장한다. 그런데 "BaseModel을 상속받아 클래스를 만든다"는 설명만 보면 그게 정확히 뭘 해주는 도구인지 잡히지 않는다. 이 글은 BaseModel 하나만 떼어내서 본다 — 이 이름이 무엇을 의미하는지, 어떤 문제를 풀려고 태어났는지, 그리고 그 문제를 어떻게 푸는지.먼저 풀어야 할 문제: 타입 힌트는 거짓말을 막지 못한다Python에는 타입 힌트(type hint)가 있다. 함수 파라미터에 query: str, top_k: int처럼 "이 자리에는 이런 타입이 와야 ..