원본 캡처

에이전트 프레임워크 지형 리서치 원본 — 2026-07-25

불변 캡처. 절대 편집하지 마라. 가공본은 위키 페이지에. 신뢰도 규칙: Anthropic 1차 = [HIGH]. 그 외 공식 docs/GitHub/PyPI 로 확인 = [MED-official]. 애그리게이터/블로그만 = [MED-agg] 또는 [LOW].

조사 방법

검색어 (WebSearch)

  1. LangGraph 2026 release version state persistence checkpointer documentation
  2. Microsoft Agent Framework AutoGen Semantic Kernel merger 2026 GA release
  3. OpenAI Agents SDK handoffs 2026 version documentation
  4. Google ADK Agent Development Kit 2026 version release Python Java
  5. CrewAI 2026 version release Flows crews documentation
  6. Pydantic AI 2026 version release agent framework documentation
  7. Mastra TypeScript agent framework 2026 version release workflows
  8. Claude Agent SDK 2026 version @anthropic-ai/claude-agent-sdk python subagents release

열어본 URL (WebFetch, 9건)

  • https://docs.langchain.com/oss/python/langgraph/persistence (LangChain 공식)
  • https://openai.github.io/openai-agents-python/ (OpenAI 공식)
  • https://pypi.org/project/pydantic-ai/ (PyPI, Pydantic 팀 배포)
  • https://devblogs.microsoft.com/agent-framework/migrate-your-semantic-kernel-and-autogen-projects-to-microsoft-agent-framework-release-candidate/ (Microsoft 공식 devblog)
  • https://github.com/mastra-ai/mastra/releases (Mastra 공식 GitHub)
  • https://github.com/google/adk-python/releases (Google 공식 GitHub)
  • https://adk.dev/2.0/ (Google ADK 공식 docs)
  • https://github.com/anthropics/claude-agent-sdk-python/releases (Anthropic 공식 GitHub)
  • https://github.com/crewAIInc/crewAI/releases (CrewAI 공식 GitHub)

확인된 사실 [신뢰도]

LangGraph (LangChain)

  • 추상화 모델 = 명시적 그래프: 노드(node) + 엣지(edge) + 상태(state). builder.compile() 로 그래프 컴파일, 메시지 + thread 설정으로 invoke. [MED-official] docs.langchain.com
  • 영속성 이중 구조 [MED-official] docs.langchain.com/oss/python/langgraph/persistence:
  • Checkpointer = thread 스코프 단기 메모리 (스레드별 상태 스냅샷). thread_id 를 그래프 config 로 넘겨 접근.
  • Store = thread 간 장기 메모리 (cross-thread 애플리케이션 데이터).
  • Checkpointer 백엔드 구현체 [MED-official]:
  • InMemorySaver — RAM, 개발용, 재시작 시 소실
  • PostgresSaver / AsyncPostgresSaver — 프로덕션 PostgreSQL
  • SqliteSaver — 로컬 파일, 개발용
  • 체크포인트 = 특정 시점 그래프 상태 스냅샷, 단조증가 고유 ID. 지원 기능: 대화 연속성, human-in-the-loop, time travel(체크포인트 간 상태 검사/되감기), fault tolerance(중단/타임아웃/재시작 후 재개). [MED-official]
  • 기본 직렬화기 = JsonPlusSerializer (ormsgpack + 확장 JSON fallback, LangChain 타입/datetime/enum 처리). [MED-agg] fast.io
  • 함정: PostgreSQL thread_id 컬럼 255자 제한, 초과 시 DB 에러. [MED-official]
  • 언어: Python 및 JavaScript/TypeScript(langgraphjs). [MED-agg]
  • 버전: 페이지에 명시 버전 없음. [unverified] — 구체 버전 못 잡음.

OpenAI Agents SDK

  • 핵심 프리미티브 4개: Agents(instructions + tools 를 가진 LLM), Handoffs(다른 에이전트로 위임), Guardrails(입출력 검증), + Sessions(영속 메모리), Tracing(내장). [MED-official] openai.github.io/openai-agents-python
  • Swarm(실험적 쿡북)의 후속. Responses API 위에 구축. [MED-agg] sureprompts.com
  • Handoff = LLM 에게 tool 로 노출됨. Refund Agent 로의 핸드오프 → transfer_to_refund_agent tool 로 호출. 모든 에이전트에 handoffs 파라미터. on_handoff 콜백, input_filter 로 다음 에이전트가 받는 입력 필터링. [MED-official] openai.github.io/.../handoffs/
  • 세션(상태) 전략 다수: 내장 세션, SQLAlchemy, SQLite(advanced), 암호화 세션, Redis, MongoDB, Dapr. [MED-official]
  • 관측성: 내장 tracing (워크플로 시각화·디버깅·모니터링), OpenAI eval/fine-tune/distillation 스위트 연동. [MED-official]
  • 언어: Python 중심(repo = openai-agents-python). 별도 JS/TS SDK 존재 (github.com/openai/openai-agents-js). docs 는 EN/JA/KO/ZH. [MED-official]
  • 버전: 구체 버전 못 잡음. [unverified]

Google ADK (Agent Development Kit)

  • 최초 공개 2025년 4월, Google. Apache 2.0. [MED-agg] futureagi.com
  • 언어 5종: Python, TypeScript, Go, Java, Kotlin. Python·Go 가 2.0 릴리스 보유. [MED-official] adk.dev/2.0
  • 모델: model-agnostic, Gemini 최적화, LiteLLM 통해 OpenAI/Anthropic 등 지원. [MED-agg]
  • ADK 2.0 = Workflow Runtime 도입: 계층적(hierarchical) agent executor → 그래프 기반(graph-based) 실행 엔진으로 전환. 에이전트·툴·함수가 워크플로 그래프의 개별 노드. 결정론적(deterministic) 실행 경로. [MED-official] adk.dev/2.0
  • 릴리스 시점 [MED-official] adk.dev/2.0:
  • ADK Python 2.0 = 2026-05-19 GA
  • ADK Go 2.0 = 2026-06-30 GA
  • ADK Python 최신 릴리스 (GitHub releases, verified 2026-07): v2.5.0 (2026-07-16) — Cloud Run sandbox code executor, to_mcp_server(ADK 에이전트를 MCP 로 서빙). 그 외 v2.4.0(2026-07-07, Managed Agents API + OpenAI Responses API 지원), v2.3.0(2026-06-18), v2.2.0(2026-06-04). [MED-official] github.com/google/adk-python/releases
  • ※ 같은 릴리스 목록에 v1.36.2(2026-07-21, Gemini 연결 로직 버그픽스)도 존재 → 1.x 라인과 2.x 라인이 병존하는 듯. 아래 "엇갈림" 참조.
  • 핵심 추상화: agents(노드), 커스텀 tools, sessions(대화 상태·이력), state(워크플로 데이터). [MED-official]

CrewAI

  • 추상화 모델 = 역할(role) 기반 + Flows:
  • Crew = 단일 실행 컨텍스트에서 협업하는 에이전트 그룹. [MED-agg] jahanzaib.ai
  • Flow = 상위 오케스트레이션 계층, 여러 crew 를 조건 로직·상태관리·이벤트 트리거로 연결. [MED-agg]
  • 최신 버전: 1.15.6 (2026-07-24) — Anthropic tool-use 감지 버그픽스, async agent 로딩. 그 외 1.15.5(skill registry auth), 1.15.4(Skills Repository 정식화), 1.15.3(execution hooks, flow TUI), 1.15.2(templated flow inputs, streaming). [MED-official] github.com/crewAIInc/crewAI/releases
  • ※ WebFetch 소형모델이 연도를 "2024"로 오기 → 실제 현재 2026-07 기준. 버전 번호(1.15.x)는 신뢰, 연도는 캡처 시점 기준 2026.
  • ※ 별도 검색은 "stable 1.14.3 / 2026-04-24" 라고 함(releasebot). 1.15.x 가 더 최신.
  • 최근 방향: conversational flows(CLI TUI), 선언적 refs(flows·crews 공통), execution hooks, Snowflake Cortex LLM 프로바이더, 체크포인트 restore, runtime isolation. [MED-agg] releasebot.io
  • 언어: Python. [MED-agg]

Pydantic AI

  • Pydantic 팀이 만든 타입 안전(type-safe) Python 에이전트 프레임워크. "the Pydantic way". MIT 라이선스. [MED-official] pypi.org/project/pydantic-ai
  • 최신 버전: v2.17.0 (2026-07-24). [MED-official] pypi.org (verified 2026-07)
  • stable v2.0.0 = 2026-06-23 도달(검색). 그 후 다수 후속 릴리스. [MED-agg] xpay.sh
  • ※ 다른 검색은 "v2.6.0 (2026-07)" 언급 → PyPI 페이지가 2.17.0 로 더 최신·1차. 2.17.0 채택.
  • 모델 지원: OpenAI, Anthropic, Gemini, DeepSeek, Grok, Cohere, Mistral, Perplexity + 다수 클라우드. 커스텀 모델 가능. [MED-official]
  • 핵심 기능 [MED-official]:
  • 완전 타입 안전, IDE 지원, static type check
  • 관측성 = Pydantic Logfire 연동(실시간 디버깅, evals 기반 모니터링)
  • Toolsets: tools/hooks/instructions/model settings 를 묶는 조합 가능 단위
  • MCP 지원
  • Human-in-the-loop = tool approval
  • 구조화 출력 스트리밍
  • 그래프: 타입 힌트로 그래프 정의 (pydantic-graph)
  • Durable execution: 일시적 API 실패·앱 에러에도 진행상황 보존하는 durable agent
  • 생태계: Pydantic AI Gateway(모델 라우팅), Pydantic Evals(평가). [MED-agg]

Mastra

  • TypeScript 오픈소스 에이전트 프레임워크. agents / workflows / memory / workspaces / observability 제공. [MED-official] mastra.ai
  • v1.0 = 2026년 1월. [MED-agg] mastra.ai
  • 최신 버전: @mastra/core@1.51.0 (2026-07-15). [MED-official] github.com/mastra-ai/mastra/releases (verified 2026-07)
  • 최근: 1.50.0(2026-07-06), 1.49.0(2026-07-03), 1.48.0(2026-07-01), 1.47.0(2026-06-26).
  • 워크플로 엔진 = 그래프 기반, 명시적 제어. .then() / .branch() / .parallel() 체이닝 문법. 순차·병렬·조건 분기. [MED-agg] mastra.ai
  • 1.51.0 신기능 [MED-official]:
  • Durable Agent 크래시 복구: DurableAgent.listActiveRuns() / recoverActiveRuns() 로 재시작 후 고아 run 복구
  • Scoped AgentController 세션(동일 리소스 위 독립 병렬 세션)
  • @mastra/platform-workspace@0.1.0(Platform 관리 인프라 연결)
  • @mastra/code-sdk@0.1.0(커스텀 UI)
  • MCP 서버 SSE 진행 알림 개선
  • 1.50.0(2026-07)에 @mastra/livekit 추가 — Mastra 에이전트를 realtime voice 에이전트로. [MED-agg]
  • 배포: standalone 서버 또는 React/Next.js/Node 통합. [MED-agg]

Microsoft Agent Framework (AutoGen + Semantic Kernel 통합)

  • Microsoft 공식: Semantic Kernel 과 AutoGen 의 후속(successor), "동일 팀이 만든 direct successor". [MED-official] devblogs.microsoft.com/agent-framework
  • 언어: .NET 과 Python 통합 프로그래밍 모델. NuGet(.NET) + PyPI(Python) 배포. [MED-official]
  • 핵심 추상화 [MED-official]:
  • 에이전트 + function tools(타입 안전)
  • 그래프 기반 워크플로: sequential / concurrent / handoff / group chat 패턴, 스트리밍 + checkpointing 지원
  • 워크플로 엔진 = 멀티에이전트 조합
  • Sessions(멀티턴), 이벤트 기반 아키텍처
  • MCP + A2A(Agent-to-Agent) 프로토콜이 네이티브 (bolt-on 아님, 1.0 에 포함). [MED-agg] cloudsummit.eu
  • 타임라인:
  • RC = 2026-02-19 (devblog: "API surface stable, 1.0 기능 완료"). [MED-official]
  • 1.0 GA = 2026-04-02 (일부 출처 04-03). [MED-agg] digitalapplied.com, jangwook.net
  • AutoGen 과 Semantic Kernel 은 maintenance mode 진입 — 버그픽스·보안패치만, 신기능 없음. 2026-06 기준 AutoGen repo 에 공식 유지보수 공지. [MED-agg] alexbevi.com

Claude Agent SDK (Anthropic) — 규격서 §7 과 대조

  • [HIGH] (Anthropic 1차, 규격서 §7): Claude Agent SDK(claude-agent-sdk / @anthropic-ai/claude-agent-sdk) = Claude Code 를 라이브러리로 만든 별개 제품. 내장 툴 포함(파일·bash·MCP 등), agent loop·hooks·subagents·sessions·built-in tools.
  • [HIGH] Tool Runner ≠ Agent SDK: Tool Runner 는 일반 Anthropic SDK 안의 루프 헬퍼(Python @beta_tool+client.beta.messages.tool_runner, TS betaZodTool+toolRunner). 내장 툴 없음, 베타. 두 개는 완전히 다른 물건. (규격서 §7, 임무 지시에서 재확인)
  • [HIGH] Managed Agents(베타, managed-agents-2026-04-01): Anthropic 이 에이전트 루프 + 세션별 샌드박스 컨테이너 호스팅. Agent(설정·버전관리) → Session(실행). model/system/tools 는 Agent 에 있고 Session 에 없음. (규격서 §7)
  • 언어: Python + TypeScript. [MED-official] github.com/anthropics/claude-agent-sdk-python
  • claude-code-sdk 로 출발 → 2025 말 claude-agent-sdk 로 개명. [MED-agg] inference.net
  • 최신 버전(GitHub releases, verified 2026-07): v0.2.127 — background task 중 stdin 조기 종료 버그픽스. v0.2.126(terminal_reason, typed model_usage), v0.2.125(CLI 2.1.217), v0.2.124(Windows cmd injection 방어). [MED-official] github.com/anthropics/claude-agent-sdk-python/releases
  • ※ WebFetch 소형모델이 연도를 "July 2025"로 오기 → PyPI 검색은 0.2.126 을 2026-07-22 로 확인. 버전 번호 신뢰, 연도는 2026.
  • ※ PyPI 상태 라벨이 "Alpha"(2026-03 기준)라는 애그리게이터 언급 있음 — 버전 0.2.x 와 정합. [MED-agg]
  • 기능: agent loop, custom tools, hooks(PreToolUse 등), MCP, subagents(run_in_background: true), built-in tools, sessions. [MED-official]

언제 프레임워크를 쓰고, 언제 안 쓰나 (수집된 관점)

  • Pydantic AI 는 "좁고 잘 정의된 작업"에 가벼운 프레임워크로 권장됨. [MED-agg] winder.ai
  • 일반 패턴(수집): 단일 LLM 호출 + 몇 개 tool 이면 프레임워크 없이 SDK 직접(Anthropic Messages API / Tool Runner)로 충분. 멀티에이전트 오케스트레이션·상태 영속·human-in-the-loop·관측성이 필요할 때 프레임워크. — 이건 종합 추론이므로 위키에서 [inferred] 표기 필요.

엇갈리거나 미확인

  • Google ADK 버전 라인 혼란: adk.dev/2.0 은 "Python 2.0 GA 2026-05-19" 라 하는데, github releases 최신은 v2.5.0(2026-07-16)이면서 동시에 v1.36.2(2026-07-21)도 존재. 1.x 와 2.x 가 병렬 유지되는 구조로 보이나 정확한 관계(2.x 가 별도 패키지인지, 1.x 가 LTS 인지) 미확인.
  • CrewAI 최신 버전: github(1.15.6) vs releasebot(stable 1.14.3). 1.15.x 채택하되 "stable vs latest" 구분 미확인.
  • Pydantic AI 버전: PyPI 2.17.0 vs 검색 2.6.0 — PyPI(1차) 우선하여 2.17.0. 단 릴리스 속도가 빨라 캡처 후 곧 낡을 값.
  • Microsoft Agent Framework 1.0 GA 날짜: 2026-04-02 vs 04-03 — 애그리게이터 간 하루 차이. devblog(1차) RC 는 확인했으나 GA 정확일자는 1차 확인 못 함.
  • LangGraph / OpenAI Agents SDK 구체 버전 번호: 1차 페이지에서 버전 못 잡음. 미확인.
  • claude-agent-sdk / crewai 릴리스 연도: WebFetch 소형모델이 각각 2025/2024 로 오기. 버전 번호와 PyPI 교차검증으로 2026-07 로 판단하나, GitHub 페이지 직접 재확인은 안 함.

⛔ DO-NOT-CITE (조작 의심 / 단일 저신뢰 출처)

  • "Claude 구독 플랜에 별도 Agent SDK 크레딧: $20(Pro)/$100(Max 5x)/$200(Max 20x), 2026-06-15 부터" — helply.com 애그리게이터 단일 출처, Anthropic 1차 확인 안 됨. 규격서 §7 에도 없음. 인용 금지.
  • 각종 애그리게이터의 GitHub star 수·"채택률" 수치 — 검증 불가, 인용 금지.
  • 벤치마크/속도 정량 수치 전반 — 규격서 §5 에 의해 인용 금지.

원문 발췌 (핵심)

  • LangChain 공식(persistence): "Checkpointers = short-term, thread-scoped memory; Stores = long-term, cross-thread memory." "checkpoint ... identified by a unique, monotonically increasing ID." 백엔드: InMemorySaver / PostgresSaver / SqliteSaver. 함정: "PostgreSQL thread_id column limited to 255 chars."
  • OpenAI 공식: "Agents: LLMs equipped with instructions and tools." "Handoffs ... delegate to other agents." "Guardrails: validation of agent inputs and outputs." + 내장 sessions, tracing. 세션 백엔드: SQLAlchemy/SQLite/encrypted/Redis/MongoDB/Dapr.
  • OpenAI handoffs docs: "Handoffs are represented as tools ... a handoff to an agent named Refund Agent, the tool would be called transfer_to_refund_agent."
  • Microsoft devblog: Agent Framework = "successor to Semantic Kernel and AutoGen", "created by the same teams". "Graph-based workflows supporting sequential, concurrent, handoff, and group chat patterns with streaming and checkpointing." RC 2026-02-19, NuGet+PyPI prerelease.
  • adk.dev/2.0: "ADK 2.0 transitions ADK from a hierarchical agent executor to a graph-based execution engine." 언어 Python/TS/Go/Java/Kotlin. Python 2.0 GA 2026-05-19, Go 2.0 GA 2026-06-30.
  • PyPI pydantic-ai: v2.17.0 (2026-07-24). "define graphs using type hints" + "durable agents that can preserve their progress across transient API failures."
  • Mastra GitHub: @mastra/core@1.51.0 (2026-07-15). "Durable Agent Crash Recovery ... DurableAgent.listActiveRuns() and recoverActiveRuns()." 워크플로 .then()/.branch()/.parallel().
  • CrewAI GitHub: 최신 1.15.6. Crew(단일 컨텍스트 협업 에이전트 그룹) + Flow(상위 오케스트레이션, 조건로직·상태·이벤트).
  • Anthropic claude-agent-sdk-python GitHub: v0.2.127. subagents(run_in_background: true), PreToolUse hooks, SDK-MCP, terminal_reason/model_usage.