AG2 Files

Highlights

🛣️ AG2 v0.12.0 – The Path to v1.0 Begins

This release kicks off the journey to AG2 v1.0. Over the next few minor versions (v0.12 → v0.13 → v0.14 → v1.0), the beta framework (autogen.beta) will mature and, at v1.0, become the official version of AG2. The current framework continues to be fully supported throughout this transition.

📍 Check out the full Release Roadmap to see what's coming.

⚠️ Deprecation Notices (Removal in v0.14)

v0.12 is the deprecation announcement release. The features below are marked for removal in v0.14. The community feedback window is now open — if any of these are critical to your workflow, please let us know via GitHub Issues or Discord.

• Deprecated agents: GPTAssistantAgent, LLaVAAgent, WebSurferAgent (contrib), TextAnalyzerAgent, MathUserProxyAgent, SocietyOfMindAgent, AgentOptimizer, RetrieveAssistantAgent, QdrantRetrieveUserProxyAgent, SwarmAgent, RealtimeAgent
• Deprecated capabilities/modules: ImageGeneration, agent_eval
• Deprecated interop: CrewAIInteroperability (use LangChain or PydanticAI interop)
• Deprecated experimental tools: PythonCodeExecutionTool, FirecrawlTool, PerplexitySearchTool, SearxngSearchTool, WebSearchPreviewTool
• Deprecated swarm functions: Use the new Group Chat

See PR [#2553] for the full list and migration paths.

What is NOT being deprecated: Core agents (ConversableAgent, AssistantAgent, UserProxyAgent), GroupChat and orchestration patterns, capabilities like Teachability and VisionCapability, and experimental agents like DeepResearchAgent, ReasoningAgent, DocAgent, CaptainAgent, A2UIAgent, and platform agents.

🔬 Beta: Major New Capabilities

The beta framework continues to grow — these are the building blocks for AG2 v1.0.

• 🤖 Agent.as_tool() – Agent delegation using tool calls with the new Tasks API.
• 👁️ Observer API – Subscribe to Agent events for monitoring and debugging.
• 🖥️ AG-UI Support – UI integration
• 🎨 Multimodal Input – Image, Document, Audio, and Video input support for OpenAI, Gemini, Anthropic.
• 🔧 Serializable Agents – Fully serializable
• 🔧 Tool-Driven Handoffs – Improved compatibility with existing ConversableAgents to support handoffs in tool calls

🧰 Beta: New Tools & Toolkits

• 📁 FilesystemToolset – File operations toolkit.
• 🔍 WebSearchTool Streaming – Streaming support for web search.
• 💻 LocalShellTool & LocalShellEnvironment – Local shell execution.
• 🎯 Skills Tool & Search Skills – Skills management and discovery.
• 🔧 Middleware Support – Added to Toolkit and FunctionTool.
• 💻 Code Execution Tool – New Beta tool for code execution.

🎉 New Features

• 🖥️ DaytonaCodeExecutor – New code executor integration with Daytona.
• 🔗 NLIP Integration – Natural Language Interface Protocol support.
• 🎯 AgentEligibilityPolicy – Runtime GroupChat candidate filtering.

🔐 Security

• 🛡️ CVE-2025-69872 – Fixed DiskCache vulnerability.
• 🔒 GitHub Actions Hardening – Added zizmor and hardened CI workflows.

Bug Fixes

• 🔧 TokenLimiter – Fixed token-to-char budget calculation.
• 🔧 Speaker Selection – Fixed duplicate condition in verbose logging.
• 🔧 Interop Error Messages – Fixed error showing 't' instead of actual type names.
• 🔧 browser-use – Updated from pinned 0.1.37 to >=0.3.1.
• 🔧 Various typo and grammar fixes.

Documentation & Accessibility

• 📔 Added Security Policy.
• ♿ Fixed WCAG 2 AA color contrast issues site-wide.
• ♿ Added alt text to 39 images on homepage.
• 🔗 Fixed numerous broken links across documentation.

CLI

• 📦 Published CLI package to PyPI.

What's Changed

• Planned deprecation for v0.14 by @marklysze in https://github.com/ag2ai/ag2/pull/2553
• feat(beta): add WebSearchTool streaming support by @Lancetnik in https://github.com/ag2ai/ag2/pull/2562
• feat(beta): add FilesystemToolset for file operations by @Lancetnik in https://github.com/ag2ai/ag2/pull/2566
• ci: add zizmor and harden GitHub Actions workflows by @Lancetnik in https://github.com/ag2ai/ag2/pull/2565
• feat: add allow_always option to approval_required middleware by @Lancetnik in https://github.com/ag2ai/ag2/pull/2563
• docs: fix broken code examples in 3 blog posts by @VasiliyRad in https://github.com/ag2ai/ag2/pull/2559
• fix: correct parameter name typo and grammar across multiple files by @Ricardo-M-L in https://github.com/ag2ai/ag2/pull/2552
• fix: correct grammar and typos across multiple files by @Ricardo-M-L in https://github.com/ag2ai/ag2/pull/2551
• fix: fix unused deepcopy result and typos in vision_capability.py by @Ricardo-M-L in https://github.com/ag2ai/ag2/pull/2550
• ci: add tests for python3.14 by @Lancetnik in https://github.com/ag2ai/ag2/pull/2138
• fix: interop error message shows 't' instead of actual type names by @ameenalkhaldi in https://github.com/ag2ai/ag2/pull/2509
• docs: add security policy by @Lancetnik in https://github.com/ag2ai/ag2/pull/2543
• docs: add AI policy for contributions by @Lancetnik in https://github.com/ag2ai/ag2/pull/2542
• docs: fix broken notebook links in FalkorDB blog post by @VasiliyRad in https://github.com/ag2ai/ag2/pull/2560
• fix: correct parameter name typo and grammar in openai_utils and other files by @Ricardo-M-L in https://github.com/ag2ai/ag2/pull/2554
• Fix CVE 2025 69872 diskcache by @cym3118288-afk in https://github.com/ag2ai/ag2/pull/2548
• Feat: DaytonaCodeExecutor by @mislavivanda in https://github.com/ag2ai/ag2/pull/2518
• fix: Daytona notebook tweak by @marklysze in https://github.com/ag2ai/ag2/pull/2576
• feat(beta): add LocalShellTool and LocalShellEnvironment for local sh… by @vvlrff in https://github.com/ag2ai/ag2/pull/2535
• feat: add NLIP integration by @river-li in https://github.com/ag2ai/ag2/pull/2468
• ci: fix docs deploy by restoring git credentials by @Lancetnik in https://github.com/ag2ai/ag2/pull/2573
• fix: correct token-to-char budget calculation in TokenLimiter by @Ricardo-M-L in https://github.com/ag2ai/ag2/pull/2577
• fix: correct duplicate condition in speaker selection verbose logging by @Ricardo-M-L in https://github.com/ag2ai/ag2/pull/2578
• feat(beta): Tasks with Agent.as_tool() for agent delegation using tool calls by @marklysze in https://github.com/ag2ai/ag2/pull/2520
• feat(beta): add observer API for Agent event subscriptions by @Lancetnik in https://github.com/ag2ai/ag2/pull/2572
• feat(beta): add middleware support to Toolkit and FunctionTool by @Lancetnik in https://github.com/ag2ai/ag2/pull/2569
• Planned tool and integration deprecations for v0.14 by @marklysze in https://github.com/ag2ai/ag2/pull/2581
• NameError in ReasoningAgent example — LLMConfig not imported by @VasiliyRad in https://github.com/ag2ai/ag2/pull/2589
• NameError in ReasoningAgent example — LLMConfig not imported by @VasiliyRad in https://github.com/ag2ai/ag2/pull/2591
• fix: update browser-use from pinned 0.1.37 to >=0.3.1 by @VasiliyRad in https://github.com/ag2ai/ag2/pull/2600
• Broken link to ChromaDB Docker docs by @VasiliyRad in https://github.com/ag2ai/ag2/pull/2597
• Heading order violations on homepage by @VasiliyRad in https://github.com/ag2ai/ag2/pull/2604
• 39 images missing alt text on homepage by @VasiliyRad in https://github.com/ag2ai/ag2/pull/2602
• Color contrast failures site-wide (WCAG 2 AA) by @VasiliyRad in https://github.com/ag2ai/ag2/pull/2603
• feat(beta): input event system with multimodal support (Image, Document, Audio, Video) by @Lancetnik in https://github.com/ag2ai/ag2/pull/2582
• Create py.typed file for mypy by @C3EQUALZz in https://github.com/ag2ai/ag2/pull/2614
• localhost URLs in production blog posts by @VasiliyRad in https://github.com/ag2ai/ag2/pull/2609
• refactor: rename Context to ConversationContext to avoid naming conflicts by @Lancetnik in https://github.com/ag2ai/ag2/pull/2621
• feat: AgentEligibilityPolicy for runtime GroupChat candidate filtering by @amabito in https://github.com/ag2ai/ag2/pull/2459
• fix(ci): add write permissions to build-mkdocs workflow by @Lancetnik in https://github.com/ag2ai/ag2/pull/2616
• feat(beta): plugin system for composable agent configuration by @Lancetnik in https://github.com/ag2ai/ag2/pull/2622
• Double-slash in GitHub notebook URLs by @VasiliyRad in https://github.com/ag2ai/ag2/pull/2617
• Broken installing-ag2 link on quickstart page by @VasiliyRad in https://github.com/ag2ai/ag2/pull/2611
• Broken FSM-GroupChat link in StateFlow blog by @VasiliyRad in https://github.com/ag2ai/ag2/pull/2613
• feat(beta): Skills tool by @vvlrff in https://github.com/ag2ai/ag2/pull/2588
• feat(beta): Multimodal input support for Gemini and Anthropic by @marklysze in https://github.com/ag2ai/ag2/pull/2624
• Broken link: tools_duckduckgo_search.ipynb by @VasiliyRad in https://github.com/ag2ai/ag2/pull/2634
• NameError — undefined variable 'questions' in code block by @VasiliyRad in https://github.com/ag2ai/ag2/pull/2639
• Broken external links with double slash in GitHub notebook URLs by @VasiliyRad in https://github.com/ag2ai/ag2/pull/2637
• Broken link: reliable_basic_example.ipynb by @VasiliyRad in https://github.com/ag2ai/ag2/pull/2630
• NameError: ConversableAgent not defined in code block by @VasiliyRad in https://github.com/ag2ai/ag2/pull/2635
• TypeError in LLMConfig — config_list expects list not dict by @VasiliyRad in https://github.com/ag2ai/ag2/pull/2638
• feat(beta): Search skills by @vvlrff in https://github.com/ag2ai/ag2/pull/2615
• feat(beta): Add extra_body parameter support to Beta OpenAI client by @marklysze in https://github.com/ag2ai/ag2/pull/2651
• refactor(beta): reorganize skills toolkit under toolkits/skills/ by @Lancetnik in https://github.com/ag2ai/ag2/pull/2650
• revert: roll back direct push of harness primitives by @SirEntropy in https://github.com/ag2ai/ag2/pull/2657
• feat(beta): AgentSpec by @vvlrff in https://github.com/ag2ai/ag2/pull/2629
• feat(beta): add AG-UI support by @Lancetnik in https://github.com/ag2ai/ag2/pull/2660
• add code execution tool by @merkulova-ki in https://github.com/ag2ai/ag2/pull/2687
• refactor(beta): move skills toolkit from toolkits/skills/ to tools/skills/ by @Lancetnik in https://github.com/ag2ai/ag2/pull/2653
• Bump pandas pin to 2.3.3 for Python 3.14 support by @marklysze in https://github.com/ag2ai/ag2/pull/2691
• fix(Swarm): remove deprecated ast.Num/Str/NameConstant for Python 3.14 compatibility by @marklysze in https://github.com/ag2ai/ag2/pull/2693
• tests: Increase test timeouts for AgentBuilder/TeachableAgent/CaptainAgent by @marklysze in https://github.com/ag2ai/ag2/pull/2692
• fix(tests): RealtimeAgent, Deepseek, and DiskCache tweaks by @marklysze in https://github.com/ag2ai/ag2/pull/2696
• fix: Various fixes for optional dependency tests by @marklysze in https://github.com/ag2ai/ag2/pull/2698
• fix(tests): DiskCache test updates by @marklysze in https://github.com/ag2ai/ag2/pull/2697
• feat(beta): tool-driven handoffs for ConversableAdapter by @Lancetnik in https://github.com/ag2ai/ag2/pull/2652
• refactor: polish Inputs class tree by @Lancetnik in https://github.com/ag2ai/ag2/pull/2700
• Publish cli package to pypi by @SirEntropy in https://github.com/ag2ai/ag2/pull/2558
• Version bump to 0.12 by @marklysze in https://github.com/ag2ai/ag2/pull/2699

New Contributors

• @ameenalkhaldi made their first contribution in https://github.com/ag2ai/ag2/pull/2509
• @cym3118288-afk made their first contribution in https://github.com/ag2ai/ag2/pull/2548
• @mislavivanda made their first contribution in https://github.com/ag2ai/ag2/pull/2518
• @river-li made their first contribution in https://github.com/ag2ai/ag2/pull/2468
• @C3EQUALZz made their first contribution in https://github.com/ag2ai/ag2/pull/2614
• @merkulova-ki made their first contribution in https://github.com/ag2ai/ag2/pull/2687

Full Changelog: https://github.com/ag2ai/ag2/compare/v0.11.5...v0.12.0