A programming framework for agentic AI
Document custom message types in teams API docs (#6400)
Eric Zhu653bcc5876d3
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 60b18df9f..3b637d459 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@@ -47,6 +47,9 @@ class MagenticOneGroupChat(BaseGroupChat, Component[MagenticOneGroupChatConfig])max_turns (int, optional): The maximum number of turns in the group chat before stopping. Defaults to 20.max_stalls (int, optional): The maximum number of stalls allowed before re-planning. Defaults to 3.final_answer_prompt (str, optional): The LLM prompt used to generate the final answer or response from the team's transcript. A default (sensible for GPT-4o class models) is provided.+ custom_message_types (List[type[BaseAgentEvent | BaseChatMessage]], optional): A list of custom message types that will be used in the group chat.+ If you are using custom message types or your agents produces custom message types, you need to specify them here.+ Make sure your custom message types are subclasses of :class:`~autogen_agentchat.messages.BaseAgentEvent` or :class:`~autogen_agentchat.messages.BaseChatMessage`.emit_team_events (bool, optional): Whether to emit team events through :meth:`BaseGroupChat.run_stream`. Defaults to False.Raises:@@ -105,6 +108,7 @@ class MagenticOneGroupChat(BaseGroupChat, Component[MagenticOneGroupChatConfig])runtime: AgentRuntime | None = None,max_stalls: int = 3,final_answer_prompt: str = ORCHESTRATOR_FINAL_ANSWER_PROMPT,+ custom_message_types: List[type[BaseAgentEvent | BaseChatMessage]] | None = None,emit_team_events: bool = False,):super().__init__(@@ -114,6 +118,7 @@ class MagenticOneGroupChat(BaseGroupChat, Component[MagenticOneGroupChatConfig])termination_condition=termination_condition,max_turns=max_turns,runtime=runtime,+ custom_message_types=custom_message_types,emit_team_events=emit_team_events,)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 915490c20..6ea915511 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@@ -97,6 +97,9 @@ class RoundRobinGroupChat(BaseGroupChat, Component[RoundRobinGroupChatConfig]):termination_condition (TerminationCondition, optional): The termination condition for the group chat. Defaults to None.Without a termination condition, the group chat will run indefinitely.max_turns (int, optional): The maximum number of turns in the group chat before stopping. Defaults to None, meaning no limit.+ custom_message_types (List[type[BaseAgentEvent | BaseChatMessage]], optional): A list of custom message types that will be used in the group chat.+ If you are using custom message types or your agents produces custom message types, you need to specify them here.+ Make sure your custom message types are subclasses of :class:`~autogen_agentchat.messages.BaseAgentEvent` or :class:`~autogen_agentchat.messages.BaseChatMessage`.emit_team_events (bool, optional): Whether to emit team events through :meth:`BaseGroupChat.run_stream`. Defaults to False.Raises: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 b55d4c4fe..c43ab85b8 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@@ -344,6 +344,9 @@ class SelectorGroupChat(BaseGroupChat, Component[SelectorGroupChatConfig]):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.+ custom_message_types (List[type[BaseAgentEvent | BaseChatMessage]], optional): A list of custom message types that will be used in the group chat.+ If you are using custom message types or your agents produces custom message types, you need to specify them here.+ Make sure your custom message types are subclasses of :class:`~autogen_agentchat.messages.BaseAgentEvent` or :class:`~autogen_agentchat.messages.BaseChatMessage`.emit_team_events (bool, optional): Whether to emit team events through :meth:`BaseGroupChat.run_stream`. Defaults to False.model_client_streaming (bool, optional): Whether to use streaming for the model client. (This is useful for reasoning models like QwQ). Defaults to False.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 1c0637cd1..7842e4c46 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@@ -129,6 +129,9 @@ class Swarm(BaseGroupChat, Component[SwarmConfig]):termination_condition (TerminationCondition, optional): The termination condition for the group chat. Defaults to None.Without a termination condition, the group chat will run indefinitely.max_turns (int, optional): The maximum number of turns in the group chat before stopping. Defaults to None, meaning no limit.+ custom_message_types (List[type[BaseAgentEvent | BaseChatMessage]], optional): A list of custom message types that will be used in the group chat.+ If you are using custom message types or your agents produces custom message types, you need to specify them here.+ Make sure your custom message types are subclasses of :class:`~autogen_agentchat.messages.BaseAgentEvent` or :class:`~autogen_agentchat.messages.BaseChatMessage`.emit_team_events (bool, optional): Whether to emit team events through :meth:`BaseGroupChat.run_stream`. Defaults to False.Basic example: