Skip to content

A programming framework for agentic AI

Timeout Termination (#4038) (#4214)

Gerardo Moreno8d89500255e9
diff --git a/python/packages/autogen-agentchat/src/autogen_agentchat/task/__init__.py b/python/packages/autogen-agentchat/src/autogen_agentchat/task/__init__.py
index bce31ba00..2a57b0e9c 100644
--- a/python/packages/autogen-agentchat/src/autogen_agentchat/task/__init__.py
+++ b/python/packages/autogen-agentchat/src/autogen_agentchat/task/__init__.py
@@ -4,6 +4,7 @@ from ._terminations import (
MaxMessageTermination,
StopMessageTermination,
TextMentionTermination,
+ TimeoutTermination,
TokenUsageTermination,
)
@@ -13,5 +14,6 @@ __all__ = [
"StopMessageTermination",
"TokenUsageTermination",
"HandoffTermination",
+ "TimeoutTermination",
"Console",
]
diff --git a/python/packages/autogen-agentchat/src/autogen_agentchat/task/_terminations.py b/python/packages/autogen-agentchat/src/autogen_agentchat/task/_terminations.py
index 62b76ed6b..16d44b984 100644
--- a/python/packages/autogen-agentchat/src/autogen_agentchat/task/_terminations.py
+++ b/python/packages/autogen-agentchat/src/autogen_agentchat/task/_terminations.py
@@ -1,3 +1,4 @@
+import time
from typing import Sequence
from ..base import TerminatedException, TerminationCondition
@@ -175,3 +176,35 @@ class HandoffTermination(TerminationCondition):
async def reset(self) -> None:
self._terminated = False
+
+
+class TimeoutTermination(TerminationCondition):
+ """Terminate the conversation after a specified duration has passed.
+
+ Args:
+ timeout_seconds: The maximum duration in seconds before terminating the conversation.
+ """
+
+ def __init__(self, timeout_seconds: float) -> None:
+ self._timeout_seconds = timeout_seconds
+ self._start_time = time.monotonic()
+ self._terminated = False
+
+ @property
+ def terminated(self) -> bool:
+ return self._terminated
+
+ async def __call__(self, messages: Sequence[AgentMessage]) -> StopMessage | None:
+ if self._terminated:
+ raise TerminatedException("Termination condition has already been reached")
+
+ if (time.monotonic() - self._start_time) >= self._timeout_seconds:
+ self._terminated = True
+ return StopMessage(
+ content=f"Timeout of {self._timeout_seconds} seconds reached", source="TimeoutTermination"
+ )
+ return None
+
+ async def reset(self) -> None:
+ self._start_time = time.monotonic()
+ self._terminated = False
diff --git a/python/packages/autogen-agentchat/tests/test_termination_condition.py b/python/packages/autogen-agentchat/tests/test_termination_condition.py
index d6e8343b1..a56d8df35 100644
--- a/python/packages/autogen-agentchat/tests/test_termination_condition.py
+++ b/python/packages/autogen-agentchat/tests/test_termination_condition.py
@@ -1,3 +1,5 @@
+import asyncio
+
import pytest
from autogen_agentchat.messages import HandoffMessage, StopMessage, TextMessage
from autogen_agentchat.task import (
@@ -5,6 +7,7 @@ from autogen_agentchat.task import (
MaxMessageTermination,
StopMessageTermination,
TextMentionTermination,
+ TimeoutTermination,
TokenUsageTermination,
)
from autogen_core.components.models import RequestUsage
@@ -202,3 +205,24 @@ async def test_or_termination() -> None:
)
is not None
)
+
+
+async def test_timeout_termination() -> None:
+ termination = TimeoutTermination(0.1) # 100ms timeout
+
+ assert await termination([]) is None
+ assert not termination.terminated
+
+ await asyncio.sleep(0.2)
+
+ assert await termination([]) is not None
+ assert termination.terminated
+
+ await termination.reset()
+ assert not termination.terminated
+ assert await termination([]) is None
+
+ assert await termination([TextMessage(content="Hello", source="user")]) is None
+ await asyncio.sleep(0.2)
+ assert await termination([TextMessage(content="World", source="user")]) is not None