Release Roadmap - AG2

Release Roadmap — The Path to AG2 v1.0

AG2 is, finally, moving to v1.0.

This page outlines what to expect in each upcoming release so you can plan ahead.

The current framework (autogen.agentchat with ConversableAgent, GroupChat, LLMConfig, etc.) will, over the next few minor versions, receive a tidy-up through deprecations, and be prepared for maintenance-mode. It will continue to be supported and patched.

The beta framework (temporarily autogen.beta, with Agent) will, at v1.0, become the official version of AG2. Documentation will be provided to help with migration from the original version to the new framework.

v0.12 — Deprecation notices

Deprecation announcements. The following features are marked as deprecated and will be removed in v0.14. This list will be actively updated throughout the feedback period.
Community feedback window opens. We want to hear from you. If a feature marked for deprecation is critical to your workflow, let us know before v0.14.
Beta development continues in parallel.

Deprecated agents

Agent	Alternative
`GPTAssistantAgent`	`ConversableAgent`
`LLaVAAgent`	v1.0 will contain native multimodal support on Agent
`WebSurferAgent` (contrib)	`autogen.agents.experimental.WebSurferAgent`
`TextAnalyzerAgent`	`ConversableAgent` with an appropriate system message
`MathUserProxyAgent`	`ConversableAgent` with tool calling
`SocietyOfMindAgent`	GroupChat patterns
`AgentOptimizer`	`ConversableAgent` with tool calling
`RetrieveAssistantAgent`	`AssistantAgent`
`QdrantRetrieveUserProxyAgent`	`RetrieveUserProxyAgent` with `vector_db='qdrant'`
`SwarmAgent`	`ConversableAgent` (already incorporated)
`RealtimeAgent`	Relies on deprecated realtime API endpoints

Deprecated swarm functions and the swarm module

The entire autogen.agentchat.contrib.swarm_agent module has been removed in v0.14. All swarm orchestration is now provided by group chat.

Feature	Alternative
`initiate_swarm_chat()`, `run_swarm()` (and async variants)	`run_group_chat`
`AFTER_WORK`, `AfterWork`, `AfterWorkOption`	Group chat handoffs (`Handoffs`, transition targets)
`ON_CONDITION`, `OnCondition`	`autogen.agentchat.group.OnCondition` / `OnContextCondition`

Deprecated capabilities and modules

Feature	Reason
`ImageGeneration` capability	Depends on deprecated `TextAnalyzerAgent`
`agent_eval` module (`generate_criteria`, `quantify_criteria`, `CriticAgent`, `QuantifierAgent`, `SubCriticAgent`)	experimental evaluation framework

Deprecated interoperability

Feature	Alternative
`CrewAIInteroperability`	LangChain or PydanticAI interop

Deprecated experimental tools

Tool	Alternative
`PythonCodeExecutionTool`	`autogen.beta.tools.CodeExecutionTool`
`FirecrawlTool`	`Crawl4AITool` or `BrowserUseTool`
`SearxngSearchTool`	`DuckDuckGoSearchTool` or `TavilySearchTool`
`WebSearchPreviewTool`	`autogen.beta.tools.WebSearchTool`

What is NOT being deprecated

The core framework and actively maintained features continue without change:

Core agents: ConversableAgent, AssistantAgent, UserProxyAgent
Group chat: GroupChat, GroupChatManager, run_group_chat, and all orchestration patterns including handoffs (Handoffs, OnCondition, OnContextCondition, and transition targets)
RAG: RetrieveUserProxyAgent, vector database integrations (ChromaDB, Qdrant, MongoDB, Couchbase, PGVector), graph RAG (Neo4j, FalkorDB)
Capabilities: Teachability, VisionCapability, TransformMessages, ToolsCapability
Experimental agents: WebSurferAgent (experimental), DeepResearchAgent, ReasoningAgent, DocAgent, CaptainAgent, A2UIAgent, and platform agents (Discord, Slack, Telegram)

Notebooks using outdated models

A number of notebooks that reference unavailable or outdated models (e.g. gpt-3.5-turbo, gpt-4-vision-preview, gpt-4-turbo-preview) have also been removed in v0.14.

Documentation removed in v0.14

Associated blog posts, user guide pages, and notebooks for the above deprecated features have been removed in v0.14.

v0.13 — Transition period

Community feedback incorporated. Deprecation decisions were revisited based on feedback.
Beta API refinements. Continued development and stabilisation of the beta API. Orchestration capabilities are introduced.
Last release where deprecated features were still available.

v0.14 — Final current-line release <-- We are here

Deprecated features removed. Everything marked deprecated in v0.12 (and not rescued by community feedback) has been removed. See the lists above.
Beta moves to Release Candidate (RC). The beta API is feature-complete and enters final testing.
This is the last release of the original AG2 codebase on main.

v1.0 — The new AG2

Original AG2 moves to the ag2-original branch and will continue to receive maintenance updates.
The beta becomes stable and takes over the main branch.
Documentation — Primary documentation will focus on the v1.0 API. Documentation for the original AG2 version will remain available.

Community feedback

As an open-source framework, we not only welcome, but encourage, users of the current version of AG2 to provide feedback on this roadmap.

The current beta development is being built for you. So, please bring your thoughts, opinions, and requirements forward so we can make sure it does what you need.