--- title: "에이전트 출력이 틀어질까 겁나는 사람들을 위한 도구 — Pydantic AI 사용기" date: 2026-10-10 model: qwen3.6-plus author_type: human category: reviews summary: "Pydantic AI는 LLM 출력을 Pydantic 모델로 검증하고 실패하면 재시도하는 타입 안전 에이전트 프레임워크다. 사용자들은 json.loads와의 전쟁이 끝났다는 만족과, 빠른 릴리스 속도·깊은 그래프 오케스트레이션의 한계를 함께 기록한다." tags: Pydantic AI, 타입 안전, 에이전트 프레임워크, 구조화 출력, Pydantic, Python, 검증, 사용자 리뷰, 실사용자 리뷰, AI 에이전트 --- ## 에이전트 출력이 틀어질까 겁나는 사람들을 위한 도구 — Pydantic AI 사용기 r/LLMDevs에는 2025년에 이런 글이 올라왔다. "Pydantic AI로 기본 에이전트와 멀티 에이전트를 만드는데 꽤 직관적이다. 이전에는 LangChain·Flowise·n8n 등을 썼는데, 조금만 복잡해지면 도구나 프레임워크와 싸우게 되더라. 프로덕션 규모에서 쓴 분 계신가요?" 답글의 온도는 비슷하다. "극도로 유연하고 직관적이다. 다른 프레임워크보다 조금 더 생각해야 하지만 충분히 가치 있다." 그리고 한 줄의 신중함: "가장 기다리던 도구일 수 있지만, PROD로 가기엔 아직 이르다." 이 글은 그 "직관적"과 "아직 이르다" 사이의 기록을 정리한다. --- ### 1. 자료 범위 독립 리뷰 2건(2026), 초기 체험기(2024), 커뮤니티 스레드, 공식 저장소를 읽했다. --- ### 2. 무엇이 끝났는가 — json.loads와의 전쟁 Pydantic AI에 대한 칭찬은 대개 한 장면에서 시작된다. 프롬프트에 JSON을 요구하고, 파싱하고, 필드가 있는지 확인하고, 모델이 "Here is the JSON:"을 붙여서 깨지는 사태를 방어 코드로 막던 작업. 독립 리뷰의 한 사례: 리뷰 초안을 루브릭에 맞춰 검사하고 구조화된 보고서를 돌려주는 QA 에이전트. 이전 방식은 "대략 70% 동작하고 디버깅에 몇 시간을 먹는" 프로젝트였다. Pydantic AI에서는 Pydantic 모델로 출력 형태를 정의하자, 검증 실패 시 오류를 먹이고 재시도하는 루프가 프레임워크가 맡았다. 첫 동작 버전은 오후 하나. 핵심 메커니즘이다. **출력을 Pydantic 모델로 정의하면 프레임워크가 모델에게 그 형태를 강제하고, 검증에 실패하면 다시 프롬프트한다.** 타입 체커가 코드를 실행하기 전에 잡는 오류로 옮겨 간다. 의존성 주입(RunContext)과 타입이 붙은 툴 시그니처도 같은 철학이다. 에이전트를 테스트하는 것이 실제로 가능해진다는 것이 사용자 만족의 두 번째 축이다. --- ### 3. 무엇이 남았는가 — 속도와 범위 **릴리스 속도.** v1 안정성 보장(최소 6개월 API 유지)이 있지만, 포인트 릴리스가 매우 빠르다. "8개월 만에 100개 이상의 포인트 릴리스"라는 기록이 있다. 사용자 조언은 일관된다. 버전을 고정하고, 업그레이드 전에 체인지로그를 읽어라. **깊은 오케스트레이션의 범위.** 사이클이 있는 상태 기계, 체크포인트, 복잡한 멀티 에이전트 HITL 분기는 LangGraph 쪽 영역으로 남는다. 한 리뷰의 요약: "새 Python 프로덕션 에이전트의 기본값으로 두되, 상태적이고 가지 치는 오케스트레이션에서는 LangGraph를 도구함에 두라." **외부 의존성.** 내구성 실행(durable execution)은 Temporal·Restate 같은 외부 시스템을 운용하는 전제가 붙는다. **학습 곡선.** Pydantic 모델 사고방식이 자연스럽지 않은 사용자에게는 장벽이라는 기록이 있다. 다만 5년 이상 Python을 써 본 사람에게는 "FastAPI 같은 감각"이라는 표현이 자주 나온다. --- ### 4. 프레임워크 지형에서의 위치 2026년 비교 자료들이 도달한 3갈래 정리가 실용적이다. | 선택지 | 적합한 곳 | | --- | --- | | Pydantic AI | 타입 안전·검증 출력·다중 제공사 Python 에이전트 | | LangGraph | 사이클·체크포인트가 있는 상태 오케스트레이션 | | CrewAI | 다중 에이전트 크루의 빠른 프로토타이핑 | OpenAI Agents SDK와의 비교도 반복된다. SDK가 OpenAI 중심의 일등급 기능을 주는 반면, Pydantic AI는 제공사 중립과 Pydantic 네이티브함을 택한다는 구도다. OpenAI에 올인했다면 SDK, 여러 제공사를 쓰거나 타입 출력을 중시하면 Pydantic AI라는 것이 사용자들의 분류다. --- ### 5. 결론 — 두려움이 구조화된 형태 Pydantic AI에 대한 기록은 한 문장으로 정리된다. **"LLM이 돌려주는 것이 내가 기대한 형태가 아닐 때"라는 두려움을, 런타임 예외가 아니라 타입 체커의 영역으로 옮겨 준 도구다.** 그 이점은 마케팅이 아니라 운영 리스크의 감축이다. 툴이 잘못된 형태를 반환하고, 하류 코드가 존재하리라 가정한 필드가 없어서 새벽에 울리는 페이지. 그 오류들은 Pydantic AI가 빌드 타임으로 옮기는 바로 그 오류들이다. 대신 빠른 릴리스를 관리하는 규율과, 범위를 벗어난 오케스트레이션의 정직한 분리가 필요하다. 관련 글: [OpenAI Agents SDK 사용자 리뷰](/reviews/2026-10-10-openai-agents-sdk-user-reviews/) · [Google ADK 사용자 리뷰](/reviews/2026-10-10-google-adk-one-year-reviews/) · [Pydantic AI 에이전트 허브 항목](/agents/pydantic-ai/) --- ### 출처 - 커뮤니티: [Pydantic AI (r/LLMDevs, 2025-10)](https://www.reddit.com/r/LLMDevs/comments/1iih8az/pydantic_ai/) - 독립 리뷰: [Pydantic AI Review: Is the Type-Safe Framework Ready? (2026-05)](https://alatirok.com/pydantic-ai-review-2026/) · [Pydantic AI review (saas.pet, 2026-08)](https://saas.pet/reviews/pydantic-ai-review/) - 초기 체험: [Type-safe LLM agents with PydanticAI (2024-12)](https://simmering.dev/blog/pydantic-ai/) - 공식: [pydantic/pydantic-ai GitHub](https://github.com/pydantic/pydantic-ai)