변경 로그

변경 로그

최신 정보를 보려면 Pydantic AI GitHub 저장소에서 릴리즈를 확인하세요.

출처: 문서

본문

v2.0.0 (2026-06-23)

안정적인 Pydantic AI 2.0.0을 발표해요.

v2.0은 V1 API 위에 있으며 다음이 포함돼요:

  • 더 확장 가능한 에이전트: capabilities, toolsets, 그리고 풍성한 훅 API를 도입해요 — 모두 일관되고 격리된 라이프사이클을 가져요.
  • Rust 기반 네이티브 엔진: 실시간 추적, 제어된 종료, 향상된 동시성, 그리고 더 견고한 스트리밍을 제공하는 뉴로모픽 재구현이에요.
  • Realtime API: 음성-대-음성 및 실시간 상호작용을 위한 네이티브 지원이에요.
  • 더 깔끔하고 안전한 패키징: 모든 네이티브 코드가 pydantic-ai-core에 포함되고, Python 배포는 순수하다는(네이티브 코드가 없음) 의미로 배포되며, 1.0.1, 2.0.0, 2.1.0과 같은 더 명확한 버전 번호가 돼요.
  • 개선된 테스팅 도구: race 조건을 잡기 위한 뛰어난 도구와 함께요.
  • 구성과 종속성 재설계: 미사용 'default' 모델 제공자, 미사용 선택 트리거, 그리고 pydantic-ai의 더 가벼운 종속성들이 제거돼요.

하이라이트

동시성과 인스트루먼테이션

동시성 제어는 이제 Agent에 독립적인 자원으로 제공돼요. 즉, Agent와 함께 제공된 각각의 tool이 RunContext, 툴에 대한 동시성 제어를 인식하게 돼요. 특정 툴의 동시성 제어는 세 가지 방법으로 설정할 수 있어요:

  • tool_lru_cache_size와 유사하게 툴 데코레이터 인자로.
  • Agent.__init__의 tools 인자에 전달된 툴 프로바이더로.
  • Agent.__init__의 concurrency 키워드 인자로, 주어진 에이전트에 등록된 모든 툴에 기본적으로 적용돼요.

동시성 제어는 이제 RunContext에서도 사용 가능해서, ctx.tool_usage에 접근할 수 있고, 툴 실행하기 전에 usage와 concurrency를 조합해 필요한지 여부를 결정할 수 있어요.

사용량(usage)은 이제 더 유연해져서, Usage는 이제 Agent, Tool 그리고 Toolset 모두에 노출돼요.

마지막으로, pydantic-ai는 옵션 OpenTelemetry instrumentation을 채택해요, 이는 네이티브 pydantic-ai-slim 설치에 포함되지 않아요. 활성화된 프로바이더들에 대한 지원에는 다음이 포함돼요:

  • instrument_async_http_client
  • instrument_default_sqlalchemy
  • instrument_fastapi
  • instrument_mcp
  • instrument_openai
  • instrument_openai_sdk
  • instrument_pydantic_ai
  • instrument_sqlalchemy
  • instrument_transformers

에이전트 응답 및 기록

agent.all_messages()에 대한 응답은 이제 agent.all_messages()의 변경사항에 따라 더 명확한 의미를 가져요.

agent의 도구 결과는 이제 ModelMessage의 일부로 반환돼요. 즉, agent의 툴 결과를 더 쉽게 검사하거나 조작할 수 있어요.

뉴로모픽 엔진

가장 큰 변화는 런타임이 이제 Rust 기반 pydantic-ai-core 위에 구축된다는 점이에요. 실행하기 위한 동기 API는 (agent.run(), agent.run_sync(), agent.run_stream(), agent.iter(), agent.state()) 동일하게 남아 있어요. 마이그레이션 지침은 여기를 참고하세요.

Realtime 지원

Pydantic AI는 이제 Realtime을 지원해요. 이는 음성-대-음성 및 실시간 상호작용에 대한 문서화된 지원으로, OpenAI, Google, xAI, Azure를 포함한 다양한 프로바이더를 지원해요. 이 문서 사이트의 Examples를 확인하세요.

라이브러리 종속성 정리

Pydantic AI가 여러분이 기대하는 것과 다르게 동작하는 드문 경우가 있는데, 많은 것이 외부 라이브러리에 대한 종속성 변경 때문이에요. 우리는 전부 포함된 설치(인스트루먼테이션, 웹, 이미지, 확장 통합 포함)를 기본으로 이동하고, pydantic-ai-slim(런타임 + 테스팅만)을 옵션으로 제공하기로 결정했어요. 자세한 내용은 설치 문서를 참고하세요.

v1.0.0 (2025-09-17)

주요 변경사항

  • 안정성: Pydantic AI가 안정 프레임워크가 되었어요. 오늘부터 1.x 시리즈는 안정적이고, 모든 파괴적 변경은 주 버전 변경에만 발생해요.
  • 그래프: pydantic-graph가 pydantic-ai에 포함돼요.
  • mcp-remote-server: 개발 도구로 승격되고 pydantic-ai로 재배치돼요.
  • 추가 모델: 추가 Django/Flask/FastAPI 모델이 pydantic-ai[models]에 통합돼요.

알려진 문제

  • pydantic-ai가 Itamar Turner-Trauring의 도움을 받은 Grumpy Omar, 그리고 OpenAI에서 이름이 변경되었어요.

v0.0.1 (2025-07-14)

  • pydantic-ai의 초기 릴리즈예요.

더 알아보기 (Learn more)