wehub-resource-sync
229 lines
8.3 KiB
Python
229 lines
8.3 KiB
Python
# Copyright (c) Microsoft. All rights reserved.
|
|
|
|
import logging
|
|
from collections.abc import AsyncIterable
|
|
from copy import deepcopy
|
|
from typing import TYPE_CHECKING, Any, cast
|
|
|
|
from pydantic import Field
|
|
|
|
from semantic_kernel.agents import Agent, AgentChat
|
|
from semantic_kernel.agents.strategies import (
|
|
DefaultTerminationStrategy,
|
|
SequentialSelectionStrategy,
|
|
)
|
|
from semantic_kernel.agents.strategies.selection.selection_strategy import SelectionStrategy
|
|
from semantic_kernel.agents.strategies.termination.termination_strategy import TerminationStrategy
|
|
from semantic_kernel.contents.chat_message_content import ChatMessageContent
|
|
from semantic_kernel.contents.history_reducer.chat_history_reducer import ChatHistoryReducer
|
|
from semantic_kernel.contents.utils.author_role import AuthorRole
|
|
from semantic_kernel.exceptions.agent_exceptions import AgentChatException
|
|
from semantic_kernel.utils.feature_stage_decorator import experimental
|
|
|
|
if TYPE_CHECKING:
|
|
from semantic_kernel.contents.chat_history import ChatHistory
|
|
|
|
logger: logging.Logger = logging.getLogger(__name__)
|
|
|
|
|
|
@experimental
|
|
class AgentGroupChat(AgentChat):
|
|
"""An agent chat that supports multi-turn interactions."""
|
|
|
|
agent_ids: set[str]
|
|
agents: list[Agent] = Field(default_factory=list)
|
|
|
|
is_complete: bool = False
|
|
termination_strategy: TerminationStrategy = Field(
|
|
default_factory=DefaultTerminationStrategy,
|
|
description="The termination strategy to use. The default strategy never terminates and has a max iterations of 5.", # noqa: E501
|
|
)
|
|
selection_strategy: SelectionStrategy = Field(default_factory=SequentialSelectionStrategy)
|
|
|
|
def __init__(
|
|
self,
|
|
agents: list[Agent] | None = None,
|
|
termination_strategy: TerminationStrategy | None = None,
|
|
selection_strategy: SelectionStrategy | None = None,
|
|
chat_history: "ChatHistory | None" = None,
|
|
) -> None:
|
|
"""Initialize a new instance of AgentGroupChat.
|
|
|
|
Args:
|
|
agents: The agents to add to the group chat.
|
|
termination_strategy: The termination strategy to use.
|
|
selection_strategy: The selection strategy
|
|
chat_history: The chat history.
|
|
"""
|
|
agent_ids = {agent.id for agent in agents} if agents else set()
|
|
|
|
if agents is None:
|
|
agents = []
|
|
|
|
args: dict[str, Any] = {
|
|
"agents": agents,
|
|
"agent_ids": agent_ids,
|
|
}
|
|
|
|
if termination_strategy is not None:
|
|
args["termination_strategy"] = termination_strategy
|
|
if selection_strategy is not None:
|
|
args["selection_strategy"] = selection_strategy
|
|
if chat_history is not None:
|
|
args["history"] = chat_history
|
|
|
|
super().__init__(**args)
|
|
|
|
def add_agent(self, agent: Agent) -> None:
|
|
"""Add an agent to the group chat.
|
|
|
|
Args:
|
|
agent: The agent to add.
|
|
"""
|
|
if agent.id not in self.agent_ids:
|
|
self.agent_ids.add(agent.id)
|
|
self.agents.append(agent)
|
|
|
|
async def invoke_single_turn(self, agent: Agent) -> AsyncIterable[ChatMessageContent]:
|
|
"""Invoke the agent chat for a single turn.
|
|
|
|
Args:
|
|
agent: The agent to invoke.
|
|
|
|
Yields:
|
|
The chat message.
|
|
"""
|
|
async for message in self.invoke(agent, is_joining=True):
|
|
if message.role == AuthorRole.ASSISTANT:
|
|
task = self.termination_strategy.should_terminate(agent, self.history.messages)
|
|
self.is_complete = await task
|
|
yield message
|
|
|
|
async def invoke_stream_single_turn(self, agent: Agent) -> AsyncIterable[ChatMessageContent]:
|
|
"""Invoke the agent chat for a single turn.
|
|
|
|
Args:
|
|
agent: The agent to invoke.
|
|
|
|
Yields:
|
|
The chat message.
|
|
"""
|
|
async for message in self.invoke_stream(agent, is_joining=True):
|
|
yield message
|
|
|
|
self.is_complete = await self.termination_strategy.should_terminate(agent, self.history.messages)
|
|
|
|
async def invoke(self, agent: Agent | None = None, is_joining: bool = True) -> AsyncIterable[ChatMessageContent]:
|
|
"""Invoke the agent chat asynchronously.
|
|
|
|
Handles both group interactions and single agent interactions based on the provided arguments.
|
|
|
|
Args:
|
|
agent: The agent to invoke. If not provided, the method processes all agents in the chat.
|
|
is_joining: Controls whether the agent joins the chat. Defaults to True.
|
|
|
|
Yields:
|
|
The chat message.
|
|
"""
|
|
if agent is not None:
|
|
if is_joining:
|
|
self.add_agent(agent)
|
|
|
|
async for message in super().invoke_agent(agent):
|
|
if message.role == AuthorRole.ASSISTANT:
|
|
task = self.termination_strategy.should_terminate(agent, self.history.messages)
|
|
self.is_complete = await task
|
|
yield message
|
|
|
|
return
|
|
|
|
if not self.agents:
|
|
raise AgentChatException("No agents are available")
|
|
|
|
if self.is_complete:
|
|
if not self.termination_strategy.automatic_reset:
|
|
raise AgentChatException("Chat is already complete")
|
|
|
|
self.is_complete = False
|
|
|
|
for _ in range(self.termination_strategy.maximum_iterations):
|
|
try:
|
|
selected_agent = await self.selection_strategy.next(self.agents, self.history.messages)
|
|
except Exception as ex:
|
|
logger.error(f"Failed to select agent: {ex}")
|
|
raise AgentChatException("Failed to select agent") from ex
|
|
|
|
async for message in super().invoke_agent(selected_agent):
|
|
if message.role == AuthorRole.ASSISTANT:
|
|
task = self.termination_strategy.should_terminate(selected_agent, self.history.messages)
|
|
self.is_complete = await task
|
|
yield message
|
|
|
|
if self.is_complete:
|
|
break
|
|
|
|
async def invoke_stream(
|
|
self, agent: Agent | None = None, is_joining: bool = True
|
|
) -> AsyncIterable[ChatMessageContent]:
|
|
"""Invoke the agent chat stream asynchronously.
|
|
|
|
Handles both group interactions and single agent interactions based on the provided arguments.
|
|
|
|
Args:
|
|
agent: The agent to invoke. If not provided, the method processes all agents in the chat.
|
|
is_joining: Controls whether the agent joins the chat. Defaults to True.
|
|
|
|
Yields:
|
|
The chat message.
|
|
"""
|
|
if agent is not None:
|
|
if is_joining:
|
|
self.add_agent(agent)
|
|
|
|
async for message in super().invoke_agent_stream(agent):
|
|
if message.role == AuthorRole.ASSISTANT:
|
|
task = self.termination_strategy.should_terminate(agent, self.history.messages)
|
|
self.is_complete = await task
|
|
yield message
|
|
|
|
return
|
|
|
|
if not self.agents:
|
|
raise AgentChatException("No agents are available")
|
|
|
|
if self.is_complete:
|
|
if not self.termination_strategy.automatic_reset:
|
|
raise AgentChatException("Chat is already complete")
|
|
|
|
self.is_complete = False
|
|
|
|
for _ in range(self.termination_strategy.maximum_iterations):
|
|
try:
|
|
selected_agent = await self.selection_strategy.next(self.agents, self.history.messages)
|
|
except Exception as ex:
|
|
logger.error(f"Failed to select agent: {ex}")
|
|
raise AgentChatException("Failed to select agent") from ex
|
|
|
|
async for message in super().invoke_agent_stream(selected_agent):
|
|
yield message
|
|
|
|
self.is_complete = await self.termination_strategy.should_terminate(selected_agent, self.history.messages)
|
|
|
|
if self.is_complete:
|
|
break
|
|
|
|
async def reduce_history(self) -> bool:
|
|
"""Perform the reduction on the provided history, returning True if reduction occurred."""
|
|
if not isinstance(self.history, ChatHistoryReducer):
|
|
return False
|
|
|
|
result = await self.history.reduce()
|
|
if result is None:
|
|
return False
|
|
|
|
reducer = cast(ChatHistoryReducer, result)
|
|
reduced_history = deepcopy(reducer.messages)
|
|
await self.reset()
|
|
await self.add_chat_messages(reduced_history)
|
|
return True
|