A programming framework for agentic AI
Rename to use BaseChatMessage and BaseAgentEvent. Bring back union types. (#6144)
Eric Zhu7615c7b83bda
diff --git a/python/packages/agbench/benchmarks/GAIA/Templates/SelectorGroupChat/scenario.py b/python/packages/agbench/benchmarks/GAIA/Templates/SelectorGroupChat/scenario.pyindex e2e1d8fae..5fa4b0027 100644--- a/python/packages/agbench/benchmarks/GAIA/Templates/SelectorGroupChat/scenario.py+++ b/python/packages/agbench/benchmarks/GAIA/Templates/SelectorGroupChat/scenario.py@@ -16,7 +16,7 @@ from autogen_core.models import ChatCompletionClientfrom autogen_ext.agents.web_surfer import MultimodalWebSurferfrom autogen_ext.agents.file_surfer import FileSurferfrom autogen_agentchat.agents import CodeExecutorAgent-from autogen_agentchat.messages import TextMessage, AgentEvent, ChatMessage, HandoffMessage, MultiModalMessage, StopMessage+from autogen_agentchat.messages import TextMessage, BaseAgentEvent, BaseChatMessage, HandoffMessage, MultiModalMessage, StopMessagefrom autogen_core.models import LLMMessage, UserMessage, AssistantMessage# Suppress warnings about the requests.Session() not being closed@@ -141,7 +141,7 @@ class LLMTermination(TerminationCondition):def terminated(self) -> bool:return self._terminated- async def __call__(self, messages: Sequence[AgentEvent | ChatMessage]) -> StopMessage | None:+ async def __call__(self, messages: Sequence[BaseAgentEvent | BaseChatMessage]) -> StopMessage | None:if self._terminated:raise TerminatedException("Termination condition has already been reached")diff --git a/python/packages/agbench/src/agbench/linter/__init__.py b/python/packages/agbench/src/agbench/linter/__init__.pyindex 797b7f272..a10496244 100644--- a/python/packages/agbench/src/agbench/linter/__init__.py+++ b/python/packages/agbench/src/agbench/linter/__init__.py@@ -1,4 +1,4 @@# __init__.py-from ._base import Code, Document, CodedDocument, BaseQualitativeCoder+from ._base import BaseQualitativeCoder, Code, CodedDocument, Document__all__ = ["Code", "Document", "CodedDocument", "BaseQualitativeCoder"]diff --git a/python/packages/agbench/src/agbench/linter/_base.py b/python/packages/agbench/src/agbench/linter/_base.pyindex 4f6209b78..c59e826d2 100644--- a/python/packages/agbench/src/agbench/linter/_base.py+++ b/python/packages/agbench/src/agbench/linter/_base.py@@ -1,7 +1,8 @@-import jsonimport hashlib+import jsonimport re-from typing import Protocol, List, Set, Optional+from typing import List, Optional, Protocol, Set+from pydantic import BaseModel, Fielddiff --git a/python/packages/agbench/src/agbench/linter/cli.py b/python/packages/agbench/src/agbench/linter/cli.pyindex 426890258..14f428929 100644--- a/python/packages/agbench/src/agbench/linter/cli.py+++ b/python/packages/agbench/src/agbench/linter/cli.py@@ -1,8 +1,10 @@-import osimport argparse-from typing import List, Sequence, Optional+import os+from typing import List, Optional, Sequence+from openai import OpenAI-from ._base import Document, CodedDocument++from ._base import CodedDocument, Documentfrom .coders.oai_coder import OAIQualitativeCoderdiff --git a/python/packages/agbench/src/agbench/linter/coders/oai_coder.py b/python/packages/agbench/src/agbench/linter/coders/oai_coder.pyindex 374093d3d..01322e0c5 100644--- a/python/packages/agbench/src/agbench/linter/coders/oai_coder.py+++ b/python/packages/agbench/src/agbench/linter/coders/oai_coder.py@@ -1,13 +1,11 @@import osimport re--from typing import List, Set, Optional-from pydantic import BaseModel+from typing import List, Optional, Setfrom openai import OpenAI+from pydantic import BaseModel-from .._base import CodedDocument, Document, Code-from .._base import BaseQualitativeCoder+from .._base import BaseQualitativeCoder, Code, CodedDocument, Documentclass CodeList(BaseModel):diff --git a/python/packages/autogen-agentchat/src/autogen_agentchat/agents/_assistant_agent.py b/python/packages/autogen-agentchat/src/autogen_agentchat/agents/_assistant_agent.pyindex c46b994aa..5e1e7f3d2 100644--- a/python/packages/autogen-agentchat/src/autogen_agentchat/agents/_assistant_agent.py+++ b/python/packages/autogen-agentchat/src/autogen_agentchat/agents/_assistant_agent.py@@ -40,8 +40,8 @@ from .. import EVENT_LOGGER_NAMEfrom ..base import Handoff as HandoffBasefrom ..base import Responsefrom ..messages import (- AgentEvent,- ChatMessage,+ BaseAgentEvent,+ BaseChatMessage,HandoffMessage,MemoryQueryEvent,ModelClientStreamingChunkEvent,@@ -697,8 +697,8 @@ class AssistantAgent(BaseChatAgent, Component[AssistantAgentConfig]):self._is_running = False@property- def produced_message_types(self) -> Sequence[type[ChatMessage]]:- message_types: List[type[ChatMessage]] = [TextMessage]+ def produced_message_types(self) -> Sequence[type[BaseChatMessage]]:+ message_types: List[type[BaseChatMessage]] = [TextMessage]if self._handoffs:message_types.append(HandoffMessage)if self._tools:@@ -712,15 +712,15 @@ class AssistantAgent(BaseChatAgent, Component[AssistantAgentConfig]):"""return self._model_context- async def on_messages(self, messages: Sequence[ChatMessage], cancellation_token: CancellationToken) -> Response:+ async def on_messages(self, messages: Sequence[BaseChatMessage], cancellation_token: CancellationToken) -> Response:async for message in self.on_messages_stream(messages, cancellation_token):if isinstance(message, Response):return messageraise AssertionError("The stream should have returned the final result.")async def on_messages_stream(- self, messages: Sequence[ChatMessage], cancellation_token: CancellationToken- ) -> AsyncGenerator[AgentEvent | ChatMessage | Response, None]:+ self, messages: Sequence[BaseChatMessage], cancellation_token: CancellationToken+ ) -> AsyncGenerator[BaseAgentEvent | BaseChatMessage | Response, None]:"""Process the incoming messages with the assistant agent and yield events/responses as they happen."""@@ -745,7 +745,7 @@ class AssistantAgent(BaseChatAgent, Component[AssistantAgentConfig]):)# STEP 2: Update model context with any relevant memory- inner_messages: List[AgentEvent | ChatMessage] = []+ inner_messages: List[BaseAgentEvent | BaseChatMessage] = []for event_msg in await self._update_model_context_with_memory(memory=memory,model_context=model_context,@@ -810,7 +810,7 @@ class AssistantAgent(BaseChatAgent, Component[AssistantAgentConfig]):@staticmethodasync def _add_messages_to_context(model_context: ChatCompletionContext,- messages: Sequence[ChatMessage],+ messages: Sequence[BaseChatMessage],) -> None:"""Add incoming messages to the model context.@@ -886,7 +886,7 @@ class AssistantAgent(BaseChatAgent, Component[AssistantAgentConfig]):async def _process_model_result(cls,model_result: CreateResult,- inner_messages: List[AgentEvent | ChatMessage],+ inner_messages: List[BaseAgentEvent | BaseChatMessage],cancellation_token: CancellationToken,agent_name: str,system_messages: List[SystemMessage],@@ -898,7 +898,7 @@ class AssistantAgent(BaseChatAgent, Component[AssistantAgentConfig]):model_client_stream: bool,reflect_on_tool_use: bool,tool_call_summary_format: str,- ) -> AsyncGenerator[AgentEvent | ChatMessage | Response, None]:+ ) -> AsyncGenerator[BaseAgentEvent | BaseChatMessage | Response, None]:"""Handle final or partial responses from model_result, including tool calls, handoffs,and reflection if needed.@@ -992,7 +992,7 @@ class AssistantAgent(BaseChatAgent, Component[AssistantAgentConfig]):def _check_and_handle_handoff(model_result: CreateResult,executed_calls_and_results: List[Tuple[FunctionCall, FunctionExecutionResult]],- inner_messages: List[AgentEvent | ChatMessage],+ inner_messages: List[BaseAgentEvent | BaseChatMessage],handoffs: Dict[str, HandoffBase],agent_name: str,) -> Optional[Response]:@@ -1061,7 +1061,7 @@ class AssistantAgent(BaseChatAgent, Component[AssistantAgentConfig]):model_client_stream: bool,model_context: ChatCompletionContext,agent_name: str,- inner_messages: List[AgentEvent | ChatMessage],+ inner_messages: List[BaseAgentEvent | BaseChatMessage],) -> AsyncGenerator[Response | ModelClientStreamingChunkEvent | ThoughtEvent, None]:"""If reflect_on_tool_use=True, we do another inference based on tool results@@ -1113,7 +1113,7 @@ class AssistantAgent(BaseChatAgent, Component[AssistantAgentConfig]):@staticmethoddef _summarize_tool_use(executed_calls_and_results: List[Tuple[FunctionCall, FunctionExecutionResult]],- inner_messages: List[AgentEvent | ChatMessage],+ inner_messages: List[BaseAgentEvent | BaseChatMessage],handoffs: Dict[str, HandoffBase],tool_call_summary_format: str,agent_name: str,diff --git a/python/packages/autogen-agentchat/src/autogen_agentchat/agents/_base_chat_agent.py b/python/packages/autogen-agentchat/src/autogen_agentchat/agents/_base_chat_agent.pyindex 375e296c2..706a03e02 100644--- a/python/packages/autogen-agentchat/src/autogen_agentchat/agents/_base_chat_agent.py+++ b/python/packages/autogen-agentchat/src/autogen_agentchat/agents/_base_chat_agent.py@@ -6,8 +6,8 @@ from pydantic import BaseModelfrom ..base import ChatAgent, Response, TaskResultfrom ..messages import (- AgentEvent,- ChatMessage,+ BaseAgentEvent,+ BaseChatMessage,ModelClientStreamingChunkEvent,TextMessage,)@@ -59,13 +59,13 @@ class BaseChatAgent(ChatAgent, ABC, ComponentBase[BaseModel]):@property@abstractmethod- def produced_message_types(self) -> Sequence[type[ChatMessage]]:+ def produced_message_types(self) -> Sequence[type[BaseChatMessage]]:"""The types of messages that the agent produces in the- :attr:`Response.chat_message` field. They must be :class:`ChatMessage` types."""+ :attr:`Response.chat_message` field. They must be :class:`BaseChatMessage` types."""...@abstractmethod- async def on_messages(self, messages: Sequence[ChatMessage], cancellation_token: CancellationToken) -> Response:+ async def on_messages(self, messages: Sequence[BaseChatMessage], cancellation_token: CancellationToken) -> Response:"""Handles incoming messages and returns a response... note::@@ -81,8 +81,8 @@ class BaseChatAgent(ChatAgent, ABC, ComponentBase[BaseModel]):...async def on_messages_stream(- self, messages: Sequence[ChatMessage], cancellation_token: CancellationToken- ) -> AsyncGenerator[AgentEvent | ChatMessage | Response, None]:+ self, messages: Sequence[BaseChatMessage], cancellation_token: CancellationToken+ ) -> AsyncGenerator[BaseAgentEvent | BaseChatMessage | Response, None]:"""Handles incoming messages and returns a stream of messages andand the final item is the response. The base implementation in:class:`BaseChatAgent` simply calls :meth:`on_messages` and yields@@ -106,21 +106,21 @@ class BaseChatAgent(ChatAgent, ABC, ComponentBase[BaseModel]):async def run(self,*,- task: str | ChatMessage | Sequence[ChatMessage] | None = None,+ task: str | BaseChatMessage | Sequence[BaseChatMessage] | None = None,cancellation_token: CancellationToken | None = None,) -> TaskResult:"""Run the agent with the given task and return the result."""if cancellation_token is None:cancellation_token = CancellationToken()- input_messages: List[ChatMessage] = []- output_messages: List[AgentEvent | ChatMessage] = []+ input_messages: List[BaseChatMessage] = []+ output_messages: List[BaseAgentEvent | BaseChatMessage] = []if task is None:passelif isinstance(task, str):text_msg = TextMessage(content=task, source="user")input_messages.append(text_msg)output_messages.append(text_msg)- elif isinstance(task, ChatMessage):+ elif isinstance(task, BaseChatMessage):input_messages.append(task)output_messages.append(task)else:@@ -128,7 +128,7 @@ class BaseChatAgent(ChatAgent, ABC, ComponentBase[BaseModel]):raise ValueError("Task list cannot be empty.")# Task is a sequence of messages.for msg in task:- if isinstance(msg, ChatMessage):+ if isinstance(msg, BaseChatMessage):input_messages.append(msg)output_messages.append(msg)else:@@ -142,15 +142,15 @@ class BaseChatAgent(ChatAgent, ABC, ComponentBase[BaseModel]):async def run_stream(self,*,- task: str | ChatMessage | Sequence[ChatMessage] | None = None,+ task: str | BaseChatMessage | Sequence[BaseChatMessage] | None = None,cancellation_token: CancellationToken | None = None,- ) -> AsyncGenerator[AgentEvent | ChatMessage | TaskResult, None]:+ ) -> AsyncGenerator[BaseAgentEvent | BaseChatMessage | TaskResult, None]:"""Run the agent with the given task and return a stream of messagesand the final task result as the last item in the stream."""if cancellation_token is None:cancellation_token = CancellationToken()- input_messages: List[ChatMessage] = []- output_messages: List[AgentEvent | ChatMessage] = []+ input_messages: List[BaseChatMessage] = []+ output_messages: List[BaseAgentEvent | BaseChatMessage] = []if task is None:passelif isinstance(task, str):@@ -158,7 +158,7 @@ class BaseChatAgent(ChatAgent, ABC, ComponentBase[BaseModel]):input_messages.append(text_msg)output_messages.append(text_msg)yield text_msg- elif isinstance(task, ChatMessage):+ elif isinstance(task, BaseChatMessage):input_messages.append(task)output_messages.append(task)yield task@@ -166,7 +166,7 @@ class BaseChatAgent(ChatAgent, ABC, ComponentBase[BaseModel]):if not task:raise ValueError("Task list cannot be empty.")for msg in task:- if isinstance(msg, ChatMessage):+ if isinstance(msg, BaseChatMessage):input_messages.append(msg)output_messages.append(msg)yield msgdiff --git a/python/packages/autogen-agentchat/src/autogen_agentchat/agents/_code_executor_agent.py b/python/packages/autogen-agentchat/src/autogen_agentchat/agents/_code_executor_agent.pyindex e94ce4550..ccd57ed21 100644--- a/python/packages/autogen-agentchat/src/autogen_agentchat/agents/_code_executor_agent.py+++ b/python/packages/autogen-agentchat/src/autogen_agentchat/agents/_code_executor_agent.py@@ -7,7 +7,7 @@ from pydantic import BaseModelfrom typing_extensions import Selffrom ..base import Response-from ..messages import ChatMessage, TextMessage+from ..messages import BaseChatMessage, TextMessagefrom ._base_chat_agent import BaseChatAgent@@ -119,11 +119,11 @@ class CodeExecutorAgent(BaseChatAgent, Component[CodeExecutorAgentConfig]):self._sources = sources@property- def produced_message_types(self) -> Sequence[type[ChatMessage]]:+ def produced_message_types(self) -> Sequence[type[BaseChatMessage]]:"""The types of messages that the code executor agent produces."""return (TextMessage,)- async def on_messages(self, messages: Sequence[ChatMessage], cancellation_token: CancellationToken) -> Response:+ async def on_messages(self, messages: Sequence[BaseChatMessage], cancellation_token: CancellationToken) -> Response:# Extract code blocks from the messages.code_blocks: List[CodeBlock] = []for msg in messages:diff --git a/python/packages/autogen-agentchat/src/autogen_agentchat/agents/_society_of_mind_agent.py b/python/packages/autogen-agentchat/src/autogen_agentchat/agents/_society_of_mind_agent.pyindex ac8f53965..88a606b40 100644--- a/python/packages/autogen-agentchat/src/autogen_agentchat/agents/_society_of_mind_agent.py+++ b/python/packages/autogen-agentchat/src/autogen_agentchat/agents/_society_of_mind_agent.py@@ -10,8 +10,8 @@ from autogen_agentchat.state import SocietyOfMindAgentStatefrom ..base import TaskResult, Teamfrom ..messages import (- AgentEvent,- ChatMessage,+ BaseAgentEvent,+ BaseChatMessage,ModelClientStreamingChunkEvent,TextMessage,)@@ -122,10 +122,10 @@ class SocietyOfMindAgent(BaseChatAgent, Component[SocietyOfMindAgentConfig]):self._response_prompt = response_prompt@property- def produced_message_types(self) -> Sequence[type[ChatMessage]]:+ def produced_message_types(self) -> Sequence[type[BaseChatMessage]]:return (TextMessage,)- async def on_messages(self, messages: Sequence[ChatMessage], cancellation_token: CancellationToken) -> Response:+ async def on_messages(self, messages: Sequence[BaseChatMessage], cancellation_token: CancellationToken) -> Response:# Call the stream method and collect the messages.response: Response | None = Noneasync for msg in self.on_messages_stream(messages, cancellation_token):@@ -135,14 +135,14 @@ class SocietyOfMindAgent(BaseChatAgent, Component[SocietyOfMindAgentConfig]):return responseasync def on_messages_stream(- self, messages: Sequence[ChatMessage], cancellation_token: CancellationToken- ) -> AsyncGenerator[AgentEvent | ChatMessage | Response, None]:+ self, messages: Sequence[BaseChatMessage], cancellation_token: CancellationToken+ ) -> AsyncGenerator[BaseAgentEvent | BaseChatMessage | Response, None]:# Prepare the task for the team of agents.task = list(messages)# Run the team of agents.result: TaskResult | None = None- inner_messages: List[AgentEvent | ChatMessage] = []+ inner_messages: List[BaseAgentEvent | BaseChatMessage] = []count = 0async for inner_msg in self._team.run_stream(task=task, cancellation_token=cancellation_token):if isinstance(inner_msg, TaskResult):@@ -167,7 +167,7 @@ class SocietyOfMindAgent(BaseChatAgent, Component[SocietyOfMindAgentConfig]):# Generate a response using the model client.llm_messages: List[LLMMessage] = [SystemMessage(content=self._instruction)]for message in messages:- if isinstance(message, ChatMessage):+ if isinstance(message, BaseChatMessage):llm_messages.append(message.to_model_message())llm_messages.append(SystemMessage(content=self._response_prompt))completion = await self._model_client.create(messages=llm_messages, cancellation_token=cancellation_token)diff --git a/python/packages/autogen-agentchat/src/autogen_agentchat/agents/_user_proxy_agent.py b/python/packages/autogen-agentchat/src/autogen_agentchat/agents/_user_proxy_agent.pyindex 221832a8a..af78f64c9 100644--- a/python/packages/autogen-agentchat/src/autogen_agentchat/agents/_user_proxy_agent.py+++ b/python/packages/autogen-agentchat/src/autogen_agentchat/agents/_user_proxy_agent.py@@ -10,7 +10,7 @@ from pydantic import BaseModelfrom typing_extensions import Selffrom ..base import Response-from ..messages import AgentEvent, ChatMessage, HandoffMessage, TextMessage, UserInputRequestedEvent+from ..messages import BaseAgentEvent, BaseChatMessage, HandoffMessage, TextMessage, UserInputRequestedEventfrom ._base_chat_agent import BaseChatAgentSyncInputFunc = Callable[[str], str]@@ -170,11 +170,11 @@ class UserProxyAgent(BaseChatAgent, Component[UserProxyAgentConfig]):self._is_async = iscoroutinefunction(self.input_func)@property- def produced_message_types(self) -> Sequence[type[ChatMessage]]:+ def produced_message_types(self) -> Sequence[type[BaseChatMessage]]:"""Message types this agent can produce."""return (TextMessage, HandoffMessage)- def _get_latest_handoff(self, messages: Sequence[ChatMessage]) -> Optional[HandoffMessage]:+ def _get_latest_handoff(self, messages: Sequence[BaseChatMessage]) -> Optional[HandoffMessage]:"""Find the HandoffMessage in the message sequence that addresses this agent."""if len(messages) > 0 and isinstance(messages[-1], HandoffMessage):if messages[-1].target == self.name:@@ -201,15 +201,15 @@ class UserProxyAgent(BaseChatAgent, Component[UserProxyAgentConfig]):except Exception as e:raise RuntimeError(f"Failed to get user input: {str(e)}") from e- async def on_messages(self, messages: Sequence[ChatMessage], cancellation_token: CancellationToken) -> Response:+ async def on_messages(self, messages: Sequence[BaseChatMessage], cancellation_token: CancellationToken) -> Response:async for message in self.on_messages_stream(messages, cancellation_token):if isinstance(message, Response):return messageraise AssertionError("The stream should have returned the final result.")async def on_messages_stream(- self, messages: Sequence[ChatMessage], cancellation_token: CancellationToken- ) -> AsyncGenerator[AgentEvent | ChatMessage | Response, None]:+ self, messages: Sequence[BaseChatMessage], cancellation_token: CancellationToken+ ) -> AsyncGenerator[BaseAgentEvent | BaseChatMessage | Response, None]:"""Handle incoming messages by requesting user input."""try:# Check for handoff firstdiff --git a/python/packages/autogen-agentchat/src/autogen_agentchat/base/_chat_agent.py b/python/packages/autogen-agentchat/src/autogen_agentchat/base/_chat_agent.pyindex ec885ee7f..21a132c7c 100644--- a/python/packages/autogen-agentchat/src/autogen_agentchat/base/_chat_agent.py+++ b/python/packages/autogen-agentchat/src/autogen_agentchat/base/_chat_agent.py@@ -5,7 +5,7 @@ from typing import Any, AsyncGenerator, Mapping, Sequencefrom autogen_core import CancellationToken, ComponentBasefrom pydantic import BaseModel-from ..messages import AgentEvent, ChatMessage+from ..messages import BaseAgentEvent, BaseChatMessagefrom ._task import TaskRunner@@ -13,12 +13,12 @@ from ._task import TaskRunnerclass Response:"""A response from calling :meth:`ChatAgent.on_messages`."""- chat_message: ChatMessage+ chat_message: BaseChatMessage"""A chat message produced by the agent as the response."""- inner_messages: Sequence[AgentEvent | ChatMessage] | None = None- """Inner messages produced by the agent, they can be :class:`AgentEvent`- or :class:`ChatMessage`."""+ inner_messages: Sequence[BaseAgentEvent | BaseChatMessage] | None = None+ """Inner messages produced by the agent, they can be :class:`BaseAgentEvent`+ or :class:`BaseChatMessage`."""class ChatAgent(ABC, TaskRunner, ComponentBase[BaseModel]):@@ -43,20 +43,20 @@ class ChatAgent(ABC, TaskRunner, ComponentBase[BaseModel]):@property@abstractmethod- def produced_message_types(self) -> Sequence[type[ChatMessage]]:+ def produced_message_types(self) -> Sequence[type[BaseChatMessage]]:"""The types of messages that the agent produces in the- :attr:`Response.chat_message` field. They must be :class:`ChatMessage` types."""+ :attr:`Response.chat_message` field. They must be :class:`BaseChatMessage` types."""...@abstractmethod- async def on_messages(self, messages: Sequence[ChatMessage], cancellation_token: CancellationToken) -> Response:+ async def on_messages(self, messages: Sequence[BaseChatMessage], cancellation_token: CancellationToken) -> Response:"""Handles incoming messages and returns a response."""...@abstractmethoddef on_messages_stream(- self, messages: Sequence[ChatMessage], cancellation_token: CancellationToken- ) -> AsyncGenerator[AgentEvent | ChatMessage | Response, None]:+ self, messages: Sequence[BaseChatMessage], cancellation_token: CancellationToken+ ) -> AsyncGenerator[BaseAgentEvent | BaseChatMessage | Response, None]:"""Handles incoming messages and returns a stream of inner messages andand the final item is the response."""...diff --git a/python/packages/autogen-agentchat/src/autogen_agentchat/base/_task.py b/python/packages/autogen-agentchat/src/autogen_agentchat/base/_task.pyindex 90e319ee3..950ebf0c5 100644--- a/python/packages/autogen-agentchat/src/autogen_agentchat/base/_task.py+++ b/python/packages/autogen-agentchat/src/autogen_agentchat/base/_task.py@@ -3,14 +3,14 @@ from typing import AsyncGenerator, Protocol, Sequencefrom autogen_core import CancellationToken-from ..messages import AgentEvent, ChatMessage+from ..messages import BaseAgentEvent, BaseChatMessage@dataclassclass TaskResult:"""Result of running a task."""- messages: Sequence[AgentEvent | ChatMessage]+ messages: Sequence[BaseAgentEvent | BaseChatMessage]"""Messages produced by the task."""stop_reason: str | None = None@@ -23,7 +23,7 @@ class TaskRunner(Protocol):async def run(self,*,- task: str | ChatMessage | Sequence[ChatMessage] | None = None,+ task: str | BaseChatMessage | Sequence[BaseChatMessage] | None = None,cancellation_token: CancellationToken | None = None,) -> TaskResult:"""Run the task and return the result.@@ -38,9 +38,9 @@ class TaskRunner(Protocol):def run_stream(self,*,- task: str | ChatMessage | Sequence[ChatMessage] | None = None,+ task: str | BaseChatMessage | Sequence[BaseChatMessage] | None = None,cancellation_token: CancellationToken | None = None,- ) -> AsyncGenerator[AgentEvent | ChatMessage | TaskResult, None]:+ ) -> AsyncGenerator[BaseAgentEvent | BaseChatMessage | TaskResult, None]:"""Run the task and produces a stream of messages and the final result:class:`TaskResult` as the last item in the stream.diff --git a/python/packages/autogen-agentchat/src/autogen_agentchat/base/_termination.py b/python/packages/autogen-agentchat/src/autogen_agentchat/base/_termination.pyindex d8a3adb96..a0187d355 100644--- a/python/packages/autogen-agentchat/src/autogen_agentchat/base/_termination.py+++ b/python/packages/autogen-agentchat/src/autogen_agentchat/base/_termination.py@@ -6,7 +6,7 @@ from autogen_core import Component, ComponentBase, ComponentModelfrom pydantic import BaseModelfrom typing_extensions import Self-from ..messages import AgentEvent, ChatMessage, StopMessage+from ..messages import BaseAgentEvent, BaseChatMessage, StopMessageclass TerminatedException(BaseException): ...@@ -15,7 +15,7 @@ class TerminatedException(BaseException): ...class TerminationCondition(ABC, ComponentBase[BaseModel]):"""A stateful condition that determines when a conversation should be terminated.- A termination condition is a callable that takes a sequence of ChatMessage objects+ A termination condition is a callable that takes a sequence of BaseChatMessage objectssince the last time the condition was called, and returns a StopMessage if theconversation should be terminated, or None otherwise.Once a termination condition has been reached, it must be reset before it can be used again.@@ -56,7 +56,7 @@ class TerminationCondition(ABC, ComponentBase[BaseModel]):...@abstractmethod- async def __call__(self, messages: Sequence[AgentEvent | ChatMessage]) -> StopMessage | None:+ async def __call__(self, messages: Sequence[BaseAgentEvent | BaseChatMessage]) -> StopMessage | None:"""Check if the conversation should be terminated based on the messages receivedsince the last time the condition was called.Return a StopMessage if the conversation should be terminated, or None otherwise.@@ -102,7 +102,7 @@ class AndTerminationCondition(TerminationCondition, Component[AndTerminationConddef terminated(self) -> bool:return all(condition.terminated for condition in self._conditions)- async def __call__(self, messages: Sequence[AgentEvent | ChatMessage]) -> StopMessage | None:+ async def __call__(self, messages: Sequence[BaseAgentEvent | BaseChatMessage]) -> StopMessage | None:if self.terminated:raise TerminatedException("Termination condition has already been reached.")# Check all remaining conditions.@@ -153,7 +153,7 @@ class OrTerminationCondition(TerminationCondition, Component[OrTerminationConditdef terminated(self) -> bool:return any(condition.terminated for condition in self._conditions)- async def __call__(self, messages: Sequence[AgentEvent | ChatMessage]) -> StopMessage | None:+ async def __call__(self, messages: Sequence[BaseAgentEvent | BaseChatMessage]) -> StopMessage | None:if self.terminated:raise RuntimeError("Termination condition has already been reached")stop_messages = await asyncio.gather(*[condition(messages) for condition in self._conditions])diff --git a/python/packages/autogen-agentchat/src/autogen_agentchat/conditions/_terminations.py b/python/packages/autogen-agentchat/src/autogen_agentchat/conditions/_terminations.pyindex c4ff24836..bccdd179d 100644--- a/python/packages/autogen-agentchat/src/autogen_agentchat/conditions/_terminations.py+++ b/python/packages/autogen-agentchat/src/autogen_agentchat/conditions/_terminations.py@@ -7,9 +7,8 @@ from typing_extensions import Selffrom ..base import TerminatedException, TerminationConditionfrom ..messages import (- AgentEvent,+ BaseAgentEvent,BaseChatMessage,- ChatMessage,HandoffMessage,StopMessage,TextMessage,@@ -34,7 +33,7 @@ class StopMessageTermination(TerminationCondition, Component[StopMessageTerminatdef terminated(self) -> bool:return self._terminated- async def __call__(self, messages: Sequence[AgentEvent | ChatMessage]) -> StopMessage | None:+ async def __call__(self, messages: Sequence[BaseAgentEvent | BaseChatMessage]) -> StopMessage | None:if self._terminated:raise TerminatedException("Termination condition has already been reached")for message in messages:@@ -64,8 +63,8 @@ class MaxMessageTermination(TerminationCondition, Component[MaxMessageTerminatioArgs:max_messages: The maximum number of messages allowed in the conversation.- include_agent_event: If True, include :class:`~autogen_agentchat.messages.AgentEvent` in the message count.- Otherwise, only include :class:`~autogen_agentchat.messages.ChatMessage`. Defaults to False.+ include_agent_event: If True, include :class:`~autogen_agentchat.messages.BaseAgentEvent` in the message count.+ Otherwise, only include :class:`~autogen_agentchat.messages.BaseChatMessage`. Defaults to False."""component_config_schema = MaxMessageTerminationConfig@@ -80,7 +79,7 @@ class MaxMessageTermination(TerminationCondition, Component[MaxMessageTerminatiodef terminated(self) -> bool:return self._message_count >= self._max_messages- async def __call__(self, messages: Sequence[AgentEvent | ChatMessage]) -> StopMessage | None:+ async def __call__(self, messages: Sequence[BaseAgentEvent | BaseChatMessage]) -> StopMessage | None:if self.terminated:raise TerminatedException("Termination condition has already been reached")self._message_count += len([m for m in messages if self._include_agent_event or isinstance(m, BaseChatMessage)])@@ -129,7 +128,7 @@ class TextMentionTermination(TerminationCondition, Component[TextMentionTerminatdef terminated(self) -> bool:return self._terminated- async def __call__(self, messages: Sequence[AgentEvent | ChatMessage]) -> StopMessage | None:+ async def __call__(self, messages: Sequence[BaseAgentEvent | BaseChatMessage]) -> StopMessage | None:if self._terminated:raise TerminatedException("Termination condition has already been reached")for message in messages:@@ -201,7 +200,7 @@ class TokenUsageTermination(TerminationCondition, Component[TokenUsageTerminatioor (self._max_completion_token is not None and self._completion_token_count >= self._max_completion_token))- async def __call__(self, messages: Sequence[AgentEvent | ChatMessage]) -> StopMessage | None:+ async def __call__(self, messages: Sequence[BaseAgentEvent | BaseChatMessage]) -> StopMessage | None:if self.terminated:raise TerminatedException("Termination condition has already been reached")for message in messages:@@ -258,7 +257,7 @@ class HandoffTermination(TerminationCondition, Component[HandoffTerminationConfidef terminated(self) -> bool:return self._terminated- async def __call__(self, messages: Sequence[AgentEvent | ChatMessage]) -> StopMessage | None:+ async def __call__(self, messages: Sequence[BaseAgentEvent | BaseChatMessage]) -> StopMessage | None:if self._terminated:raise TerminatedException("Termination condition has already been reached")for message in messages:@@ -303,7 +302,7 @@ class TimeoutTermination(TerminationCondition, Component[TimeoutTerminationConfidef terminated(self) -> bool:return self._terminated- async def __call__(self, messages: Sequence[AgentEvent | ChatMessage]) -> StopMessage | None:+ async def __call__(self, messages: Sequence[BaseAgentEvent | BaseChatMessage]) -> StopMessage | None:if self._terminated:raise TerminatedException("Termination condition has already been reached")@@ -365,7 +364,7 @@ class ExternalTermination(TerminationCondition, Component[ExternalTerminationCon"""Set the termination condition to terminated."""self._setted = True- async def __call__(self, messages: Sequence[AgentEvent | ChatMessage]) -> StopMessage | None:+ async def __call__(self, messages: Sequence[BaseAgentEvent | BaseChatMessage]) -> StopMessage | None:if self._terminated:raise TerminatedException("Termination condition has already been reached")if self._setted:@@ -410,7 +409,7 @@ class SourceMatchTermination(TerminationCondition, Component[SourceMatchTerminatdef terminated(self) -> bool:return self._terminated- async def __call__(self, messages: Sequence[AgentEvent | ChatMessage]) -> StopMessage | None:+ async def __call__(self, messages: Sequence[BaseAgentEvent | BaseChatMessage]) -> StopMessage | None:if self._terminated:raise TerminatedException("Termination condition has already been reached")if not messages:@@ -463,7 +462,7 @@ class TextMessageTermination(TerminationCondition, Component[TextMessageTerminatdef terminated(self) -> bool:return self._terminated- async def __call__(self, messages: Sequence[AgentEvent | ChatMessage]) -> StopMessage | None:+ async def __call__(self, messages: Sequence[BaseAgentEvent | BaseChatMessage]) -> StopMessage | None:if self._terminated:raise TerminatedException("Termination condition has already been reached")for message in messages:@@ -513,7 +512,7 @@ class FunctionCallTermination(TerminationCondition, Component[FunctionCallTermindef terminated(self) -> bool:return self._terminated- async def __call__(self, messages: Sequence[AgentEvent | ChatMessage]) -> StopMessage | None:+ async def __call__(self, messages: Sequence[BaseAgentEvent | BaseChatMessage]) -> StopMessage | None:if self._terminated:raise TerminatedException("Termination condition has already been reached")for message in messages:diff --git a/python/packages/autogen-agentchat/src/autogen_agentchat/messages.py b/python/packages/autogen-agentchat/src/autogen_agentchat/messages.pyindex f03ae61e2..aa27cd218 100644--- a/python/packages/autogen-agentchat/src/autogen_agentchat/messages.py+++ b/python/packages/autogen-agentchat/src/autogen_agentchat/messages.py@@ -1,6 +1,6 @@"""This module defines various message types used for agent-to-agent communication.-Each message type inherits either from the ChatMessage class or BaseAgentEvent+Each message type inherits either from the BaseChatMessage class or BaseAgentEventclass and includes specific fields relevant to the type of message being sent."""@@ -10,33 +10,36 @@ from typing import Any, Dict, Generic, List, Literal, Mapping, TypeVarfrom autogen_core import FunctionCall, Imagefrom autogen_core.memory import MemoryContentfrom autogen_core.models import FunctionExecutionResult, LLMMessage, RequestUsage, UserMessage-from pydantic import BaseModel, ConfigDict, computed_field-from typing_extensions import Self+from pydantic import BaseModel, Field, computed_field+from typing_extensions import Annotated, Selfclass BaseMessage(BaseModel, ABC):- """Base class for all message types in AgentChat. This is an abstract class- with default implementations for serialization and deserialization.+ """Abstract base class for all message types in AgentChat... warning::If you want to create a new message type, do not inherit from this class.- Instead, inherit from :class:`ChatMessage` or :class:`AgentEvent`+ Instead, inherit from :class:`BaseChatMessage` or :class:`BaseAgentEvent`to clarify the purpose of the message type."""- @computed_field- def type(self) -> str:- """The class name of this message."""- return self.__class__.__name__+ @abstractmethod+ def to_text(self) -> str:+ """Convert the message content to a string-only representation+ that can be rendered in the console and inspected by the user or conditions.+ This is not used for creating text-only content for models.+ For :class:`BaseChatMessage` types, use :meth:`to_model_text` instead."""+ ...def dump(self) -> Mapping[str, Any]:"""Convert the message to a JSON-serializable dictionary.- The default implementation uses the Pydantic model's `model_dump` method.-- If you want to customize the serialization, override this method.+ The default implementation uses the Pydantic model's+ :meth:`model_dump` method to convert the message to a dictionary.+ Override this method if you want to customize the serialization+ process or add additional fields to the output."""return self.model_dump()@@ -44,14 +47,15 @@ class BaseMessage(BaseModel, ABC):def load(cls, data: Mapping[str, Any]) -> Self:"""Create a message from a dictionary of JSON-serializable data.- The default implementation uses the Pydantic model's `model_validate` method.- If you want to customize the deserialization, override this method.- """+ The default implementation uses the Pydantic model's+ :meth:`model_validate` method to create the message from the data.+ Override this method if you want to customize the deserialization+ process or add additional fields to the input data."""return cls.model_validate(data)-class ChatMessage(BaseMessage, ABC):- """Base class for chat messages.+class BaseChatMessage(BaseMessage, ABC):+ """Abstract base class for chat messages... note::@@ -62,7 +66,7 @@ class ChatMessage(BaseMessage, ABC):This class is used for messages that are sent between agents in a chatconversation. Agents are expected to process the content of the- message using models and return a response as another :class:`ChatMessage`.+ message using models and return a response as another :class:`BaseChatMessage`."""source: str@@ -74,17 +78,6 @@ class ChatMessage(BaseMessage, ABC):metadata: Dict[str, str] = {}"""Additional metadata about the message."""- model_config = ConfigDict(arbitrary_types_allowed=True)-- @abstractmethod- def to_text(self) -> str:- """Convert the content of the message to a string-only representation- that can be rendered in the console and inspected by the user or conditions.-- This is not used for creating text-only content for models.- For :class:`ChatMessage` types, use :meth:`to_model_text` instead."""- ...-@abstractmethoddef to_model_text(self) -> str:"""Convert the content of the message to text-only representation.@@ -107,8 +100,8 @@ class ChatMessage(BaseMessage, ABC):...-class TextChatMessage(ChatMessage, ABC):- """Base class for all text-only :class:`ChatMessage` types.+class BaseTextChatMessage(BaseChatMessage, ABC):+ """Base class for all text-only :class:`BaseChatMessage` types.It has implementations for :meth:`to_text`, :meth:`to_model_text`,and :meth:`to_model_message` methods.@@ -128,7 +121,7 @@ class TextChatMessage(ChatMessage, ABC):return UserMessage(content=self.content, source=self.source)-class AgentEvent(BaseMessage, ABC):+class BaseAgentEvent(BaseMessage, ABC):"""Base class for agent events... note::@@ -153,24 +146,13 @@ class AgentEvent(BaseMessage, ABC):metadata: Dict[str, str] = {}"""Additional metadata about the message."""- model_config = ConfigDict(arbitrary_types_allowed=True)-- @abstractmethod- def to_text(self) -> str:- """Convert the content of the message to a string-only representation- that can be rendered in the console and inspected by the user.-- This is not used for creating text-only content for models.- For :class:`ChatMessage` types, use :meth:`to_model_text` instead."""- ...-StructuredContentType = TypeVar("StructuredContentType", bound=BaseModel, covariant=True)"""Type variable for structured content types."""-class StructuredMessage(ChatMessage, Generic[StructuredContentType]):- """A :class:`ChatMessage` type with an unspecified content type.+class StructuredMessage(BaseChatMessage, Generic[StructuredContentType]):+ """A :class:`BaseChatMessage` type with an unspecified content type.To create a new structured message type, specify the content typeas a subclass of `Pydantic BaseModel <https://docs.pydantic.dev/latest/concepts/models/>`_.@@ -199,6 +181,10 @@ class StructuredMessage(ChatMessage, Generic[StructuredContentType]):"""The content of the message. Must be a subclass of`Pydantic BaseModel <https://docs.pydantic.dev/latest/concepts/models/>`_."""+ @computed_field+ def type(self) -> str:+ return self.__class__.__name__+def to_text(self) -> str:return self.content.model_dump_json(indent=2)@@ -212,18 +198,20 @@ class StructuredMessage(ChatMessage, Generic[StructuredContentType]):)-class TextMessage(TextChatMessage):+class TextMessage(BaseTextChatMessage):"""A text message with string-only content."""- ...+ type: Literal["TextMessage"] = "TextMessage"-class MultiModalMessage(ChatMessage):+class MultiModalMessage(BaseChatMessage):"""A multimodal message."""content: List[str | Image]"""The content of the message."""+ type: Literal["MultiModalMessage"] = "MultiModalMessage"+def to_model_text(self, image_placeholder: str | None = "[image]") -> str:"""Convert the content of the message to a string-only representation.If an image is present, it will be replaced with the image placeholder@@ -258,13 +246,13 @@ class MultiModalMessage(ChatMessage):return UserMessage(content=self.content, source=self.source)-class StopMessage(TextChatMessage):+class StopMessage(BaseTextChatMessage):"""A message requesting stop of a conversation."""- ...+ type: Literal["StopMessage"] = "StopMessage"-class HandoffMessage(TextChatMessage):+class HandoffMessage(BaseTextChatMessage):"""A message requesting handoff of a conversation to another agent."""target: str@@ -273,34 +261,40 @@ class HandoffMessage(TextChatMessage):context: List[LLMMessage] = []"""The model context to be passed to the target agent."""+ type: Literal["HandoffMessage"] = "HandoffMessage"+-class ToolCallSummaryMessage(TextChatMessage):+class ToolCallSummaryMessage(BaseTextChatMessage):"""A message signaling the summary of tool call results."""- ...+ type: Literal["ToolCallSummaryMessage"] = "ToolCallSummaryMessage"-class ToolCallRequestEvent(AgentEvent):+class ToolCallRequestEvent(BaseAgentEvent):"""An event signaling a request to use tools."""content: List[FunctionCall]"""The tool calls."""+ type: Literal["ToolCallRequestEvent"] = "ToolCallRequestEvent"+def to_text(self) -> str:return str(self.content)-class ToolCallExecutionEvent(AgentEvent):+class ToolCallExecutionEvent(BaseAgentEvent):"""An event signaling the execution of tool calls."""content: List[FunctionExecutionResult]"""The tool call results."""+ type: Literal["ToolCallExecutionEvent"] = "ToolCallExecutionEvent"+def to_text(self) -> str:return str(self.content)-class UserInputRequestedEvent(AgentEvent):+class UserInputRequestedEvent(BaseAgentEvent):"""An event signaling a that the user proxy has requested user input. Published prior to invoking the input callback."""request_id: str@@ -309,31 +303,37 @@ class UserInputRequestedEvent(AgentEvent):content: Literal[""] = """""Empty content for compat with consumers expecting a content field."""+ type: Literal["UserInputRequestedEvent"] = "UserInputRequestedEvent"+def to_text(self) -> str:return str(self.content)-class MemoryQueryEvent(AgentEvent):+class MemoryQueryEvent(BaseAgentEvent):"""An event signaling the results of memory queries."""content: List[MemoryContent]"""The memory query results."""+ type: Literal["MemoryQueryEvent"] = "MemoryQueryEvent"+def to_text(self) -> str:return str(self.content)-class ModelClientStreamingChunkEvent(AgentEvent):+class ModelClientStreamingChunkEvent(BaseAgentEvent):"""An event signaling a text output chunk from a model client in streaming mode."""content: str"""A string chunk from the model client."""+ type: Literal["ModelClientStreamingChunkEvent"] = "ModelClientStreamingChunkEvent"+def to_text(self) -> str:return self.content-class ThoughtEvent(AgentEvent):+class ThoughtEvent(BaseAgentEvent):"""An event signaling the thought process of a model.It is used to communicate the reasoning tokens generated by a reasoning model,or the extra text content generated by a function call."""@@ -341,6 +341,8 @@ class ThoughtEvent(AgentEvent):content: str"""The thought process of the model."""+ type: Literal["ThoughtEvent"] = "ThoughtEvent"+def to_text(self) -> str:return self.content@@ -354,7 +356,7 @@ class MessageFactory:"""def __init__(self) -> None:- self._message_types: Dict[str, type[AgentEvent | ChatMessage]] = {}+ self._message_types: Dict[str, type[BaseAgentEvent | BaseChatMessage]] = {}# Register all message types.self._message_types[TextMessage.__name__] = TextMessageself._message_types[MultiModalMessage.__name__] = MultiModalMessage@@ -368,29 +370,31 @@ class MessageFactory:self._message_types[ModelClientStreamingChunkEvent.__name__] = ModelClientStreamingChunkEventself._message_types[ThoughtEvent.__name__] = ThoughtEvent- def is_registered(self, message_type: type[AgentEvent | ChatMessage]) -> bool:+ def is_registered(self, message_type: type[BaseAgentEvent | BaseChatMessage]) -> bool:"""Check if a message type is registered with the factory."""# Get the class name of the message type.class_name = message_type.__name__# Check if the class name is already registered.return class_name in self._message_types- def register(self, message_type: type[AgentEvent | ChatMessage]) -> None:+ def register(self, message_type: type[BaseAgentEvent | BaseChatMessage]) -> None:"""Register a new message type with the factory."""if self.is_registered(message_type):raise ValueError(f"Message type {message_type} is already registered.")- if not issubclass(message_type, ChatMessage) and not issubclass(message_type, AgentEvent):- raise ValueError(f"Message type {message_type} must be a subclass of ChatMessage or AgentEvent.")+ if not issubclass(message_type, BaseChatMessage) and not issubclass(message_type, BaseAgentEvent):+ raise ValueError(f"Message type {message_type} must be a subclass of BaseChatMessage or BaseAgentEvent.")# Get the class name of theclass_name = message_type.__name__# Check if the class name is already registered.# Register the message type.self._message_types[class_name] = message_type- def create(self, data: Mapping[str, Any]) -> AgentEvent | ChatMessage:+ def create(self, data: Mapping[str, Any]) -> BaseAgentEvent | BaseChatMessage:"""Create a message from a dictionary of JSON-serializable data."""# Get the type of the message from the dictionary.message_type = data.get("type")+ if message_type is None:+ raise ValueError("Field 'type' is required in the message data to recover the message type.")if message_type not in self._message_types:raise ValueError(f"Unknown message type: {message_type}")if not isinstance(message_type, str):@@ -400,14 +404,26 @@ class MessageFactory:message_class = self._message_types[message_type]# Create an instance of the message class.- assert issubclass(message_class, ChatMessage) or issubclass(message_class, AgentEvent)+ assert issubclass(message_class, BaseChatMessage) or issubclass(message_class, BaseAgentEvent)return message_class.load(data)-# For backward compatibility-BaseAgentEvent = AgentEvent-BaseChatMessage = ChatMessage-+ChatMessage = Annotated[+ TextMessage | MultiModalMessage | StopMessage | ToolCallSummaryMessage | HandoffMessage, Field(discriminator="type")+]+"""The union type of all built-in concrete subclasses of :class:`BaseChatMessage`.+It does not include :class:`StructuredMessage` types."""++AgentEvent = Annotated[+ ToolCallRequestEvent+ | ToolCallExecutionEvent+ | MemoryQueryEvent+ | UserInputRequestedEvent+ | ModelClientStreamingChunkEvent+ | ThoughtEvent,+ Field(discriminator="type"),+]+"""The union type of all built-in concrete subclasses of :class:`BaseAgentEvent`."""__all__ = ["AgentEvent",@@ -415,9 +431,8 @@ __all__ = ["ChatMessage","BaseChatMessage","BaseAgentEvent",- "AgentEvent",- "TextChatMessage",- "ChatMessage",+ "BaseTextChatMessage",+ "BaseChatMessage","StructuredContentType","StructuredMessage","HandoffMessage",diff --git a/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_base_group_chat.py b/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_base_group_chat.pyindex 9e4f77a3a..5f032203b 100644--- a/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_base_group_chat.py+++ b/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_base_group_chat.py@@ -18,8 +18,8 @@ from pydantic import BaseModel, ValidationErrorfrom ... import EVENT_LOGGER_NAMEfrom ...base import ChatAgent, TaskResult, Team, TerminationConditionfrom ...messages import (- AgentEvent,- ChatMessage,+ BaseAgentEvent,+ BaseChatMessage,MessageFactory,ModelClientStreamingChunkEvent,StopMessage,@@ -50,7 +50,7 @@ class BaseGroupChat(Team, ABC, ComponentBase[BaseModel]):termination_condition: TerminationCondition | None = None,max_turns: int | None = None,runtime: AgentRuntime | None = None,- custom_message_types: List[type[AgentEvent | ChatMessage]] | None = None,+ custom_message_types: List[type[BaseAgentEvent | BaseChatMessage]] | None = None,):if len(participants) == 0:raise ValueError("At least one participant is required.")@@ -90,7 +90,9 @@ class BaseGroupChat(Team, ABC, ComponentBase[BaseModel]):self._output_topic_type = f"output_topic_{self._team_id}"# The queue for collecting the output messages.- self._output_message_queue: asyncio.Queue[AgentEvent | ChatMessage | GroupChatTermination] = asyncio.Queue()+ self._output_message_queue: asyncio.Queue[BaseAgentEvent | BaseChatMessage | GroupChatTermination] = (+ asyncio.Queue()+ )# Create a runtime for the team.if runtime is not None:@@ -117,7 +119,7 @@ class BaseGroupChat(Team, ABC, ComponentBase[BaseModel]):participant_topic_types: List[str],participant_names: List[str],participant_descriptions: List[str],- output_message_queue: asyncio.Queue[AgentEvent | ChatMessage | GroupChatTermination],+ output_message_queue: asyncio.Queue[BaseAgentEvent | BaseChatMessage | GroupChatTermination],termination_condition: TerminationCondition | None,max_turns: int | None,message_factory: MessageFactory,@@ -195,7 +197,7 @@ class BaseGroupChat(Team, ABC, ComponentBase[BaseModel]):async def run(self,*,- task: str | ChatMessage | Sequence[ChatMessage] | None = None,+ task: str | BaseChatMessage | Sequence[BaseChatMessage] | None = None,cancellation_token: CancellationToken | None = None,) -> TaskResult:"""Run the team and return the result. The base implementation uses@@ -203,7 +205,7 @@ class BaseGroupChat(Team, ABC, ComponentBase[BaseModel]):Once the team is stopped, the termination condition is reset.Args:- task (str | ChatMessage | Sequence[ChatMessage] | None): The task to run the team with. Can be a string, a single :class:`ChatMessage` , or a list of :class:`ChatMessage`.+ task (str | BaseChatMessage | Sequence[BaseChatMessage] | None): The task to run the team with. Can be a string, a single :class:`BaseChatMessage` , or a list of :class:`BaseChatMessage`.cancellation_token (CancellationToken | None): The cancellation token to kill the task immediately.Setting the cancellation token potentially put the team in an inconsistent state,and it may not reset the termination condition.@@ -297,9 +299,9 @@ class BaseGroupChat(Team, ABC, ComponentBase[BaseModel]):async def run_stream(self,*,- task: str | ChatMessage | Sequence[ChatMessage] | None = None,+ task: str | BaseChatMessage | Sequence[BaseChatMessage] | None = None,cancellation_token: CancellationToken | None = None,- ) -> AsyncGenerator[AgentEvent | ChatMessage | TaskResult, None]:+ ) -> AsyncGenerator[BaseAgentEvent | BaseChatMessage | TaskResult, None]:"""Run the team and produces a stream of messages and the final resultof the type :class:`~autogen_agentchat.base.TaskResult` as the last item in the stream. Once theteam is stopped, the termination condition is reset.@@ -311,14 +313,14 @@ class BaseGroupChat(Team, ABC, ComponentBase[BaseModel])::attr:`~autogen_agentchat.base.TaskResult.messages`.Args:- task (str | ChatMessage | Sequence[ChatMessage] | None): The task to run the team with. Can be a string, a single :class:`ChatMessage` , or a list of :class:`ChatMessage`.+ task (str | BaseChatMessage | Sequence[BaseChatMessage] | None): The task to run the team with. Can be a string, a single :class:`BaseChatMessage` , or a list of :class:`BaseChatMessage`.cancellation_token (CancellationToken | None): The cancellation token to kill the task immediately.Setting the cancellation token potentially put the team in an inconsistent state,and it may not reset the termination condition.To gracefully stop the team, use :class:`~autogen_agentchat.conditions.ExternalTermination` instead.Returns:- stream: an :class:`~collections.abc.AsyncGenerator` that yields :class:`~autogen_agentchat.messages.AgentEvent`, :class:`~autogen_agentchat.messages.ChatMessage`, and the final result :class:`~autogen_agentchat.base.TaskResult` as the last item in the stream.+ stream: an :class:`~collections.abc.AsyncGenerator` that yields :class:`~autogen_agentchat.messages.BaseAgentEvent`, :class:`~autogen_agentchat.messages.BaseChatMessage`, and the final result :class:`~autogen_agentchat.base.TaskResult` as the last item in the stream.Example using the :class:`~autogen_agentchat.teams.RoundRobinGroupChat` team:@@ -398,23 +400,23 @@ class BaseGroupChat(Team, ABC, ComponentBase[BaseModel]):"""# Create the messages list if the task is a string or a chat message.- messages: List[ChatMessage] | None = None+ messages: List[BaseChatMessage] | None = Noneif task is None:passelif isinstance(task, str):messages = [TextMessage(content=task, source="user")]- elif isinstance(task, ChatMessage):+ elif isinstance(task, BaseChatMessage):messages = [task]elif isinstance(task, list):if not task:raise ValueError("Task list cannot be empty.")messages = []for msg in task:- if not isinstance(msg, ChatMessage):- raise ValueError("All messages in task list must be valid ChatMessage types")+ if not isinstance(msg, BaseChatMessage):+ raise ValueError("All messages in task list must be valid BaseChatMessage types")messages.append(msg)else:- raise ValueError("Task must be a string, a ChatMessage, or a list of ChatMessage.")+ raise ValueError("Task must be a string, a BaseChatMessage, or a list of BaseChatMessage.")# Check if the messages types are registered with the message factory.if messages is not None:for msg in messages:@@ -469,7 +471,7 @@ class BaseGroupChat(Team, ABC, ComponentBase[BaseModel]):cancellation_token=cancellation_token,)# Collect the output messages in order.- output_messages: List[AgentEvent | ChatMessage] = []+ output_messages: List[BaseAgentEvent | BaseChatMessage] = []stop_reason: str | None = None# Yield the messsages until the queue is empty.while True:diff --git a/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_base_group_chat_manager.py b/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_base_group_chat_manager.pyindex 59653e5f3..2f9c0a1e3 100644--- a/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_base_group_chat_manager.py+++ b/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_base_group_chat_manager.py@@ -5,7 +5,7 @@ from typing import Any, Listfrom autogen_core import DefaultTopicId, MessageContext, event, rpcfrom ...base import TerminationCondition-from ...messages import AgentEvent, ChatMessage, MessageFactory, StopMessage+from ...messages import BaseAgentEvent, BaseChatMessage, MessageFactory, StopMessagefrom ._events import (GroupChatAgentResponse,GroupChatMessage,@@ -39,7 +39,7 @@ class BaseGroupChatManager(SequentialRoutedAgent, ABC):participant_topic_types: List[str],participant_names: List[str],participant_descriptions: List[str],- output_message_queue: asyncio.Queue[AgentEvent | ChatMessage | GroupChatTermination],+ output_message_queue: asyncio.Queue[BaseAgentEvent | BaseChatMessage | GroupChatTermination],termination_condition: TerminationCondition | None,max_turns: int | None,message_factory: MessageFactory,@@ -67,7 +67,7 @@ class BaseGroupChatManager(SequentialRoutedAgent, ABC):name: topic_type for name, topic_type in zip(participant_names, participant_topic_types, strict=True)}self._participant_descriptions = participant_descriptions- self._message_thread: List[AgentEvent | ChatMessage] = []+ self._message_thread: List[BaseAgentEvent | BaseChatMessage] = []self._output_message_queue = output_message_queueself._termination_condition = termination_conditionif max_turns is not None and max_turns <= 0:@@ -141,7 +141,7 @@ class BaseGroupChatManager(SequentialRoutedAgent, ABC):@eventasync def handle_agent_response(self, message: GroupChatAgentResponse, ctx: MessageContext) -> None:# Append the message to the message thread and construct the delta.- delta: List[AgentEvent | ChatMessage] = []+ delta: List[BaseAgentEvent | BaseChatMessage] = []if message.agent_response.inner_messages is not None:for inner_message in message.agent_response.inner_messages:self._message_thread.append(inner_message)@@ -225,7 +225,7 @@ class BaseGroupChatManager(SequentialRoutedAgent, ABC):pass@abstractmethod- async def validate_group_state(self, messages: List[ChatMessage] | None) -> None:+ async def validate_group_state(self, messages: List[BaseChatMessage] | None) -> None:"""Validate the state of the group chat given the start messages.This is executed when the group chat manager receives a GroupChatStart event.@@ -235,7 +235,7 @@ class BaseGroupChatManager(SequentialRoutedAgent, ABC):...@abstractmethod- async def select_speaker(self, thread: List[AgentEvent | ChatMessage]) -> str:+ async def select_speaker(self, thread: List[BaseAgentEvent | BaseChatMessage]) -> str:"""Select a speaker from the participants and return thetopic type of the selected speaker."""...diff --git a/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_chat_agent_container.py b/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_chat_agent_container.pyindex d4a2adda8..fa74b8f98 100644--- a/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_chat_agent_container.py+++ b/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_chat_agent_container.py@@ -2,7 +2,7 @@ from typing import Any, List, Mappingfrom autogen_core import DefaultTopicId, MessageContext, event, rpc-from autogen_agentchat.messages import AgentEvent, ChatMessage, MessageFactory+from autogen_agentchat.messages import BaseAgentEvent, BaseChatMessage, MessageFactoryfrom ...base import ChatAgent, Responsefrom ...state import ChatAgentContainerState@@ -46,7 +46,7 @@ class ChatAgentContainer(SequentialRoutedAgent):self._parent_topic_type = parent_topic_typeself._output_topic_type = output_topic_typeself._agent = agent- self._message_buffer: List[ChatMessage] = []+ self._message_buffer: List[BaseChatMessage] = []self._message_factory = message_factory@event@@ -90,13 +90,13 @@ class ChatAgentContainer(SequentialRoutedAgent):cancellation_token=ctx.cancellation_token,)- def _buffer_message(self, message: ChatMessage) -> None:+ def _buffer_message(self, message: BaseChatMessage) -> None:if not self._message_factory.is_registered(message.__class__):raise ValueError(f"Message type {message.__class__} is not registered.")# Buffer the message.self._message_buffer.append(message)- async def _log_message(self, message: AgentEvent | ChatMessage) -> None:+ async def _log_message(self, message: BaseAgentEvent | BaseChatMessage) -> None:if not self._message_factory.is_registered(message.__class__):raise ValueError(f"Message type {message.__class__} is not registered.")# Log the message.@@ -130,7 +130,7 @@ class ChatAgentContainer(SequentialRoutedAgent):self._message_buffer = []for message_data in container_state.message_buffer:message = self._message_factory.create(message_data)- if isinstance(message, ChatMessage):+ if isinstance(message, BaseChatMessage):self._message_buffer.append(message)else:raise ValueError(f"Invalid message type in message buffer: {type(message)}")diff --git a/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_events.py b/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_events.pyindex f705a54c4..351701a19 100644--- a/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_events.py+++ b/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_events.py@@ -3,13 +3,13 @@ from typing import Listfrom pydantic import BaseModelfrom ...base import Response-from ...messages import AgentEvent, ChatMessage, StopMessage+from ...messages import BaseAgentEvent, BaseChatMessage, StopMessageclass GroupChatStart(BaseModel):"""A request to start a group chat."""- messages: List[ChatMessage] | None = None+ messages: List[BaseChatMessage] | None = None"""An optional list of messages to start the group chat."""@@ -29,7 +29,7 @@ class GroupChatRequestPublish(BaseModel):class GroupChatMessage(BaseModel):"""A message from a group chat."""- message: AgentEvent | ChatMessage+ message: BaseAgentEvent | BaseChatMessage"""The message that was published."""diff --git a/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_magentic_one/_magentic_one_group_chat.py b/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_magentic_one/_magentic_one_group_chat.pyindex 66ff53fe1..6cc32701e 100644--- a/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_magentic_one/_magentic_one_group_chat.py+++ b/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_magentic_one/_magentic_one_group_chat.py@@ -9,7 +9,7 @@ from typing_extensions import Selffrom .... import EVENT_LOGGER_NAME, TRACE_LOGGER_NAMEfrom ....base import ChatAgent, TerminationCondition-from ....messages import AgentEvent, ChatMessage, MessageFactory+from ....messages import BaseAgentEvent, BaseChatMessage, MessageFactoryfrom .._base_group_chat import BaseGroupChatfrom .._events import GroupChatTerminationfrom ._magentic_one_orchestrator import MagenticOneOrchestrator@@ -128,7 +128,7 @@ class MagenticOneGroupChat(BaseGroupChat, Component[MagenticOneGroupChatConfig])participant_topic_types: List[str],participant_names: List[str],participant_descriptions: List[str],- output_message_queue: asyncio.Queue[AgentEvent | ChatMessage | GroupChatTermination],+ output_message_queue: asyncio.Queue[BaseAgentEvent | BaseChatMessage | GroupChatTermination],termination_condition: TerminationCondition | None,max_turns: int | None,message_factory: MessageFactory,diff --git a/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_magentic_one/_magentic_one_orchestrator.py b/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_magentic_one/_magentic_one_orchestrator.pyindex d442c8acb..4e6681315 100644--- a/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_magentic_one/_magentic_one_orchestrator.py+++ b/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_magentic_one/_magentic_one_orchestrator.py@@ -15,8 +15,8 @@ from autogen_core.models import (from .... import TRACE_LOGGER_NAMEfrom ....base import Response, TerminationConditionfrom ....messages import (- AgentEvent,- ChatMessage,+ BaseAgentEvent,+ BaseChatMessage,HandoffMessage,MessageFactory,MultiModalMessage,@@ -66,7 +66,7 @@ class MagenticOneOrchestrator(BaseGroupChatManager):model_client: ChatCompletionClient,max_stalls: int,final_answer_prompt: str,- output_message_queue: asyncio.Queue[AgentEvent | ChatMessage | GroupChatTermination],+ output_message_queue: asyncio.Queue[BaseAgentEvent | BaseChatMessage | GroupChatTermination],termination_condition: TerminationCondition | None,):super().__init__(@@ -184,7 +184,7 @@ class MagenticOneOrchestrator(BaseGroupChatManager):@eventasync def handle_agent_response(self, message: GroupChatAgentResponse, ctx: MessageContext) -> None: # type: ignore- delta: List[AgentEvent | ChatMessage] = []+ delta: List[BaseAgentEvent | BaseChatMessage] = []if message.agent_response.inner_messages is not None:for inner_message in message.agent_response.inner_messages:delta.append(inner_message)@@ -201,7 +201,7 @@ class MagenticOneOrchestrator(BaseGroupChatManager):returnawait self._orchestrate_step(ctx.cancellation_token)- async def validate_group_state(self, messages: List[ChatMessage] | None) -> None:+ async def validate_group_state(self, messages: List[BaseChatMessage] | None) -> None:passasync def save_state(self) -> Mapping[str, Any]:@@ -226,7 +226,7 @@ class MagenticOneOrchestrator(BaseGroupChatManager):self._n_rounds = orchestrator_state.n_roundsself._n_stalls = orchestrator_state.n_stalls- async def select_speaker(self, thread: List[AgentEvent | ChatMessage]) -> str:+ async def select_speaker(self, thread: List[BaseAgentEvent | BaseChatMessage]) -> str:"""Not used in this orchestrator, we select next speaker in _orchestrate_step."""return ""diff --git a/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_round_robin_group_chat.py b/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_round_robin_group_chat.pyindex 0f06d9aee..8d9218619 100644--- a/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_round_robin_group_chat.py+++ b/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_round_robin_group_chat.py@@ -6,7 +6,7 @@ from pydantic import BaseModelfrom typing_extensions import Selffrom ...base import ChatAgent, TerminationCondition-from ...messages import AgentEvent, ChatMessage, MessageFactory+from ...messages import BaseAgentEvent, BaseChatMessage, MessageFactoryfrom ...state import RoundRobinManagerStatefrom ._base_group_chat import BaseGroupChatfrom ._base_group_chat_manager import BaseGroupChatManager@@ -24,7 +24,7 @@ class RoundRobinGroupChatManager(BaseGroupChatManager):participant_topic_types: List[str],participant_names: List[str],participant_descriptions: List[str],- output_message_queue: asyncio.Queue[AgentEvent | ChatMessage | GroupChatTermination],+ output_message_queue: asyncio.Queue[BaseAgentEvent | BaseChatMessage | GroupChatTermination],termination_condition: TerminationCondition | None,max_turns: int | None,message_factory: MessageFactory,@@ -43,7 +43,7 @@ class RoundRobinGroupChatManager(BaseGroupChatManager):)self._next_speaker_index = 0- async def validate_group_state(self, messages: List[ChatMessage] | None) -> None:+ async def validate_group_state(self, messages: List[BaseChatMessage] | None) -> None:passasync def reset(self) -> None:@@ -67,7 +67,7 @@ class RoundRobinGroupChatManager(BaseGroupChatManager):self._current_turn = round_robin_state.current_turnself._next_speaker_index = round_robin_state.next_speaker_index- async def select_speaker(self, thread: List[AgentEvent | ChatMessage]) -> str:+ async def select_speaker(self, thread: List[BaseAgentEvent | BaseChatMessage]) -> str:"""Select a speaker from the participants in a round-robin fashion."""current_speaker_index = self._next_speaker_indexself._next_speaker_index = (current_speaker_index + 1) % len(self._participant_names)@@ -166,7 +166,7 @@ class RoundRobinGroupChat(BaseGroupChat, Component[RoundRobinGroupChatConfig]):termination_condition: TerminationCondition | None = None,max_turns: int | None = None,runtime: AgentRuntime | None = None,- custom_message_types: List[type[AgentEvent | ChatMessage]] | None = None,+ custom_message_types: List[type[BaseAgentEvent | BaseChatMessage]] | None = None,) -> None:super().__init__(participants,@@ -186,7 +186,7 @@ class RoundRobinGroupChat(BaseGroupChat, Component[RoundRobinGroupChatConfig]):participant_topic_types: List[str],participant_names: List[str],participant_descriptions: List[str],- output_message_queue: asyncio.Queue[AgentEvent | ChatMessage | GroupChatTermination],+ output_message_queue: asyncio.Queue[BaseAgentEvent | BaseChatMessage | GroupChatTermination],termination_condition: TerminationCondition | None,max_turns: int | None,message_factory: MessageFactory,diff --git a/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_selector_group_chat.py b/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_selector_group_chat.pyindex 7e1b68814..1aa5aa337 100644--- a/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_selector_group_chat.py+++ b/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_selector_group_chat.py@@ -13,8 +13,8 @@ from ... import TRACE_LOGGER_NAMEfrom ...agents import BaseChatAgentfrom ...base import ChatAgent, TerminationConditionfrom ...messages import (- AgentEvent,- ChatMessage,+ BaseAgentEvent,+ BaseChatMessage,MessageFactory,)from ...state import SelectorManagerState@@ -24,12 +24,12 @@ from ._events import GroupChatTerminationtrace_logger = logging.getLogger(TRACE_LOGGER_NAME)-SyncSelectorFunc = Callable[[Sequence[AgentEvent | ChatMessage]], str | None]-AsyncSelectorFunc = Callable[[Sequence[AgentEvent | ChatMessage]], Awaitable[str | None]]+SyncSelectorFunc = Callable[[Sequence[BaseAgentEvent | BaseChatMessage]], str | None]+AsyncSelectorFunc = Callable[[Sequence[BaseAgentEvent | BaseChatMessage]], Awaitable[str | None]]SelectorFuncType = Union[SyncSelectorFunc | AsyncSelectorFunc]-SyncCandidateFunc = Callable[[Sequence[AgentEvent | ChatMessage]], List[str]]-AsyncCandidateFunc = Callable[[Sequence[AgentEvent | ChatMessage]], Awaitable[List[str]]]+SyncCandidateFunc = Callable[[Sequence[BaseAgentEvent | BaseChatMessage]], List[str]]+AsyncCandidateFunc = Callable[[Sequence[BaseAgentEvent | BaseChatMessage]], Awaitable[List[str]]]CandidateFuncType = Union[SyncCandidateFunc | AsyncCandidateFunc]@@ -45,7 +45,7 @@ class SelectorGroupChatManager(BaseGroupChatManager):participant_topic_types: List[str],participant_names: List[str],participant_descriptions: List[str],- output_message_queue: asyncio.Queue[AgentEvent | ChatMessage | GroupChatTermination],+ output_message_queue: asyncio.Queue[BaseAgentEvent | BaseChatMessage | GroupChatTermination],termination_condition: TerminationCondition | None,max_turns: int | None,message_factory: MessageFactory,@@ -78,7 +78,7 @@ class SelectorGroupChatManager(BaseGroupChatManager):self._candidate_func = candidate_funcself._is_candidate_func_async = iscoroutinefunction(self._candidate_func)- async def validate_group_state(self, messages: List[ChatMessage] | None) -> None:+ async def validate_group_state(self, messages: List[BaseChatMessage] | None) -> None:passasync def reset(self) -> None:@@ -102,7 +102,7 @@ class SelectorGroupChatManager(BaseGroupChatManager):self._current_turn = selector_state.current_turnself._previous_speaker = selector_state.previous_speaker- async def select_speaker(self, thread: List[AgentEvent | ChatMessage]) -> str:+ async def select_speaker(self, thread: List[BaseAgentEvent | BaseChatMessage]) -> str:"""Selects the next speaker in a group chat using a ChatCompletion client,with the selector function as override if it returns a speaker name.@@ -153,7 +153,7 @@ class SelectorGroupChatManager(BaseGroupChatManager):# Construct the history of the conversation.history_messages: List[str] = []for msg in thread:- if not isinstance(msg, ChatMessage):+ if not isinstance(msg, BaseChatMessage):# Only process chat messages.continuemessage = f"{msg.source}: {msg.to_model_text()}"@@ -299,11 +299,11 @@ class SelectorGroupChat(BaseGroupChat, Component[SelectorGroupChatConfig]):max_selector_attempts (int, optional): The maximum number of attempts to select a speaker using the model. Defaults to 3.If the model fails to select a speaker after the maximum number of attempts, the previous speaker will be used if available,otherwise the first participant will be used.- selector_func (Callable[[Sequence[AgentEvent | ChatMessage]], str | None], Callable[[Sequence[AgentEvent | ChatMessage]], Awaitable[str | None]], optional): A custom selector+ selector_func (Callable[[Sequence[BaseAgentEvent | BaseChatMessage]], str | None], Callable[[Sequence[BaseAgentEvent | BaseChatMessage]], Awaitable[str | None]], optional): A custom selectorfunction that takes the conversation history and returns the name of the next speaker.If provided, this function will be used to override the model to select the next speaker.If the function returns None, the model will be used to select the next speaker.- candidate_func (Callable[[Sequence[AgentEvent | ChatMessage]], List[str]], Callable[[Sequence[AgentEvent | ChatMessage]], Awaitable[List[str]]], optional):+ candidate_func (Callable[[Sequence[BaseAgentEvent | BaseChatMessage]], List[str]], Callable[[Sequence[BaseAgentEvent | BaseChatMessage]], Awaitable[List[str]]], optional):A custom function that takes the conversation history and returns a filtered list of candidates for the next speakerselection using model. If the function returns an empty list or `None`, `SelectorGroupChat` will raise a `ValueError`.This function is only used if `selector_func` is not set. The `allow_repeated_speaker` will be ignored if set.@@ -378,7 +378,7 @@ class SelectorGroupChat(BaseGroupChat, Component[SelectorGroupChatConfig]):from autogen_agentchat.teams import SelectorGroupChatfrom autogen_agentchat.conditions import TextMentionTerminationfrom autogen_agentchat.ui import Console- from autogen_agentchat.messages import AgentEvent, ChatMessage+ from autogen_agentchat.messages import BaseAgentEvent, BaseChatMessageasync def main() -> None:@@ -404,7 +404,7 @@ class SelectorGroupChat(BaseGroupChat, Component[SelectorGroupChatConfig]):system_message="Check the answer and respond with 'Correct!' or 'Incorrect!'",)- def selector_func(messages: Sequence[AgentEvent | ChatMessage]) -> str | None:+ def selector_func(messages: Sequence[BaseAgentEvent | BaseChatMessage]) -> str | None:if len(messages) == 1 or messages[-1].to_text() == "Incorrect!":return "Agent1"if messages[-1].source == "Agent1":@@ -448,7 +448,7 @@ Read the above conversation. Then select the next role from {participants} to plmax_selector_attempts: int = 3,selector_func: Optional[SelectorFuncType] = None,candidate_func: Optional[CandidateFuncType] = None,- custom_message_types: List[type[AgentEvent | ChatMessage]] | None = None,+ custom_message_types: List[type[BaseAgentEvent | BaseChatMessage]] | None = None,):super().__init__(participants,@@ -477,7 +477,7 @@ Read the above conversation. Then select the next role from {participants} to plparticipant_topic_types: List[str],participant_names: List[str],participant_descriptions: List[str],- output_message_queue: asyncio.Queue[AgentEvent | ChatMessage | GroupChatTermination],+ output_message_queue: asyncio.Queue[BaseAgentEvent | BaseChatMessage | GroupChatTermination],termination_condition: TerminationCondition | None,max_turns: int | None,message_factory: MessageFactory,@@ -525,7 +525,7 @@ Read the above conversation. Then select the next role from {participants} to plselector_prompt=config.selector_prompt,allow_repeated_speaker=config.allow_repeated_speaker,max_selector_attempts=config.max_selector_attempts,- # selector_func=ComponentLoader.load_component(config.selector_func, Callable[[Sequence[AgentEvent | ChatMessage]], str | None])+ # selector_func=ComponentLoader.load_component(config.selector_func, Callable[[Sequence[BaseAgentEvent | BaseChatMessage]], str | None])# if config.selector_func# else None,)diff --git a/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_swarm_group_chat.py b/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_swarm_group_chat.pyindex d76ba0fb1..8a810896f 100644--- a/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_swarm_group_chat.py+++ b/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_swarm_group_chat.py@@ -5,7 +5,7 @@ from autogen_core import AgentRuntime, Component, ComponentModelfrom pydantic import BaseModelfrom ...base import ChatAgent, TerminationCondition-from ...messages import AgentEvent, ChatMessage, HandoffMessage, MessageFactory+from ...messages import BaseAgentEvent, BaseChatMessage, HandoffMessage, MessageFactoryfrom ...state import SwarmManagerStatefrom ._base_group_chat import BaseGroupChatfrom ._base_group_chat_manager import BaseGroupChatManager@@ -23,7 +23,7 @@ class SwarmGroupChatManager(BaseGroupChatManager):participant_topic_types: List[str],participant_names: List[str],participant_descriptions: List[str],- output_message_queue: asyncio.Queue[AgentEvent | ChatMessage | GroupChatTermination],+ output_message_queue: asyncio.Queue[BaseAgentEvent | BaseChatMessage | GroupChatTermination],termination_condition: TerminationCondition | None,max_turns: int | None,message_factory: MessageFactory,@@ -42,7 +42,7 @@ class SwarmGroupChatManager(BaseGroupChatManager):)self._current_speaker = self._participant_names[0]- async def validate_group_state(self, messages: List[ChatMessage] | None) -> None:+ async def validate_group_state(self, messages: List[BaseChatMessage] | None) -> None:"""Validate the start messages for the group chat."""# Check if any of the start messages is a handoff message.if messages:@@ -77,7 +77,7 @@ class SwarmGroupChatManager(BaseGroupChatManager):await self._termination_condition.reset()self._current_speaker = self._participant_names[0]- async def select_speaker(self, thread: List[AgentEvent | ChatMessage]) -> str:+ async def select_speaker(self, thread: List[BaseAgentEvent | BaseChatMessage]) -> str:"""Select a speaker from the participants based on handoff message.Looks for the last handoff message in the thread to determine the next speaker."""if len(thread) == 0:@@ -212,7 +212,7 @@ class Swarm(BaseGroupChat, Component[SwarmConfig]):termination_condition: TerminationCondition | None = None,max_turns: int | None = None,runtime: AgentRuntime | None = None,- custom_message_types: List[type[AgentEvent | ChatMessage]] | None = None,+ custom_message_types: List[type[BaseAgentEvent | BaseChatMessage]] | None = None,) -> None:super().__init__(participants,@@ -236,7 +236,7 @@ class Swarm(BaseGroupChat, Component[SwarmConfig]):participant_topic_types: List[str],participant_names: List[str],participant_descriptions: List[str],- output_message_queue: asyncio.Queue[AgentEvent | ChatMessage | GroupChatTermination],+ output_message_queue: asyncio.Queue[BaseAgentEvent | BaseChatMessage | GroupChatTermination],termination_condition: TerminationCondition | None,max_turns: int | None,message_factory: MessageFactory,diff --git a/python/packages/autogen-agentchat/src/autogen_agentchat/ui/_console.py b/python/packages/autogen-agentchat/src/autogen_agentchat/ui/_console.pyindex 524ee93a8..51d98ffe2 100644--- a/python/packages/autogen-agentchat/src/autogen_agentchat/ui/_console.py+++ b/python/packages/autogen-agentchat/src/autogen_agentchat/ui/_console.py@@ -11,8 +11,8 @@ from autogen_core.models import RequestUsagefrom autogen_agentchat.agents import UserProxyAgentfrom autogen_agentchat.base import Response, TaskResultfrom autogen_agentchat.messages import (- AgentEvent,- ChatMessage,+ BaseAgentEvent,+ BaseChatMessage,ModelClientStreamingChunkEvent,MultiModalMessage,UserInputRequestedEvent,@@ -80,7 +80,7 @@ def aprint(output: str, end: str = "\n", flush: bool = False) -> Awaitable[None]async def Console(- stream: AsyncGenerator[AgentEvent | ChatMessage | T, None],+ stream: AsyncGenerator[BaseAgentEvent | BaseChatMessage | T, None],*,no_inline_images: bool = False,output_stats: bool = False,@@ -97,7 +97,7 @@ async def Console(It will be improved in future releases.Args:- stream (AsyncGenerator[AgentEvent | ChatMessage | TaskResult, None] | AsyncGenerator[AgentEvent | ChatMessage | Response, None]): Message stream to render.+ stream (AsyncGenerator[BaseAgentEvent | BaseChatMessage | TaskResult, None] | AsyncGenerator[BaseAgentEvent | BaseChatMessage | Response, None]): Message stream to render.This can be from :meth:`~autogen_agentchat.base.TaskRunner.run_stream` or :meth:`~autogen_agentchat.base.ChatAgent.on_messages_stream`.no_inline_images (bool, optional): If terminal is iTerm2 will render images inline. Use this to disable this behavior. Defaults to False.output_stats (bool, optional): (Experimental) If True, will output a summary of the messages and inline token usage info. Defaults to False.@@ -170,7 +170,7 @@ async def Console(user_input_manager.notify_event_received(message.request_id)else:# Cast required for mypy to be happy- message = cast(AgentEvent | ChatMessage, message) # type: ignore+ message = cast(BaseAgentEvent | BaseChatMessage, message) # type: ignoreif not streaming_chunks:# Print message sender.await aprint(f"{'-' * 10} {message.source} {'-' * 10}", end="\n", flush=True)diff --git a/python/packages/autogen-agentchat/tests/test_assistant_agent.py b/python/packages/autogen-agentchat/tests/test_assistant_agent.pyindex c061651b0..8de0665c9 100644--- a/python/packages/autogen-agentchat/tests/test_assistant_agent.py+++ b/python/packages/autogen-agentchat/tests/test_assistant_agent.py@@ -7,7 +7,7 @@ from autogen_agentchat import EVENT_LOGGER_NAMEfrom autogen_agentchat.agents import AssistantAgentfrom autogen_agentchat.base import Handoff, TaskResultfrom autogen_agentchat.messages import (- ChatMessage,+ BaseChatMessage,HandoffMessage,MemoryQueryEvent,ModelClientStreamingChunkEvent,@@ -737,7 +737,7 @@ async def test_list_chat_messages(monkeypatch: pytest.MonkeyPatch) -> None:)# Create a list of chat messages- messages: List[ChatMessage] = [+ messages: List[BaseChatMessage] = [TextMessage(content="Message 1", source="user"),TextMessage(content="Message 2", source="user"),]diff --git a/python/packages/autogen-agentchat/tests/test_group_chat.py b/python/packages/autogen-agentchat/tests/test_group_chat.pyindex c0387ee84..25d64ade8 100644--- a/python/packages/autogen-agentchat/tests/test_group_chat.py+++ b/python/packages/autogen-agentchat/tests/test_group_chat.py@@ -2,7 +2,7 @@ import asyncioimport jsonimport loggingimport tempfile-from typing import AsyncGenerator, List, Sequence+from typing import Any, AsyncGenerator, List, Mapping, Sequenceimport pytestimport pytest_asyncio@@ -15,8 +15,8 @@ from autogen_agentchat.agents import (from autogen_agentchat.base import Handoff, Response, TaskResultfrom autogen_agentchat.conditions import HandoffTermination, MaxMessageTermination, TextMentionTerminationfrom autogen_agentchat.messages import (- AgentEvent,- ChatMessage,+ BaseAgentEvent,+ BaseChatMessage,HandoffMessage,MultiModalMessage,StopMessage,@@ -60,14 +60,14 @@ class _EchoAgent(BaseChatAgent):self._total_messages = 0@property- def produced_message_types(self) -> Sequence[type[ChatMessage]]:+ def produced_message_types(self) -> Sequence[type[BaseChatMessage]]:return (TextMessage,)@propertydef total_messages(self) -> int:return self._total_messages- async def on_messages(self, messages: Sequence[ChatMessage], cancellation_token: CancellationToken) -> Response:+ async def on_messages(self, messages: Sequence[BaseChatMessage], cancellation_token: CancellationToken) -> Response:if len(messages) > 0:assert isinstance(messages[0], TextMessage)self._last_message = messages[0].content@@ -89,21 +89,21 @@ class _FlakyAgent(BaseChatAgent):self._total_messages = 0@property- def produced_message_types(self) -> Sequence[type[ChatMessage]]:+ def produced_message_types(self) -> Sequence[type[BaseChatMessage]]:return (TextMessage,)@propertydef total_messages(self) -> int:return self._total_messages- async def on_messages(self, messages: Sequence[ChatMessage], cancellation_token: CancellationToken) -> Response:+ async def on_messages(self, messages: Sequence[BaseChatMessage], cancellation_token: CancellationToken) -> Response:raise ValueError("I am a flaky agent...")async def on_reset(self, cancellation_token: CancellationToken) -> None:self._last_message = None-class _UnknownMessageType(ChatMessage):+class _UnknownMessageType(BaseChatMessage):content: strdef to_model_message(self) -> UserMessage:@@ -115,16 +115,23 @@ class _UnknownMessageType(ChatMessage):def to_text(self) -> str:raise NotImplementedError("This message type is not supported.")+ def dump(self) -> Mapping[str, Any]:+ return {}++ @classmethod+ def load(cls, data: Mapping[str, Any]) -> "_UnknownMessageType":+ return cls(**data)+class _UnknownMessageTypeAgent(BaseChatAgent):def __init__(self, name: str, description: str) -> None:super().__init__(name, description)@property- def produced_message_types(self) -> Sequence[type[ChatMessage]]:+ def produced_message_types(self) -> Sequence[type[BaseChatMessage]]:return (_UnknownMessageType,)- async def on_messages(self, messages: Sequence[ChatMessage], cancellation_token: CancellationToken) -> Response:+ async def on_messages(self, messages: Sequence[BaseChatMessage], cancellation_token: CancellationToken) -> Response:return Response(chat_message=_UnknownMessageType(content="Unknown message type", source=self.name))async def on_reset(self, cancellation_token: CancellationToken) -> None:@@ -138,10 +145,10 @@ class _StopAgent(_EchoAgent):self._stop_at = stop_at@property- def produced_message_types(self) -> Sequence[type[ChatMessage]]:+ def produced_message_types(self) -> Sequence[type[BaseChatMessage]]:return (TextMessage, StopMessage)- async def on_messages(self, messages: Sequence[ChatMessage], cancellation_token: CancellationToken) -> Response:+ async def on_messages(self, messages: Sequence[BaseChatMessage], cancellation_token: CancellationToken) -> Response:self._count += 1if self._count < self._stop_at:return await super().on_messages(messages, cancellation_token)@@ -162,7 +169,7 @@ class _InputTask2(BaseModel):data: str-TaskType = str | List[ChatMessage] | ChatMessage+TaskType = str | List[BaseChatMessage] | BaseChatMessage@pytest_asyncio.fixture(params=["single_threaded", "embedded"]) # type: ignore@@ -821,7 +828,7 @@ async def test_selector_group_chat_custom_selector(runtime: AgentRuntime | None)agent3 = _EchoAgent("agent3", description="echo agent 3")agent4 = _EchoAgent("agent4", description="echo agent 4")- def _select_agent(messages: Sequence[AgentEvent | ChatMessage]) -> str | None:+ def _select_agent(messages: Sequence[BaseAgentEvent | BaseChatMessage]) -> str | None:if len(messages) == 0:return "agent1"elif messages[-1].source == "agent1":@@ -862,7 +869,7 @@ async def test_selector_group_chat_custom_candidate_func(runtime: AgentRuntime |agent3 = _EchoAgent("agent3", description="echo agent 3")agent4 = _EchoAgent("agent4", description="echo agent 4")- def _candidate_func(messages: Sequence[AgentEvent | ChatMessage]) -> List[str]:+ def _candidate_func(messages: Sequence[BaseAgentEvent | BaseChatMessage]) -> List[str]:if len(messages) == 0:return ["agent1"]elif messages[-1].source == "agent1":@@ -901,10 +908,10 @@ class _HandOffAgent(BaseChatAgent):self._next_agent = next_agent@property- def produced_message_types(self) -> Sequence[type[ChatMessage]]:+ def produced_message_types(self) -> Sequence[type[BaseChatMessage]]:return (HandoffMessage,)- async def on_messages(self, messages: Sequence[ChatMessage], cancellation_token: CancellationToken) -> Response:+ async def on_messages(self, messages: Sequence[BaseChatMessage], cancellation_token: CancellationToken) -> Response:return Response(chat_message=HandoffMessage(content=f"Transferred to {self._next_agent}.", target=self._next_agent, source=self.name@@ -1292,7 +1299,7 @@ async def test_round_robin_group_chat_with_message_list(runtime: AgentRuntime |team = RoundRobinGroupChat([agent1, agent2], termination_condition=termination, runtime=runtime)# Create a list of messages- messages: List[ChatMessage] = [+ messages: List[BaseChatMessage] = [TextMessage(content="Message 1", source="user"),TextMessage(content="Message 2", source="user"),TextMessage(content="Message 3", source="user"),@@ -1324,7 +1331,7 @@ async def test_round_robin_group_chat_with_message_list(runtime: AgentRuntime |index += 1# Test with invalid message list- with pytest.raises(ValueError, match="All messages in task list must be valid ChatMessage types"):+ with pytest.raises(ValueError, match="All messages in task list must be valid BaseChatMessage types"):await team.run(task=["not a message"]) # type: ignore[list-item, arg-type] # intentionally testing invalid input# Test with empty message listdiff --git a/python/packages/autogen-agentchat/tests/test_group_chat_endpoint.py b/python/packages/autogen-agentchat/tests/test_group_chat_endpoint.pyindex dd0c3ba71..d9081b161 100644--- a/python/packages/autogen-agentchat/tests/test_group_chat_endpoint.py+++ b/python/packages/autogen-agentchat/tests/test_group_chat_endpoint.py@@ -4,7 +4,7 @@ from typing import List, Sequenceimport pytestfrom autogen_agentchat.agents import AssistantAgentfrom autogen_agentchat.base import TaskResult-from autogen_agentchat.messages import AgentEvent, ChatMessage+from autogen_agentchat.messages import BaseAgentEvent, BaseChatMessagefrom autogen_agentchat.teams import SelectorGroupChatfrom autogen_agentchat.ui import Consolefrom autogen_core.models import ChatCompletionClient@@ -33,7 +33,7 @@ async def _test_selector_group_chat(model_client: ChatCompletionClient) -> None:async def _test_selector_group_chat_with_candidate_func(model_client: ChatCompletionClient) -> None:filtered_participants = ["developer", "tester"]- def dummy_candidate_func(thread: Sequence[AgentEvent | ChatMessage]) -> List[str]:+ def dummy_candidate_func(thread: Sequence[BaseAgentEvent | BaseChatMessage]) -> List[str]:# Dummy candidate function that will return# only return developer and reviewerreturn filtered_participantsdiff --git a/python/packages/autogen-agentchat/tests/test_group_chat_pause_resume.py b/python/packages/autogen-agentchat/tests/test_group_chat_pause_resume.pyindex ee87f6f4a..e26c7262d 100644--- a/python/packages/autogen-agentchat/tests/test_group_chat_pause_resume.py+++ b/python/packages/autogen-agentchat/tests/test_group_chat_pause_resume.py@@ -5,7 +5,7 @@ import pytestimport pytest_asynciofrom autogen_agentchat.agents import BaseChatAgentfrom autogen_agentchat.base import Response-from autogen_agentchat.messages import ChatMessage, TextMessage+from autogen_agentchat.messages import BaseChatMessage, TextMessagefrom autogen_agentchat.teams import RoundRobinGroupChatfrom autogen_core import AgentRuntime, CancellationToken, SingleThreadedAgentRuntime@@ -20,10 +20,10 @@ class TestAgent(BaseChatAgent):self.counter = 0@property- def produced_message_types(self) -> Sequence[type[ChatMessage]]:+ def produced_message_types(self) -> Sequence[type[BaseChatMessage]]:return [TextMessage]- async def on_messages(self, messages: Sequence[ChatMessage], cancellation_token: CancellationToken) -> Response:+ async def on_messages(self, messages: Sequence[BaseChatMessage], cancellation_token: CancellationToken) -> Response:assert not self._is_paused, "Agent is paused"async def _process() -> None:diff --git a/python/packages/autogen-agentchat/tests/test_magentic_one_group_chat.py b/python/packages/autogen-agentchat/tests/test_magentic_one_group_chat.pyindex 4213087d8..d217d5476 100644--- a/python/packages/autogen-agentchat/tests/test_magentic_one_group_chat.py+++ b/python/packages/autogen-agentchat/tests/test_magentic_one_group_chat.py@@ -11,7 +11,7 @@ from autogen_agentchat.agents import ()from autogen_agentchat.base import Responsefrom autogen_agentchat.messages import (- ChatMessage,+ BaseChatMessage,TextMessage,)from autogen_agentchat.teams import (@@ -34,14 +34,14 @@ class _EchoAgent(BaseChatAgent):self._total_messages = 0@property- def produced_message_types(self) -> Sequence[type[ChatMessage]]:+ def produced_message_types(self) -> Sequence[type[BaseChatMessage]]:return (TextMessage,)@propertydef total_messages(self) -> int:return self._total_messages- async def on_messages(self, messages: Sequence[ChatMessage], cancellation_token: CancellationToken) -> Response:+ async def on_messages(self, messages: Sequence[BaseChatMessage], cancellation_token: CancellationToken) -> Response:if len(messages) > 0:assert isinstance(messages[0], TextMessage)self._last_message = messages[0].contentdiff --git a/python/packages/autogen-agentchat/tests/test_messages.py b/python/packages/autogen-agentchat/tests/test_messages.pyindex c3dd0acac..2129cd66c 100644--- a/python/packages/autogen-agentchat/tests/test_messages.py+++ b/python/packages/autogen-agentchat/tests/test_messages.py@@ -1,5 +1,22 @@+import json+from typing import List+import pytest-from autogen_agentchat.messages import HandoffMessage, MessageFactory, StructuredMessage, TextMessage+from autogen_agentchat.messages import (+ AgentEvent,+ ChatMessage,+ HandoffMessage,+ MessageFactory,+ ModelClientStreamingChunkEvent,+ MultiModalMessage,+ StopMessage,+ StructuredMessage,+ TextMessage,+ ToolCallExecutionEvent,+ ToolCallRequestEvent,+)+from autogen_core import FunctionCall+from autogen_core.models import FunctionExecutionResultfrom pydantic import BaseModel@@ -18,7 +35,7 @@ def test_structured_message() -> None:)# Check that the message type is correct- assert message.type == "StructuredMessage[TestContent]" # type: ignore+ assert message.type == "StructuredMessage[TestContent]" # type: ignore[comparison-overlap]# Check that the content is of the correct typeassert isinstance(message.content, TestContent)@@ -50,7 +67,7 @@ def test_message_factory() -> None:assert isinstance(text_message, TextMessage)assert text_message.source == "test_agent"assert text_message.content == "Hello, world!"- assert text_message.type == "TextMessage" # type: ignore+ assert text_message.type == "TextMessage" # type: ignore[comparison-overlap]# Handoff message datahandoff_data = {@@ -66,7 +83,7 @@ def test_message_factory() -> None:assert handoff_message.source == "test_agent"assert handoff_message.content == "handoff to another agent"assert handoff_message.target == "target_agent"- assert handoff_message.type == "HandoffMessage" # type: ignore+ assert handoff_message.type == "HandoffMessage" # type: ignore[comparison-overlap]# Structured message datastructured_data = {@@ -86,8 +103,48 @@ def test_message_factory() -> None:# Create a StructuredMessage instancestructured_message = factory.create(structured_data)assert isinstance(structured_message, StructuredMessage)- assert isinstance(structured_message.content, TestContent) # type: ignore+ assert isinstance(structured_message.content, TestContent) # type: ignore[reportUnkownMemberType]assert structured_message.source == "test_agent"assert structured_message.content.field1 == "test"assert structured_message.content.field2 == 42- assert structured_message.type == "StructuredMessage[TestContent]" # type: ignore+ assert structured_message.type == "StructuredMessage[TestContent]" # type: ignore[comparison-overlap]+++class TestContainer(BaseModel):+ chat_messages: List[ChatMessage]+ agent_events: List[AgentEvent]+++def test_union_types() -> None:+ # Create a few messages.+ chat_messages: List[ChatMessage] = [+ TextMessage(source="user", content="Hello!"),+ MultiModalMessage(source="user", content=["Hello!", "World!"]),+ HandoffMessage(source="user", content="handoff to another agent", target="target_agent"),+ StopMessage(source="user", content="stop"),+ ]++ # Create a few agent events.+ agent_events: List[AgentEvent] = [+ ModelClientStreamingChunkEvent(source="user", content="Hello!"),+ ToolCallRequestEvent(+ content=[+ FunctionCall(id="1", name="test_function", arguments=json.dumps({"arg1": "value1", "arg2": "value2"}))+ ],+ source="user",+ ),+ ToolCallExecutionEvent(+ content=[FunctionExecutionResult(call_id="1", content="result", name="test")], source="user"+ ),+ ]++ # Create a container with the messages.+ container = TestContainer(chat_messages=chat_messages, agent_events=agent_events)++ # Dump the container to JSON.+ data = container.model_dump()++ # Load the container from JSON.+ loaded_container = TestContainer.model_validate(data)+ assert loaded_container.chat_messages == chat_messages+ assert loaded_container.agent_events == agent_eventsdiff --git a/python/packages/autogen-agentchat/tests/test_userproxy_agent.py b/python/packages/autogen-agentchat/tests/test_userproxy_agent.pyindex 8ff6422a6..855211de8 100644--- a/python/packages/autogen-agentchat/tests/test_userproxy_agent.py+++ b/python/packages/autogen-agentchat/tests/test_userproxy_agent.py@@ -4,7 +4,7 @@ from typing import Optional, Sequenceimport pytestfrom autogen_agentchat.agents import UserProxyAgentfrom autogen_agentchat.base import Response-from autogen_agentchat.messages import ChatMessage, HandoffMessage, TextMessage+from autogen_agentchat.messages import BaseChatMessage, HandoffMessage, TextMessagefrom autogen_core import CancellationToken@@ -53,7 +53,7 @@ async def test_handoff_handling() -> None:agent = UserProxyAgent(name="test_user", input_func=custom_input)- messages: Sequence[ChatMessage] = [+ messages: Sequence[BaseChatMessage] = [TextMessage(content="Initial message", source="assistant"),HandoffMessage(content="Handing off to user for confirmation", source="assistant", target="test_user"),]diff --git a/python/packages/autogen-core/docs/src/user-guide/agentchat-user-guide/custom-agents.ipynb b/python/packages/autogen-core/docs/src/user-guide/agentchat-user-guide/custom-agents.ipynbindex 3f4a66896..4ca98a433 100644--- a/python/packages/autogen-core/docs/src/user-guide/agentchat-user-guide/custom-agents.ipynb+++ b/python/packages/autogen-core/docs/src/user-guide/agentchat-user-guide/custom-agents.ipynb@@ -14,7 +14,7 @@"\n","- {py:meth}`~autogen_agentchat.agents.BaseChatAgent.on_messages`: The abstract method that defines the behavior of the agent in response to messages. This method is called when the agent is asked to provide a response in {py:meth}`~autogen_agentchat.agents.BaseChatAgent.run`. It returns a {py:class}`~autogen_agentchat.base.Response` object.\n","- {py:meth}`~autogen_agentchat.agents.BaseChatAgent.on_reset`: The abstract method that resets the agent to its initial state. This method is called when the agent is asked to reset itself.\n",- "- {py:attr}`~autogen_agentchat.agents.BaseChatAgent.produced_message_types`: The list of possible {py:class}`~autogen_agentchat.messages.ChatMessage` message types the agent can produce in its response.\n",+ "- {py:attr}`~autogen_agentchat.agents.BaseChatAgent.produced_message_types`: The list of possible {py:class}`~autogen_agentchat.messages.BaseChatMessage` message types the agent can produce in its response.\n","\n","Optionally, you can implement the the {py:meth}`~autogen_agentchat.agents.BaseChatAgent.on_messages_stream` method to stream messages as they are generated by the agent. If this method is not implemented, the agent\n","uses the default implementation of {py:meth}`~autogen_agentchat.agents.BaseChatAgent.on_messages_stream`\n",@@ -53,7 +53,7 @@"\n","from autogen_agentchat.agents import BaseChatAgent\n","from autogen_agentchat.base import Response\n",- "from autogen_agentchat.messages import AgentEvent, ChatMessage, TextMessage\n",+ "from autogen_agentchat.messages import BaseAgentEvent, BaseChatMessage, TextMessage\n","from autogen_core import CancellationToken\n","\n","\n",@@ -63,10 +63,10 @@" self._count = count\n","\n"," @property\n",- " def produced_message_types(self) -> Sequence[type[ChatMessage]]:\n",+ " def produced_message_types(self) -> Sequence[type[BaseChatMessage]]:\n"," return (TextMessage,)\n","\n",- " async def on_messages(self, messages: Sequence[ChatMessage], cancellation_token: CancellationToken) -> Response:\n",+ " async def on_messages(self, messages: Sequence[BaseChatMessage], cancellation_token: CancellationToken) -> Response:\n"," # Calls the on_messages_stream.\n"," response: Response | None = None\n"," async for message in self.on_messages_stream(messages, cancellation_token):\n",@@ -76,9 +76,9 @@" return response\n","\n"," async def on_messages_stream(\n",- " self, messages: Sequence[ChatMessage], cancellation_token: CancellationToken\n",- " ) -> AsyncGenerator[AgentEvent | ChatMessage | Response, None]:\n",- " inner_messages: List[AgentEvent | ChatMessage] = []\n",+ " self, messages: Sequence[BaseChatMessage], cancellation_token: CancellationToken\n",+ " ) -> AsyncGenerator[BaseAgentEvent | BaseChatMessage | Response, None]:\n",+ " inner_messages: List[BaseAgentEvent | BaseChatMessage] = []\n"," for i in range(self._count, 0, -1):\n"," msg = TextMessage(content=f\"{i}...\", source=self.name)\n"," inner_messages.append(msg)\n",@@ -135,7 +135,7 @@"from autogen_agentchat.agents import BaseChatAgent\n","from autogen_agentchat.base import Response\n","from autogen_agentchat.conditions import MaxMessageTermination\n",- "from autogen_agentchat.messages import ChatMessage\n",+ "from autogen_agentchat.messages import BaseChatMessage\n","from autogen_agentchat.teams import SelectorGroupChat\n","from autogen_agentchat.ui import Console\n","from autogen_core import CancellationToken\n",@@ -146,13 +146,13 @@" def __init__(self, name: str, description: str, operator_func: Callable[[int], int]) -> None:\n"," super().__init__(name, description=description)\n"," self._operator_func = operator_func\n",- " self._message_history: List[ChatMessage] = []\n",+ " self._message_history: List[BaseChatMessage] = []\n","\n"," @property\n",- " def produced_message_types(self) -> Sequence[type[ChatMessage]]:\n",+ " def produced_message_types(self) -> Sequence[type[BaseChatMessage]]:\n"," return (TextMessage,)\n","\n",- " async def on_messages(self, messages: Sequence[ChatMessage], cancellation_token: CancellationToken) -> Response:\n",+ " async def on_messages(self, messages: Sequence[BaseChatMessage], cancellation_token: CancellationToken) -> Response:\n"," # Update the message history.\n"," # NOTE: it is possible the messages is an empty list, which means the agent was selected previously.\n"," self._message_history.extend(messages)\n",@@ -268,7 +268,7 @@" )\n","\n"," # Run the selector group chat with a given task and stream the response.\n",- " task: List[ChatMessage] = [\n",+ " task: List[BaseChatMessage] = [\n"," TextMessage(content=\"Apply the operations to turn the given number into 25.\", source=\"user\"),\n"," TextMessage(content=\"10\", source=\"user\"),\n"," ]\n",@@ -319,7 +319,7 @@"\n","from autogen_agentchat.agents import BaseChatAgent\n","from autogen_agentchat.base import Response\n",- "from autogen_agentchat.messages import AgentEvent, ChatMessage\n",+ "from autogen_agentchat.messages import BaseAgentEvent, BaseChatMessage\n","from autogen_core import CancellationToken\n","from autogen_core.model_context import UnboundedChatCompletionContext\n","from autogen_core.models import AssistantMessage, RequestUsage, UserMessage\n",@@ -344,10 +344,10 @@" self._model = model\n","\n"," @property\n",- " def produced_message_types(self) -> Sequence[type[ChatMessage]]:\n",+ " def produced_message_types(self) -> Sequence[type[BaseChatMessage]]:\n"," return (TextMessage,)\n","\n",- " async def on_messages(self, messages: Sequence[ChatMessage], cancellation_token: CancellationToken) -> Response:\n",+ " async def on_messages(self, messages: Sequence[BaseChatMessage], cancellation_token: CancellationToken) -> Response:\n"," final_response = None\n"," async for message in self.on_messages_stream(messages, cancellation_token):\n"," if isinstance(message, Response):\n",@@ -359,8 +359,8 @@" return final_response\n","\n"," async def on_messages_stream(\n",- " self, messages: Sequence[ChatMessage], cancellation_token: CancellationToken\n",- " ) -> AsyncGenerator[AgentEvent | ChatMessage | Response, None]:\n",+ " self, messages: Sequence[BaseChatMessage], cancellation_token: CancellationToken\n",+ " ) -> AsyncGenerator[BaseAgentEvent | BaseChatMessage | Response, None]:\n"," # Add messages to the model context\n"," for msg in messages:\n"," await self._model_context.add_message(msg.to_model_message())\n",@@ -550,7 +550,7 @@"\n","from autogen_agentchat.agents import BaseChatAgent\n","from autogen_agentchat.base import Response\n",- "from autogen_agentchat.messages import AgentEvent, ChatMessage\n",+ "from autogen_agentchat.messages import BaseAgentEvent, BaseChatMessage\n","from autogen_core import CancellationToken, Component\n","from pydantic import BaseModel\n","from typing_extensions import Self\n",@@ -583,10 +583,10 @@" self._model = model\n","\n"," @property\n",- " def produced_message_types(self) -> Sequence[type[ChatMessage]]:\n",+ " def produced_message_types(self) -> Sequence[type[BaseChatMessage]]:\n"," return (TextMessage,)\n","\n",- " async def on_messages(self, messages: Sequence[ChatMessage], cancellation_token: CancellationToken) -> Response:\n",+ " async def on_messages(self, messages: Sequence[BaseChatMessage], cancellation_token: CancellationToken) -> Response:\n"," final_response = None\n"," async for message in self.on_messages_stream(messages, cancellation_token):\n"," if isinstance(message, Response):\n",@@ -598,8 +598,8 @@" return final_response\n","\n"," async def on_messages_stream(\n",- " self, messages: Sequence[ChatMessage], cancellation_token: CancellationToken\n",- " ) -> AsyncGenerator[AgentEvent | ChatMessage | Response, None]:\n",+ " self, messages: Sequence[BaseChatMessage], cancellation_token: CancellationToken\n",+ " ) -> AsyncGenerator[BaseAgentEvent | BaseChatMessage | Response, None]:\n"," # Add messages to the model context\n"," for msg in messages:\n"," await self._model_context.add_message(msg.to_model_message())\n",diff --git a/python/packages/autogen-core/docs/src/user-guide/agentchat-user-guide/memory.ipynb b/python/packages/autogen-core/docs/src/user-guide/agentchat-user-guide/memory.ipynbindex ca6f3e7c6..b70c60b61 100644--- a/python/packages/autogen-core/docs/src/user-guide/agentchat-user-guide/memory.ipynb+++ b/python/packages/autogen-core/docs/src/user-guide/agentchat-user-guide/memory.ipynb@@ -1,442 +1,442 @@{- "cells": [- {- "cell_type": "markdown",- "metadata": {},- "source": [- "## Memory and RAG\n",- "\n",- "There are several use cases where it is valuable to maintain a _store_ of useful facts that can be intelligently added to the context of the agent just before a specific step. The typically use case here is a RAG pattern where a query is used to retrieve relevant information from a database that is then added to the agent's context.\n",- "\n",- "\n",- "AgentChat provides a {py:class}`~autogen_core.memory.Memory` protocol that can be extended to provide this functionality. The key methods are `query`, `update_context`, `add`, `clear`, and `close`. \n",- "\n",- "- `add`: add new entries to the memory store\n",- "- `query`: retrieve relevant information from the memory store \n",- "- `update_context`: mutate an agent's internal `model_context` by adding the retrieved information (used in the {py:class}`~autogen_agentchat.agents.AssistantAgent` class) \n",- "- `clear`: clear all entries from the memory store\n",- "- `close`: clean up any resources used by the memory store \n",- "\n",- "\n",- "## ListMemory Example\n",- "\n",- "{py:class}~autogen_core.memory.ListMemory is provided as an example implementation of the {py:class}~autogen_core.memory.Memory protocol. It is a simple list-based memory implementation that maintains memories in chronological order, appending the most recent memories to the model's context. The implementation is designed to be straightforward and predictable, making it easy to understand and debug.\n",- "In the following example, we will use ListMemory to maintain a memory bank of user preferences and demonstrate how it can be used to provide consistent context for agent responses over time."- ]- },- {- "cell_type": "code",- "execution_count": null,- "metadata": {},- "outputs": [],- "source": [- "from autogen_agentchat.agents import AssistantAgent\n",- "from autogen_agentchat.ui import Console\n",- "from autogen_core.memory import ListMemory, MemoryContent, MemoryMimeType\n",- "from autogen_ext.models.openai import OpenAIChatCompletionClient"- ]- },- {- "cell_type": "code",- "execution_count": null,- "metadata": {},- "outputs": [],- "source": [- "# Initialize user memory\n",- "user_memory = ListMemory()\n",- "\n",- "# Add user preferences to memory\n",- "await user_memory.add(MemoryContent(content=\"The weather should be in metric units\", mime_type=MemoryMimeType.TEXT))\n",- "\n",- "await user_memory.add(MemoryContent(content=\"Meal recipe must be vegan\", mime_type=MemoryMimeType.TEXT))\n",- "\n",- "\n",- "async def get_weather(city: str, units: str = \"imperial\") -> str:\n",- " if units == \"imperial\":\n",- " return f\"The weather in {city} is 73 °F and Sunny.\"\n",- " elif units == \"metric\":\n",- " return f\"The weather in {city} is 23 °C and Sunny.\"\n",- " else:\n",- " return f\"Sorry, I don't know the weather in {city}.\"\n",- "\n",- "\n",- "assistant_agent = AssistantAgent(\n",- " name=\"assistant_agent\",\n",- " model_client=OpenAIChatCompletionClient(\n",- " model=\"gpt-4o-2024-08-06\",\n",- " ),\n",- " tools=[get_weather],\n",- " memory=[user_memory],\n",- ")"- ]- },- {- "cell_type": "code",- "execution_count": null,- "metadata": {},- "outputs": [],- "source": [- "# Run the agent with a task.\n",- "stream = assistant_agent.run_stream(task=\"What is the weather in New York?\")\n",- "await Console(stream)"- ]- },- {- "cell_type": "markdown",- "metadata": {},- "source": [- "We can inspect that the `assistant_agent` model_context is actually updated with the retrieved memory entries. The `transform` method is used to format the retrieved memory entries into a string that can be used by the agent. In this case, we simply concatenate the content of each memory entry into a single string."- ]- },- {- "cell_type": "code",- "execution_count": null,- "metadata": {},- "outputs": [],- "source": [- "await assistant_agent._model_context.get_messages()"- ]- },- {- "cell_type": "markdown",- "metadata": {},- "source": [- "We see above that the weather is returned in Centigrade as stated in the user preferences. \n",- "\n",- "Similarly, assuming we ask a separate question about generating a meal plan, the agent is able to retrieve relevant information from the memory store and provide a personalized (vegan) response."- ]- },- {- "cell_type": "code",- "execution_count": null,- "metadata": {},- "outputs": [],- "source": [- "stream = assistant_agent.run_stream(task=\"Write brief meal recipe with broth\")\n",- "await Console(stream)"- ]- },- {- "cell_type": "markdown",- "metadata": {},- "source": [- "## Custom Memory Stores (Vector DBs, etc.)\n",- "\n",- "You can build on the `Memory` protocol to implement more complex memory stores. For example, you could implement a custom memory store that uses a vector database to store and retrieve information, or a memory store that uses a machine learning model to generate personalized responses based on the user's preferences etc.\n",- "\n",- "Specifically, you will need to overload the `add`, `query` and `update_context` methods to implement the desired functionality and pass the memory store to your agent.\n",- "\n",- "\n",- "Currently the following example memory stores are available as part of the {py:class}`~autogen_ext` extensions package. \n",- "\n",- "- `autogen_ext.memory.chromadb.ChromaDBVectorMemory`: A memory store that uses a vector database to store and retrieve information. "- ]- },- {- "cell_type": "code",- "execution_count": null,- "metadata": {},- "outputs": [],- "source": [- "import os\n",- "from pathlib import Path\n",- "\n",- "from autogen_agentchat.agents import AssistantAgent\n",- "from autogen_agentchat.ui import Console\n",- "from autogen_core.memory import MemoryContent, MemoryMimeType\n",- "from autogen_ext.memory.chromadb import ChromaDBVectorMemory, PersistentChromaDBVectorMemoryConfig\n",- "from autogen_ext.models.openai import OpenAIChatCompletionClient\n",- "\n",- "# Initialize ChromaDB memory with custom config\n",- "chroma_user_memory = ChromaDBVectorMemory(\n",- " config=PersistentChromaDBVectorMemoryConfig(\n",- " collection_name=\"preferences\",\n",- " persistence_path=os.path.join(str(Path.home()), \".chromadb_autogen\"),\n",- " k=2, # Return top k results\n",- " score_threshold=0.4, # Minimum similarity score\n",- " )\n",- ")\n",- "# a HttpChromaDBVectorMemoryConfig is also supported for connecting to a remote ChromaDB server\n",- "\n",- "# Add user preferences to memory\n",- "await chroma_user_memory.add(\n",- " MemoryContent(\n",- " content=\"The weather should be in metric units\",\n",- " mime_type=MemoryMimeType.TEXT,\n",- " metadata={\"category\": \"preferences\", \"type\": \"units\"},\n",- " )\n",- ")\n",- "\n",- "await chroma_user_memory.add(\n",- " MemoryContent(\n",- " content=\"Meal recipe must be vegan\",\n",- " mime_type=MemoryMimeType.TEXT,\n",- " metadata={\"category\": \"preferences\", \"type\": \"dietary\"},\n",- " )\n",- ")\n",- "\n",- "model_client = OpenAIChatCompletionClient(\n",- " model=\"gpt-4o\",\n",- ")\n",- "\n",- "# Create assistant agent with ChromaDB memory\n",- "assistant_agent = AssistantAgent(\n",- " name=\"assistant_agent\",\n",- " model_client=model_client,\n",- " tools=[get_weather],\n",- " memory=[chroma_user_memory],\n",- ")\n",- "\n",- "stream = assistant_agent.run_stream(task=\"What is the weather in New York?\")\n",- "await Console(stream)\n",- "\n",- "await model_client.close()\n",- "await chroma_user_memory.close()"- ]- },- {- "cell_type": "markdown",- "metadata": {},- "source": [- "Note that you can also serialize the ChromaDBVectorMemory and save it to disk."- ]- },- {- "cell_type": "code",- "execution_count": null,- "metadata": {},- "outputs": [],- "source": [- "chroma_user_memory.dump_component().model_dump_json()"- ]- },- {- "cell_type": "markdown",- "metadata": {},- "source": [- "## RAG Agent: Putting It All Together\n",- "\n",- "The RAG (Retrieval Augmented Generation) pattern which is common in building AI systems encompasses two distinct phases:\n",- "\n",- "1. **Indexing**: Loading documents, chunking them, and storing them in a vector database\n",- "2. **Retrieval**: Finding and using relevant chunks during conversation runtime\n",- "\n",- "In our previous examples, we manually added items to memory and passed them to our agents. In practice, the indexing process is usually automated and based on much larger document sources like product documentation, internal files, or knowledge bases.\n",- "\n",- "> Note: The quality of a RAG system is dependent on the quality of the chunking and retrieval process (models, embeddings, etc.). You may need to experiement with more advanced chunking and retrieval models to get the best results.\n",- "\n",- "### Building a Simple RAG Agent\n",- "\n",- "To begin, let's create a simple document indexer that we will used to load documents, chunk them, and store them in a `ChromaDBVectorMemory` memory store. "- ]- },- {- "cell_type": "code",- "execution_count": null,- "metadata": {},- "outputs": [],- "source": [- "import re\n",- "from typing import List\n",- "\n",- "import aiofiles\n",- "import aiohttp\n",- "from autogen_core.memory import Memory, MemoryContent, MemoryMimeType\n",- "\n",- "\n",- "class SimpleDocumentIndexer:\n",- " \"\"\"Basic document indexer for AutoGen Memory.\"\"\"\n",- "\n",- " def __init__(self, memory: Memory, chunk_size: int = 1500) -> None:\n",- " self.memory = memory\n",- " self.chunk_size = chunk_size\n",- "\n",- " async def _fetch_content(self, source: str) -> str:\n",- " \"\"\"Fetch content from URL or file.\"\"\"\n",- " if source.startswith((\"http://\", \"https://\")):\n",- " async with aiohttp.ClientSession() as session:\n",- " async with session.get(source) as response:\n",- " return await response.text()\n",- " else:\n",- " async with aiofiles.open(source, \"r\", encoding=\"utf-8\") as f:\n",- " return await f.read()\n",- "\n",- " def _strip_html(self, text: str) -> str:\n",- " \"\"\"Remove HTML tags and normalize whitespace.\"\"\"\n",- " text = re.sub(r\"<[^>]*>\", \" \", text)\n",- " text = re.sub(r\"\\s+\", \" \", text)\n",- " return text.strip()\n",- "\n",- " def _split_text(self, text: str) -> List[str]:\n",- " \"\"\"Split text into fixed-size chunks.\"\"\"\n",- " chunks: list[str] = []\n",- " # Just split text into fixed-size chunks\n",- " for i in range(0, len(text), self.chunk_size):\n",- " chunk = text[i : i + self.chunk_size]\n",- " chunks.append(chunk.strip())\n",- " return chunks\n",- "\n",- " async def index_documents(self, sources: List[str]) -> int:\n",- " \"\"\"Index documents into memory.\"\"\"\n",- " total_chunks = 0\n",- "\n",- " for source in sources:\n",- " try:\n",- " content = await self._fetch_content(source)\n",- "\n",- " # Strip HTML if content appears to be HTML\n",- " if \"<\" in content and \">\" in content:\n",- " content = self._strip_html(content)\n",- "\n",- " chunks = self._split_text(content)\n",- "\n",- " for i, chunk in enumerate(chunks):\n",- " await self.memory.add(\n",- " MemoryContent(\n",- " content=chunk, mime_type=MemoryMimeType.TEXT, metadata={\"source\": source, \"chunk_index\": i}\n",- " )\n",- " )\n",- "\n",- " total_chunks += len(chunks)\n",- "\n",- " except Exception as e:\n",- " print(f\"Error indexing {source}: {str(e)}\")\n",- "\n",- " return total_chunks"- ]- },- {- "cell_type": "markdown",- "metadata": {},- "source": [- "\n",- " \n",- "Now let's use our indexer with ChromaDBVectorMemory to build a complete RAG agent:\n"- ]- },- {- "cell_type": "code",- "execution_count": null,- "metadata": {},- "outputs": [- {- "name": "stdout",- "output_type": "stream",- "text": [- "Indexed 72 chunks from 4 AutoGen documents\n"- ]- }- ],- "source": [- "import os\n",- "from pathlib import Path\n",- "\n",- "from autogen_agentchat.agents import AssistantAgent\n",- "from autogen_agentchat.ui import Console\n",- "from autogen_ext.memory.chromadb import ChromaDBVectorMemory, PersistentChromaDBVectorMemoryConfig\n",- "from autogen_ext.models.openai import OpenAIChatCompletionClient\n",- "\n",- "# Initialize vector memory\n",- "\n",- "rag_memory = ChromaDBVectorMemory(\n",- " config=PersistentChromaDBVectorMemoryConfig(\n",- " collection_name=\"autogen_docs\",\n",- " persistence_path=os.path.join(str(Path.home()), \".chromadb_autogen\"),\n",- " k=3, # Return top 3 results\n",- " score_threshold=0.4, # Minimum similarity score\n",- " )\n",- ")\n",- "\n",- "await rag_memory.clear() # Clear existing memory\n",- "\n",- "\n",- "# Index AutoGen documentation\n",- "async def index_autogen_docs() -> None:\n",- " indexer = SimpleDocumentIndexer(memory=rag_memory)\n",- " sources = [\n",- " \"https://raw.githubusercontent.com/microsoft/autogen/main/README.md\",\n",- " \"https://microsoft.github.io/autogen/dev/user-guide/agentchat-user-guide/tutorial/agents.html\",\n",- " \"https://microsoft.github.io/autogen/dev/user-guide/agentchat-user-guide/tutorial/teams.html\",\n",- " \"https://microsoft.github.io/autogen/dev/user-guide/agentchat-user-guide/tutorial/termination.html\",\n",- " ]\n",- " chunks: int = await indexer.index_documents(sources)\n",- " print(f\"Indexed {chunks} chunks from {len(sources)} AutoGen documents\")\n",- "\n",- "\n",- "await index_autogen_docs()"- ]- },- {- "cell_type": "code",- "execution_count": 4,- "metadata": {},- "outputs": [- {- "name": "stdout",- "output_type": "stream",- "text": [- "---------- user ----------\n",- "What is AgentChat?\n",- "Query results: results=[MemoryContent(content='ng OpenAI\\'s GPT-4o model. See [other supported models](https://microsoft.github.io/autogen/stable/user-guide/agentchat-user-guide/tutorial/models.html). ```python import asyncio from autogen_agentchat.agents import AssistantAgent from autogen_ext.models.openai import OpenAIChatCompletionClient async def main() -> None: model_client = OpenAIChatCompletionClient(model=\"gpt-4o\") agent = AssistantAgent(\"assistant\", model_client=model_client) print(await agent.run(task=\"Say \\'Hello World!\\'\")) await model_client.close() asyncio.run(main()) ``` ### Web Browsing Agent Team Create a group chat team with a web surfer agent and a user proxy agent for web browsing tasks. You need to install [playwright](https://playwright.dev/python/docs/library). ```python # pip install -U autogen-agentchat autogen-ext[openai,web-surfer] # playwright install import asyncio from autogen_agentchat.agents import UserProxyAgent from autogen_agentchat.conditions import TextMentionTermination from autogen_agentchat.teams import RoundRobinGroupChat from autogen_agentchat.ui import Console from autogen_ext.models.openai import OpenAIChatCompletionClient from autogen_ext.agents.web_surfer import MultimodalWebSurfer async def main() -> None: model_client = OpenAIChatCompletionClient(model=\"gpt-4o\") # The web surfer will open a Chromium browser window to perform web browsing tasks. web_surfer = MultimodalWebSurfer(\"web_surfer\", model_client, headless=False, animate_actions=True) # The user proxy agent is used to ge', mime_type='MemoryMimeType.TEXT', metadata={'chunk_index': 1, 'mime_type': 'MemoryMimeType.TEXT', 'source': 'https://raw.githubusercontent.com/microsoft/autogen/main/README.md', 'score': 0.48810458183288574, 'id': '16088e03-0153-4da3-9dec-643b39c549f5'}), MemoryContent(content='els_usage=None content='AutoGen is a programming framework for building multi-agent applications.' type='ToolCallSummaryMessage' The call to the on_messages() method returns a Response that contains the agent’s final response in the chat_message attribute, as well as a list of inner messages in the inner_messages attribute, which stores the agent’s “thought process” that led to the final response. Note It is important to note that on_messages() will update the internal state of the agent – it will add the messages to the agent’s history. So you should call this method with new messages. You should not repeatedly call this method with the same messages or the complete history. Note Unlike in v0.2 AgentChat, the tools are executed by the same agent directly within the same call to on_messages() . By default, the agent will return the result of the tool call as the final response. You can also call the run() method, which is a convenience method that calls on_messages() . It follows the same interface as Teams and returns a TaskResult object. Multi-Modal Input # The AssistantAgent can handle multi-modal input by providing the input as a MultiModalMessage . from io import BytesIO import PIL import requests from autogen_agentchat.messages import MultiModalMessage from autogen_core import Image # Create a multi-modal message with random image and text. pil_image = PIL . Image . open ( BytesIO ( requests . get ( "https://picsum.photos/300/200" ) . content )', mime_type='MemoryMimeType.TEXT', metadata={'chunk_index': 3, 'mime_type': 'MemoryMimeType.TEXT', 'source': 'https://microsoft.github.io/autogen/dev/user-guide/agentchat-user-guide/tutorial/agents.html', 'score': 0.4665141701698303, 'id': '3d603b62-7cab-4f74-b671-586fe36306f2'}), MemoryContent(content='AgentChat Termination Termination # In the previous section, we explored how to define agents, and organize them into teams that can solve tasks. However, a run can go on forever, and in many cases, we need to know when to stop them. This is the role of the termination condition. AgentChat supports several termination condition by providing a base TerminationCondition class and several implementations that inherit from it. A termination condition is a callable that takes a sequence of AgentEvent or ChatMessage objects since the last time the condition was called , and returns a StopMessage if the conversation should be terminated, or None otherwise. Once a termination condition has been reached, it must be reset by calling reset() before it can be used again. Some important things to note about termination conditions: They are stateful but reset automatically after each run ( run() or run_stream() ) is finished. They can be combined using the AND and OR operators. Note For group chat teams (i.e., RoundRobinGroupChat , SelectorGroupChat , and Swarm ), the termination condition is called after each agent responds. While a response may contain multiple inner messages, the team calls its termination condition just once for all the messages from a single response. So the condition is called with the “delta sequence” of messages since the last time it was called. Built-In Termination Conditions: MaxMessageTermination : Stops after a specified number of messages have been produced,', mime_type='MemoryMimeType.TEXT', metadata={'chunk_index': 1, 'mime_type': 'MemoryMimeType.TEXT', 'source': 'https://microsoft.github.io/autogen/dev/user-guide/agentchat-user-guide/tutorial/termination.html', 'score': 0.461774212772051, 'id': '699ef490-d108-4cd3-b629-c1198d6b78ba'})]\n",- "---------- rag_assistant ----------\n",- "[MemoryContent(content='ng OpenAI\\'s GPT-4o model. See [other supported models](https://microsoft.github.io/autogen/stable/user-guide/agentchat-user-guide/tutorial/models.html). ```python import asyncio from autogen_agentchat.agents import AssistantAgent from autogen_ext.models.openai import OpenAIChatCompletionClient async def main() -> None: model_client = OpenAIChatCompletionClient(model=\"gpt-4o\") agent = AssistantAgent(\"assistant\", model_client=model_client) print(await agent.run(task=\"Say \\'Hello World!\\'\")) await model_client.close() asyncio.run(main()) ``` ### Web Browsing Agent Team Create a group chat team with a web surfer agent and a user proxy agent for web browsing tasks. You need to install [playwright](https://playwright.dev/python/docs/library). ```python # pip install -U autogen-agentchat autogen-ext[openai,web-surfer] # playwright install import asyncio from autogen_agentchat.agents import UserProxyAgent from autogen_agentchat.conditions import TextMentionTermination from autogen_agentchat.teams import RoundRobinGroupChat from autogen_agentchat.ui import Console from autogen_ext.models.openai import OpenAIChatCompletionClient from autogen_ext.agents.web_surfer import MultimodalWebSurfer async def main() -> None: model_client = OpenAIChatCompletionClient(model=\"gpt-4o\") # The web surfer will open a Chromium browser window to perform web browsing tasks. web_surfer = MultimodalWebSurfer(\"web_surfer\", model_client, headless=False, animate_actions=True) # The user proxy agent is used to ge', mime_type='MemoryMimeType.TEXT', metadata={'chunk_index': 1, 'mime_type': 'MemoryMimeType.TEXT', 'source': 'https://raw.githubusercontent.com/microsoft/autogen/main/README.md', 'score': 0.48810458183288574, 'id': '16088e03-0153-4da3-9dec-643b39c549f5'}), MemoryContent(content='els_usage=None content='AutoGen is a programming framework for building multi-agent applications.' type='ToolCallSummaryMessage' The call to the on_messages() method returns a Response that contains the agent’s final response in the chat_message attribute, as well as a list of inner messages in the inner_messages attribute, which stores the agent’s “thought process” that led to the final response. Note It is important to note that on_messages() will update the internal state of the agent – it will add the messages to the agent’s history. So you should call this method with new messages. You should not repeatedly call this method with the same messages or the complete history. Note Unlike in v0.2 AgentChat, the tools are executed by the same agent directly within the same call to on_messages() . By default, the agent will return the result of the tool call as the final response. You can also call the run() method, which is a convenience method that calls on_messages() . It follows the same interface as Teams and returns a TaskResult object. Multi-Modal Input # The AssistantAgent can handle multi-modal input by providing the input as a MultiModalMessage . from io import BytesIO import PIL import requests from autogen_agentchat.messages import MultiModalMessage from autogen_core import Image # Create a multi-modal message with random image and text. pil_image = PIL . Image . open ( BytesIO ( requests . get ( "https://picsum.photos/300/200" ) . content )', mime_type='MemoryMimeType.TEXT', metadata={'chunk_index': 3, 'mime_type': 'MemoryMimeType.TEXT', 'source': 'https://microsoft.github.io/autogen/dev/user-guide/agentchat-user-guide/tutorial/agents.html', 'score': 0.4665141701698303, 'id': '3d603b62-7cab-4f74-b671-586fe36306f2'}), MemoryContent(content='AgentChat Termination Termination # In the previous section, we explored how to define agents, and organize them into teams that can solve tasks. However, a run can go on forever, and in many cases, we need to know when to stop them. This is the role of the termination condition. AgentChat supports several termination condition by providing a base TerminationCondition class and several implementations that inherit from it. A termination condition is a callable that takes a sequence of AgentEvent or ChatMessage objects since the last time the condition was called , and returns a StopMessage if the conversation should be terminated, or None otherwise. Once a termination condition has been reached, it must be reset by calling reset() before it can be used again. Some important things to note about termination conditions: They are stateful but reset automatically after each run ( run() or run_stream() ) is finished. They can be combined using the AND and OR operators. Note For group chat teams (i.e., RoundRobinGroupChat , SelectorGroupChat , and Swarm ), the termination condition is called after each agent responds. While a response may contain multiple inner messages, the team calls its termination condition just once for all the messages from a single response. So the condition is called with the “delta sequence” of messages since the last time it was called. Built-In Termination Conditions: MaxMessageTermination : Stops after a specified number of messages have been produced,', mime_type='MemoryMimeType.TEXT', metadata={'chunk_index': 1, 'mime_type': 'MemoryMimeType.TEXT', 'source': 'https://microsoft.github.io/autogen/dev/user-guide/agentchat-user-guide/tutorial/termination.html', 'score': 0.461774212772051, 'id': '699ef490-d108-4cd3-b629-c1198d6b78ba'})]\n",- "---------- rag_assistant ----------\n",- "AgentChat is part of the AutoGen framework, a programming environment for building multi-agent applications. In AgentChat, agents can interact with each other and with users to perform various tasks, including web browsing and engaging in dialogue. It utilizes models from OpenAI for chat completions and supports multi-modal input, which means agents can handle inputs that include both text and images. Additionally, AgentChat provides mechanisms to define termination conditions to control when a conversation or task should be concluded, ensuring that the agent interactions are efficient and goal-oriented. TERMINATE\n"- ]- }- ],- "source": [- "# Create our RAG assistant agent\n",- "rag_assistant = AssistantAgent(\n",- " name=\"rag_assistant\", model_client=OpenAIChatCompletionClient(model=\"gpt-4o\"), memory=[rag_memory]\n",- ")\n",- "\n",- "# Ask questions about AutoGen\n",- "stream = rag_assistant.run_stream(task=\"What is AgentChat?\")\n",- "await Console(stream)\n",- "\n",- "# Remember to close the memory when done\n",- "await rag_memory.close()"- ]- },- {- "cell_type": "markdown",- "metadata": {},- "source": [- "This implementation provides a RAG agent that can answer questions based on AutoGen documentation. When a question is asked, the Memory system retrieves relevant chunks and adds them to the context, enabling the assistant to generate informed responses.\n",- "\n",- "For production systems, you might want to:\n",- "1. Implement more sophisticated chunking strategies\n",- "2. Add metadata filtering capabilities\n",- "3. Customize the retrieval scoring\n",- "4. Optimize embedding models for your specific domain\n"- ]- },- {- "cell_type": "markdown",- "metadata": {},- "source": []- }- ],- "metadata": {- "kernelspec": {- "display_name": ".venv",- "language": "python",- "name": "python3"- },- "language_info": {- "codemirror_mode": {- "name": "ipython",- "version": 3- },- "file_extension": ".py",- "mimetype": "text/x-python",- "name": "python",- "nbconvert_exporter": "python",- "pygments_lexer": "ipython3",- "version": "3.11.9"- }- },- "nbformat": 4,- "nbformat_minor": 2+ "cells": [+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "## Memory and RAG\n",+ "\n",+ "There are several use cases where it is valuable to maintain a _store_ of useful facts that can be intelligently added to the context of the agent just before a specific step. The typically use case here is a RAG pattern where a query is used to retrieve relevant information from a database that is then added to the agent's context.\n",+ "\n",+ "\n",+ "AgentChat provides a {py:class}`~autogen_core.memory.Memory` protocol that can be extended to provide this functionality. The key methods are `query`, `update_context`, `add`, `clear`, and `close`. \n",+ "\n",+ "- `add`: add new entries to the memory store\n",+ "- `query`: retrieve relevant information from the memory store \n",+ "- `update_context`: mutate an agent's internal `model_context` by adding the retrieved information (used in the {py:class}`~autogen_agentchat.agents.AssistantAgent` class) \n",+ "- `clear`: clear all entries from the memory store\n",+ "- `close`: clean up any resources used by the memory store \n",+ "\n",+ "\n",+ "## ListMemory Example\n",+ "\n",+ "{py:class}~autogen_core.memory.ListMemory is provided as an example implementation of the {py:class}~autogen_core.memory.Memory protocol. It is a simple list-based memory implementation that maintains memories in chronological order, appending the most recent memories to the model's context. The implementation is designed to be straightforward and predictable, making it easy to understand and debug.\n",+ "In the following example, we will use ListMemory to maintain a memory bank of user preferences and demonstrate how it can be used to provide consistent context for agent responses over time."+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "metadata": {},+ "outputs": [],+ "source": [+ "from autogen_agentchat.agents import AssistantAgent\n",+ "from autogen_agentchat.ui import Console\n",+ "from autogen_core.memory import ListMemory, MemoryContent, MemoryMimeType\n",+ "from autogen_ext.models.openai import OpenAIChatCompletionClient"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "metadata": {},+ "outputs": [],+ "source": [+ "# Initialize user memory\n",+ "user_memory = ListMemory()\n",+ "\n",+ "# Add user preferences to memory\n",+ "await user_memory.add(MemoryContent(content=\"The weather should be in metric units\", mime_type=MemoryMimeType.TEXT))\n",+ "\n",+ "await user_memory.add(MemoryContent(content=\"Meal recipe must be vegan\", mime_type=MemoryMimeType.TEXT))\n",+ "\n",+ "\n",+ "async def get_weather(city: str, units: str = \"imperial\") -> str:\n",+ " if units == \"imperial\":\n",+ " return f\"The weather in {city} is 73 °F and Sunny.\"\n",+ " elif units == \"metric\":\n",+ " return f\"The weather in {city} is 23 °C and Sunny.\"\n",+ " else:\n",+ " return f\"Sorry, I don't know the weather in {city}.\"\n",+ "\n",+ "\n",+ "assistant_agent = AssistantAgent(\n",+ " name=\"assistant_agent\",\n",+ " model_client=OpenAIChatCompletionClient(\n",+ " model=\"gpt-4o-2024-08-06\",\n",+ " ),\n",+ " tools=[get_weather],\n",+ " memory=[user_memory],\n",+ ")"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "metadata": {},+ "outputs": [],+ "source": [+ "# Run the agent with a task.\n",+ "stream = assistant_agent.run_stream(task=\"What is the weather in New York?\")\n",+ "await Console(stream)"+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "We can inspect that the `assistant_agent` model_context is actually updated with the retrieved memory entries. The `transform` method is used to format the retrieved memory entries into a string that can be used by the agent. In this case, we simply concatenate the content of each memory entry into a single string."+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "metadata": {},+ "outputs": [],+ "source": [+ "await assistant_agent._model_context.get_messages()"+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "We see above that the weather is returned in Centigrade as stated in the user preferences. \n",+ "\n",+ "Similarly, assuming we ask a separate question about generating a meal plan, the agent is able to retrieve relevant information from the memory store and provide a personalized (vegan) response."+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "metadata": {},+ "outputs": [],+ "source": [+ "stream = assistant_agent.run_stream(task=\"Write brief meal recipe with broth\")\n",+ "await Console(stream)"+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "## Custom Memory Stores (Vector DBs, etc.)\n",+ "\n",+ "You can build on the `Memory` protocol to implement more complex memory stores. For example, you could implement a custom memory store that uses a vector database to store and retrieve information, or a memory store that uses a machine learning model to generate personalized responses based on the user's preferences etc.\n",+ "\n",+ "Specifically, you will need to overload the `add`, `query` and `update_context` methods to implement the desired functionality and pass the memory store to your agent.\n",+ "\n",+ "\n",+ "Currently the following example memory stores are available as part of the {py:class}`~autogen_ext` extensions package. \n",+ "\n",+ "- `autogen_ext.memory.chromadb.ChromaDBVectorMemory`: A memory store that uses a vector database to store and retrieve information. "+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "metadata": {},+ "outputs": [],+ "source": [+ "import os\n",+ "from pathlib import Path\n",+ "\n",+ "from autogen_agentchat.agents import AssistantAgent\n",+ "from autogen_agentchat.ui import Console\n",+ "from autogen_core.memory import MemoryContent, MemoryMimeType\n",+ "from autogen_ext.memory.chromadb import ChromaDBVectorMemory, PersistentChromaDBVectorMemoryConfig\n",+ "from autogen_ext.models.openai import OpenAIChatCompletionClient\n",+ "\n",+ "# Initialize ChromaDB memory with custom config\n",+ "chroma_user_memory = ChromaDBVectorMemory(\n",+ " config=PersistentChromaDBVectorMemoryConfig(\n",+ " collection_name=\"preferences\",\n",+ " persistence_path=os.path.join(str(Path.home()), \".chromadb_autogen\"),\n",+ " k=2, # Return top k results\n",+ " score_threshold=0.4, # Minimum similarity score\n",+ " )\n",+ ")\n",+ "# a HttpChromaDBVectorMemoryConfig is also supported for connecting to a remote ChromaDB server\n",+ "\n",+ "# Add user preferences to memory\n",+ "await chroma_user_memory.add(\n",+ " MemoryContent(\n",+ " content=\"The weather should be in metric units\",\n",+ " mime_type=MemoryMimeType.TEXT,\n",+ " metadata={\"category\": \"preferences\", \"type\": \"units\"},\n",+ " )\n",+ ")\n",+ "\n",+ "await chroma_user_memory.add(\n",+ " MemoryContent(\n",+ " content=\"Meal recipe must be vegan\",\n",+ " mime_type=MemoryMimeType.TEXT,\n",+ " metadata={\"category\": \"preferences\", \"type\": \"dietary\"},\n",+ " )\n",+ ")\n",+ "\n",+ "model_client = OpenAIChatCompletionClient(\n",+ " model=\"gpt-4o\",\n",+ ")\n",+ "\n",+ "# Create assistant agent with ChromaDB memory\n",+ "assistant_agent = AssistantAgent(\n",+ " name=\"assistant_agent\",\n",+ " model_client=model_client,\n",+ " tools=[get_weather],\n",+ " memory=[chroma_user_memory],\n",+ ")\n",+ "\n",+ "stream = assistant_agent.run_stream(task=\"What is the weather in New York?\")\n",+ "await Console(stream)\n",+ "\n",+ "await model_client.close()\n",+ "await chroma_user_memory.close()"+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "Note that you can also serialize the ChromaDBVectorMemory and save it to disk."+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "metadata": {},+ "outputs": [],+ "source": [+ "chroma_user_memory.dump_component().model_dump_json()"+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "## RAG Agent: Putting It All Together\n",+ "\n",+ "The RAG (Retrieval Augmented Generation) pattern which is common in building AI systems encompasses two distinct phases:\n",+ "\n",+ "1. **Indexing**: Loading documents, chunking them, and storing them in a vector database\n",+ "2. **Retrieval**: Finding and using relevant chunks during conversation runtime\n",+ "\n",+ "In our previous examples, we manually added items to memory and passed them to our agents. In practice, the indexing process is usually automated and based on much larger document sources like product documentation, internal files, or knowledge bases.\n",+ "\n",+ "> Note: The quality of a RAG system is dependent on the quality of the chunking and retrieval process (models, embeddings, etc.). You may need to experiement with more advanced chunking and retrieval models to get the best results.\n",+ "\n",+ "### Building a Simple RAG Agent\n",+ "\n",+ "To begin, let's create a simple document indexer that we will used to load documents, chunk them, and store them in a `ChromaDBVectorMemory` memory store. "+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "metadata": {},+ "outputs": [],+ "source": [+ "import re\n",+ "from typing import List\n",+ "\n",+ "import aiofiles\n",+ "import aiohttp\n",+ "from autogen_core.memory import Memory, MemoryContent, MemoryMimeType\n",+ "\n",+ "\n",+ "class SimpleDocumentIndexer:\n",+ " \"\"\"Basic document indexer for AutoGen Memory.\"\"\"\n",+ "\n",+ " def __init__(self, memory: Memory, chunk_size: int = 1500) -> None:\n",+ " self.memory = memory\n",+ " self.chunk_size = chunk_size\n",+ "\n",+ " async def _fetch_content(self, source: str) -> str:\n",+ " \"\"\"Fetch content from URL or file.\"\"\"\n",+ " if source.startswith((\"http://\", \"https://\")):\n",+ " async with aiohttp.ClientSession() as session:\n",+ " async with session.get(source) as response:\n",+ " return await response.text()\n",+ " else:\n",+ " async with aiofiles.open(source, \"r\", encoding=\"utf-8\") as f:\n",+ " return await f.read()\n",+ "\n",+ " def _strip_html(self, text: str) -> str:\n",+ " \"\"\"Remove HTML tags and normalize whitespace.\"\"\"\n",+ " text = re.sub(r\"<[^>]*>\", \" \", text)\n",+ " text = re.sub(r\"\\s+\", \" \", text)\n",+ " return text.strip()\n",+ "\n",+ " def _split_text(self, text: str) -> List[str]:\n",+ " \"\"\"Split text into fixed-size chunks.\"\"\"\n",+ " chunks: list[str] = []\n",+ " # Just split text into fixed-size chunks\n",+ " for i in range(0, len(text), self.chunk_size):\n",+ " chunk = text[i : i + self.chunk_size]\n",+ " chunks.append(chunk.strip())\n",+ " return chunks\n",+ "\n",+ " async def index_documents(self, sources: List[str]) -> int:\n",+ " \"\"\"Index documents into memory.\"\"\"\n",+ " total_chunks = 0\n",+ "\n",+ " for source in sources:\n",+ " try:\n",+ " content = await self._fetch_content(source)\n",+ "\n",+ " # Strip HTML if content appears to be HTML\n",+ " if \"<\" in content and \">\" in content:\n",+ " content = self._strip_html(content)\n",+ "\n",+ " chunks = self._split_text(content)\n",+ "\n",+ " for i, chunk in enumerate(chunks):\n",+ " await self.memory.add(\n",+ " MemoryContent(\n",+ " content=chunk, mime_type=MemoryMimeType.TEXT, metadata={\"source\": source, \"chunk_index\": i}\n",+ " )\n",+ " )\n",+ "\n",+ " total_chunks += len(chunks)\n",+ "\n",+ " except Exception as e:\n",+ " print(f\"Error indexing {source}: {str(e)}\")\n",+ "\n",+ " return total_chunks"+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "\n",+ " \n",+ "Now let's use our indexer with ChromaDBVectorMemory to build a complete RAG agent:\n"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "metadata": {},+ "outputs": [+ {+ "name": "stdout",+ "output_type": "stream",+ "text": [+ "Indexed 72 chunks from 4 AutoGen documents\n"+ ]+ }+ ],+ "source": [+ "import os\n",+ "from pathlib import Path\n",+ "\n",+ "from autogen_agentchat.agents import AssistantAgent\n",+ "from autogen_agentchat.ui import Console\n",+ "from autogen_ext.memory.chromadb import ChromaDBVectorMemory, PersistentChromaDBVectorMemoryConfig\n",+ "from autogen_ext.models.openai import OpenAIChatCompletionClient\n",+ "\n",+ "# Initialize vector memory\n",+ "\n",+ "rag_memory = ChromaDBVectorMemory(\n",+ " config=PersistentChromaDBVectorMemoryConfig(\n",+ " collection_name=\"autogen_docs\",\n",+ " persistence_path=os.path.join(str(Path.home()), \".chromadb_autogen\"),\n",+ " k=3, # Return top 3 results\n",+ " score_threshold=0.4, # Minimum similarity score\n",+ " )\n",+ ")\n",+ "\n",+ "await rag_memory.clear() # Clear existing memory\n",+ "\n",+ "\n",+ "# Index AutoGen documentation\n",+ "async def index_autogen_docs() -> None:\n",+ " indexer = SimpleDocumentIndexer(memory=rag_memory)\n",+ " sources = [\n",+ " \"https://raw.githubusercontent.com/microsoft/autogen/main/README.md\",\n",+ " \"https://microsoft.github.io/autogen/dev/user-guide/agentchat-user-guide/tutorial/agents.html\",\n",+ " \"https://microsoft.github.io/autogen/dev/user-guide/agentchat-user-guide/tutorial/teams.html\",\n",+ " \"https://microsoft.github.io/autogen/dev/user-guide/agentchat-user-guide/tutorial/termination.html\",\n",+ " ]\n",+ " chunks: int = await indexer.index_documents(sources)\n",+ " print(f\"Indexed {chunks} chunks from {len(sources)} AutoGen documents\")\n",+ "\n",+ "\n",+ "await index_autogen_docs()"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 4,+ "metadata": {},+ "outputs": [+ {+ "name": "stdout",+ "output_type": "stream",+ "text": [+ "---------- user ----------\n",+ "What is AgentChat?\n",+ "Query results: results=[MemoryContent(content='ng OpenAI\\'s GPT-4o model. See [other supported models](https://microsoft.github.io/autogen/stable/user-guide/agentchat-user-guide/tutorial/models.html). ```python import asyncio from autogen_agentchat.agents import AssistantAgent from autogen_ext.models.openai import OpenAIChatCompletionClient async def main() -> None: model_client = OpenAIChatCompletionClient(model=\"gpt-4o\") agent = AssistantAgent(\"assistant\", model_client=model_client) print(await agent.run(task=\"Say \\'Hello World!\\'\")) await model_client.close() asyncio.run(main()) ``` ### Web Browsing Agent Team Create a group chat team with a web surfer agent and a user proxy agent for web browsing tasks. You need to install [playwright](https://playwright.dev/python/docs/library). ```python # pip install -U autogen-agentchat autogen-ext[openai,web-surfer] # playwright install import asyncio from autogen_agentchat.agents import UserProxyAgent from autogen_agentchat.conditions import TextMentionTermination from autogen_agentchat.teams import RoundRobinGroupChat from autogen_agentchat.ui import Console from autogen_ext.models.openai import OpenAIChatCompletionClient from autogen_ext.agents.web_surfer import MultimodalWebSurfer async def main() -> None: model_client = OpenAIChatCompletionClient(model=\"gpt-4o\") # The web surfer will open a Chromium browser window to perform web browsing tasks. web_surfer = MultimodalWebSurfer(\"web_surfer\", model_client, headless=False, animate_actions=True) # The user proxy agent is used to ge', mime_type='MemoryMimeType.TEXT', metadata={'chunk_index': 1, 'mime_type': 'MemoryMimeType.TEXT', 'source': 'https://raw.githubusercontent.com/microsoft/autogen/main/README.md', 'score': 0.48810458183288574, 'id': '16088e03-0153-4da3-9dec-643b39c549f5'}), MemoryContent(content='els_usage=None content='AutoGen is a programming framework for building multi-agent applications.' type='ToolCallSummaryMessage' The call to the on_messages() method returns a Response that contains the agent’s final response in the chat_message attribute, as well as a list of inner messages in the inner_messages attribute, which stores the agent’s “thought process” that led to the final response. Note It is important to note that on_messages() will update the internal state of the agent – it will add the messages to the agent’s history. So you should call this method with new messages. You should not repeatedly call this method with the same messages or the complete history. Note Unlike in v0.2 AgentChat, the tools are executed by the same agent directly within the same call to on_messages() . By default, the agent will return the result of the tool call as the final response. You can also call the run() method, which is a convenience method that calls on_messages() . It follows the same interface as Teams and returns a TaskResult object. Multi-Modal Input # The AssistantAgent can handle multi-modal input by providing the input as a MultiModalMessage . from io import BytesIO import PIL import requests from autogen_agentchat.messages import MultiModalMessage from autogen_core import Image # Create a multi-modal message with random image and text. pil_image = PIL . Image . open ( BytesIO ( requests . get ( "https://picsum.photos/300/200" ) . content )', mime_type='MemoryMimeType.TEXT', metadata={'chunk_index': 3, 'mime_type': 'MemoryMimeType.TEXT', 'source': 'https://microsoft.github.io/autogen/dev/user-guide/agentchat-user-guide/tutorial/agents.html', 'score': 0.4665141701698303, 'id': '3d603b62-7cab-4f74-b671-586fe36306f2'}), MemoryContent(content='AgentChat Termination Termination # In the previous section, we explored how to define agents, and organize them into teams that can solve tasks. However, a run can go on forever, and in many cases, we need to know when to stop them. This is the role of the termination condition. AgentChat supports several termination condition by providing a base TerminationCondition class and several implementations that inherit from it. A termination condition is a callable that takes a sequence of BaseAgentEvent or BaseChatMessage objects since the last time the condition was called , and returns a StopMessage if the conversation should be terminated, or None otherwise. Once a termination condition has been reached, it must be reset by calling reset() before it can be used again. Some important things to note about termination conditions: They are stateful but reset automatically after each run ( run() or run_stream() ) is finished. They can be combined using the AND and OR operators. Note For group chat teams (i.e., RoundRobinGroupChat , SelectorGroupChat , and Swarm ), the termination condition is called after each agent responds. While a response may contain multiple inner messages, the team calls its termination condition just once for all the messages from a single response. So the condition is called with the “delta sequence” of messages since the last time it was called. Built-In Termination Conditions: MaxMessageTermination : Stops after a specified number of messages have been produced,', mime_type='MemoryMimeType.TEXT', metadata={'chunk_index': 1, 'mime_type': 'MemoryMimeType.TEXT', 'source': 'https://microsoft.github.io/autogen/dev/user-guide/agentchat-user-guide/tutorial/termination.html', 'score': 0.461774212772051, 'id': '699ef490-d108-4cd3-b629-c1198d6b78ba'})]\n",+ "---------- rag_assistant ----------\n",+ "[MemoryContent(content='ng OpenAI\\'s GPT-4o model. See [other supported models](https://microsoft.github.io/autogen/stable/user-guide/agentchat-user-guide/tutorial/models.html). ```python import asyncio from autogen_agentchat.agents import AssistantAgent from autogen_ext.models.openai import OpenAIChatCompletionClient async def main() -> None: model_client = OpenAIChatCompletionClient(model=\"gpt-4o\") agent = AssistantAgent(\"assistant\", model_client=model_client) print(await agent.run(task=\"Say \\'Hello World!\\'\")) await model_client.close() asyncio.run(main()) ``` ### Web Browsing Agent Team Create a group chat team with a web surfer agent and a user proxy agent for web browsing tasks. You need to install [playwright](https://playwright.dev/python/docs/library). ```python # pip install -U autogen-agentchat autogen-ext[openai,web-surfer] # playwright install import asyncio from autogen_agentchat.agents import UserProxyAgent from autogen_agentchat.conditions import TextMentionTermination from autogen_agentchat.teams import RoundRobinGroupChat from autogen_agentchat.ui import Console from autogen_ext.models.openai import OpenAIChatCompletionClient from autogen_ext.agents.web_surfer import MultimodalWebSurfer async def main() -> None: model_client = OpenAIChatCompletionClient(model=\"gpt-4o\") # The web surfer will open a Chromium browser window to perform web browsing tasks. web_surfer = MultimodalWebSurfer(\"web_surfer\", model_client, headless=False, animate_actions=True) # The user proxy agent is used to ge', mime_type='MemoryMimeType.TEXT', metadata={'chunk_index': 1, 'mime_type': 'MemoryMimeType.TEXT', 'source': 'https://raw.githubusercontent.com/microsoft/autogen/main/README.md', 'score': 0.48810458183288574, 'id': '16088e03-0153-4da3-9dec-643b39c549f5'}), MemoryContent(content='els_usage=None content='AutoGen is a programming framework for building multi-agent applications.' type='ToolCallSummaryMessage' The call to the on_messages() method returns a Response that contains the agent’s final response in the chat_message attribute, as well as a list of inner messages in the inner_messages attribute, which stores the agent’s “thought process” that led to the final response. Note It is important to note that on_messages() will update the internal state of the agent – it will add the messages to the agent’s history. So you should call this method with new messages. You should not repeatedly call this method with the same messages or the complete history. Note Unlike in v0.2 AgentChat, the tools are executed by the same agent directly within the same call to on_messages() . By default, the agent will return the result of the tool call as the final response. You can also call the run() method, which is a convenience method that calls on_messages() . It follows the same interface as Teams and returns a TaskResult object. Multi-Modal Input # The AssistantAgent can handle multi-modal input by providing the input as a MultiModalMessage . from io import BytesIO import PIL import requests from autogen_agentchat.messages import MultiModalMessage from autogen_core import Image # Create a multi-modal message with random image and text. pil_image = PIL . Image . open ( BytesIO ( requests . get ( "https://picsum.photos/300/200" ) . content )', mime_type='MemoryMimeType.TEXT', metadata={'chunk_index': 3, 'mime_type': 'MemoryMimeType.TEXT', 'source': 'https://microsoft.github.io/autogen/dev/user-guide/agentchat-user-guide/tutorial/agents.html', 'score': 0.4665141701698303, 'id': '3d603b62-7cab-4f74-b671-586fe36306f2'}), MemoryContent(content='AgentChat Termination Termination # In the previous section, we explored how to define agents, and organize them into teams that can solve tasks. However, a run can go on forever, and in many cases, we need to know when to stop them. This is the role of the termination condition. AgentChat supports several termination condition by providing a base TerminationCondition class and several implementations that inherit from it. A termination condition is a callable that takes a sequenceBaseChatMessageent or BaseChatMessage objects since the last time the condition was called , and returns a StopMessage if the conversation should be terminated, or None otherwise. Once a termination condition has been reached, it must be reset by calling reset() before it can be used again. Some important things to note about termination conditions: They are stateful but reset automatically after each run ( run() or run_stream() ) is finished. They can be combined using the AND and OR operators. Note For group chat teams (i.e., RoundRobinGroupChat , SelectorGroupChat , and Swarm ), the termination condition is called after each agent responds. While a response may contain multiple inner messages, the team calls its termination condition just once for all the messages from a single response. So the condition is called with the “delta sequence” of messages since the last time it was called. Built-In Termination Conditions: MaxMessageTermination : Stops after a specified number of messages have been produced,', mime_type='MemoryMimeType.TEXT', metadata={'chunk_index': 1, 'mime_type': 'MemoryMimeType.TEXT', 'source': 'https://microsoft.github.io/autogen/dev/user-guide/agentchat-user-guide/tutorial/termination.html', 'score': 0.461774212772051, 'id': '699ef490-d108-4cd3-b629-c1198d6b78ba'})]\n",+ "---------- rag_assistant ----------\n",+ "AgentChat is part of the AutoGen framework, a programming environment for building multi-agent applications. In AgentChat, agents can interact with each other and with users to perform various tasks, including web browsing and engaging in dialogue. It utilizes models from OpenAI for chat completions and supports multi-modal input, which means agents can handle inputs that include both text and images. Additionally, AgentChat provides mechanisms to define termination conditions to control when a conversation or task should be concluded, ensuring that the agent interactions are efficient and goal-oriented. TERMINATE\n"+ ]+ }+ ],+ "source": [+ "# Create our RAG assistant agent\n",+ "rag_assistant = AssistantAgent(\n",+ " name=\"rag_assistant\", model_client=OpenAIChatCompletionClient(model=\"gpt-4o\"), memory=[rag_memory]\n",+ ")\n",+ "\n",+ "# Ask questions about AutoGen\n",+ "stream = rag_assistant.run_stream(task=\"What is AgentChat?\")\n",+ "await Console(stream)\n",+ "\n",+ "# Remember to close the memory when done\n",+ "await rag_memory.close()"+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "This implementation provides a RAG agent that can answer questions based on AutoGen documentation. When a question is asked, the Memory system retrieves relevant chunks and adds them to the context, enabling the assistant to generate informed responses.\n",+ "\n",+ "For production systems, you might want to:\n",+ "1. Implement more sophisticated chunking strategies\n",+ "2. Add metadata filtering capabilities\n",+ "3. Customize the retrieval scoring\n",+ "4. Optimize embedding models for your specific domain\n"+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": []+ }+ ],+ "metadata": {+ "kernelspec": {+ "display_name": ".venv",+ "language": "python",+ "name": "python3"+ },+ "language_info": {+ "codemirror_mode": {+ "name": "ipython",+ "version": 3+ },+ "file_extension": ".py",+ "mimetype": "text/x-python",+ "name": "python",+ "nbconvert_exporter": "python",+ "pygments_lexer": "ipython3",+ "version": "3.11.9"+ }+ },+ "nbformat": 4,+ "nbformat_minor": 2}diff --git a/python/packages/autogen-core/docs/src/user-guide/agentchat-user-guide/migration-guide.md b/python/packages/autogen-core/docs/src/user-guide/agentchat-user-guide/migration-guide.mdindex 9d505d771..ce93cee66 100644--- a/python/packages/autogen-core/docs/src/user-guide/agentchat-user-guide/migration-guide.md+++ b/python/packages/autogen-core/docs/src/user-guide/agentchat-user-guide/migration-guide.md@@ -462,18 +462,18 @@ and implement the `on_messages`, `on_reset`, and `produced_message_types` methodfrom typing import Sequencefrom autogen_core import CancellationTokenfrom autogen_agentchat.agents import BaseChatAgent-from autogen_agentchat.messages import TextMessage, ChatMessage+from autogen_agentchat.messages import TextMessage, BaseChatMessagefrom autogen_agentchat.base import Responseclass CustomAgent(BaseChatAgent):- async def on_messages(self, messages: Sequence[ChatMessage], cancellation_token: CancellationToken) -> Response:+ async def on_messages(self, messages: Sequence[BaseChatMessage], cancellation_token: CancellationToken) -> Response:return Response(chat_message=TextMessage(content="Custom reply", source=self.name))async def on_reset(self, cancellation_token: CancellationToken) -> None:pass@property- def produced_message_types(self) -> Sequence[type[ChatMessage]]:+ def produced_message_types(self) -> Sequence[type[BaseChatMessage]]:return (TextMessage,)```@@ -742,8 +742,8 @@ You can use the following conversion functions to convert between a v0.4 messagefrom typing import Any, Dict, List, Literalfrom autogen_agentchat.messages import (- AgentEvent,- ChatMessage,+ BaseAgentEvent,+ BaseChatMessage,HandoffMessage,MultiModalMessage,StopMessage,@@ -757,14 +757,14 @@ from autogen_core.models import FunctionExecutionResultdef convert_to_v02_message(- message: AgentEvent | ChatMessage,+ message: BaseAgentEvent | BaseChatMessage,role: Literal["assistant", "user", "tool"],image_detail: Literal["auto", "high", "low"] = "auto",) -> Dict[str, Any]:"""Convert a v0.4 AgentChat message to a v0.2 message.Args:- message (AgentEvent | ChatMessage): The message to convert.+ message (BaseAgentEvent | BaseChatMessage): The message to convert.role (Literal["assistant", "user", "tool"]): The role of the message.image_detail (Literal["auto", "high", "low"], optional): The detail level of image content in multi-modal message. Defaults to "auto".@@ -810,7 +810,7 @@ def convert_to_v02_message(return v02_message-def convert_to_v04_message(message: Dict[str, Any]) -> AgentEvent | ChatMessage:+def convert_to_v04_message(message: Dict[str, Any]) -> BaseAgentEvent | BaseChatMessage:"""Convert a v0.2 message to a v0.4 AgentChat message."""if "tool_calls" in message:tool_calls: List[FunctionCall] = []@@ -1065,7 +1065,7 @@ import asynciofrom typing import Sequencefrom autogen_agentchat.agents import AssistantAgentfrom autogen_agentchat.conditions import MaxMessageTermination, TextMentionTermination-from autogen_agentchat.messages import AgentEvent, ChatMessage+from autogen_agentchat.messages import BaseAgentEvent, BaseChatMessagefrom autogen_agentchat.teams import SelectorGroupChatfrom autogen_agentchat.ui import Consolefrom autogen_ext.models.openai import OpenAIChatCompletionClient@@ -1141,7 +1141,7 @@ def create_team(model_client : OpenAIChatCompletionClient) -> SelectorGroupChat:# The selector function is a function that takes the current message thread of the group chat# and returns the next speaker's name. If None is returned, the LLM-based selection method will be used.- def selector_func(messages: Sequence[AgentEvent | ChatMessage]) -> str | None:+ def selector_func(messages: Sequence[BaseAgentEvent | BaseChatMessage]) -> str | None:if messages[-1].source != planning_agent.name:return planning_agent.name # Always return to the planning agent after the other agents have spoken.return None@@ -1190,12 +1190,12 @@ from typing import Sequencefrom autogen_core import CancellationTokenfrom autogen_agentchat.agents import BaseChatAgentfrom autogen_agentchat.teams import RoundRobinGroupChat-from autogen_agentchat.messages import TextMessage, ChatMessage+from autogen_agentchat.messages import TextMessage, BaseChatMessagefrom autogen_agentchat.base import Responseclass CountingAgent(BaseChatAgent):"""An agent that returns a new number by adding 1 to the last number in the input messages."""- async def on_messages(self, messages: Sequence[ChatMessage], cancellation_token: CancellationToken) -> Response:+ async def on_messages(self, messages: Sequence[BaseChatMessage], cancellation_token: CancellationToken) -> Response:if len(messages) == 0:last_number = 0 # Start from 0 if no messages are given.else:@@ -1207,7 +1207,7 @@ class CountingAgent(BaseChatAgent):pass@property- def produced_message_types(self) -> Sequence[type[ChatMessage]]:+ def produced_message_types(self) -> Sequence[type[BaseChatMessage]]:return (TextMessage,)class NestedCountingAgent(BaseChatAgent):@@ -1217,7 +1217,7 @@ class NestedCountingAgent(BaseChatAgent):super().__init__(name, description="An agent that counts numbers.")self._counting_team = counting_team- async def on_messages(self, messages: Sequence[ChatMessage], cancellation_token: CancellationToken) -> Response:+ async def on_messages(self, messages: Sequence[BaseChatMessage], cancellation_token: CancellationToken) -> Response:# Run the inner team with the given messages and returns the last message produced by the team.result = await self._counting_team.run(task=messages, cancellation_token=cancellation_token)# To stream the inner messages, implement `on_messages_stream` and use that to implement `on_messages`.@@ -1229,7 +1229,7 @@ class NestedCountingAgent(BaseChatAgent):await self._counting_team.reset()@property- def produced_message_types(self) -> Sequence[type[ChatMessage]]:+ def produced_message_types(self) -> Sequence[type[BaseChatMessage]]:return (TextMessage,)async def main() -> None:diff --git a/python/packages/autogen-core/docs/src/user-guide/agentchat-user-guide/selector-group-chat.ipynb b/python/packages/autogen-core/docs/src/user-guide/agentchat-user-guide/selector-group-chat.ipynbindex fdc2b9a9d..f00ce7e36 100644--- a/python/packages/autogen-core/docs/src/user-guide/agentchat-user-guide/selector-group-chat.ipynb+++ b/python/packages/autogen-core/docs/src/user-guide/agentchat-user-guide/selector-group-chat.ipynb@@ -61,7 +61,7 @@"\n","from autogen_agentchat.agents import AssistantAgent, UserProxyAgent\n","from autogen_agentchat.conditions import MaxMessageTermination, TextMentionTermination\n",- "from autogen_agentchat.messages import AgentEvent, ChatMessage\n",+ "from autogen_agentchat.messages import BaseAgentEvent, BaseChatMessage\n","from autogen_agentchat.teams import SelectorGroupChat\n","from autogen_agentchat.ui import Console\n","from autogen_ext.models.openai import OpenAIChatCompletionClient"@@ -511,7 +511,7 @@}],"source": [- "def selector_func(messages: Sequence[AgentEvent | ChatMessage]) -> str | None:\n",+ "def selector_func(messages: Sequence[BaseAgentEvent | BaseChatMessage]) -> str | None:\n"," if messages[-1].source != planning_agent.name:\n"," return planning_agent.name\n"," return None\n",@@ -655,7 +655,7 @@}],"source": [- "def candidate_func(messages: Sequence[AgentEvent | ChatMessage]) -> List[str]:\n",+ "def candidate_func(messages: Sequence[BaseAgentEvent | BaseChatMessage]) -> List[str]:\n"," # keep planning_agent first one to plan out the tasks\n"," if messages[-1].source == \"user\":\n"," return [planning_agent.name]\n",@@ -813,7 +813,7 @@"user_proxy_agent = UserProxyAgent(\"UserProxyAgent\", description=\"A proxy for the user to approve or disapprove tasks.\")\n","\n","\n",- "def selector_func_with_user_proxy(messages: Sequence[AgentEvent | ChatMessage]) -> str | None:\n",+ "def selector_func_with_user_proxy(messages: Sequence[BaseAgentEvent | BaseChatMessage]) -> str | None:\n"," if messages[-1].source != planning_agent.name and messages[-1].source != user_proxy_agent.name:\n"," # Planning agent should be the first to engage when given a new task, or check progress.\n"," return planning_agent.name\n",@@ -1018,7 +1018,7 @@"name": "python","nbconvert_exporter": "python","pygments_lexer": "ipython3",- "version": "3.12.3"+ "version": "3.12.9"}},"nbformat": 4,diff --git a/python/packages/autogen-core/docs/src/user-guide/agentchat-user-guide/tutorial/agents.ipynb b/python/packages/autogen-core/docs/src/user-guide/agentchat-user-guide/tutorial/agents.ipynbindex c927e775a..b05d82b7c 100644--- a/python/packages/autogen-core/docs/src/user-guide/agentchat-user-guide/tutorial/agents.ipynb+++ b/python/packages/autogen-core/docs/src/user-guide/agentchat-user-guide/tutorial/agents.ipynb@@ -11,8 +11,8 @@"\n","- {py:attr}`~autogen_agentchat.agents.BaseChatAgent.name`: The unique name of the agent.\n","- {py:attr}`~autogen_agentchat.agents.BaseChatAgent.description`: The description of the agent in text.\n",- "- {py:meth}`~autogen_agentchat.agents.BaseChatAgent.on_messages`: Send the agent a sequence of {py:class}`~autogen_agentchat.messages.ChatMessage` and get a {py:class}`~autogen_agentchat.base.Response`. **It is important to note that agents are expected to be stateful and this method is expected to be called with new messages, not the complete history**.\n",- "- {py:meth}`~autogen_agentchat.agents.BaseChatAgent.on_messages_stream`: Same as {py:meth}`~autogen_agentchat.agents.BaseChatAgent.on_messages` but returns an iterator of {py:class}`~autogen_agentchat.messages.AgentEvent` or {py:class}`~autogen_agentchat.messages.ChatMessage` followed by a {py:class}`~autogen_agentchat.base.Response` as the last item.\n",+ "- {py:meth}`~autogen_agentchat.agents.BaseChatAgent.on_messages`: Send the agent a sequence of {py:class}`~autogen_agentchat.messages.BaseChatMessage` and get a {py:class}`~autogen_agentchat.base.Response`. **It is important to note that agents are expected to be stateful and this method is expected to be called with new messages, not the complete history**.\n",+ "- {py:meth}`~autogen_agentchat.agents.BaseChatAgent.on_messages_stream`: Same as {py:meth}`~autogen_agentchat.agents.BaseChatAgent.on_messages` but returns an iterator of {py:class}`~autogen_agentchat.messages.BaseAgentEvent` or {py:class}`~autogen_agentchat.messages.BaseChatMessage` followed by a {py:class}`~autogen_agentchat.base.Response` as the last item.\n","- {py:meth}`~autogen_agentchat.agents.BaseChatAgent.on_reset`: Reset the agent to its initial state.\n","- {py:meth}`~autogen_agentchat.agents.BaseChatAgent.run` and {py:meth}`~autogen_agentchat.agents.BaseChatAgent.run_stream`: convenience methods that call {py:meth}`~autogen_agentchat.agents.BaseChatAgent.on_messages` and {py:meth}`~autogen_agentchat.agents.BaseChatAgent.on_messages_stream` respectively but offer the same interface as [Teams](./teams.ipynb).\n","\n",@@ -840,7 +840,7 @@"name": "python","nbconvert_exporter": "python","pygments_lexer": "ipython3",- "version": "3.12.3"+ "version": "3.12.9"}},"nbformat": 4,diff --git a/python/packages/autogen-core/docs/src/user-guide/agentchat-user-guide/tutorial/messages.ipynb b/python/packages/autogen-core/docs/src/user-guide/agentchat-user-guide/tutorial/messages.ipynbindex a3f5a2551..24b3cc61e 100644--- a/python/packages/autogen-core/docs/src/user-guide/agentchat-user-guide/tutorial/messages.ipynb+++ b/python/packages/autogen-core/docs/src/user-guide/agentchat-user-guide/tutorial/messages.ipynb@@ -1,129 +1,137 @@{- "cells": [- {- "cell_type": "markdown",- "metadata": {},- "source": [- "# Messages"- ]- },- {- "cell_type": "markdown",- "metadata": {},- "source": [- "In AutoGen AgentChat, _messages_ facilitate communication and information exchange with other agents, orchestrators, and applications. AgentChat supports various message types, each designed for specific purposes."- ]- },- {- "cell_type": "markdown",- "metadata": {},- "source": [- "## Types of Messages\n",- "\n",- "At a high level, messages in AgentChat can be categorized into two types: agent-agent messages and an agent's internal events and messages.\n",- "\n",- "### Agent-Agent Messages\n",- "AgentChat supports many message types for agent-to-agent communication. They belong to the union type {py:class}`~autogen_agentchat.messages.ChatMessage`. This message type allows both text and multimodal communication and subsumes other message types, such as {py:class}`~autogen_agentchat.messages.TextMessage` or {py:class}`~autogen_agentchat.messages.MultiModalMessage`.\n",- "\n",- "For example, the following code snippet demonstrates how to create a text message, which accepts a string content and a string source:"- ]- },- {- "cell_type": "code",- "execution_count": null,- "metadata": {},- "outputs": [],- "source": [- "from autogen_agentchat.messages import TextMessage\n",- "\n",- "text_message = TextMessage(content=\"Hello, world!\", source=\"User\")"- ]- },- {- "cell_type": "markdown",- "metadata": {},- "source": [- "Similarly, the following code snippet demonstrates how to create a multimodal message, which accepts\n",- "a list of strings or {py:class}`~autogen_core.Image` objects:"- ]- },- {- "cell_type": "code",- "execution_count": 16,- "metadata": {},- "outputs": [- {- "data": {- "text/html": [- "<img src=\"data:image/png;base64,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\"/>"- ],- "text/plain": [- "<autogen_core._image.Image at 0x10d96e710>"- ]- },- "execution_count": 16,- "metadata": {},- "output_type": "execute_result"- }- ],- "source": [- "from io import BytesIO\n",- "\n",- "import requests\n",- "from autogen_agentchat.messages import MultiModalMessage\n",- "from autogen_core import Image as AGImage\n",- "from PIL import Image\n",- "\n",- "pil_image = Image.open(BytesIO(requests.get(\"https://picsum.photos/300/200\").content))\n",- "img = AGImage(pil_image)\n",- "multi_modal_message = MultiModalMessage(content=[\"Can you describe the content of this image?\", img], source=\"User\")\n",- "img"- ]- },- {- "cell_type": "markdown",- "metadata": {},- "source": [- "The {py:class}`~autogen_agentchat.messages.TextMessage` and {py:class}`~autogen_agentchat.messages.MultiModalMessage` we have created can be passed to agents directly via the {py:class}`~autogen_agentchat.base.ChatAgent.on_messages` method, or as tasks given to a team {py:meth}`~autogen_agentchat.teams.BaseGroupChat.run` method. Messages are also used in the responses of an agent. We will explain these in more detail in [Agents](./agents.ipynb) and [Teams](./teams.ipynb)."- ]- },- {- "cell_type": "markdown",- "metadata": {},- "source": [- "### Internal Events\n",- "\n",- "AgentChat also supports the concept of `events` - messages that are internal to an agent. These messages are used to communicate events and information on actions _within_ the agent itself, and belong to the union type {py:class}`~autogen_agentchat.messages.AgentEvent`.\n",- "\n",- "Examples of these include {py:class}`~autogen_agentchat.messages.ToolCallRequestEvent`, which indicates that a request was made to call a tool, and {py:class}`~autogen_agentchat.messages.ToolCallExecutionEvent`, which contains the results of tool calls.\n",- "\n",- "Typically, events are created by the agent itself and are contained in the {py:attr}`~autogen_agentchat.base.Response.inner_messages` field of the {py:class}`~autogen_agentchat.base.Response` returned from {py:class}`~autogen_agentchat.base.ChatAgent.on_messages`. If you are building a custom agent and have events that you want to communicate to other entities (e.g., a UI), you can include these in the {py:attr}`~autogen_agentchat.base.Response.inner_messages` field of the {py:class}`~autogen_agentchat.base.Response`. We will show examples of this in [Custom Agents](../custom-agents.ipynb).\n",- "\n",- "\n",- "You can read about the full set of messages supported in AgentChat in the {py:mod}`~autogen_agentchat.messages` module. \n",- "<!-- Note that this is not an exhaustive list, and you can create custom messages as needed by subclassing the {py:class}`~autogen_agentchat.messages.BaseMessage` class. -->"- ]- }- ],- "metadata": {- "kernelspec": {- "display_name": "agnext",- "language": "python",- "name": "python3"- },- "language_info": {- "codemirror_mode": {- "name": "ipython",- "version": 3- },- "file_extension": ".py",- "mimetype": "text/x-python",- "name": "python",- "nbconvert_exporter": "python",- "pygments_lexer": "ipython3",- "version": "3.11.9"- }- },- "nbformat": 4,- "nbformat_minor": 2+ "cells": [+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "# Messages"+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "In AutoGen AgentChat, _messages_ facilitate communication and information exchange with other agents, orchestrators, and applications. AgentChat supports various message types, each designed for specific purposes."+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "## Types of Messages\n",+ "\n",+ "At a high level, messages in AgentChat can be categorized into two types: agent-agent messages and an agent's internal events and messages.\n",+ "\n",+ "### Agent-Agent Messages\n",+ "AgentChat supports many message types for agent-to-agent communication. They belong to subclasses of the base class {py:class}`~autogen_agentchat.messages.BaseChatMessage`. Concrete subclasses covers basic text and multimodal communication, such as {py:class}`~autogen_agentchat.messages.TextMessage` and {py:class}`~autogen_agentchat.messages.MultiModalMessage`.\n",+ "\n",+ "For example, the following code snippet demonstrates how to create a text message, which accepts a string content and a string source:"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "metadata": {},+ "outputs": [],+ "source": [+ "from autogen_agentchat.messages import TextMessage\n",+ "\n",+ "text_message = TextMessage(content=\"Hello, world!\", source=\"User\")"+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "Similarly, the following code snippet demonstrates how to create a multimodal message, which accepts\n",+ "a list of strings or {py:class}`~autogen_core.Image` objects:"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 16,+ "metadata": {},+ "outputs": [+ {+ "data": {+ "text/html": [+ "<img src=\"data:image/png;base64,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\"/>"+ ],+ "text/plain": [+ "<autogen_core._image.Image at 0x10d96e710>"+ ]+ },+ "execution_count": 16,+ "metadata": {},+ "output_type": "execute_result"+ }+ ],+ "source": [+ "from io import BytesIO\n",+ "\n",+ "import requests\n",+ "from autogen_agentchat.messages import MultiModalMessage\n",+ "from autogen_core import Image as AGImage\n",+ "from PIL import Image\n",+ "\n",+ "pil_image = Image.open(BytesIO(requests.get(\"https://picsum.photos/300/200\").content))\n",+ "img = AGImage(pil_image)\n",+ "multi_modal_message = MultiModalMessage(content=[\"Can you describe the content of this image?\", img], source=\"User\")\n",+ "img"+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "The {py:class}`~autogen_agentchat.messages.TextMessage` and {py:class}`~autogen_agentchat.messages.MultiModalMessage` we have created can be passed to agents directly via the {py:class}`~autogen_agentchat.base.ChatAgent.on_messages` method, or as tasks given to a team {py:meth}`~autogen_agentchat.teams.BaseGroupChat.run` method. Messages are also used in the responses of an agent. We will explain these in more detail in [Agents](./agents.ipynb) and [Teams](./teams.ipynb)."+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "### Internal Events\n",+ "\n",+ "AgentChat also supports the concept of `events` - messages that are internal to an agent. These messages are used to communicate events and information on actions _within_ the agent itself, and belong to subclasses of the base class {py:class}`~autogen_agentchat.messages.BaseAgentEvent`.\n",+ "\n",+ "Examples of these include {py:class}`~autogen_agentchat.messages.ToolCallRequestEvent`, which indicates that a request was made to call a tool, and {py:class}`~autogen_agentchat.messages.ToolCallExecutionEvent`, which contains the results of tool calls.\n",+ "\n",+ "Typically, events are created by the agent itself and are contained in the {py:attr}`~autogen_agentchat.base.Response.inner_messages` field of the {py:class}`~autogen_agentchat.base.Response` returned from {py:class}`~autogen_agentchat.base.ChatAgent.on_messages`. If you are building a custom agent and have events that you want to communicate to other entities (e.g., a UI), you can include these in the {py:attr}`~autogen_agentchat.base.Response.inner_messages` field of the {py:class}`~autogen_agentchat.base.Response`. We will show examples of this in [Custom Agents](../custom-agents.ipynb).\n",+ "\n",+ "\n",+ "You can read about the full set of messages supported in AgentChat in the {py:mod}`~autogen_agentchat.messages` module. "+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "## Custom Message Types\n",+ "\n",+ "You can create custom message types by subclassing the base class {py:class}`~autogen_agentchat.messages.BaseChatMessage` or {py:class}`~autogen_agentchat.messages.BaseAgentEvent`. This allows you to define your own message formats and behaviors, tailored to your application. Custom message types are useful when you write custom agents."+ ]+ }+ ],+ "metadata": {+ "kernelspec": {+ "display_name": "agnext",+ "language": "python",+ "name": "python3"+ },+ "language_info": {+ "codemirror_mode": {+ "name": "ipython",+ "version": 3+ },+ "file_extension": ".py",+ "mimetype": "text/x-python",+ "name": "python",+ "nbconvert_exporter": "python",+ "pygments_lexer": "ipython3",+ "version": "3.11.9"+ }+ },+ "nbformat": 4,+ "nbformat_minor": 2}diff --git a/python/packages/autogen-core/docs/src/user-guide/agentchat-user-guide/tutorial/termination.ipynb b/python/packages/autogen-core/docs/src/user-guide/agentchat-user-guide/tutorial/termination.ipynbindex 8c9701550..f02ca26fc 100644--- a/python/packages/autogen-core/docs/src/user-guide/agentchat-user-guide/tutorial/termination.ipynb+++ b/python/packages/autogen-core/docs/src/user-guide/agentchat-user-guide/tutorial/termination.ipynb@@ -1,517 +1,517 @@{- "cells": [- {- "cell_type": "markdown",- "metadata": {},- "source": [- "# Termination \n",- "\n",- "In the previous section, we explored how to define agents, and organize them into teams that can solve tasks. However, a run can go on forever, and in many cases, we need to know _when_ to stop them. This is the role of the termination condition.\n",- "\n",- "AgentChat supports several termination condition by providing a base {py:class}`~autogen_agentchat.base.TerminationCondition` class and several implementations that inherit from it.\n",- "\n",- "A termination condition is a callable that takes a sequence of {py:class}`~autogen_agentchat.messages.AgentEvent` or {py:class}`~autogen_agentchat.messages.ChatMessage` objects **since the last time the condition was called**, and returns a {py:class}`~autogen_agentchat.messages.StopMessage` if the conversation should be terminated, or `None` otherwise.\n",- "Once a termination condition has been reached, it must be reset by calling {py:meth}`~autogen_agentchat.base.TerminationCondition.reset` before it can be used again.\n",- "\n",- "Some important things to note about termination conditions: \n",- "- They are stateful but reset automatically after each run ({py:meth}`~autogen_agentchat.base.TaskRunner.run` or {py:meth}`~autogen_agentchat.base.TaskRunner.run_stream`) is finished.\n",- "- They can be combined using the AND and OR operators.\n",- "\n",- "```{note}\n",- "For group chat teams (i.e., {py:class}`~autogen_agentchat.teams.RoundRobinGroupChat`,\n",- "{py:class}`~autogen_agentchat.teams.SelectorGroupChat`, and {py:class}`~autogen_agentchat.teams.Swarm`),\n",- "the termination condition is called after each agent responds.\n",- "While a response may contain multiple inner messages, the team calls its termination condition just once for all the messages from a single response.\n",- "So the condition is called with the \"delta sequence\" of messages since the last time it was called.\n",- "```"- ]- },- {- "cell_type": "markdown",- "metadata": {},- "source": [- "Built-In Termination Conditions: \n",- "1. {py:class}`~autogen_agentchat.conditions.MaxMessageTermination`: Stops after a specified number of messages have been produced, including both agent and task messages.\n",- "2. {py:class}`~autogen_agentchat.conditions.TextMentionTermination`: Stops when specific text or string is mentioned in a message (e.g., \"TERMINATE\").\n",- "3. {py:class}`~autogen_agentchat.conditions.TokenUsageTermination`: Stops when a certain number of prompt or completion tokens are used. This requires the agents to report token usage in their messages.\n",- "4. {py:class}`~autogen_agentchat.conditions.TimeoutTermination`: Stops after a specified duration in seconds.\n",- "5. {py:class}`~autogen_agentchat.conditions.HandoffTermination`: Stops when a handoff to a specific target is requested. Handoff messages can be used to build patterns such as {py:class}`~autogen_agentchat.teams.Swarm`. This is useful when you want to pause the run and allow application or user to provide input when an agent hands off to them.\n",- "6. {py:class}`~autogen_agentchat.conditions.SourceMatchTermination`: Stops after a specific agent responds.\n",- "7. {py:class}`~autogen_agentchat.conditions.ExternalTermination`: Enables programmatic control of termination from outside the run. This is useful for UI integration (e.g., \"Stop\" buttons in chat interfaces).\n",- "8. {py:class}`~autogen_agentchat.conditions.StopMessageTermination`: Stops when a {py:class}`~autogen_agentchat.messages.StopMessage` is produced by an agent.\n",- "9. {py:class}`~autogen_agentchat.conditions.TextMessageTermination`: Stops when a {py:class}`~autogen_agentchat.messages.TextMessage` is produced by an agent.\n",- "10. {py:class}`~autogen_agentchat.conditions.FunctionCallTermination`: Stops when a {py:class}`~autogen_agentchat.messages.ToolCallExecutionEvent` containing a {py:class}`~autogen_core.models.FunctionExecutionResult` with a matching name is produced by an agent."- ]- },- {- "cell_type": "markdown",- "metadata": {},- "source": [- "## Basic Usage\n",- "\n",- "To demonstrate the characteristics of termination conditions, we'll create a team consisting of two agents: a primary agent responsible for text generation and a critic agent that reviews and provides feedback on the generated text."- ]- },- {- "cell_type": "code",- "execution_count": null,- "metadata": {},- "outputs": [],- "source": [- "from autogen_agentchat.agents import AssistantAgent\n",- "from autogen_agentchat.conditions import MaxMessageTermination, TextMentionTermination\n",- "from autogen_agentchat.teams import RoundRobinGroupChat\n",- "from autogen_agentchat.ui import Console\n",- "from autogen_ext.models.openai import OpenAIChatCompletionClient\n",- "\n",- "model_client = OpenAIChatCompletionClient(\n",- " model=\"gpt-4o\",\n",- " temperature=1,\n",- " # api_key=\"sk-...\", # Optional if you have an OPENAI_API_KEY env variable set.\n",- ")\n",- "\n",- "# Create the primary agent.\n",- "primary_agent = AssistantAgent(\n",- " \"primary\",\n",- " model_client=model_client,\n",- " system_message=\"You are a helpful AI assistant.\",\n",- ")\n",- "\n",- "# Create the critic agent.\n",- "critic_agent = AssistantAgent(\n",- " \"critic\",\n",- " model_client=model_client,\n",- " system_message=\"Provide constructive feedback for every message. Respond with 'APPROVE' to when your feedbacks are addressed.\",\n",- ")"- ]- },- {- "cell_type": "markdown",- "metadata": {},- "source": [- "Let's explore how termination conditions automatically reset after each `run` or `run_stream` call, allowing the team to resume its conversation from where it left off."- ]- },- {- "cell_type": "code",- "execution_count": null,- "metadata": {},- "outputs": [- {- "name": "stdout",- "output_type": "stream",- "text": [- "---------- user ----------\n",- "Write a unique, Haiku about the weather in Paris\n",- "---------- primary ----------\n",- "Gentle rain whispers, \n",- "Cobblestones glisten softly— \n",- "Paris dreams in gray.\n",- "[Prompt tokens: 30, Completion tokens: 19]\n",- "---------- critic ----------\n",- "The Haiku captures the essence of a rainy day in Paris beautifully, and the imagery is vivid. However, it's important to ensure the use of the traditional 5-7-5 syllable structure for Haikus. Your current Haiku lines are composed of 4-7-5 syllables, which slightly deviates from the form. Consider revising the first line to fit the structure.\n",- "\n",- "For example:\n",- "Soft rain whispers down, \n",- "Cobblestones glisten softly — \n",- "Paris dreams in gray.\n",- "\n",- "This revision maintains the essence of your original lines while adhering to the traditional Haiku structure.\n",- "[Prompt tokens: 70, Completion tokens: 120]\n",- "---------- Summary ----------\n",- "Number of messages: 3\n",- "Finish reason: Maximum number of messages 3 reached, current message count: 3\n",- "Total prompt tokens: 100\n",- "Total completion tokens: 139\n",- "Duration: 3.34 seconds\n"- ]+ "cells": [+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "# Termination \n",+ "\n",+ "In the previous section, we explored how to define agents, and organize them into teams that can solve tasks. However, a run can go on forever, and in many cases, we need to know _when_ to stop them. This is the role of the termination condition.\n",+ "\n",+ "AgentChat supports several termination condition by providing a base {py:class}`~autogen_agentchat.base.TerminationCondition` class and several implementations that inherit from it.\n",+ "\n",+ "A termination condition is a callable that takes a sequence of {py:class}`~autogen_agentchat.messages.BaseAgentEvent` or {py:class}`~autogen_agentchat.messages.BaseChatMessage` objects **since the last time the condition was called**, and returns a {py:class}`~autogen_agentchat.messages.StopMessage` if the conversation should be terminated, or `None` otherwise.\n",+ "Once a termination condition has been reached, it must be reset by calling {py:meth}`~autogen_agentchat.base.TerminationCondition.reset` before it can be used again.\n",+ "\n",+ "Some important things to note about termination conditions: \n",+ "- They are stateful but reset automatically after each run ({py:meth}`~autogen_agentchat.base.TaskRunner.run` or {py:meth}`~autogen_agentchat.base.TaskRunner.run_stream`) is finished.\n",+ "- They can be combined using the AND and OR operators.\n",+ "\n",+ "```{note}\n",+ "For group chat teams (i.e., {py:class}`~autogen_agentchat.teams.RoundRobinGroupChat`,\n",+ "{py:class}`~autogen_agentchat.teams.SelectorGroupChat`, and {py:class}`~autogen_agentchat.teams.Swarm`),\n",+ "the termination condition is called after each agent responds.\n",+ "While a response may contain multiple inner messages, the team calls its termination condition just once for all the messages from a single response.\n",+ "So the condition is called with the \"delta sequence\" of messages since the last time it was called.\n",+ "```"+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "Built-In Termination Conditions: \n",+ "1. {py:class}`~autogen_agentchat.conditions.MaxMessageTermination`: Stops after a specified number of messages have been produced, including both agent and task messages.\n",+ "2. {py:class}`~autogen_agentchat.conditions.TextMentionTermination`: Stops when specific text or string is mentioned in a message (e.g., \"TERMINATE\").\n",+ "3. {py:class}`~autogen_agentchat.conditions.TokenUsageTermination`: Stops when a certain number of prompt or completion tokens are used. This requires the agents to report token usage in their messages.\n",+ "4. {py:class}`~autogen_agentchat.conditions.TimeoutTermination`: Stops after a specified duration in seconds.\n",+ "5. {py:class}`~autogen_agentchat.conditions.HandoffTermination`: Stops when a handoff to a specific target is requested. Handoff messages can be used to build patterns such as {py:class}`~autogen_agentchat.teams.Swarm`. This is useful when you want to pause the run and allow application or user to provide input when an agent hands off to them.\n",+ "6. {py:class}`~autogen_agentchat.conditions.SourceMatchTermination`: Stops after a specific agent responds.\n",+ "7. {py:class}`~autogen_agentchat.conditions.ExternalTermination`: Enables programmatic control of termination from outside the run. This is useful for UI integration (e.g., \"Stop\" buttons in chat interfaces).\n",+ "8. {py:class}`~autogen_agentchat.conditions.StopMessageTermination`: Stops when a {py:class}`~autogen_agentchat.messages.StopMessage` is produced by an agent.\n",+ "9. {py:class}`~autogen_agentchat.conditions.TextMessageTermination`: Stops when a {py:class}`~autogen_agentchat.messages.TextMessage` is produced by an agent.\n",+ "10. {py:class}`~autogen_agentchat.conditions.FunctionCallTermination`: Stops when a {py:class}`~autogen_agentchat.messages.ToolCallExecutionEvent` containing a {py:class}`~autogen_core.models.FunctionExecutionResult` with a matching name is produced by an agent."+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "## Basic Usage\n",+ "\n",+ "To demonstrate the characteristics of termination conditions, we'll create a team consisting of two agents: a primary agent responsible for text generation and a critic agent that reviews and provides feedback on the generated text."+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "metadata": {},+ "outputs": [],+ "source": [+ "from autogen_agentchat.agents import AssistantAgent\n",+ "from autogen_agentchat.conditions import MaxMessageTermination, TextMentionTermination\n",+ "from autogen_agentchat.teams import RoundRobinGroupChat\n",+ "from autogen_agentchat.ui import Console\n",+ "from autogen_ext.models.openai import OpenAIChatCompletionClient\n",+ "\n",+ "model_client = OpenAIChatCompletionClient(\n",+ " model=\"gpt-4o\",\n",+ " temperature=1,\n",+ " # api_key=\"sk-...\", # Optional if you have an OPENAI_API_KEY env variable set.\n",+ ")\n",+ "\n",+ "# Create the primary agent.\n",+ "primary_agent = AssistantAgent(\n",+ " \"primary\",\n",+ " model_client=model_client,\n",+ " system_message=\"You are a helpful AI assistant.\",\n",+ ")\n",+ "\n",+ "# Create the critic agent.\n",+ "critic_agent = AssistantAgent(\n",+ " \"critic\",\n",+ " model_client=model_client,\n",+ " system_message=\"Provide constructive feedback for every message. Respond with 'APPROVE' to when your feedbacks are addressed.\",\n",+ ")"+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "Let's explore how termination conditions automatically reset after each `run` or `run_stream` call, allowing the team to resume its conversation from where it left off."+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "metadata": {},+ "outputs": [+ {+ "name": "stdout",+ "output_type": "stream",+ "text": [+ "---------- user ----------\n",+ "Write a unique, Haiku about the weather in Paris\n",+ "---------- primary ----------\n",+ "Gentle rain whispers, \n",+ "Cobblestones glisten softly— \n",+ "Paris dreams in gray.\n",+ "[Prompt tokens: 30, Completion tokens: 19]\n",+ "---------- critic ----------\n",+ "The Haiku captures the essence of a rainy day in Paris beautifully, and the imagery is vivid. However, it's important to ensure the use of the traditional 5-7-5 syllable structure for Haikus. Your current Haiku lines are composed of 4-7-5 syllables, which slightly deviates from the form. Consider revising the first line to fit the structure.\n",+ "\n",+ "For example:\n",+ "Soft rain whispers down, \n",+ "Cobblestones glisten softly — \n",+ "Paris dreams in gray.\n",+ "\n",+ "This revision maintains the essence of your original lines while adhering to the traditional Haiku structure.\n",+ "[Prompt tokens: 70, Completion tokens: 120]\n",+ "---------- Summary ----------\n",+ "Number of messages: 3\n",+ "Finish reason: Maximum number of messages 3 reached, current message count: 3\n",+ "Total prompt tokens: 100\n",+ "Total completion tokens: 139\n",+ "Duration: 3.34 seconds\n"+ ]+ },+ {+ "data": {+ "text/plain": [+ "TaskResult(messages=[TextMessage(source='user', models_usage=None, content='Write a unique, Haiku about the weather in Paris'), TextMessage(source='primary', models_usage=RequestUsage(prompt_tokens=30, completion_tokens=19), content='Gentle rain whispers, \\nCobblestones glisten softly— \\nParis dreams in gray.'), TextMessage(source='critic', models_usage=RequestUsage(prompt_tokens=70, completion_tokens=120), content=\"The Haiku captures the essence of a rainy day in Paris beautifully, and the imagery is vivid. However, it's important to ensure the use of the traditional 5-7-5 syllable structure for Haikus. Your current Haiku lines are composed of 4-7-5 syllables, which slightly deviates from the form. Consider revising the first line to fit the structure.\\n\\nFor example:\\nSoft rain whispers down, \\nCobblestones glisten softly — \\nParis dreams in gray.\\n\\nThis revision maintains the essence of your original lines while adhering to the traditional Haiku structure.\")], stop_reason='Maximum number of messages 3 reached, current message count: 3')"+ ]+ },+ "execution_count": 4,+ "metadata": {},+ "output_type": "execute_result"+ }+ ],+ "source": [+ "max_msg_termination = MaxMessageTermination(max_messages=3)\n",+ "round_robin_team = RoundRobinGroupChat([primary_agent, critic_agent], termination_condition=max_msg_termination)\n",+ "\n",+ "# Use asyncio.run(...) if you are running this script as a standalone script.\n",+ "await Console(round_robin_team.run_stream(task=\"Write a unique, Haiku about the weather in Paris\"))"+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "The conversation stopped after reaching the maximum message limit. Since the primary agent didn't get to respond to the feedback, let's continue the conversation."+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "metadata": {},+ "outputs": [+ {+ "name": "stdout",+ "output_type": "stream",+ "text": [+ "---------- primary ----------\n",+ "Thank you for your feedback. Here is the revised Haiku:\n",+ "\n",+ "Soft rain whispers down, \n",+ "Cobblestones glisten softly — \n",+ "Paris dreams in gray.\n",+ "[Prompt tokens: 181, Completion tokens: 32]\n",+ "---------- critic ----------\n",+ "The revised Haiku now follows the traditional 5-7-5 syllable pattern, and it still beautifully captures the atmospheric mood of Paris in the rain. The imagery and flow are both clear and evocative. Well done on making the adjustment! \n",+ "\n",+ "APPROVE\n",+ "[Prompt tokens: 234, Completion tokens: 54]\n",+ "---------- primary ----------\n",+ "Thank you for your kind words and approval. I'm glad the revision meets your expectations and captures the essence of Paris. If you have any more requests or need further assistance, feel free to ask!\n",+ "[Prompt tokens: 279, Completion tokens: 39]\n",+ "---------- Summary ----------\n",+ "Number of messages: 3\n",+ "Finish reason: Maximum number of messages 3 reached, current message count: 3\n",+ "Total prompt tokens: 694\n",+ "Total completion tokens: 125\n",+ "Duration: 6.43 seconds\n"+ ]+ },+ {+ "data": {+ "text/plain": [+ "TaskResult(messages=[TextMessage(source='primary', models_usage=RequestUsage(prompt_tokens=181, completion_tokens=32), content='Thank you for your feedback. Here is the revised Haiku:\\n\\nSoft rain whispers down, \\nCobblestones glisten softly — \\nParis dreams in gray.'), TextMessage(source='critic', models_usage=RequestUsage(prompt_tokens=234, completion_tokens=54), content='The revised Haiku now follows the traditional 5-7-5 syllable pattern, and it still beautifully captures the atmospheric mood of Paris in the rain. The imagery and flow are both clear and evocative. Well done on making the adjustment! \\n\\nAPPROVE'), TextMessage(source='primary', models_usage=RequestUsage(prompt_tokens=279, completion_tokens=39), content=\"Thank you for your kind words and approval. I'm glad the revision meets your expectations and captures the essence of Paris. If you have any more requests or need further assistance, feel free to ask!\")], stop_reason='Maximum number of messages 3 reached, current message count: 3')"+ ]+ },+ "execution_count": 5,+ "metadata": {},+ "output_type": "execute_result"+ }+ ],+ "source": [+ "# Use asyncio.run(...) if you are running this script as a standalone script.\n",+ "await Console(round_robin_team.run_stream())"+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "The team continued from where it left off, allowing the primary agent to respond to the feedback."+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "## Combining Termination Conditions\n",+ "\n",+ "Let's show how termination conditions can be combined using the AND (`&`) and OR (`|`) operators to create more complex termination logic. For example, we'll create a team that stops either after 10 messages are generated or when the critic agent approves a message.\n"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "metadata": {},+ "outputs": [+ {+ "name": "stdout",+ "output_type": "stream",+ "text": [+ "---------- user ----------\n",+ "Write a unique, Haiku about the weather in Paris\n",+ "---------- primary ----------\n",+ "Spring breeze gently hums, \n",+ "Cherry blossoms in full bloom— \n",+ "Paris wakes to life.\n",+ "[Prompt tokens: 467, Completion tokens: 19]\n",+ "---------- critic ----------\n",+ "The Haiku beautifully captures the awakening of Paris in the spring. The imagery of a gentle spring breeze and cherry blossoms in full bloom effectively conveys the rejuvenating feel of the season. The final line, \"Paris wakes to life,\" encapsulates the renewed energy and vibrancy of the city. The Haiku adheres to the 5-7-5 syllable structure and portrays a vivid seasonal transformation in a concise and poetic manner. Excellent work!\n",+ "\n",+ "APPROVE\n",+ "[Prompt tokens: 746, Completion tokens: 93]\n",+ "---------- Summary ----------\n",+ "Number of messages: 3\n",+ "Finish reason: Text 'APPROVE' mentioned\n",+ "Total prompt tokens: 1213\n",+ "Total completion tokens: 112\n",+ "Duration: 2.75 seconds\n"+ ]+ },+ {+ "data": {+ "text/plain": [+ "TaskResult(messages=[TextMessage(source='user', models_usage=None, content='Write a unique, Haiku about the weather in Paris'), TextMessage(source='primary', models_usage=RequestUsage(prompt_tokens=467, completion_tokens=19), content='Spring breeze gently hums, \\nCherry blossoms in full bloom— \\nParis wakes to life.'), TextMessage(source='critic', models_usage=RequestUsage(prompt_tokens=746, completion_tokens=93), content='The Haiku beautifully captures the awakening of Paris in the spring. The imagery of a gentle spring breeze and cherry blossoms in full bloom effectively conveys the rejuvenating feel of the season. The final line, \"Paris wakes to life,\" encapsulates the renewed energy and vibrancy of the city. The Haiku adheres to the 5-7-5 syllable structure and portrays a vivid seasonal transformation in a concise and poetic manner. Excellent work!\\n\\nAPPROVE')], stop_reason=\"Text 'APPROVE' mentioned\")"+ ]+ },+ "execution_count": 9,+ "metadata": {},+ "output_type": "execute_result"+ }+ ],+ "source": [+ "max_msg_termination = MaxMessageTermination(max_messages=10)\n",+ "text_termination = TextMentionTermination(\"APPROVE\")\n",+ "combined_termination = max_msg_termination | text_termination\n",+ "\n",+ "round_robin_team = RoundRobinGroupChat([primary_agent, critic_agent], termination_condition=combined_termination)\n",+ "\n",+ "# Use asyncio.run(...) if you are running this script as a standalone script.\n",+ "await Console(round_robin_team.run_stream(task=\"Write a unique, Haiku about the weather in Paris\"))"+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "The conversation stopped after the critic agent approved the message, although it could have also stopped if 10 messages were generated.\n",+ "\n",+ "Alternatively, if we want to stop the run only when both conditions are met, we can use the AND (`&`) operator."+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "metadata": {},+ "outputs": [],+ "source": [+ "combined_termination = max_msg_termination & text_termination"+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "## Custom Termination Condition\n",+ "\n",+ "The built-in termination conditions are sufficient for most use cases.\n",+ "However, there may be cases where you need to implement a custom termination condition that doesn't fit into the existing ones.\n",+ "You can do this by subclassing the {py:class}`~autogen_agentchat.base.TerminationCondition` class.\n",+ "\n",+ "In this example, we create a custom termination condition that stops the conversation when\n",+ "a specific function call is made."+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "metadata": {},+ "outputs": [],+ "source": [+ "from typing import Sequence\n",+ "\n",+ "from autogen_agentchat.base import TerminatedException, TerminationCondition\n",+ "from autogen_agentchat.messages import BaseAgentEvent, BaseChatMessage, StopMessage, ToolCallExecutionEvent\n",+ "from autogen_core import Component\n",+ "from pydantic import BaseModel\n",+ "from typing_extensions import Self\n",+ "\n",+ "\n",+ "class FunctionCallTerminationConfig(BaseModel):\n",+ " \"\"\"Configuration for the termination condition to allow for serialization\n",+ " and deserialization of the component.\n",+ " \"\"\"\n",+ "\n",+ " function_name: str\n",+ "\n",+ "\n",+ "class FunctionCallTermination(TerminationCondition, Component[FunctionCallTerminationConfig]):\n",+ " \"\"\"Terminate the conversation if a FunctionExecutionResult with a specific name is received.\"\"\"\n",+ "\n",+ " component_config_schema = FunctionCallTerminationConfig\n",+ " \"\"\"The schema for the component configuration.\"\"\"\n",+ "\n",+ " def __init__(self, function_name: str) -> None:\n",+ " self._terminated = False\n",+ " self._function_name = function_name\n",+ "\n",+ " @property\n",+ " def terminated(self) -> bool:\n",+ " return self._terminated\n",+ "\n",+ " async def __call__(self, messages: Sequence[BaseAgentEvent | BaseChatMessage]) -> StopMessage | None:\n",+ " if self._terminated:\n",+ " raise TerminatedException(\"Termination condition has already been reached\")\n",+ " for message in messages:\n",+ " if isinstance(message, ToolCallExecutionEvent):\n",+ " for execution in message.content:\n",+ " if execution.name == self._function_name:\n",+ " self._terminated = True\n",+ " return StopMessage(\n",+ " content=f\"Function '{self._function_name}' was executed.\",\n",+ " source=\"FunctionCallTermination\",\n",+ " )\n",+ " return None\n",+ "\n",+ " async def reset(self) -> None:\n",+ " self._terminated = False\n",+ "\n",+ " def _to_config(self) -> FunctionCallTerminationConfig:\n",+ " return FunctionCallTerminationConfig(\n",+ " function_name=self._function_name,\n",+ " )\n",+ "\n",+ " @classmethod\n",+ " def _from_config(cls, config: FunctionCallTerminationConfig) -> Self:\n",+ " return cls(\n",+ " function_name=config.function_name,\n",+ " )"+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "Let's use this new termination condition to stop the conversation when the critic agent approves a message\n",+ "using the `approve` function call.\n",+ "\n",+ "First we create a simple function that will be called when the critic agent approves a message."+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 2,+ "metadata": {},+ "outputs": [],+ "source": [+ "def approve() -> None:\n",+ " \"\"\"Approve the message when all feedbacks have been addressed.\"\"\"\n",+ " pass"+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "Then we create the agents. The critic agent is equipped with the `approve` tool."+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 9,+ "metadata": {},+ "outputs": [],+ "source": [+ "from autogen_agentchat.agents import AssistantAgent\n",+ "from autogen_agentchat.teams import RoundRobinGroupChat\n",+ "from autogen_agentchat.ui import Console\n",+ "from autogen_ext.models.openai import OpenAIChatCompletionClient\n",+ "\n",+ "model_client = OpenAIChatCompletionClient(\n",+ " model=\"gpt-4o\",\n",+ " temperature=1,\n",+ " # api_key=\"sk-...\", # Optional if you have an OPENAI_API_KEY env variable set.\n",+ ")\n",+ "\n",+ "# Create the primary agent.\n",+ "primary_agent = AssistantAgent(\n",+ " \"primary\",\n",+ " model_client=model_client,\n",+ " system_message=\"You are a helpful AI assistant.\",\n",+ ")\n",+ "\n",+ "# Create the critic agent with the approve function as a tool.\n",+ "critic_agent = AssistantAgent(\n",+ " \"critic\",\n",+ " model_client=model_client,\n",+ " tools=[approve], # Register the approve function as a tool.\n",+ " system_message=\"Provide constructive feedback. Use the approve tool to approve when all feedbacks are addressed.\",\n",+ ")"+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "Now, we create the termination condition and the team.\n",+ "We run the team with the poem-writing task."+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 10,+ "metadata": {},+ "outputs": [+ {+ "name": "stdout",+ "output_type": "stream",+ "text": [+ "---------- user ----------\n",+ "Write a unique, Haiku about the weather in Paris\n",+ "---------- primary ----------\n",+ "Raindrops gently fall, \n",+ "Cobblestones shine in dim light— \n",+ "Paris dreams in grey. \n",+ "---------- critic ----------\n",+ "This Haiku beautifully captures a melancholic yet romantic image of Paris in the rain. The use of sensory imagery like \"Raindrops gently fall\" and \"Cobblestones shine\" effectively paints a vivid picture. It could be interesting to experiment with more distinct seasonal elements of Paris, such as incorporating the Seine River or iconic landmarks in the context of the weather. Overall, it successfully conveys the atmosphere of Paris in subtle, poetic imagery.\n",+ "---------- primary ----------\n",+ "Thank you for your feedback! I’m glad you enjoyed the imagery. Here’s another Haiku that incorporates iconic Parisian elements:\n",+ "\n",+ "Eiffel stands in mist, \n",+ "Seine's ripple mirrors the sky— \n",+ "Spring whispers anew. \n",+ "---------- critic ----------\n",+ "[FunctionCall(id='call_QEWJZ873EG4UIEpsQHi1HsAu', arguments='{}', name='approve')]\n",+ "---------- critic ----------\n",+ "[FunctionExecutionResult(content='None', name='approve', call_id='call_QEWJZ873EG4UIEpsQHi1HsAu', is_error=False)]\n",+ "---------- critic ----------\n",+ "None\n"+ ]+ },+ {+ "data": {+ "text/plain": [+ "TaskResult(messages=[TextMessage(source='user', models_usage=None, metadata={}, content='Write a unique, Haiku about the weather in Paris', type='TextMessage'), TextMessage(source='primary', models_usage=RequestUsage(prompt_tokens=30, completion_tokens=23), metadata={}, content='Raindrops gently fall, \\nCobblestones shine in dim light— \\nParis dreams in grey. ', type='TextMessage'), TextMessage(source='critic', models_usage=RequestUsage(prompt_tokens=99, completion_tokens=90), metadata={}, content='This Haiku beautifully captures a melancholic yet romantic image of Paris in the rain. The use of sensory imagery like \"Raindrops gently fall\" and \"Cobblestones shine\" effectively paints a vivid picture. It could be interesting to experiment with more distinct seasonal elements of Paris, such as incorporating the Seine River or iconic landmarks in the context of the weather. Overall, it successfully conveys the atmosphere of Paris in subtle, poetic imagery.', type='TextMessage'), TextMessage(source='primary', models_usage=RequestUsage(prompt_tokens=152, completion_tokens=48), metadata={}, content=\"Thank you for your feedback! I’m glad you enjoyed the imagery. Here’s another Haiku that incorporates iconic Parisian elements:\\n\\nEiffel stands in mist, \\nSeine's ripple mirrors the sky— \\nSpring whispers anew. \", type='TextMessage'), ToolCallRequestEvent(source='critic', models_usage=RequestUsage(prompt_tokens=246, completion_tokens=11), metadata={}, content=[FunctionCall(id='call_QEWJZ873EG4UIEpsQHi1HsAu', arguments='{}', name='approve')], type='ToolCallRequestEvent'), ToolCallExecutionEvent(source='critic', models_usage=None, metadata={}, content=[FunctionExecutionResult(content='None', name='approve', call_id='call_QEWJZ873EG4UIEpsQHi1HsAu', is_error=False)], type='ToolCallExecutionEvent'), ToolCallSummaryMessage(source='critic', models_usage=None, metadata={}, content='None', type='ToolCallSummaryMessage')], stop_reason=\"Function 'approve' was executed.\")"+ ]+ },+ "execution_count": 10,+ "metadata": {},+ "output_type": "execute_result"+ }+ ],+ "source": [+ "function_call_termination = FunctionCallTermination(function_name=\"approve\")\n",+ "round_robin_team = RoundRobinGroupChat([primary_agent, critic_agent], termination_condition=function_call_termination)\n",+ "\n",+ "# Use asyncio.run(...) if you are running this script as a standalone script.\n",+ "await Console(round_robin_team.run_stream(task=\"Write a unique, Haiku about the weather in Paris\"))\n",+ "await model_client.close()"+ ]+ },+ {+ "cell_type": "markdown",+ "metadata": {},+ "source": [+ "You can see that the conversation stopped when the critic agent approved the message using the `approve` function call."+ ]+ }+ ],+ "metadata": {+ "kernelspec": {+ "display_name": ".venv",+ "language": "python",+ "name": "python3"+ },+ "language_info": {+ "codemirror_mode": {+ "name": "ipython",+ "version": 3+ },+ "file_extension": ".py",+ "mimetype": "text/x-python",+ "name": "python",+ "nbconvert_exporter": "python",+ "pygments_lexer": "ipython3",+ "version": "3.12.9"+ }},- {- "data": {- "text/plain": [- "TaskResult(messages=[TextMessage(source='user', models_usage=None, content='Write a unique, Haiku about the weather in Paris'), TextMessage(source='primary', models_usage=RequestUsage(prompt_tokens=30, completion_tokens=19), content='Gentle rain whispers, \\nCobblestones glisten softly— \\nParis dreams in gray.'), TextMessage(source='critic', models_usage=RequestUsage(prompt_tokens=70, completion_tokens=120), content=\"The Haiku captures the essence of a rainy day in Paris beautifully, and the imagery is vivid. However, it's important to ensure the use of the traditional 5-7-5 syllable structure for Haikus. Your current Haiku lines are composed of 4-7-5 syllables, which slightly deviates from the form. Consider revising the first line to fit the structure.\\n\\nFor example:\\nSoft rain whispers down, \\nCobblestones glisten softly — \\nParis dreams in gray.\\n\\nThis revision maintains the essence of your original lines while adhering to the traditional Haiku structure.\")], stop_reason='Maximum number of messages 3 reached, current message count: 3')"- ]- },- "execution_count": 4,- "metadata": {},- "output_type": "execute_result"- }- ],- "source": [- "max_msg_termination = MaxMessageTermination(max_messages=3)\n",- "round_robin_team = RoundRobinGroupChat([primary_agent, critic_agent], termination_condition=max_msg_termination)\n",- "\n",- "# Use asyncio.run(...) if you are running this script as a standalone script.\n",- "await Console(round_robin_team.run_stream(task=\"Write a unique, Haiku about the weather in Paris\"))"- ]- },- {- "cell_type": "markdown",- "metadata": {},- "source": [- "The conversation stopped after reaching the maximum message limit. Since the primary agent didn't get to respond to the feedback, let's continue the conversation."- ]- },- {- "cell_type": "code",- "execution_count": null,- "metadata": {},- "outputs": [- {- "name": "stdout",- "output_type": "stream",- "text": [- "---------- primary ----------\n",- "Thank you for your feedback. Here is the revised Haiku:\n",- "\n",- "Soft rain whispers down, \n",- "Cobblestones glisten softly — \n",- "Paris dreams in gray.\n",- "[Prompt tokens: 181, Completion tokens: 32]\n",- "---------- critic ----------\n",- "The revised Haiku now follows the traditional 5-7-5 syllable pattern, and it still beautifully captures the atmospheric mood of Paris in the rain. The imagery and flow are both clear and evocative. Well done on making the adjustment! \n",- "\n",- "APPROVE\n",- "[Prompt tokens: 234, Completion tokens: 54]\n",- "---------- primary ----------\n",- "Thank you for your kind words and approval. I'm glad the revision meets your expectations and captures the essence of Paris. If you have any more requests or need further assistance, feel free to ask!\n",- "[Prompt tokens: 279, Completion tokens: 39]\n",- "---------- Summary ----------\n",- "Number of messages: 3\n",- "Finish reason: Maximum number of messages 3 reached, current message count: 3\n",- "Total prompt tokens: 694\n",- "Total completion tokens: 125\n",- "Duration: 6.43 seconds\n"- ]- },- {- "data": {- "text/plain": [- "TaskResult(messages=[TextMessage(source='primary', models_usage=RequestUsage(prompt_tokens=181, completion_tokens=32), content='Thank you for your feedback. Here is the revised Haiku:\\n\\nSoft rain whispers down, \\nCobblestones glisten softly — \\nParis dreams in gray.'), TextMessage(source='critic', models_usage=RequestUsage(prompt_tokens=234, completion_tokens=54), content='The revised Haiku now follows the traditional 5-7-5 syllable pattern, and it still beautifully captures the atmospheric mood of Paris in the rain. The imagery and flow are both clear and evocative. Well done on making the adjustment! \\n\\nAPPROVE'), TextMessage(source='primary', models_usage=RequestUsage(prompt_tokens=279, completion_tokens=39), content=\"Thank you for your kind words and approval. I'm glad the revision meets your expectations and captures the essence of Paris. If you have any more requests or need further assistance, feel free to ask!\")], stop_reason='Maximum number of messages 3 reached, current message count: 3')"- ]- },- "execution_count": 5,- "metadata": {},- "output_type": "execute_result"- }- ],- "source": [- "# Use asyncio.run(...) if you are running this script as a standalone script.\n",- "await Console(round_robin_team.run_stream())"- ]- },- {- "cell_type": "markdown",- "metadata": {},- "source": [- "The team continued from where it left off, allowing the primary agent to respond to the feedback."- ]- },- {- "cell_type": "markdown",- "metadata": {},- "source": [- "## Combining Termination Conditions\n",- "\n",- "Let's show how termination conditions can be combined using the AND (`&`) and OR (`|`) operators to create more complex termination logic. For example, we'll create a team that stops either after 10 messages are generated or when the critic agent approves a message.\n"- ]- },- {- "cell_type": "code",- "execution_count": null,- "metadata": {},- "outputs": [- {- "name": "stdout",- "output_type": "stream",- "text": [- "---------- user ----------\n",- "Write a unique, Haiku about the weather in Paris\n",- "---------- primary ----------\n",- "Spring breeze gently hums, \n",- "Cherry blossoms in full bloom— \n",- "Paris wakes to life.\n",- "[Prompt tokens: 467, Completion tokens: 19]\n",- "---------- critic ----------\n",- "The Haiku beautifully captures the awakening of Paris in the spring. The imagery of a gentle spring breeze and cherry blossoms in full bloom effectively conveys the rejuvenating feel of the season. The final line, \"Paris wakes to life,\" encapsulates the renewed energy and vibrancy of the city. The Haiku adheres to the 5-7-5 syllable structure and portrays a vivid seasonal transformation in a concise and poetic manner. Excellent work!\n",- "\n",- "APPROVE\n",- "[Prompt tokens: 746, Completion tokens: 93]\n",- "---------- Summary ----------\n",- "Number of messages: 3\n",- "Finish reason: Text 'APPROVE' mentioned\n",- "Total prompt tokens: 1213\n",- "Total completion tokens: 112\n",- "Duration: 2.75 seconds\n"- ]- },- {- "data": {- "text/plain": [- "TaskResult(messages=[TextMessage(source='user', models_usage=None, content='Write a unique, Haiku about the weather in Paris'), TextMessage(source='primary', models_usage=RequestUsage(prompt_tokens=467, completion_tokens=19), content='Spring breeze gently hums, \\nCherry blossoms in full bloom— \\nParis wakes to life.'), TextMessage(source='critic', models_usage=RequestUsage(prompt_tokens=746, completion_tokens=93), content='The Haiku beautifully captures the awakening of Paris in the spring. The imagery of a gentle spring breeze and cherry blossoms in full bloom effectively conveys the rejuvenating feel of the season. The final line, \"Paris wakes to life,\" encapsulates the renewed energy and vibrancy of the city. The Haiku adheres to the 5-7-5 syllable structure and portrays a vivid seasonal transformation in a concise and poetic manner. Excellent work!\\n\\nAPPROVE')], stop_reason=\"Text 'APPROVE' mentioned\")"- ]- },- "execution_count": 9,- "metadata": {},- "output_type": "execute_result"- }- ],- "source": [- "max_msg_termination = MaxMessageTermination(max_messages=10)\n",- "text_termination = TextMentionTermination(\"APPROVE\")\n",- "combined_termination = max_msg_termination | text_termination\n",- "\n",- "round_robin_team = RoundRobinGroupChat([primary_agent, critic_agent], termination_condition=combined_termination)\n",- "\n",- "# Use asyncio.run(...) if you are running this script as a standalone script.\n",- "await Console(round_robin_team.run_stream(task=\"Write a unique, Haiku about the weather in Paris\"))"- ]- },- {- "cell_type": "markdown",- "metadata": {},- "source": [- "The conversation stopped after the critic agent approved the message, although it could have also stopped if 10 messages were generated.\n",- "\n",- "Alternatively, if we want to stop the run only when both conditions are met, we can use the AND (`&`) operator."- ]- },- {- "cell_type": "code",- "execution_count": null,- "metadata": {},- "outputs": [],- "source": [- "combined_termination = max_msg_termination & text_termination"- ]- },- {- "cell_type": "markdown",- "metadata": {},- "source": [- "## Custom Termination Condition\n",- "\n",- "The built-in termination conditions are sufficient for most use cases.\n",- "However, there may be cases where you need to implement a custom termination condition that doesn't fit into the existing ones.\n",- "You can do this by subclassing the {py:class}`~autogen_agentchat.base.TerminationCondition` class.\n",- "\n",- "In this example, we create a custom termination condition that stops the conversation when\n",- "a specific function call is made."- ]- },- {- "cell_type": "code",- "execution_count": null,- "metadata": {},- "outputs": [],- "source": [- "from typing import Sequence\n",- "\n",- "from autogen_agentchat.base import TerminatedException, TerminationCondition\n",- "from autogen_agentchat.messages import AgentEvent, ChatMessage, StopMessage, ToolCallExecutionEvent\n",- "from autogen_core import Component\n",- "from pydantic import BaseModel\n",- "from typing_extensions import Self\n",- "\n",- "\n",- "class FunctionCallTerminationConfig(BaseModel):\n",- " \"\"\"Configuration for the termination condition to allow for serialization\n",- " and deserialization of the component.\n",- " \"\"\"\n",- "\n",- " function_name: str\n",- "\n",- "\n",- "class FunctionCallTermination(TerminationCondition, Component[FunctionCallTerminationConfig]):\n",- " \"\"\"Terminate the conversation if a FunctionExecutionResult with a specific name is received.\"\"\"\n",- "\n",- " component_config_schema = FunctionCallTerminationConfig\n",- " \"\"\"The schema for the component configuration.\"\"\"\n",- "\n",- " def __init__(self, function_name: str) -> None:\n",- " self._terminated = False\n",- " self._function_name = function_name\n",- "\n",- " @property\n",- " def terminated(self) -> bool:\n",- " return self._terminated\n",- "\n",- " async def __call__(self, messages: Sequence[AgentEvent | ChatMessage]) -> StopMessage | None:\n",- " if self._terminated:\n",- " raise TerminatedException(\"Termination condition has already been reached\")\n",- " for message in messages:\n",- " if isinstance(message, ToolCallExecutionEvent):\n",- " for execution in message.content:\n",- " if execution.name == self._function_name:\n",- " self._terminated = True\n",- " return StopMessage(\n",- " content=f\"Function '{self._function_name}' was executed.\",\n",- " source=\"FunctionCallTermination\",\n",- " )\n",- " return None\n",- "\n",- " async def reset(self) -> None:\n",- " self._terminated = False\n",- "\n",- " def _to_config(self) -> FunctionCallTerminationConfig:\n",- " return FunctionCallTerminationConfig(\n",- " function_name=self._function_name,\n",- " )\n",- "\n",- " @classmethod\n",- " def _from_config(cls, config: FunctionCallTerminationConfig) -> Self:\n",- " return cls(\n",- " function_name=config.function_name,\n",- " )"- ]- },- {- "cell_type": "markdown",- "metadata": {},- "source": [- "Let's use this new termination condition to stop the conversation when the critic agent approves a message\n",- "using the `approve` function call.\n",- "\n",- "First we create a simple function that will be called when the critic agent approves a message."- ]- },- {- "cell_type": "code",- "execution_count": 2,- "metadata": {},- "outputs": [],- "source": [- "def approve() -> None:\n",- " \"\"\"Approve the message when all feedbacks have been addressed.\"\"\"\n",- " pass"- ]- },- {- "cell_type": "markdown",- "metadata": {},- "source": [- "Then we create the agents. The critic agent is equipped with the `approve` tool."- ]- },- {- "cell_type": "code",- "execution_count": 9,- "metadata": {},- "outputs": [],- "source": [- "from autogen_agentchat.agents import AssistantAgent\n",- "from autogen_agentchat.teams import RoundRobinGroupChat\n",- "from autogen_agentchat.ui import Console\n",- "from autogen_ext.models.openai import OpenAIChatCompletionClient\n",- "\n",- "model_client = OpenAIChatCompletionClient(\n",- " model=\"gpt-4o\",\n",- " temperature=1,\n",- " # api_key=\"sk-...\", # Optional if you have an OPENAI_API_KEY env variable set.\n",- ")\n",- "\n",- "# Create the primary agent.\n",- "primary_agent = AssistantAgent(\n",- " \"primary\",\n",- " model_client=model_client,\n",- " system_message=\"You are a helpful AI assistant.\",\n",- ")\n",- "\n",- "# Create the critic agent with the approve function as a tool.\n",- "critic_agent = AssistantAgent(\n",- " \"critic\",\n",- " model_client=model_client,\n",- " tools=[approve], # Register the approve function as a tool.\n",- " system_message=\"Provide constructive feedback. Use the approve tool to approve when all feedbacks are addressed.\",\n",- ")"- ]- },- {- "cell_type": "markdown",- "metadata": {},- "source": [- "Now, we create the termination condition and the team.\n",- "We run the team with the poem-writing task."- ]- },- {- "cell_type": "code",- "execution_count": 10,- "metadata": {},- "outputs": [- {- "name": "stdout",- "output_type": "stream",- "text": [- "---------- user ----------\n",- "Write a unique, Haiku about the weather in Paris\n",- "---------- primary ----------\n",- "Raindrops gently fall, \n",- "Cobblestones shine in dim light— \n",- "Paris dreams in grey. \n",- "---------- critic ----------\n",- "This Haiku beautifully captures a melancholic yet romantic image of Paris in the rain. The use of sensory imagery like \"Raindrops gently fall\" and \"Cobblestones shine\" effectively paints a vivid picture. It could be interesting to experiment with more distinct seasonal elements of Paris, such as incorporating the Seine River or iconic landmarks in the context of the weather. Overall, it successfully conveys the atmosphere of Paris in subtle, poetic imagery.\n",- "---------- primary ----------\n",- "Thank you for your feedback! I’m glad you enjoyed the imagery. Here’s another Haiku that incorporates iconic Parisian elements:\n",- "\n",- "Eiffel stands in mist, \n",- "Seine's ripple mirrors the sky— \n",- "Spring whispers anew. \n",- "---------- critic ----------\n",- "[FunctionCall(id='call_QEWJZ873EG4UIEpsQHi1HsAu', arguments='{}', name='approve')]\n",- "---------- critic ----------\n",- "[FunctionExecutionResult(content='None', name='approve', call_id='call_QEWJZ873EG4UIEpsQHi1HsAu', is_error=False)]\n",- "---------- critic ----------\n",- "None\n"- ]- },- {- "data": {- "text/plain": [- "TaskResult(messages=[TextMessage(source='user', models_usage=None, metadata={}, content='Write a unique, Haiku about the weather in Paris', type='TextMessage'), TextMessage(source='primary', models_usage=RequestUsage(prompt_tokens=30, completion_tokens=23), metadata={}, content='Raindrops gently fall, \\nCobblestones shine in dim light— \\nParis dreams in grey. ', type='TextMessage'), TextMessage(source='critic', models_usage=RequestUsage(prompt_tokens=99, completion_tokens=90), metadata={}, content='This Haiku beautifully captures a melancholic yet romantic image of Paris in the rain. The use of sensory imagery like \"Raindrops gently fall\" and \"Cobblestones shine\" effectively paints a vivid picture. It could be interesting to experiment with more distinct seasonal elements of Paris, such as incorporating the Seine River or iconic landmarks in the context of the weather. Overall, it successfully conveys the atmosphere of Paris in subtle, poetic imagery.', type='TextMessage'), TextMessage(source='primary', models_usage=RequestUsage(prompt_tokens=152, completion_tokens=48), metadata={}, content=\"Thank you for your feedback! I’m glad you enjoyed the imagery. Here’s another Haiku that incorporates iconic Parisian elements:\\n\\nEiffel stands in mist, \\nSeine's ripple mirrors the sky— \\nSpring whispers anew. \", type='TextMessage'), ToolCallRequestEvent(source='critic', models_usage=RequestUsage(prompt_tokens=246, completion_tokens=11), metadata={}, content=[FunctionCall(id='call_QEWJZ873EG4UIEpsQHi1HsAu', arguments='{}', name='approve')], type='ToolCallRequestEvent'), ToolCallExecutionEvent(source='critic', models_usage=None, metadata={}, content=[FunctionExecutionResult(content='None', name='approve', call_id='call_QEWJZ873EG4UIEpsQHi1HsAu', is_error=False)], type='ToolCallExecutionEvent'), ToolCallSummaryMessage(source='critic', models_usage=None, metadata={}, content='None', type='ToolCallSummaryMessage')], stop_reason=\"Function 'approve' was executed.\")"- ]- },- "execution_count": 10,- "metadata": {},- "output_type": "execute_result"- }- ],- "source": [- "function_call_termination = FunctionCallTermination(function_name=\"approve\")\n",- "round_robin_team = RoundRobinGroupChat([primary_agent, critic_agent], termination_condition=function_call_termination)\n",- "\n",- "# Use asyncio.run(...) if you are running this script as a standalone script.\n",- "await Console(round_robin_team.run_stream(task=\"Write a unique, Haiku about the weather in Paris\"))\n",- "await model_client.close()"- ]- },- {- "cell_type": "markdown",- "metadata": {},- "source": [- "You can see that the conversation stopped when the critic agent approved the message using the `approve` function call."- ]- }- ],- "metadata": {- "kernelspec": {- "display_name": ".venv",- "language": "python",- "name": "python3"- },- "language_info": {- "codemirror_mode": {- "name": "ipython",- "version": 3- },- "file_extension": ".py",- "mimetype": "text/x-python",- "name": "python",- "nbconvert_exporter": "python",- "pygments_lexer": "ipython3",- "version": "3.12.7"- }- },- "nbformat": 4,- "nbformat_minor": 2+ "nbformat": 4,+ "nbformat_minor": 2}diff --git a/python/packages/autogen-core/src/autogen_core/tools/_base.py b/python/packages/autogen-core/src/autogen_core/tools/_base.pyindex 813065939..eb8909ada 100644--- a/python/packages/autogen-core/src/autogen_core/tools/_base.py+++ b/python/packages/autogen-core/src/autogen_core/tools/_base.py@@ -3,12 +3,11 @@ import loggingfrom abc import ABC, abstractmethodfrom collections.abc import Sequencefrom typing import Any, Dict, Generic, Mapping, Protocol, Type, TypeVar, cast, runtime_checkable-from typing_extensions import TypedDictimport jsonreffrom opentelemetry.trace import get_tracerfrom pydantic import BaseModel-from typing_extensions import NotRequired+from typing_extensions import NotRequired, TypedDictfrom .. import EVENT_LOGGER_NAME, CancellationTokenfrom .._component_config import ComponentBasediff --git a/python/packages/autogen-ext/src/autogen_ext/agents/file_surfer/_file_surfer.py b/python/packages/autogen-ext/src/autogen_ext/agents/file_surfer/_file_surfer.pyindex f569b8d96..91cd01720 100644--- a/python/packages/autogen-ext/src/autogen_ext/agents/file_surfer/_file_surfer.py+++ b/python/packages/autogen-ext/src/autogen_ext/agents/file_surfer/_file_surfer.py@@ -6,7 +6,7 @@ from typing import List, Sequence, Tuplefrom autogen_agentchat.agents import BaseChatAgentfrom autogen_agentchat.base import Responsefrom autogen_agentchat.messages import (- ChatMessage,+ BaseChatMessage,TextMessage,)from autogen_agentchat.utils import remove_images@@ -84,10 +84,10 @@ class FileSurfer(BaseChatAgent, Component[FileSurferConfig]):self._browser = MarkdownFileBrowser(viewport_size=1024 * 5, base_path=base_path)@property- def produced_message_types(self) -> Sequence[type[ChatMessage]]:+ def produced_message_types(self) -> Sequence[type[BaseChatMessage]]:return (TextMessage,)- async def on_messages(self, messages: Sequence[ChatMessage], cancellation_token: CancellationToken) -> Response:+ async def on_messages(self, messages: Sequence[BaseChatMessage], cancellation_token: CancellationToken) -> Response:for chat_message in messages:self._chat_history.append(chat_message.to_model_message())try:diff --git a/python/packages/autogen-ext/src/autogen_ext/agents/openai/_openai_assistant_agent.py b/python/packages/autogen-ext/src/autogen_ext/agents/openai/_openai_assistant_agent.pyindex 419c517b3..c2dc4670b 100644--- a/python/packages/autogen-ext/src/autogen_ext/agents/openai/_openai_assistant_agent.py+++ b/python/packages/autogen-ext/src/autogen_ext/agents/openai/_openai_assistant_agent.py@@ -24,8 +24,8 @@ from autogen_agentchat import EVENT_LOGGER_NAMEfrom autogen_agentchat.agents import BaseChatAgentfrom autogen_agentchat.base import Responsefrom autogen_agentchat.messages import (- AgentEvent,- ChatMessage,+ BaseAgentEvent,+ BaseChatMessage,TextMessage,ToolCallExecutionEvent,ToolCallRequestEvent,@@ -353,7 +353,7 @@ class OpenAIAssistantAgent(BaseChatAgent):self._initial_message_ids = initial_message_ids@property- def produced_message_types(self) -> Sequence[type[ChatMessage]]:+ def produced_message_types(self) -> Sequence[type[BaseChatMessage]]:"""The types of messages that the assistant agent produces."""return (TextMessage,)@@ -392,7 +392,7 @@ class OpenAIAssistantAgent(BaseChatAgent):result = await tool.run_json(arguments, cancellation_token)return tool.return_value_as_string(result)- async def on_messages(self, messages: Sequence[ChatMessage], cancellation_token: CancellationToken) -> Response:+ async def on_messages(self, messages: Sequence[BaseChatMessage], cancellation_token: CancellationToken) -> Response:"""Handle incoming messages and return a response."""async for message in self.on_messages_stream(messages, cancellation_token):@@ -401,8 +401,8 @@ class OpenAIAssistantAgent(BaseChatAgent):raise AssertionError("The stream should have returned the final result.")async def on_messages_stream(- self, messages: Sequence[ChatMessage], cancellation_token: CancellationToken- ) -> AsyncGenerator[AgentEvent | ChatMessage | Response, None]:+ self, messages: Sequence[BaseChatMessage], cancellation_token: CancellationToken+ ) -> AsyncGenerator[BaseAgentEvent | BaseChatMessage | Response, None]:"""Handle incoming messages and return a response."""await self._ensure_initialized()@@ -411,7 +411,7 @@ class OpenAIAssistantAgent(BaseChatAgent):await self.handle_incoming_message(message, cancellation_token)# Inner messages for tool calls- inner_messages: List[AgentEvent | ChatMessage] = []+ inner_messages: List[BaseAgentEvent | BaseChatMessage] = []# Create and start a runrun: Run = await cancellation_token.link_future(@@ -518,7 +518,7 @@ class OpenAIAssistantAgent(BaseChatAgent):chat_message = TextMessage(source=self.name, content=text_content[0].text.value)yield Response(chat_message=chat_message, inner_messages=inner_messages)- async def handle_incoming_message(self, message: ChatMessage, cancellation_token: CancellationToken) -> None:+ async def handle_incoming_message(self, message: BaseChatMessage, cancellation_token: CancellationToken) -> None:"""Handle regular text messages by adding them to the thread."""content: str | List[MessageContentPartParam] | None = Nonellm_message = message.to_model_message()diff --git a/python/packages/autogen-ext/src/autogen_ext/agents/web_surfer/_multimodal_web_surfer.py b/python/packages/autogen-ext/src/autogen_ext/agents/web_surfer/_multimodal_web_surfer.pyindex 8e48f187d..e833a27ce 100644--- a/python/packages/autogen-ext/src/autogen_ext/agents/web_surfer/_multimodal_web_surfer.py+++ b/python/packages/autogen-ext/src/autogen_ext/agents/web_surfer/_multimodal_web_surfer.py@@ -24,7 +24,7 @@ import aiofilesimport PIL.Imagefrom autogen_agentchat.agents import BaseChatAgentfrom autogen_agentchat.base import Response-from autogen_agentchat.messages import AgentEvent, ChatMessage, MultiModalMessage, TextMessage+from autogen_agentchat.messages import BaseAgentEvent, BaseChatMessage, MultiModalMessage, TextMessagefrom autogen_agentchat.utils import content_to_str, remove_imagesfrom autogen_core import EVENT_LOGGER_NAME, CancellationToken, Component, ComponentModel, FunctionCallfrom autogen_core import Image as AGImage@@ -385,7 +385,7 @@ class MultimodalWebSurfer(BaseChatAgent, Component[MultimodalWebSurferConfig]):)@property- def produced_message_types(self) -> Sequence[type[ChatMessage]]:+ def produced_message_types(self) -> Sequence[type[BaseChatMessage]]:return (MultiModalMessage,)async def on_reset(self, cancellation_token: CancellationToken) -> None:@@ -422,19 +422,19 @@ class MultimodalWebSurfer(BaseChatAgent, Component[MultimodalWebSurferConfig]):))- async def on_messages(self, messages: Sequence[ChatMessage], cancellation_token: CancellationToken) -> Response:+ async def on_messages(self, messages: Sequence[BaseChatMessage], cancellation_token: CancellationToken) -> Response:async for message in self.on_messages_stream(messages, cancellation_token):if isinstance(message, Response):return messageraise AssertionError("The stream should have returned the final result.")async def on_messages_stream(- self, messages: Sequence[ChatMessage], cancellation_token: CancellationToken- ) -> AsyncGenerator[AgentEvent | ChatMessage | Response, None]:+ self, messages: Sequence[BaseChatMessage], cancellation_token: CancellationToken+ ) -> AsyncGenerator[BaseAgentEvent | BaseChatMessage | Response, None]:for chat_message in messages:self._chat_history.append(chat_message.to_model_message())- self.inner_messages: List[AgentEvent | ChatMessage] = []+ self.inner_messages: List[BaseAgentEvent | BaseChatMessage] = []self.model_usage: List[RequestUsage] = []try:content = await self._generate_reply(cancellation_token=cancellation_token)diff --git a/python/packages/autogen-ext/src/autogen_ext/experimental/task_centric_memory/utils/apprentice.py b/python/packages/autogen-ext/src/autogen_ext/experimental/task_centric_memory/utils/apprentice.pyindex 8619d7ae7..b212628ec 100644--- a/python/packages/autogen-ext/src/autogen_ext/experimental/task_centric_memory/utils/apprentice.py+++ b/python/packages/autogen-ext/src/autogen_ext/experimental/task_centric_memory/utils/apprentice.py@@ -4,7 +4,7 @@ from typing import TYPE_CHECKING, Any, List, Sequence, Tuple, TypedDictfrom autogen_agentchat.agents import AssistantAgentfrom autogen_agentchat.base import TaskResult-from autogen_agentchat.messages import AgentEvent, ChatMessage, TextMessage+from autogen_agentchat.messages import BaseAgentEvent, BaseChatMessage, TextMessagefrom autogen_core.models import (ChatCompletionClient,LLMMessage,@@ -190,8 +190,8 @@ In responding to every user message, you follow the same multi-step process give# Get the agent's response to the task.task_result: TaskResult = await assistant_agent.run(task=TextMessage(content=task, source="User"))- messages: Sequence[AgentEvent | ChatMessage] = task_result.messages- message: AgentEvent | ChatMessage = messages[-1]+ messages: Sequence[BaseAgentEvent | BaseChatMessage] = task_result.messages+ message: BaseAgentEvent | BaseChatMessage = messages[-1]response_str = message.to_text()# Log the model calldiff --git a/python/packages/autogen-ext/src/autogen_ext/experimental/task_centric_memory/utils/page_logger.py b/python/packages/autogen-ext/src/autogen_ext/experimental/task_centric_memory/utils/page_logger.pyindex 806524ad8..fa7fe2f1d 100644--- a/python/packages/autogen-ext/src/autogen_ext/experimental/task_centric_memory/utils/page_logger.py+++ b/python/packages/autogen-ext/src/autogen_ext/experimental/task_centric_memory/utils/page_logger.py@@ -5,7 +5,7 @@ import shutilfrom typing import Any, Dict, List, Mapping, Optional, Sequence, TypedDictfrom autogen_agentchat.base import TaskResult-from autogen_agentchat.messages import AgentEvent, ChatMessage+from autogen_agentchat.messages import BaseAgentEvent, BaseChatMessagefrom autogen_core import Imagefrom autogen_core.models import (AssistantMessage,@@ -343,7 +343,7 @@ class PageLogger:if self.level > self.levels["INFO"]:return None- messages: Sequence[AgentEvent | ChatMessage] = task_result.messages+ messages: Sequence[BaseAgentEvent | BaseChatMessage] = task_result.messagesmessage = messages[-1]response_str = message.to_text()if not isinstance(response_str, str):diff --git a/python/packages/autogen-ext/src/autogen_ext/ui/_rich_console.py b/python/packages/autogen-ext/src/autogen_ext/ui/_rich_console.pyindex 3614a25c7..04299ab06 100644--- a/python/packages/autogen-ext/src/autogen_ext/ui/_rich_console.py+++ b/python/packages/autogen-ext/src/autogen_ext/ui/_rich_console.py@@ -14,8 +14,8 @@ from typing import (from autogen_agentchat.base import Response, TaskResultfrom autogen_agentchat.messages import (- AgentEvent,- ChatMessage,+ BaseAgentEvent,+ BaseChatMessage,ModelClientStreamingChunkEvent,MultiModalMessage,UserInputRequestedEvent,@@ -56,7 +56,7 @@ def aprint(output: str, end: str = "\n") -> Awaitable[None]:return asyncio.to_thread(print, output, end=end)-def _extract_message_content(message: AgentEvent | ChatMessage) -> Tuple[List[str], List[Image]]:+def _extract_message_content(message: BaseAgentEvent | BaseChatMessage) -> Tuple[List[str], List[Image]]:if isinstance(message, MultiModalMessage):text_parts = [item for item in message.content if isinstance(item, str)]image_parts = [item for item in message.content if isinstance(item, Image)]@@ -100,7 +100,7 @@ async def _aprint_message_content(async def RichConsole(- stream: AsyncGenerator[AgentEvent | ChatMessage | T, None],+ stream: AsyncGenerator[BaseAgentEvent | BaseChatMessage | T, None],*,no_inline_images: bool = False,output_stats: bool = False,@@ -117,7 +117,7 @@ async def RichConsole(It will be improved in future releases.Args:- stream (AsyncGenerator[AgentEvent | ChatMessage | TaskResult, None] | AsyncGenerator[AgentEvent | ChatMessage | Response, None]): Message stream to render.+ stream (AsyncGenerator[BaseAgentEvent | BaseChatMessage | TaskResult, None] | AsyncGenerator[BaseAgentEvent | BaseChatMessage | Response, None]): Message stream to render.This can be from :meth:`~autogen_agentchat.base.TaskRunner.run_stream` or :meth:`~autogen_agentchat.base.ChatAgent.on_messages_stream`.no_inline_images (bool, optional): If terminal is iTerm2 will render images inline. Use this to disable this behavior. Defaults to False.output_stats (bool, optional): (Experimental) If True, will output a summary of the messages and inline token usage info. Defaults to False.@@ -191,7 +191,7 @@ async def RichConsole(passelse:# Cast required for mypy to be happy- message = cast(AgentEvent | ChatMessage, message) # type: ignore+ message = cast(BaseAgentEvent | BaseChatMessage, message) # type: ignoretext_parts, image_parts = _extract_message_content(message)# Add usage stats if neededdiff --git a/python/packages/autogen-ext/tests/test_openai_assistant_agent.py b/python/packages/autogen-ext/tests/test_openai_assistant_agent.pyindex 2213d6f6a..d170e6b7f 100644--- a/python/packages/autogen-ext/tests/test_openai_assistant_agent.py+++ b/python/packages/autogen-ext/tests/test_openai_assistant_agent.py@@ -8,7 +8,7 @@ from unittest.mock import AsyncMock, MagicMockimport aiofilesimport pytest-from autogen_agentchat.messages import ChatMessage, TextMessage, ToolCallRequestEvent+from autogen_agentchat.messages import BaseChatMessage, TextMessage, ToolCallRequestEventfrom autogen_core import CancellationTokenfrom autogen_core.tools._base import BaseTool, Toolfrom autogen_ext.agents.openai import OpenAIAssistantAgent@@ -81,7 +81,7 @@ class FakeMessage:class FakeCursorPage:- def __init__(self, data: List[ChatMessage | FakeMessage]) -> None:+ def __init__(self, data: List[BaseChatMessage | FakeMessage]) -> None:self.data = datadef has_next_page(self) -> bool:diff --git a/python/packages/autogen-studio/autogenstudio/teammanager/teammanager.py b/python/packages/autogen-studio/autogenstudio/teammanager/teammanager.pyindex 96dbaec10..433074c2a 100644--- a/python/packages/autogen-studio/autogenstudio/teammanager/teammanager.py+++ b/python/packages/autogen-studio/autogenstudio/teammanager/teammanager.py@@ -10,7 +10,7 @@ import aiofilesimport yamlfrom autogen_agentchat.agents import UserProxyAgentfrom autogen_agentchat.base import TaskResult, Team-from autogen_agentchat.messages import AgentEvent, ChatMessage+from autogen_agentchat.messages import BaseAgentEvent, BaseChatMessagefrom autogen_agentchat.teams import BaseGroupChatfrom autogen_core import EVENT_LOGGER_NAME, CancellationToken, Component, ComponentModelfrom autogen_core.logging import LLMCallEvent@@ -102,7 +102,7 @@ class TeamManager:input_func: Optional[Callable] = None,cancellation_token: Optional[CancellationToken] = None,env_vars: Optional[List[EnvironmentVariable]] = None,- ) -> AsyncGenerator[Union[AgentEvent | ChatMessage | LLMCallEvent, ChatMessage, TeamResult], None]:+ ) -> AsyncGenerator[Union[BaseAgentEvent | BaseChatMessage | LLMCallEvent, BaseChatMessage, TeamResult], None]:"""Stream team execution results"""start_time = time.time()team = Nonediff --git a/python/packages/autogen-studio/autogenstudio/web/managers/connection.py b/python/packages/autogen-studio/autogenstudio/web/managers/connection.pyindex 458620464..99d59cf50 100644--- a/python/packages/autogen-studio/autogenstudio/web/managers/connection.py+++ b/python/packages/autogen-studio/autogenstudio/web/managers/connection.py@@ -6,8 +6,8 @@ from typing import Any, Callable, Dict, Optional, Unionfrom autogen_agentchat.base._task import TaskResultfrom autogen_agentchat.messages import (- AgentEvent,- ChatMessage,+ BaseAgentEvent,+ BaseChatMessage,HandoffMessage,ModelClientStreamingChunkEvent,MultiModalMessage,@@ -160,7 +160,9 @@ class WebSocketManager:finally:self._cancellation_tokens.pop(run_id, None)- async def _save_message(self, run_id: int, message: Union[AgentEvent | ChatMessage, ChatMessage]) -> None:+ async def _save_message(+ self, run_id: int, message: Union[BaseAgentEvent | BaseChatMessage, BaseChatMessage]+ ) -> None:"""Save a message to the database"""run = await self._get_run(run_id)