Class ToolExecutor

tutorials/03_tool_system.py:251–314

工具执行器 —— 管理和执行所有工具。 它做两件事： 1. 注册工具（把工具的名称和执行函数绑定起来） 2. 执行工具（根据名称找到函数，传入参数，返回结果） 对应源码: conversation.rs 中的 ToolExecutor trait 以及 tools/src/lib.rs 中的 StaticToolExecutor

# 这样加新工具的时候，Agentic Loop 的代码完全不用改！

class ToolExecutor:
    """
    工具执行器 —— 管理和执行所有工具。

    它做两件事：
    1. 注册工具（把工具的名称和执行函数绑定起来）
    2. 执行工具（根据名称找到函数，传入参数，返回结果）

    对应源码: conversation.rs 中的 ToolExecutor trait
    以及 tools/src/lib.rs 中的 StaticToolExecutor
    """

    def __init__(self):
        # _handlers 是一个字典：工具名 → 执行函数
        # 就像一本电话簿：名字 → 电话号码
        self._handlers: dict[str, Callable[[dict], str]] = {}
        # _specs 保存工具的说明书
        self._specs: dict[str, ToolSpec] = {}

    def register(self, spec: ToolSpec, handler: Callable[[dict], str]) -> "ToolExecutor":
        """
        注册一个工具。

        参数:
            spec: 工具说明书
            handler: 工具的执行函数
        返回:
            self（返回自身是为了支持链式调用，后面演示）
        """
        self._handlers[spec.name] = handler
        self._specs[spec.name] = spec
        return self  # 返回自身，这样可以连续调用 .register().register()

    def execute(self, tool_name: str, input_json: str) -> tuple[str, bool]:
        """
        执行一个工具。

        参数:
            tool_name: 工具名称
            input_json: 参数（JSON 字符串）
        返回:
            (输出结果, 是否出错)
        """
        if tool_name not in self._handlers:
            return (f"Unknown tool: {tool_name}", True)

        try:
            params = json.loads(input_json) if input_json else {}
        except json.JSONDecodeError:
            return (f"Invalid JSON input: {input_json}", True)

        try:
            result = self._handlers[tool_name](params)
            return (result, False)
        except Exception as e:
            return (f"Tool execution error: {e}", True)

    def get_specs(self) -> list[ToolSpec]: