TL;DR

AG2 v0.12.0 (phát hành 17/04/2025) là release đầu tiên trên lộ trình chính thức tới v1.0. Bản này mở beta framework mới (autogen.beta) với Toolkits, Tasks, Observer API, AG-UI, Multimodal input và AgentSpec; đồng thời bổ sung FilesystemToolset, LocalShellTool, Skills, DaytonaCodeExecutorNLIP ở core. 11 agent cũ và nhiều tool đã được đánh dấu deprecated và sẽ bị gỡ ở v0.14 — cộng đồng có window v0.12 → v0.13 để phản hồi trước khi API đóng băng.

AG2 GitHub repo: 4k stars, 185 contributors, 591 forks

What's new

AG2 v0.12.0 chia làm 3 nhóm thay đổi lớn:

  • Beta framework (autogen.beta): lần đầu ra mắt bộ Toolkits, Tasks API (Agent.as_tool()), Observer API để subscribe sự kiện agent, AG-UI cho giao diện trực quan, Multimodal Input (Image, Document, Audio, Video) hỗ trợ OpenAI, Gemini, Anthropic, AgentSpec khai báo cấu hình agent, cùng Serializable Agents và Tool-Driven Handoffs.
  • Tool mới: FilesystemToolset (thao tác file), LocalShellTool + LocalShellEnvironment (chạy shell), Skills Tool + Search Skills (đóng gói & tìm kiếm capability), WebSearchTool streaming, Code Execution Tool, Middleware hỗ trợ trên Toolkit/FunctionTool.
  • Core framework: DaytonaCodeExecutor chạy code trong sandbox cô lập (Python, Bash, JavaScript, TypeScript), NLIP (Natural Language Interface Protocol), và AgentEligibilityPolicy để lọc ứng viên trong GroupChat runtime.

Why it matters

Trước v0.12, AG2 (tách ra từ Microsoft AutoGen) chủ yếu vá và mở rộng codebase gốc. Từ v0.12, team công bố rõ ràng rằng autogen.beta mới là tương lai: ở v1.0, beta sẽ thay thế framework hiện tại trên nhánh main, còn codebase gốc chuyển sang nhánh ag2-original ở chế độ maintenance. Điều này có nghĩa các team đang chạy production trên AG2 có một window cụ thể (v0.12 → v0.14) để migrate — không còn "tương lai" mơ hồ nữa.

Technical facts

Hạng mụcChi tiết
Phiên bảnv0.12.0 (17/04/2025)
Beta moduleautogen.beta
Multimodal providersOpenAI, Gemini, Anthropic
Sandbox runtimeDaytona (Python, Bash, JS, TS)
Security fixCVE-2025-69872 (DiskCache)
CI hardeningzizmor cho GitHub Actions
Repo4k+ stars, 185 contributors, 765 used-by

Một số bugfix đáng chú ý: TokenLimiter tính lại budget token-to-char chính xác, speaker selection gỡ điều kiện trùng lặp, Interop hiện đúng tên type trong thông báo lỗi, và browser-use nâng từ 0.1.37 lên >=0.3.1.

Comparison: v0.11.x → v0.12.0 → v1.0

PhaseTrạng tháiHành động cần thiết
v0.11.xFramework gốc, mọi agent cũ còn hoạt độngKhông có migration bắt buộc
v0.12 (hiện tại)Deprecation công bố; beta mở công khaiĐọc roadmap, thử beta, gửi feedback
v0.13Refine API beta; bản cuối chứa code deprecatedBắt đầu migrate sang ConversableAgent / beta
v0.14Gỡ code deprecated; beta thành Release CandidateHoàn tất migration, test beta API
v1.0Beta trở thành chính thức; codebase cũ dời sang nhánh ag2-originalDùng framework mới, dựa theo migration docs

Use cases

  • Agent team cần filesystem/shell: dùng FilesystemToolset + LocalShellTool thay vì viết tool wrapper thủ công.
  • Code-gen agent an toàn: thay LocalCommandLineCodeExecutor bằng DaytonaCodeExecutor để chạy code trong sandbox cô lập, giảm rủi ro khi agent generate và exec code tuỳ ý.
  • Multimodal agent: đọc ảnh, PDF, audio, video qua một interface thống nhất trên OpenAI/Gemini/Anthropic — không cần viết adapter riêng cho từng provider.
  • Observability production: Observer API subscribe sự kiện để feed vào monitoring/eval pipeline, thay cho việc patch log thủ công.
  • Declarative agents: AgentSpec cho phép khai báo agent bằng config, phù hợp với tooling CI/CD và review code.

Limitations & pricing

AG2 là Apache 2.0 — hoàn toàn free. Tuy nhiên ba điểm cần lưu ý:

  • Beta còn thay đổi: API sẽ được refine ở v0.13; nếu build production trên autogen.beta hôm nay, hãy plan sẵn một vòng update ở mốc v0.13/v0.14.
  • Deprecation thật sẽ đau: 11 agent (GPTAssistantAgent, LLaVAAgent, WebSurferAgent, TextAnalyzerAgent, MathUserProxyAgent, SocietyOfMindAgent, AgentOptimizer, RetrieveAssistantAgent, QdrantRetrieveUserProxyAgent, SwarmAgent, RealtimeAgent), nhiều tool (PythonCodeExecutionTool, FirecrawlTool, PerplexitySearchTool, SearxngSearchTool, WebSearchPreviewTool) và CrewAIInteroperability sẽ bị xoá ở v0.14.
  • CrewAI interop phải chuyển: team đang dùng CrewAIInteroperability cần migrate sang LangChain hoặc PydanticAI interop.

Các core không bị ảnh hưởng: ConversableAgent, AssistantAgent, UserProxyAgent, GroupChat, Teachability, VisionCapability, cũng như các agent experimental (DeepResearchAgent, ReasoningAgent, DocAgent, CaptainAgent, A2UIAgent).

What's next

Window feedback cộng đồng đang mở. Team AG2 khuyến khích review danh sách deprecation và phản hồi trước khi v0.13 chốt API. Nếu bạn đang maintain một agent pipeline dùng AG2:

  1. Đọc Release Roadmap và đánh dấu agent/tool của mình trong danh sách deprecated.
  2. Thử autogen.beta trên một use-case nhỏ — Toolkits + Observer API thường là chuyển đổi dễ nhất để bắt đầu.
  3. Cân nhắc chuyển code execution sang DaytonaCodeExecutor nếu agent có phần generate-and-exec code.
  4. Cập nhật CI để pin version và chuẩn bị matrix test v0.12/v0.13/v0.14.

Nguồn: GitHub release v0.12.0, AG2 Release Roadmap, ag2.ai.