mirror of
https://gitee.com/wanwujie/deer-flow
synced 2026-04-02 22:02:13 +08:00
Support configuring max_concurrent_subagents (2-4, default 3) through config.configurable, with automatic clamping and dynamic prompt generation. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
76 lines
2.8 KiB
Python
76 lines
2.8 KiB
Python
"""Middleware to enforce maximum concurrent subagent tool calls per model response."""
|
|
|
|
import logging
|
|
from typing import override
|
|
|
|
from langchain.agents import AgentState
|
|
from langchain.agents.middleware import AgentMiddleware
|
|
from langgraph.runtime import Runtime
|
|
|
|
from src.subagents.executor import MAX_CONCURRENT_SUBAGENTS
|
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
# Valid range for max_concurrent_subagents
|
|
MIN_SUBAGENT_LIMIT = 2
|
|
MAX_SUBAGENT_LIMIT = 4
|
|
|
|
|
|
def _clamp_subagent_limit(value: int) -> int:
|
|
"""Clamp subagent limit to valid range [2, 4]."""
|
|
return max(MIN_SUBAGENT_LIMIT, min(MAX_SUBAGENT_LIMIT, value))
|
|
|
|
|
|
class SubagentLimitMiddleware(AgentMiddleware[AgentState]):
|
|
"""Truncates excess 'task' tool calls from a single model response.
|
|
|
|
When an LLM generates more than max_concurrent parallel task tool calls
|
|
in one response, this middleware keeps only the first max_concurrent and
|
|
discards the rest. This is more reliable than prompt-based limits.
|
|
|
|
Args:
|
|
max_concurrent: Maximum number of concurrent subagent calls allowed.
|
|
Defaults to MAX_CONCURRENT_SUBAGENTS (3). Clamped to [2, 4].
|
|
"""
|
|
|
|
def __init__(self, max_concurrent: int = MAX_CONCURRENT_SUBAGENTS):
|
|
super().__init__()
|
|
self.max_concurrent = _clamp_subagent_limit(max_concurrent)
|
|
|
|
def _truncate_task_calls(self, state: AgentState) -> dict | None:
|
|
messages = state.get("messages", [])
|
|
if not messages:
|
|
return None
|
|
|
|
last_msg = messages[-1]
|
|
if getattr(last_msg, "type", None) != "ai":
|
|
return None
|
|
|
|
tool_calls = getattr(last_msg, "tool_calls", None)
|
|
if not tool_calls:
|
|
return None
|
|
|
|
# Count task tool calls
|
|
task_indices = [i for i, tc in enumerate(tool_calls) if tc.get("name") == "task"]
|
|
if len(task_indices) <= self.max_concurrent:
|
|
return None
|
|
|
|
# Build set of indices to drop (excess task calls beyond the limit)
|
|
indices_to_drop = set(task_indices[self.max_concurrent :])
|
|
truncated_tool_calls = [tc for i, tc in enumerate(tool_calls) if i not in indices_to_drop]
|
|
|
|
dropped_count = len(indices_to_drop)
|
|
logger.warning(f"Truncated {dropped_count} excess task tool call(s) from model response (limit: {self.max_concurrent})")
|
|
|
|
# Replace the AIMessage with truncated tool_calls (same id triggers replacement)
|
|
updated_msg = last_msg.model_copy(update={"tool_calls": truncated_tool_calls})
|
|
return {"messages": [updated_msg]}
|
|
|
|
@override
|
|
def after_model(self, state: AgentState, runtime: Runtime) -> dict | None:
|
|
return self._truncate_task_calls(state)
|
|
|
|
@override
|
|
async def aafter_model(self, state: AgentState, runtime: Runtime) -> dict | None:
|
|
return self._truncate_task_calls(state)
|