Function main

tutorials/03_tool_system.py:321–418

()

# ============================================================

def main():
    print("=" * 60)
    print("Tutorial 03: Tool System 工具系统演示")
    print("=" * 60)

    # --- 1. 创建工具执行器并注册工具 ---
    # 注意这里的"链式调用"：.register().register().register()
    # 这就是"Builder 模式"的一种简单形式 —— 一行代码完成多步配置
    executor = (
        ToolExecutor()
        .register(BASH_SPEC, execute_bash)
        .register(READ_FILE_SPEC, execute_read_file)
        .register(WRITE_FILE_SPEC, execute_write_file)
        .register(GREP_SPEC, execute_grep)
    )

    print(f"\n已注册 {len(executor.get_specs())} 个工具:")
    for spec in executor.get_specs():
        print(f"  - {spec.name}: {spec.description} [权限: {spec.required_permission}]")

    # --- 2. 通过统一接口执行工具 ---
    print("\n--- 执行工具演示 ---")

    # 执行 bash 工具
    print("\n[1] 执行 bash: echo hello")
    output, is_error = executor.execute("bash", '{"command": "echo hello"}')
    print(f"    结果: {output}")
    print(f"    出错: {is_error}")

    # 执行 read_file 工具（读取当前教程文件的前 3 行）
    print("\n[2] 执行 read_file: 读取本文件前 3 行")
    this_file = os.path.abspath(__file__)
    output, is_error = executor.execute(
        "read_file",
        json.dumps({"path": this_file, "limit": 3}),
    )
    print(f"    结果:\n{output}")

    # 执行 write_file 工具
    print("\n[3] 执行 write_file: 写一个临时文件")
    tmp = os.path.join(tempfile.gettempdir(), "tutorial_test.txt")
    output, is_error = executor.execute(
        "write_file",
        json.dumps({"path": tmp, "content": "Hello from Tutorial 03!\n"}),
    )
    print(f"    结果: {output}")

    # 执行一个不存在的工具
    print("\n[4] 执行未知工具: unknown_tool")
    output, is_error = executor.execute("unknown_tool", '{}')
    print(f"    结果: {output}")
    print(f"    出错: {is_error}")

    # 清理
    if os.path.exists(tmp):
        os.remove(tmp)

    # --- 3. 查看工具的 input_schema ---