pydantic/pydantic-ai

어떤 프로젝트인가요?

핵심 기능

• 01모델 문자열을 사용해 여러 모델 제공업체 간에 전환할 수 있습니다.
• 02의존성 주입을 지원하는 구조화된 검증 출력과 타입 지정 함수 도구를 제공합니다.
• 03동일한 에이전트를 CLI, 웹 채팅, 실시간 음성 세션 또는 UI 이벤트 스트림으로 실행할 수 있습니다.
• 04Temporal, DBOS, Prefect 등의 엔진에서 내구성 있는 실행을 지원합니다.
• 05OpenTelemetry 기반 계측으로 모델과 도구 호출을 추적할 수 있습니다.
• 06같은 패키지에서 이미지 생성과 임베딩을 지원합니다.

활용 사례

• LLM 출력에서 검증된 Pydantic 모델을 반환하는 타입 지정 데이터 추출 파이프라인 구축.
• Temporal 또는 DBOS를 통해 재시작 후에도 실행을 이어 가야 하는 장시간 연구 에이전트 제작.
• 실시간 대화 중 내부 도구를 호출하는 음성 어시스턴트 추가.
• 테스트 데이터셋을 기준으로 에이전트의 답변과 도구 호출 동작 평가.

빠른 시작

1. 1

   uv로 패키지를 설치합니다

   uv add pydantic-ai
2. 2

   Agent가 포함된 Python 파일을 만들고 agent.run_sync(...)를 호출해 타입이 지정된 결과를 가져옵니다

사용 전 알아둘 점

• !호스팅 모델을 대상으로 예제를 실행하려면 해당 제공자의 API 키가 필요하며, README에는 자세한 설명이 없습니다.
• !지속성 있는 실행, 실시간 음성 등의 고급 기능을 사용하려면 추가 설치와 Temporal 같은 별도의 백엔드가 필요합니다.

토픽

자주 묻는 질문

pydantic-ai은(는) 무엇인가요?

모델, 웹 프런트엔드, CLI, 음성 인터페이스와 내구성 있는 백그라운드 워크플로에서 실행되는 타입 지정 에이전트를 만드는 Python AI SDK입니다. Pydantic AI는 입력, 출력, 의존성에 타입을 지정해 AI 에이전트를 만드는 Python SDK입니다. OpenAI, Anthropic, Google, Groq 등의 제공업체 모델은 문자열만 바꾸면 전환할 수 있으며, 동일한 에이전트를 CLI, 내장 웹 채팅, 실시간 음성 세션 또는 프런트엔드 연동용 UI 이벤트 스트림으로 제공할 수 있습니다.

pydantic-ai은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

pydantic-ai은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

pydantic-ai은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. pydantic-ai의 마지막 커밋은 2026년 10월 20일입니다.

pydantic-ai은(는) 어디에 사용할 수 있나요?

LLM 출력에서 검증된 Pydantic 모델을 반환하는 타입 지정 데이터 추출 파이프라인 구축. Temporal 또는 DBOS를 통해 재시작 후에도 실행을 이어 가야 하는 장시간 연구 에이전트 제작. 실시간 대화 중 내부 도구를 호출하는 음성 어시스턴트 추가. 테스트 데이터셋을 기준으로 에이전트의 답변과 도구 호출 동작 평가.

pydantic-ai는 어떻게 설치하나요?

uv로 패키지를 설치합니다: uv add pydantic-ai Agent가 포함된 Python 파일을 만들고 agent.run_sync(...)를 호출해 타입이 지정된 결과를 가져옵니다

pydantic-ai은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/pydantic/pydantic-ai