Pydantic AI 2.0 완전정리 — capability로 조립하는 AI 에이전트 구축법

핵심 메시지

• Pydantic AI 2.0은 에이전트를 구성하는 단일 기본 단위로 'capability(역량)'를 도입했다.
• capability는 지시문, 도구, 라이프사이클 훅, 모델 설정, 가드레일을 하나로 묶은 조립 가능한 단위다.
• 레고 블록처럼 여러 에이전트 사이에서 capability를 재사용할 수 있어, 하나를 개선하면 그것을 쓰는 모든 에이전트가 동시에 이득을 본다.
• capability는 스킬처럼 '점진적 공개'를 지원해, 에이전트가 실제로 필요할 때만 전체 지시를 불러온다.
• 프레임워크는 대부분의 에이전트에 필요한 '린 코어'와, 코드 실행 같은 선택적 기능을 감싸는 '하네스'의 두 층으로 나뉜다.

쉽게 이해하기

AI 에이전트 프레임워크를 오래 다뤄 온 콜 메딘은 Pydantic AI를 자신이 가장 선호하는 프레임워크로 꼽으며, 이번 2.0 릴리스를 에이전트 구축 방식의 큰 진화로 소개했다. 핵심은 'capability'라는 하나의 기본 단위로 모든 것을 표현하게 됐다는 점이다.

capability는 에이전트가 갖는 하나의 책임을 이루는 요소들 — 외부 세계와 닿는 도구, 방향을 잡아 주는 지시문과 가드레일, 모델 설정, 훅 — 을 한 덩어리로 묶는다. 그래서 에이전트는 이제 이런 조립 가능한 단위들의 집합으로 단순하게 생각할 수 있다. 발표자는 이를 MCP 서버보다 한 층 위의 개념으로 설명했다. MCP가 도구 묶음을 공유하는 방식이라면, capability는 그 도구에 더해 지시·설정·훅·가드레일까지 함께 패키징한다.

재사용성이 큰 장점이다. 예컨대 '지식베이스' capability를 만들어 두면, 사람에게 에스컬레이션까지 하는 고객지원 에이전트와 단순 FAQ 위젯이 같은 capability를 공유할 수 있다. 나중에 그 지식베이스 capability의 지시·가드레일·도구를 개선하면 두 에이전트가 동시에 혜택을 받는다. 발표자는 1.0에서 도구와 지시가 뒤섞여 조직화·조립이 어려웠던 코드와 대비해, 2.0의 생성자가 훨씬 단순해졌음을 보여 줬다.

capability는 클로드 코드·코덱스의 스킬처럼 '점진적 공개(progressive disclosure)'를 구현한다. 에이전트에는 각 capability의 짧은 설명만 목록으로 주고, 실제로 필요하다고 판단할 때만 전체 지시를 불러온다. 덕분에 수십에서 수백 개의 capability를 줘도 LLM을 압도하지 않는다. 데모에서 에이전트는 '슬랙 연동' 질문에는 지식베이스만 사용하고, '중복 결제 환불' 요청에는 에스컬레이션 capability를 추가로 불러왔다.

프레임워크 구조도 두 층으로 정리됐다. 대부분의 에이전트에 필요한 '사고(thinking)·웹 검색·도구 검색' 같은 것은 린 코어에서 직접 지원하고, 코드를 샌드박스에서 실행하는 '코드 모드'처럼 다수에게 필수는 아니지만 지원하고 싶은 기능은 하네스가 감싼다. 발표자는 이 방식이 코어를 가볍게 유지하면서도 필요할 때 강력한 기능을 꺼내 쓰게 해 준다고 평가했다.

주요 인사이트

• capability를 이루는 요소들 자체는 새로운 것이 아니다 — 이미 쓰고 있는 스킬·훅·MCP를 프레임워크로 단순하게 끌어들이는 방식이 핵심 가치다.
• 발표자는 Pydantic AI가 코딩 에이전트 SDK의 부상으로 잠시 뒤처졌다가, capability 도입으로 다시 업계를 앞서게 됐다고 평가했다.
• 코딩 에이전트 SDK는 개인용 에이전트에는 쉽고 편하지만 더 느리고 토큰을 많이 쓴다 — 프로덕션에 배포하고 여러 사용자가 쓰는 에이전트에는 여전히 프레임워크가 필요하다.
• 발표자는 Pydantic AI 코드를 손으로 짜기보다, capability 문서를 코딩 에이전트에 직접 물려 만들게 하라고 권한다. 방대한 문서는 사람보다 에이전트가 소비하도록 만들어졌다는 것이다.
• Pydantic의 모회사는 몬티(Monty)라는 오픈소스 경량 샌드박스를 개발 중이며, 코드 모드 같은 하네스 capability의 기반이 된다.

자주 묻는 질문

관련 AI 소식