Skip to content

A programming framework for agentic AI

Add module for common messages (#133)

gagb8901b4d224a0
diff --git a/python/teams/team-one/examples/example_coder.py b/python/teams/team-one/examples/example_coder.py
index 3d304ecce..a1e604e62 100644
--- a/python/teams/team-one/examples/example_coder.py
+++ b/python/teams/team-one/examples/example_coder.py
@@ -2,7 +2,8 @@ import asyncio
from agnext.application import SingleThreadedAgentRuntime
from agnext.components.models import OpenAIChatCompletionClient
-from team_one.agents.coder import Coder, LLMResponseMessage, TaskMessage
+from team_one.agents.coder import Coder
+from team_one.messages import LLMResponseMessage, TaskMessage
async def main() -> None:
diff --git a/python/teams/team-one/examples/example_file_surfer.py b/python/teams/team-one/examples/example_file_surfer.py
index 2996d40f4..58103631c 100644
--- a/python/teams/team-one/examples/example_file_surfer.py
+++ b/python/teams/team-one/examples/example_file_surfer.py
@@ -4,7 +4,8 @@ from agnext.application import SingleThreadedAgentRuntime
from agnext.components.models import (
OpenAIChatCompletionClient,
)
-from team_one.agents.file_surfer import FileSurfer, LLMResponseMessage, TaskMessage
+from team_one.agents.file_surfer import FileSurfer
+from team_one.messages import LLMResponseMessage, TaskMessage
async def main() -> None:
diff --git a/python/teams/team-one/examples/example_reflexagents.py b/python/teams/team-one/examples/example_reflexagents.py
new file mode 100644
index 000000000..0198cd699
--- /dev/null
+++ b/python/teams/team-one/examples/example_reflexagents.py
@@ -0,0 +1,28 @@
+import asyncio
+
+from agnext.application import SingleThreadedAgentRuntime
+from team_one.agents.orchestrator import RoundRobinOrchestrator
+from team_one.agents.reflex_agents import ReflexAgent
+from team_one.messages import BroadcastMessage
+
+
+async def main() -> None:
+ runtime = SingleThreadedAgentRuntime()
+
+ fake1 = runtime.register_and_get_proxy("fake_agent_1", lambda: ReflexAgent("First reflect agent"))
+ fake2 = runtime.register_and_get_proxy("fake_agent_2", lambda: ReflexAgent("Second reflect agent"))
+ fake3 = runtime.register_and_get_proxy("fake_agent_3", lambda: ReflexAgent("Third reflect agent"))
+ runtime.register_and_get("orchestrator", lambda: RoundRobinOrchestrator([fake1, fake2, fake3]))
+
+ await runtime.publish_message(BroadcastMessage("Test message"), namespace="default")
+
+ await runtime.process_until_idle()
+
+
+if __name__ == "__main__":
+ import logging
+
+ logging.basicConfig(level=logging.WARNING)
+ logging.getLogger("agnext").setLevel(logging.DEBUG)
+
+ asyncio.run(main())
diff --git a/python/teams/team-one/examples/example_team.py b/python/teams/team-one/examples/example_team.py
new file mode 100644
index 000000000..f6470d174
--- /dev/null
+++ b/python/teams/team-one/examples/example_team.py
@@ -0,0 +1,6 @@
+"""
+A team that use multiple agents including, coder and file_surfer
+to solve tasks.
+"""
+
+# TODO: Add code here to implement the team.
diff --git a/python/teams/team-one/src/team_one/agents/coder.py b/python/teams/team-one/src/team_one/agents/coder.py
index 8c3b60e62..010b87c03 100644
--- a/python/teams/team-one/src/team_one/agents/coder.py
+++ b/python/teams/team-one/src/team_one/agents/coder.py
@@ -1,6 +1,5 @@
import asyncio
import json
-from dataclasses import dataclass
from typing import List
from agnext.components import FunctionCall, TypeRoutedAgent, message_handler
@@ -17,25 +16,7 @@ from agnext.components.models import (
from agnext.components.tools import PythonCodeExecutionTool
from agnext.core import CancellationToken
-
-@dataclass
-class ToolMessage:
- function_call: FunctionCall
-
-
-@dataclass
-class ToolResultMessage:
- result: FunctionExecutionResult
-
-
-@dataclass
-class TaskMessage:
- content: str
-
-
-@dataclass
-class LLMResponseMessage:
- content: str
+from ..messages import TaskMessage, LLMResponseMessage, ToolMessage, ToolResultMessage
class Coder(TypeRoutedAgent):
diff --git a/python/teams/team-one/src/team_one/agents/file_surfer.py b/python/teams/team-one/src/team_one/agents/file_surfer.py
index 6bb801f51..9bcec897b 100644
--- a/python/teams/team-one/src/team_one/agents/file_surfer.py
+++ b/python/teams/team-one/src/team_one/agents/file_surfer.py
@@ -1,6 +1,5 @@
import asyncio
import json
-from dataclasses import dataclass
from pathlib import Path
from typing import List
@@ -18,25 +17,7 @@ from agnext.components.models import (
from agnext.components.tools import FunctionTool
from agnext.core import CancellationToken
-
-@dataclass
-class ToolMessage:
- function_call: FunctionCall
-
-
-@dataclass
-class ToolResultMessage:
- result: FunctionExecutionResult
-
-
-@dataclass
-class TaskMessage:
- content: str
-
-
-@dataclass
-class LLMResponseMessage:
- content: str
+from ..messages import TaskMessage, LLMResponseMessage, ToolMessage, ToolResultMessage
async def read_local_file(file_path: str) -> str:
diff --git a/python/teams/team-one/src/team_one/agents/orchestrator.py b/python/teams/team-one/src/team_one/agents/orchestrator.py
new file mode 100644
index 000000000..af6402715
--- /dev/null
+++ b/python/teams/team-one/src/team_one/agents/orchestrator.py
@@ -0,0 +1,34 @@
+from typing import List
+
+from agnext.components import TypeRoutedAgent, message_handler
+from agnext.core import CancellationToken, AgentProxy
+
+from ..messages import BroadcastMessage, RequestReplyMessage
+
+
+class RoundRobinOrchestrator(TypeRoutedAgent):
+ def __init__(
+ self,
+ agents: List[AgentProxy],
+ description: str = "Round robin orchestrator",
+ ) -> None:
+ super().__init__(description)
+ self._agents = agents
+ self._num_rounds = 0
+
+ @message_handler
+ async def handle_incoming_message(self, message: BroadcastMessage, cancellation_token: CancellationToken) -> None:
+ """Handle an incoming message."""
+
+ if self._num_rounds > 3:
+ return
+
+ next_agent = self._select_next_agent()
+ request_reply_message = RequestReplyMessage()
+ await self.send_message(request_reply_message, next_agent.id)
+
+ self._num_rounds += 1
+
+ def _select_next_agent(self) -> AgentProxy:
+ self._current_index = (self._num_rounds) % len(self._agents)
+ return self._agents[self._current_index]
diff --git a/python/teams/team-one/src/team_one/agents/reflex_agents.py b/python/teams/team-one/src/team_one/agents/reflex_agents.py
new file mode 100644
index 000000000..b7adbd7da
--- /dev/null
+++ b/python/teams/team-one/src/team_one/agents/reflex_agents.py
@@ -0,0 +1,23 @@
+from agnext.components import TypeRoutedAgent, message_handler
+from agnext.core import CancellationToken
+
+from ..messages import BroadcastMessage, RequestReplyMessage
+
+
+class ReflexAgent(TypeRoutedAgent):
+ def __init__(self, description: str) -> None:
+ super().__init__(description)
+
+ @message_handler
+ async def handle_incoming_message(self, message: BroadcastMessage, cancellation_token: CancellationToken) -> None:
+ """Handle an incoming message."""
+ pass
+
+ @message_handler
+ async def handle_request_reply_message(
+ self, message: RequestReplyMessage, cancellation_token: CancellationToken
+ ) -> None:
+ name = self.metadata["name"]
+ await self.publish_message(
+ BroadcastMessage(content=f"Hello, world from {name}!"), cancellation_token=cancellation_token
+ )
diff --git a/python/teams/team-one/src/team_one/messages.py b/python/teams/team-one/src/team_one/messages.py
new file mode 100644
index 000000000..423c020f0
--- /dev/null
+++ b/python/teams/team-one/src/team_one/messages.py
@@ -0,0 +1,33 @@
+from dataclasses import dataclass
+from agnext.components.models import FunctionExecutionResult
+from agnext.components import FunctionCall
+
+
+@dataclass
+class ToolMessage:
+ function_call: FunctionCall
+
+
+@dataclass
+class ToolResultMessage:
+ result: FunctionExecutionResult
+
+
+@dataclass
+class TaskMessage:
+ content: str
+
+
+@dataclass
+class LLMResponseMessage:
+ content: str
+
+
+@dataclass
+class BroadcastMessage:
+ content: str
+
+
+@dataclass
+class RequestReplyMessage:
+ pass