●Change8

python-v0.4.8

Breaking Changes
📦 autogenView on GitHub →
⚠ 2 breaking✨ 8 features🐛 6 fixes🔧 10 symbols

Summary

This release introduces the Ollama Chat Completion Client and adds support for model 'thought' processes and custom metadata in messages. It also includes breaking changes to FunctionExecutionResult requirements and makes agent exceptions fatal to improve debugging.

⚠️ Breaking Changes

  • The 'name' field in 'FunctionExecutionResult' is now required. Code creating these objects must now provide a string value for 'name'.
  • Exceptions raised within AgentChat agents (like 'AssistantAgent') are now fatal and will propagate instead of silently stopping the team.

Migration Steps

  1. Update all instances of 'FunctionExecutionResult' to include the mandatory 'name' parameter.
  2. If using Ollama, install the extension package: pip install -U "autogen-ext[ollama]".
  3. Review error handling logic around AgentChat teams, as exceptions are no longer silently swallowed.

✨ New Features

  • Introduced OllamaChatCompletionClient for local LLM support via Ollama.
  • Added support for structured output in OllamaChatCompletionClient using Pydantic models.
  • Added 'thought' field to 'CreateResult' and 'ThoughtEvent' to capture model reasoning/chain-of-thought, supported by OpenAIChatCompletionClient.
  • Added 'metadata' field to AgentChat message types for custom application data.
  • New 'TextMessageTerminationCondition' for controlling agent teams in loops.
  • New 'FunctionCallTermination' condition for custom termination logic.
  • Added support for custom headers in HTTP tool requests.
  • Auto-conversion of Pydantic and Dataclass arguments in Tool calls.

🐛 Bug Fixes

  • Fixed SKChatCompletionAdapter message conversion.
  • Fixed crash in argument parsing when using Openrouter.
  • Fixed structured output with tool calls for OpenAIChatCompletionClient.
  • Removed R1 model family from is_openai function check.
  • Fixed initialization of BaseGroupChat before reset.
  • Fixed undefined tools variable in ToolUseAgent class.

🔧 Affected Symbols

autogen_ext.models.ollama.OllamaChatCompletionClientautogen_core.models.FunctionExecutionResultautogen_core.models.CreateResultautogen_core.models.ThoughtEventautogen_agentchat.agents.AssistantAgentautogen_agentchat.messages.BaseMessageautogen_agentchat.conditions.TextMessageTerminationConditionautogen_agentchat.conditions.FunctionCallTerminationautogen_core.models.ChatCompletionClient.load_componentautogen_agentchat.agents.ToolUseAgent