PydanticAI와 FastAPI 기반의 오픈소스 AI 에이전트 런타임 'Agent2' 공개

실용적 조언

Claude Code를 사용 중이라면 Agent2 리포지토리를 열어 /create-agent 명령어로 에이전트 백엔드를 즉시 구축해볼 수 있다.
복잡한 에이전트 로직에 승인 절차가 필요하다면 내장된 approvals 기능을 활용하여 안정성을 확보할 수 있다.

섹션별 상세

Agent2는 Claude Code가 프레임워크 사용법을 즉시 학습할 수 있도록 SKILL.md 파일을 포함한다. 사용자가 Claude Code에서 리포지토리를 열면 /create-agent와 같은 명령어를 통해 에이전트 서비스를 자동으로 스캐폴딩하고 지식 베이스를 추가할 수 있다. 이 방식은 개발자가 프롬프트만으로 프로덕션 수준의 에이전트 백엔드를 구축할 수 있게 돕는다.

이 런타임은 PydanticAI와 FastAPI를 결합하여 에이전트의 안정성과 확장성을 확보했다. 입력 스키마를 정의하면 API 엔드포인트가 자동으로 생성되는 구조를 채택하여 개발 생산성을 높였다. R2R 컬렉션을 통한 지식 관리와 테넌트별 스코핑 기능을 통해 복잡한 문서 처리 워크플로우를 지원한다.

단순한 데모를 넘어 승인 절차(approvals), 일시 중지/재개(pause/resume), 프로바이더 라우팅 등 실무에 필수적인 기능을 제공한다. 개발자는 /adding-capabilities 스킬을 사용하여 에이전트에 제어 로직을 쉽게 추가할 수 있다. 실제 환경에서 400만 개 이상의 문서를 처리하며 안정성을 검증받았다는 점이 핵심이다.

용어 해설

파이단틱 AI(PydanticAI): — Pydantic 기반의 AI 에이전트 프레임워크로, 데이터 검증과 구조화된 출력을 보장하여 LLM 애플리케이션의 안정성을 높인다.
클로드 코드(Claude Code): — Anthropic의 CLI 도구로, 로컬 코드베이스를 이해하고 직접 코드를 수정하거나 명령어를 실행하여 개발 작업을 보조한다.
R2R: — Retrieval-to-Response의 약자로, 대규모 문서 검색 및 지식 베이스 관리를 위한 오픈소스 RAG 엔진이다.
스캐폴딩(Scaffolding): — 프로젝트의 기본 구조와 설정 파일을 자동으로 생성해주는 기법으로, 초기 개발 시간을 단축하고 표준화된 아키텍처를 유지하게 돕는다.

언급된 도구

Agent2추천링크

AI 에이전트 프로덕션 런타임

PydanticAI중립

에이전트 구축 프레임워크

FastAPI중립

웹 프레임워크 및 API 서버

Claude Code추천

CLI 기반 AI 코딩 보조 도구

언급된 리소스

GitHubAgent2 GitHub Repository