Skip to content

AG2 Beta

Warning

autogen.beta is under active development and may introduce breaking changes between releases. For production workloads, use the stable APIs documented in the User Guide and API References.

Why did we create AG2 Beta?#

The original AutoGen project released with its first public preview in September 2023, and AG2 later diverged from that codebase in November 2024 to continue building on its core ideas.

AutoGen was one of the earliest frameworks for building AI agents and orchestrating agent-to-agent collaboration. That early vision proved valuable: it enabled real-world systems, informed the design of many tools, and helped shape the agent ecosystem.

Since then, the agent landscape has changed significantly. Over time, the community has established better practices, common protocols, and new interoperability standards. Capabilities that were once experimental are now becoming part of the expected foundation for agent platforms.

Examples include:

We have increasingly found that the original architecture inherited from AutoGen challenged the adoption of new ideas. Shipping modern capabilities inside the original design often requires introducing complexity, unnecessary migration effort, or compatibility compromises.

Not every part of the ecosystem is standardized yet, but the direction is clear. AI agents are no longer an experiment; they are standard application infrastructure.

AG2 Beta is our way to move forward with a future-focused foundation while applying the lessons we learned from building and operating hundreds of agent systems based on AG2.

What is AG2 Beta?#

AG2 Beta is a new development track inside AG2 where we build capabilities that would be difficult or impractical to introduce on the original framework architecture.

As the beta matures, we expect it to become the primary foundation for future AG2 agent development and production-ready multi-agent systems.

Compatibility with AG2#

We value all the users and contributors who have made AG2 what it is today and want to bring you along on this journey.

Where it is practical and beneficial, we aim to preserve compatibility with existing AG2 workflows.

From day one, AG2 Beta agents can participate in established AG2 multi-agent interaction patterns. This makes it possible to adopt Beta agents gradually within existing systems instead of rewriting everything at once.

How do I try it out?#

The AG2 Beta currently resides in the AG2 repository alongside the current AG2 code.

When you pip install ag2, this will include the current AG2 Beta release under the autogen.beta module.

If you want the most up-to-date version, use the main branch. To see current work in progress, view the GitHub repository for PRs with the beta label.

See the following pages for walkthroughs of the new AG2 Beta API.

Current Focus Areas#

AG2 Beta is actively focused on:

  • improving the single-agent developer experience
  • providing stronger context and memory management primitives
  • simplifying integration with real applications, including Text UI, web, ambient, and background runtimes
  • enabling new multi-agent coordination patterns that are not feasible in the current AG2 architecture
  • supporting emerging standards and protocols across the AI agent ecosystem

We are building AG2 Beta to make agent development simpler, more modern, and easier to integrate into production-grade applications. We would love your feedback as the API evolves (Discord).