mirror of
https://gitee.com/wanwujie/deer-flow
synced 2026-04-19 12:24:46 +08:00
* feat(tools): add tool_search for deferred MCP tool loading When multiple MCP servers are enabled, total tool count can exceed 30-50, causing context bloat and degraded tool selection accuracy. This adds a deferred tool loading mechanism controlled by `tool_search.enabled` config. - Add ToolSearchConfig with single `enabled` field - Add DeferredToolRegistry with regex search (select:, +keyword, keyword) - Add tool_search tool returning OpenAI-compatible function JSON - Add DeferredToolFilterMiddleware to hide deferred schemas from bind_tools - Add <available-deferred-tools> section to system prompt - Enable MCP tool_name_prefix to prevent cross-server name collisions - Add 34 unit tests covering registry, tool, prompt, and middleware * fix: reset stale deferred registry and bump config_version - Reset deferred registry upfront in get_available_tools() to prevent stale tool entries when MCP servers are disabled between calls - Bump config_version to 2 for new tool_search config field Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * fix(tests): mock get_app_config in prompt section tests for CI CI has no config.yaml, causing TestDeferredToolsPromptSection to fail with FileNotFoundError. Add autouse fixture to mock get_app_config. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
36 lines
1.1 KiB
Python
36 lines
1.1 KiB
Python
"""Configuration for deferred tool loading via tool_search."""
|
|
|
|
from pydantic import BaseModel, Field
|
|
|
|
|
|
class ToolSearchConfig(BaseModel):
|
|
"""Configuration for deferred tool loading via tool_search.
|
|
|
|
When enabled, MCP tools are not loaded into the agent's context directly.
|
|
Instead, they are listed by name in the system prompt and discoverable
|
|
via the tool_search tool at runtime.
|
|
"""
|
|
|
|
enabled: bool = Field(
|
|
default=False,
|
|
description="Defer tools and enable tool_search",
|
|
)
|
|
|
|
|
|
_tool_search_config: ToolSearchConfig | None = None
|
|
|
|
|
|
def get_tool_search_config() -> ToolSearchConfig:
|
|
"""Get the tool search config, loading from AppConfig if needed."""
|
|
global _tool_search_config
|
|
if _tool_search_config is None:
|
|
_tool_search_config = ToolSearchConfig()
|
|
return _tool_search_config
|
|
|
|
|
|
def load_tool_search_config_from_dict(data: dict) -> ToolSearchConfig:
|
|
"""Load tool search config from a dict (called during AppConfig loading)."""
|
|
global _tool_search_config
|
|
_tool_search_config = ToolSearchConfig.model_validate(data)
|
|
return _tool_search_config
|