Skip to content

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 <-- We are here#

  • 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 aliases#

Feature Alternative
initiate_swarm_chat() run_group_chat
run_swarm() run_group_chat
AFTER_WORK AfterWork
ON_CONDITION OnCondition

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 (AfterWork, OnCondition, OnContextCondition)
  • 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 deprecated and will be removed in v0.14.

Documentation to be removed in v0.14#

Associated blog posts, user guide pages, and notebooks for the above deprecated features will also be removed in v0.14. Each affected page and notebook now displays a deprecation warning.

v0.13 — Transition period#

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

v0.14 — Final current-line release#

  • Deprecated features removed. Anything marked deprecated in v0.12 (and not rescued by community feedback) will be removed.
  • 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.

Please provide feedback through an Issue or on our Discord server.