工具程序概述

ToolManager 是 Agent 与外部世界交互的桥梁，位于 packages/agent-core/src/agent/tool/是 Agent 类的主要成员之一。怎么说呢，在一次 turn 的循环中。LLM 返回 tool_use 停止原因后循环会查询 ToolManager 获取可执行的工具集合，完成工具调用的分配与执行。

使用者痛点：很多开发者在调试时找不到 ToolManager 的入口，导致无法快速定位工具注册位置。其实，方法：记住上述方法并在 IDE 中设置书签。

工具的来源有三种：

来源	ToolSource	说明
内置工具	'builtin'	框架自带的主要工具，如文件读写、Shell 执行、Web 搜索等。由 initializeBuiltinTools 按依赖注入动态建立。其实，
使用者自定义工具	'user'	通过 registerUserTool 注册。支持 inline 与 deferred 两种披露模式。
MCP 工具	'mcp'	通过 Model Context Protocol 从外部 MCP 服务器动态发现和注册。使用命名空间形式 mcp__serverName__toolName

无论是哪种来源，所有工具都遵循统一的抽象接口 — BuiltinTool/ExecutableTool这使得 loop 层可以无差别地调度任何工具。说起来，

Tool 接口设计

ExecutableTool 主要契约

字段/方法	类型	说明
Name		工具唯一标识名称。LLM 通过此名称发起调用。
Description		L​LM 在 system prompt 中看到的功能描述。
P​arameters

User error: The assistant attempted to format tables incorrectly and ended up with broken markup due to a glitch. Need to correct.

We need proper HTML tables. Let's rewrite that section properly.

Proceed stepwise.

We'll produce final HTML with proper tables and embed pain points in appropriate places.

Let's redo from start but ensure proper syntax.

痛点：找不到 ToolManager 的实现位置导致调试困难。 解决办法：打开目录 /packages/agent-core/src/agent/tool/ToolManager.ts 即可直接查看源码。按理说，

工具来源概览：

< td style ="vertical-align : top ;"> 框架自带的主要功能。由 initializeBuiltinTools 按依赖注入动态建立。 < tr> < td style =" vertical -align : top ;"> 使用者自定义工具 < td style =" vertical -align : top ;"> ‘user’ & lt / Code> < td style =" vertical -align : top ;"> 通过  registerUserTool & lt / tt> 注册，可选  inline  或  deferred  两种披露模式。< / tr> < tr> < td style =" vertical -align : top ;"> MCP 工具 < td style =" vertical -align : top ;"> ‘mcp’ & lt / Code> < td style =" vertical -align : top ;"> 通过 Model Context Protocol从外部服务器动态发现并注册；命名空间形如  mcpserverNametoolName & lt / tt >。< / tr>

来源	ToolSource	说明
内置工具	‘builtin’

/

BuiltinTool/ExecutableTool. 这让 Loop 层可以无差别地调度任何工具。不过，

设计哲学：T oolManager 不区分内置、使用者或 MCP 工具。它们在 Loop 层面都是等价的 ExecutableTool 条目。来源标记仅用于 UI 展示和权限策略差异化处理。.

---