From db557bd5944fa76e8f52db29a578528f43190240 Mon Sep 17 00:00:00 2001 From: Bren Whyte Date: Mon, 7 Sep 2026 15:33:44 +0100 Subject: [PATCH] =?UTF-8?q?=F0=9F=A7=AD=20docs:=20Document=20defaultDeferL?= =?UTF-8?q?oading=20Agents=20Setting?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Documents the opt-in endpoints.agents.defaultDeferLoading setting from LibreChat PR #15713: MCP tools newly added to an agent in the Agent Builder start with Defer Loading enabled, gated on the deferred_tools capability, with per-tool user opt-out preserved. - Features/Agents (Deferred Tools): add a note on defaulting Defer Loading on - Agents Endpoint Object Structure: add the defaultDeferLoading reference section and example yaml entry --- .../object_structure/agents.mdx | 26 +++++++++++++++++++ content/docs/features/agents.mdx | 2 ++ 2 files changed, 28 insertions(+) diff --git a/content/docs/configuration/librechat_yaml/object_structure/agents.mdx b/content/docs/configuration/librechat_yaml/object_structure/agents.mdx index 26cd6feca..5523ca95d 100644 --- a/content/docs/configuration/librechat_yaml/object_structure/agents.mdx +++ b/content/docs/configuration/librechat_yaml/object_structure/agents.mdx @@ -18,6 +18,9 @@ endpoints: maxToolCallArgBytesByTool: create_file: 131072 disableBuilder: false + # (optional) When true, MCP tools newly added to an agent in the Agent Builder start with Defer Loading enabled. + # Requires the "deferred_tools" capability; users can still opt out per tool. Defaults to false. + # defaultDeferLoading: false # (optional) Agent Capabilities available to all users. Omit the ones you wish to exclude. Defaults to list below. # Opt-in capabilities: "programmatic_tools", "stateful_code_sessions", "run_in_background", and "tool_intents". # capabilities: ["deferred_tools", "execute_code", "file_search", "web_search", "artifacts", "subagents", "actions", "context", "skills", "memory", "ask_user_question", "tools", "chain", "ocr"] @@ -305,6 +308,29 @@ capabilities: **Note:** This field is optional. If omitted, the default behavior is to include all the capabilities listed in the default. +## defaultDeferLoading + + + +**Default:** `false` + +**Example:** + +```yaml filename="endpoints / agents / defaultDeferLoading" +defaultDeferLoading: true +``` + +**Note:** This field is optional. If omitted, newly added MCP tools start with Defer Loading off, matching the previous behavior. + ## statefulCodeSessions Configures the sharing scopes and optional execution backends for highly experimental stateful Code Interpreter workspaces. diff --git a/content/docs/features/agents.mdx b/content/docs/features/agents.mdx index 883ae4784..a0ab823b6 100644 --- a/content/docs/features/agents.mdx +++ b/content/docs/features/agents.mdx @@ -188,6 +188,8 @@ This is especially useful when an agent has access to many MCP servers with doze **Note:** The `deferred_tools` capability is enabled by default. It can be toggled via the [`librechat.yaml` agents configuration](/docs/configuration/librechat_yaml/object_structure/agents#capabilities). +**Defaulting Defer Loading on:** Administrators can set [`defaultDeferLoading: true`](/docs/configuration/librechat_yaml/object_structure/agents#defaultdeferloading) so MCP tools newly added to an agent start with Defer Loading already enabled. The setting requires the `deferred_tools` capability, users can still opt out per tool, and existing agents keep their saved choices. + ### Activity Groups Activity groups collapse each contiguous block of Agent reasoning and tool calls under a generated one-line header, making long runs easier to scan. Administrators enable them with `activityLabel` and can use a faster model, another configured endpoint, a custom prompt, and per-run limits. Header generation is a separate model call whose tokens and cost are recorded. See [Agent Activity Groups](/docs/configuration/librechat_yaml/object_structure/shared_endpoint_settings#agent-activity-groups).