●Change8

Migrating to AutoGen v0.4.0

Version v0.4.0 introduces 3 breaking changes. This guide details how to update your code.

Released: 1/10/2025

3
Breaking Changes
4
Migration Steps
6
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

azure auth providerintervention handlerSelectorGroupChatautogen_agentchatm1 clio1-2024-12-17

Breaking Changes

●Issue #1

Azure authentication provider has been moved to a separate module. Update imports to the new location.

●Issue #2

The intervention handler signature now includes message context. Update custom intervention handler implementations to accept the new argument.

●Issue #3

Deprecated items have been removed for the stable release. Replace any usage of deprecated v0.4.0-dev symbols with their stable counterparts.

Migration Steps

  1. 1
    Upgrade packages using: pip install -U "autogen-agentchat" "autogen-ext[openai]"
  2. 2
    Follow the official migration guide at https://microsoft.github.io/autogen/stable/user-guide/agentchat-user-guide/migration-guide.html for moving from v0.2 to v0.4.
  3. 3
    Update Azure auth provider imports to the new module location.
  4. 4
    Update intervention handler signatures to include the message context parameter.

Release Summary

This release marks the first stable version of AutoGen v0.4, introducing a new API architecture, support for OpenAI's o1 model, and breaking changes to Azure authentication and intervention handlers.

Need More Details?

View the full release notes and all changes for AutoGen v0.4.0.

View Full Changelog