CubeLoop — a Pythonic, async-native agent harness core designed for high performance, readability, and production-grade persistence.
Python agent-frameworkagent-harnessagent-runtimeagentic-aiai-agentsai-frameworkanthropicharnessharness-engineeringharness-frameworklanggraphlanggraph-alternativellmmcpopenaipi-agentpi-agent-corepythonpython-agent
docs(deferred-tools): show how to write a loader; stop pretending github_mcp.load_tools exists
xf gong729e1bee2160
diff --git a/website/docs/guides/agents/tool-use.md b/website/docs/guides/agents/tool-use.mdindex 8d84e47..1d2a246 100644--- a/website/docs/guides/agents/tool-use.md+++ b/website/docs/guides/agents/tool-use.md@@ -245,13 +245,21 @@ their schemas are appended (append-only, for cache stability).```pythonfrom cubepi import Agentfrom cubepi.deferred import DeferredToolGroup+from cubepi.mcp import load_mcp_tools_stdio++async def load_github_tools():+ result = await load_mcp_tools_stdio(+ command="npx",+ args=["-y", "@modelcontextprotocol/server-github"],+ )+ return result.tools # list[AgentTool]github_group = DeferredToolGroup(group_id="mcp:github",display_name="GitHub",description="Issues, PRs, repos, code search",tool_names=["create_issue", "search_repos", "create_pr"],- loader=github_mcp.load_tools,+ loader=load_github_tools,)agent = Agent(@@ -261,13 +269,19 @@ agent = Agent()```+The loader is a zero-arg async callable returning `list[AgentTool]` —+wrap an MCP discovery call (as above), or just return your own+`@tool`-decorated functions. The names in `tool_names` must match each+tool's `AgentTool.name` so selective expansion can find them.+Good fit when you have ≥5 tool groups but typically only use one ortwo per conversation, or when schemas are large enough to noticeablyinflate every system prompt. Skip it when all the tools are needed onevery turn — deferring just adds a round trip.See [Deferred Tool Groups](../middleware/deferred-tools) for the full-API, cross-run replay, and the advanced middleware constructor.+API (including a hand-written-tools loader example), cross-run replay,+and the advanced middleware constructor.## Common pitfallsdiff --git a/website/docs/guides/middleware/deferred-tools.md b/website/docs/guides/middleware/deferred-tools.mdindex 1ea8c69..8687e91 100644--- a/website/docs/guides/middleware/deferred-tools.md+++ b/website/docs/guides/middleware/deferred-tools.md@@ -41,12 +41,16 @@ automatically — no manual wiring needed:from cubepi import Agentfrom cubepi.deferred import DeferredToolGroup+# load_github_tools / load_linear_tools are zero-arg async callables+# returning list[AgentTool]. See "Writing a loader" below for the two+# common shapes (MCP-backed and hand-written @tool functions).+github_group = DeferredToolGroup(group_id="mcp:github",display_name="GitHub",description="Issues, PRs, repos, code search",tool_names=["create_issue", "search_repos", "create_pr", "list_comments"],- loader=github_mcp.load_tools, # async () -> list[AgentTool]+ loader=load_github_tools,)linear_group = DeferredToolGroup(@@ -54,7 +58,7 @@ linear_group = DeferredToolGroup(display_name="Linear",description="Project management and issue tracking",tool_names=["create_issue", "update_issue", "list_projects"],- loader=linear_mcp.load_tools,+ loader=load_linear_tools,)agent = Agent(@@ -71,9 +75,82 @@ agent = Agent(| `group_id` | `str` | Unique identifier the model uses in `load_tools` calls (e.g. `"mcp:github"`) || `display_name` | `str` | Human-readable label shown in the catalog || `description` | `str` | One-line summary of the group's capabilities |-| `tool_names` | `list[str]` | Tool names shown in the catalog |+| `tool_names` | `list[str]` | Tool names shown in the catalog. **Must match the `AgentTool.name` of each tool the loader returns** — selective expansion (`load_tools(group_id, tool_names=[…])`) matches on this. || `loader` | `async () -> list[AgentTool]` | Callback that returns the full tool set for this group |+### Writing a loader++The loader is a zero-argument async callable that returns+`list[AgentTool]`. CubePi only cares about its return type — where the+`AgentTool` objects come from is up to you. Two common shapes:++**From an MCP server.** `load_mcp_tools_stdio` / `load_mcp_tools_http`+return an `MCPDiscoveryResult` whose `.tools` is the `list[AgentTool]`+you want. Wrap it:++```python+from cubepi.deferred import DeferredToolGroup+from cubepi.mcp import load_mcp_tools_stdio++async def load_github_tools():+ result = await load_mcp_tools_stdio(+ command="npx",+ args=["-y", "@modelcontextprotocol/server-github"],+ env={"GITHUB_TOKEN": "ghp_…"},+ )+ return result.tools # list[AgentTool]++github_group = DeferredToolGroup(+ group_id="mcp:github",+ display_name="GitHub",+ description="Issues, PRs, repos, code search",+ tool_names=["create_issue", "search_repos", "create_pr"],+ loader=load_github_tools,+)+```++The names in `tool_names` must match the MCP server's tool names —+those become `AgentTool.name` after discovery. If the catalog lists+`create_issue` but the server publishes it as `github_create_issue`,+selective expansion misses.++**From hand-written `@tool` functions.** Any function decorated with+`@tool` produces an `AgentTool` (its `.name` defaults to the function+name, overridable via `@tool(name="…")`). A loader for hand-written+tools is just `async lambda` over a list:++```python+from cubepi import tool+from cubepi.deferred import DeferredToolGroup++@tool+async def create_issue(*, repo: str, title: str, body: str) -> str:+ "Open a GitHub issue."+ ...++@tool+async def search_repos(*, query: str) -> str:+ "Search public repos."+ ...++async def load_github_tools():+ return [create_issue, search_repos] # already AgentTools++github_group = DeferredToolGroup(+ group_id="mcp:github",+ display_name="GitHub",+ description="Issues, PRs, repos, code search",+ tool_names=["create_issue", "search_repos"],+ loader=load_github_tools,+)+```++You can mix the two — return MCP tools and hand-written tools in the+same list — as long as every name in `tool_names` matches an+`AgentTool.name` in the returned list. If the loader raises, the+error is reported to the model as a tool error and the group stays+unexpanded.+## The `load_tools` toolThe model calls `load_tools` to load a group's tools. Two modes:diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/agents/tool-use.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/agents/tool-use.mdindex 8bad6d9..b3b8bf4 100644--- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/agents/tool-use.md+++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/agents/tool-use.md@@ -227,13 +227,21 @@ CubePi 仅在当前批次中 *每个* 工具结果都是 `terminate=True` 时才```pythonfrom cubepi import Agentfrom cubepi.deferred import DeferredToolGroup+from cubepi.mcp import load_mcp_tools_stdio++async def load_github_tools():+ result = await load_mcp_tools_stdio(+ command="npx",+ args=["-y", "@modelcontextprotocol/server-github"],+ )+ return result.tools # list[AgentTool]github_group = DeferredToolGroup(group_id="mcp:github",display_name="GitHub",description="Issues, PRs, repos, code search",tool_names=["create_issue", "search_repos", "create_pr"],- loader=github_mcp.load_tools,+ loader=load_github_tools,)agent = Agent(@@ -243,11 +251,16 @@ agent = Agent()```+loader 是一个零参 async 可调用对象,返回 `list[AgentTool]` —— 你可以+像上面这样包一次 MCP discovery,也可以直接返回你自己写的 `@tool` 装饰+函数。`tool_names` 里的名字必须和返回的每个工具的 `AgentTool.name`+完全一致,选择性展开才能找到。+适合 ≥ 5 个工具组、但每次对话通常只用一两组的场景,或者 schema 大到足以明显撑大每一轮 system prompt 的情况。每一轮都要全部 tool 的话就别用,延迟反而多一次往返。-完整 API、跨 run 恢复以及高级中间件构造器见+完整 API(含手写工具 loader 示例)、跨 run 恢复、高级中间件构造器见[延迟工具组](../middleware/deferred-tools)。## 常见坑diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/middleware/deferred-tools.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/middleware/deferred-tools.mdindex 143a3a2..e0a3d30 100644--- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/middleware/deferred-tools.md+++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/middleware/deferred-tools.md@@ -40,12 +40,16 @@ to load a group's tools for the rest of this conversation.from cubepi import Agentfrom cubepi.deferred import DeferredToolGroup+# load_github_tools / load_linear_tools 是零参 async 可调用对象,+# 返回 list[AgentTool]。具体怎么写见下面的「编写 loader」一节,+# 给了 MCP 后端和手写 @tool 函数两种常见形态。+github_group = DeferredToolGroup(group_id="mcp:github",display_name="GitHub",description="Issues, PRs, repos, code search",tool_names=["create_issue", "search_repos", "create_pr", "list_comments"],- loader=github_mcp.load_tools, # async () -> list[AgentTool]+ loader=load_github_tools,)linear_group = DeferredToolGroup(@@ -53,7 +57,7 @@ linear_group = DeferredToolGroup(display_name="Linear",description="Project management and issue tracking",tool_names=["create_issue", "update_issue", "list_projects"],- loader=linear_mcp.load_tools,+ loader=load_linear_tools,)agent = Agent(@@ -70,9 +74,78 @@ agent = Agent(| `group_id` | `str` | 模型在 `load_tools` 调用里使用的唯一 ID(如 `"mcp:github"`) || `display_name` | `str` | 目录里展示的人类可读名称 || `description` | `str` | 该组能力的一行摘要 |-| `tool_names` | `list[str]` | 目录里列出的 tool 名 |+| `tool_names` | `list[str]` | 目录里列出的 tool 名。**必须和 loader 返回的每个工具的 `AgentTool.name` 完全一致** —— 选择性展开(`load_tools(group_id, tool_names=[…])`)就靠这个字段匹配。 || `loader` | `async () -> list[AgentTool]` | 返回该组完整 tool 集的回调 |+### 编写 loader++`loader` 是一个零参 async 可调用对象,返回 `list[AgentTool]`。CubePi+只看返回类型——里面的 `AgentTool` 怎么来由你决定。两种典型写法:++**从 MCP server 加载。** `load_mcp_tools_stdio` / `load_mcp_tools_http`+返回 `MCPDiscoveryResult`,里面 `.tools` 字段就是你想要的+`list[AgentTool]`。包一层:++```python+from cubepi.deferred import DeferredToolGroup+from cubepi.mcp import load_mcp_tools_stdio++async def load_github_tools():+ result = await load_mcp_tools_stdio(+ command="npx",+ args=["-y", "@modelcontextprotocol/server-github"],+ env={"GITHUB_TOKEN": "ghp_…"},+ )+ return result.tools # list[AgentTool]++github_group = DeferredToolGroup(+ group_id="mcp:github",+ display_name="GitHub",+ description="Issues, PRs, repos, code search",+ tool_names=["create_issue", "search_repos", "create_pr"],+ loader=load_github_tools,+)+```++`tool_names` 里写的名字必须和 MCP server 公布的工具名一致——这些名字+discovery 之后会成为 `AgentTool.name`。如果目录里写 `create_issue` 但+server 发布的是 `github_create_issue`,选择性展开就匹配不到。++**从手写 `@tool` 函数加载。** 任何被 `@tool` 装饰的函数都是一个+`AgentTool`(`.name` 默认取函数名,可用 `@tool(name="…")` 覆盖)。+loader 就是一个返回列表的 async 函数:++```python+from cubepi import tool+from cubepi.deferred import DeferredToolGroup++@tool+async def create_issue(*, repo: str, title: str, body: str) -> str:+ "Open a GitHub issue."+ ...++@tool+async def search_repos(*, query: str) -> str:+ "Search public repos."+ ...++async def load_github_tools():+ return [create_issue, search_repos] # 已经是 AgentTool++github_group = DeferredToolGroup(+ group_id="mcp:github",+ display_name="GitHub",+ description="Issues, PRs, repos, code search",+ tool_names=["create_issue", "search_repos"],+ loader=load_github_tools,+)+```++两种可以混用——同一个 list 里既有 MCP 工具又有手写工具——只要+`tool_names` 里每一个名字都能在返回的 list 里找到对应的+`AgentTool.name` 就行。如果 loader 抛异常,错误会作为 tool error 回给+模型,组保持未展开。+## `load_tools` 工具模型通过 `load_tools` 加载一组的 tool。两种模式:diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/version-0.10/guides/agents/tool-use.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/version-0.10/guides/agents/tool-use.mdindex 8bad6d9..b3b8bf4 100644--- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/version-0.10/guides/agents/tool-use.md+++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/version-0.10/guides/agents/tool-use.md@@ -227,13 +227,21 @@ CubePi 仅在当前批次中 *每个* 工具结果都是 `terminate=True` 时才```pythonfrom cubepi import Agentfrom cubepi.deferred import DeferredToolGroup+from cubepi.mcp import load_mcp_tools_stdio++async def load_github_tools():+ result = await load_mcp_tools_stdio(+ command="npx",+ args=["-y", "@modelcontextprotocol/server-github"],+ )+ return result.tools # list[AgentTool]github_group = DeferredToolGroup(group_id="mcp:github",display_name="GitHub",description="Issues, PRs, repos, code search",tool_names=["create_issue", "search_repos", "create_pr"],- loader=github_mcp.load_tools,+ loader=load_github_tools,)agent = Agent(@@ -243,11 +251,16 @@ agent = Agent()```+loader 是一个零参 async 可调用对象,返回 `list[AgentTool]` —— 你可以+像上面这样包一次 MCP discovery,也可以直接返回你自己写的 `@tool` 装饰+函数。`tool_names` 里的名字必须和返回的每个工具的 `AgentTool.name`+完全一致,选择性展开才能找到。+适合 ≥ 5 个工具组、但每次对话通常只用一两组的场景,或者 schema 大到足以明显撑大每一轮 system prompt 的情况。每一轮都要全部 tool 的话就别用,延迟反而多一次往返。-完整 API、跨 run 恢复以及高级中间件构造器见+完整 API(含手写工具 loader 示例)、跨 run 恢复、高级中间件构造器见[延迟工具组](../middleware/deferred-tools)。## 常见坑diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/version-0.10/guides/middleware/deferred-tools.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/version-0.10/guides/middleware/deferred-tools.mdindex 143a3a2..e0a3d30 100644--- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/version-0.10/guides/middleware/deferred-tools.md+++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/version-0.10/guides/middleware/deferred-tools.md@@ -40,12 +40,16 @@ to load a group's tools for the rest of this conversation.from cubepi import Agentfrom cubepi.deferred import DeferredToolGroup+# load_github_tools / load_linear_tools 是零参 async 可调用对象,+# 返回 list[AgentTool]。具体怎么写见下面的「编写 loader」一节,+# 给了 MCP 后端和手写 @tool 函数两种常见形态。+github_group = DeferredToolGroup(group_id="mcp:github",display_name="GitHub",description="Issues, PRs, repos, code search",tool_names=["create_issue", "search_repos", "create_pr", "list_comments"],- loader=github_mcp.load_tools, # async () -> list[AgentTool]+ loader=load_github_tools,)linear_group = DeferredToolGroup(@@ -53,7 +57,7 @@ linear_group = DeferredToolGroup(display_name="Linear",description="Project management and issue tracking",tool_names=["create_issue", "update_issue", "list_projects"],- loader=linear_mcp.load_tools,+ loader=load_linear_tools,)agent = Agent(@@ -70,9 +74,78 @@ agent = Agent(| `group_id` | `str` | 模型在 `load_tools` 调用里使用的唯一 ID(如 `"mcp:github"`) || `display_name` | `str` | 目录里展示的人类可读名称 || `description` | `str` | 该组能力的一行摘要 |-| `tool_names` | `list[str]` | 目录里列出的 tool 名 |+| `tool_names` | `list[str]` | 目录里列出的 tool 名。**必须和 loader 返回的每个工具的 `AgentTool.name` 完全一致** —— 选择性展开(`load_tools(group_id, tool_names=[…])`)就靠这个字段匹配。 || `loader` | `async () -> list[AgentTool]` | 返回该组完整 tool 集的回调 |+### 编写 loader++`loader` 是一个零参 async 可调用对象,返回 `list[AgentTool]`。CubePi+只看返回类型——里面的 `AgentTool` 怎么来由你决定。两种典型写法:++**从 MCP server 加载。** `load_mcp_tools_stdio` / `load_mcp_tools_http`+返回 `MCPDiscoveryResult`,里面 `.tools` 字段就是你想要的+`list[AgentTool]`。包一层:++```python+from cubepi.deferred import DeferredToolGroup+from cubepi.mcp import load_mcp_tools_stdio++async def load_github_tools():+ result = await load_mcp_tools_stdio(+ command="npx",+ args=["-y", "@modelcontextprotocol/server-github"],+ env={"GITHUB_TOKEN": "ghp_…"},+ )+ return result.tools # list[AgentTool]++github_group = DeferredToolGroup(+ group_id="mcp:github",+ display_name="GitHub",+ description="Issues, PRs, repos, code search",+ tool_names=["create_issue", "search_repos", "create_pr"],+ loader=load_github_tools,+)+```++`tool_names` 里写的名字必须和 MCP server 公布的工具名一致——这些名字+discovery 之后会成为 `AgentTool.name`。如果目录里写 `create_issue` 但+server 发布的是 `github_create_issue`,选择性展开就匹配不到。++**从手写 `@tool` 函数加载。** 任何被 `@tool` 装饰的函数都是一个+`AgentTool`(`.name` 默认取函数名,可用 `@tool(name="…")` 覆盖)。+loader 就是一个返回列表的 async 函数:++```python+from cubepi import tool+from cubepi.deferred import DeferredToolGroup++@tool+async def create_issue(*, repo: str, title: str, body: str) -> str:+ "Open a GitHub issue."+ ...++@tool+async def search_repos(*, query: str) -> str:+ "Search public repos."+ ...++async def load_github_tools():+ return [create_issue, search_repos] # 已经是 AgentTool++github_group = DeferredToolGroup(+ group_id="mcp:github",+ display_name="GitHub",+ description="Issues, PRs, repos, code search",+ tool_names=["create_issue", "search_repos"],+ loader=load_github_tools,+)+```++两种可以混用——同一个 list 里既有 MCP 工具又有手写工具——只要+`tool_names` 里每一个名字都能在返回的 list 里找到对应的+`AgentTool.name` 就行。如果 loader 抛异常,错误会作为 tool error 回给+模型,组保持未展开。+## `load_tools` 工具模型通过 `load_tools` 加载一组的 tool。两种模式:diff --git a/website/versioned_docs/version-0.10/guides/agents/tool-use.md b/website/versioned_docs/version-0.10/guides/agents/tool-use.mdindex 8d84e47..1d2a246 100644--- a/website/versioned_docs/version-0.10/guides/agents/tool-use.md+++ b/website/versioned_docs/version-0.10/guides/agents/tool-use.md@@ -245,13 +245,21 @@ their schemas are appended (append-only, for cache stability).```pythonfrom cubepi import Agentfrom cubepi.deferred import DeferredToolGroup+from cubepi.mcp import load_mcp_tools_stdio++async def load_github_tools():+ result = await load_mcp_tools_stdio(+ command="npx",+ args=["-y", "@modelcontextprotocol/server-github"],+ )+ return result.tools # list[AgentTool]github_group = DeferredToolGroup(group_id="mcp:github",display_name="GitHub",description="Issues, PRs, repos, code search",tool_names=["create_issue", "search_repos", "create_pr"],- loader=github_mcp.load_tools,+ loader=load_github_tools,)agent = Agent(@@ -261,13 +269,19 @@ agent = Agent()```+The loader is a zero-arg async callable returning `list[AgentTool]` —+wrap an MCP discovery call (as above), or just return your own+`@tool`-decorated functions. The names in `tool_names` must match each+tool's `AgentTool.name` so selective expansion can find them.+Good fit when you have ≥5 tool groups but typically only use one ortwo per conversation, or when schemas are large enough to noticeablyinflate every system prompt. Skip it when all the tools are needed onevery turn — deferring just adds a round trip.See [Deferred Tool Groups](../middleware/deferred-tools) for the full-API, cross-run replay, and the advanced middleware constructor.+API (including a hand-written-tools loader example), cross-run replay,+and the advanced middleware constructor.## Common pitfallsdiff --git a/website/versioned_docs/version-0.10/guides/middleware/deferred-tools.md b/website/versioned_docs/version-0.10/guides/middleware/deferred-tools.mdindex 1ea8c69..8687e91 100644--- a/website/versioned_docs/version-0.10/guides/middleware/deferred-tools.md+++ b/website/versioned_docs/version-0.10/guides/middleware/deferred-tools.md@@ -41,12 +41,16 @@ automatically — no manual wiring needed:from cubepi import Agentfrom cubepi.deferred import DeferredToolGroup+# load_github_tools / load_linear_tools are zero-arg async callables+# returning list[AgentTool]. See "Writing a loader" below for the two+# common shapes (MCP-backed and hand-written @tool functions).+github_group = DeferredToolGroup(group_id="mcp:github",display_name="GitHub",description="Issues, PRs, repos, code search",tool_names=["create_issue", "search_repos", "create_pr", "list_comments"],- loader=github_mcp.load_tools, # async () -> list[AgentTool]+ loader=load_github_tools,)linear_group = DeferredToolGroup(@@ -54,7 +58,7 @@ linear_group = DeferredToolGroup(display_name="Linear",description="Project management and issue tracking",tool_names=["create_issue", "update_issue", "list_projects"],- loader=linear_mcp.load_tools,+ loader=load_linear_tools,)agent = Agent(@@ -71,9 +75,82 @@ agent = Agent(| `group_id` | `str` | Unique identifier the model uses in `load_tools` calls (e.g. `"mcp:github"`) || `display_name` | `str` | Human-readable label shown in the catalog || `description` | `str` | One-line summary of the group's capabilities |-| `tool_names` | `list[str]` | Tool names shown in the catalog |+| `tool_names` | `list[str]` | Tool names shown in the catalog. **Must match the `AgentTool.name` of each tool the loader returns** — selective expansion (`load_tools(group_id, tool_names=[…])`) matches on this. || `loader` | `async () -> list[AgentTool]` | Callback that returns the full tool set for this group |+### Writing a loader++The loader is a zero-argument async callable that returns+`list[AgentTool]`. CubePi only cares about its return type — where the+`AgentTool` objects come from is up to you. Two common shapes:++**From an MCP server.** `load_mcp_tools_stdio` / `load_mcp_tools_http`+return an `MCPDiscoveryResult` whose `.tools` is the `list[AgentTool]`+you want. Wrap it:++```python+from cubepi.deferred import DeferredToolGroup+from cubepi.mcp import load_mcp_tools_stdio++async def load_github_tools():+ result = await load_mcp_tools_stdio(+ command="npx",+ args=["-y", "@modelcontextprotocol/server-github"],+ env={"GITHUB_TOKEN": "ghp_…"},+ )+ return result.tools # list[AgentTool]++github_group = DeferredToolGroup(+ group_id="mcp:github",+ display_name="GitHub",+ description="Issues, PRs, repos, code search",+ tool_names=["create_issue", "search_repos", "create_pr"],+ loader=load_github_tools,+)+```++The names in `tool_names` must match the MCP server's tool names —+those become `AgentTool.name` after discovery. If the catalog lists+`create_issue` but the server publishes it as `github_create_issue`,+selective expansion misses.++**From hand-written `@tool` functions.** Any function decorated with+`@tool` produces an `AgentTool` (its `.name` defaults to the function+name, overridable via `@tool(name="…")`). A loader for hand-written+tools is just `async lambda` over a list:++```python+from cubepi import tool+from cubepi.deferred import DeferredToolGroup++@tool+async def create_issue(*, repo: str, title: str, body: str) -> str:+ "Open a GitHub issue."+ ...++@tool+async def search_repos(*, query: str) -> str:+ "Search public repos."+ ...++async def load_github_tools():+ return [create_issue, search_repos] # already AgentTools++github_group = DeferredToolGroup(+ group_id="mcp:github",+ display_name="GitHub",+ description="Issues, PRs, repos, code search",+ tool_names=["create_issue", "search_repos"],+ loader=load_github_tools,+)+```++You can mix the two — return MCP tools and hand-written tools in the+same list — as long as every name in `tool_names` matches an+`AgentTool.name` in the returned list. If the loader raises, the+error is reported to the model as a tool error and the group stays+unexpanded.+## The `load_tools` toolThe model calls `load_tools` to load a group's tools. Two modes: