Pydantic AI로 마이그레이션
Pydantic AI로 마이그레이션 (Migrate to Pydantic AI)
다른 에이전트 프레임워크로 만든 애플리케이션이 있다면, Pydantic AI와 함께 번들되는 마이그레이션 스킬을 코딩 에이전트가 사용할 수 있어요. 각 스킬은 에이전트가 원본 프레임워크를 이해하고, 올바른 Pydantic AI 컴포넌트를 고르며, 한 번에 하나의 동작하는 애플리케이션 경로를 이식하도록 돕습니다.
출처: 문서
본문
스킬들은 API 이름을 일대일로 번역하는 대신 동작을 보존해요. 책임을 이렇게 나눕니다:
- Pydantic AI — 에이전트, 모델, 도구, 출력, 메시지, 스트리밍;
- Pydantic Graph — 명시적 애플리케이션 제어 흐름;
- Pydantic AI Harness — 스킬, 메모리, 서브에이전트, 플래닝, 샌드박스 도구 같은 선택적 캐퍼빌리티;
- Pydantic Evals — 평가 데이터셋과 검사;
- 여러분의 애플리케이션 — 인증, 스토리지, API, UI, 배포, 그 밖의 제품 인프라.
지원되는 원본 프레임워크 (Supported source frameworks)
| 원본 프레임워크 | 마이그레이션 스킬 |
|---|---|
| LangChain and LangGraph | migrating-langchain-to-pydantic-ai |
| Agno | migrating-agno-to-pydantic-ai |
| Claude Agent SDK | migrating-claude-agent-sdk-to-pydantic-ai |
| Google Agent Development Kit | migrating-google-adk-to-pydantic-ai |
| Mastra | migrating-mastra-to-pydantic-ai |
| OpenAI Agents SDK | migrating-openai-agents-sdk-to-pydantic-ai |
| Pi | migrating-pi-to-pydantic-ai |
| Vercel AI SDK and Eve | migrating-vercel-ai-sdk-and-eve-to-pydantic-ai |
마이그레이션 스킬 사용 (Use a migration skill)
프로젝트 의존성과 함께 번들된 스킬을 설치합니다:
uvx library-skills --all
설치 세부 사항(Claude Code 지원 포함)은 Coding Agent Skills를 보세요.
그런 다음 기존 애플리케이션을 코딩 에이전트에서 열고 요청에서 해당 스킬의 이름을 지정하세요. 예:
Use the migrating-openai-agents-sdk-to-pydantic-ai skill to migrate this application
to Pydantic AI. Preserve its existing API and behavior, and verify the port with tests.
코딩 에이전트는 먼저 원본 애플리케이션을 통해 실제 요청을 추적하고 호출자가 관찰하는 것을 기록해야 해요. 그다음 가장 작은 완전한 경로를 마이그레이션하고, 같은 경계에서 옛·새 동작을 테스트하며, 정확히 보존할 수 없는 차이는 설명합니다. 모든 필수 경로가 검증된 후에만 옛 프레임워크를 제거하세요.