内置工具

为常见Agent任务提供全面内置工具集

AG-Kit提供了一套全面的内置工具，涵盖AI Agent需要执行的大多数常见任务。这些工具已为生产环境准备就绪，经过充分测试，并设计为可无缝协同工作。

​

工具分类

​

文件系统操作

完整的文件与目录管理能力：

文件操作

支持编码的文件读写与编辑功能

目录操作

目录的列举、创建与管理

搜索操作

使用通配符查找文件，正则表达式搜索内容

高级编辑器

支持复杂工作流的多操作文件编辑器

​

代码执行

安全的多语言代码执行环境：

沙盒执行

在隔离的E2B容器中安全执行

本地执行

高性能本地代码执行

语言支持

Python、JavaScript、TypeScript、Bash等

流式输出

实时stdout/stderr流传输

​

系统操作

命令行与系统交互：

Shell命令

在适当隔离环境下执行shell命令

环境控制

管理环境变量与工作目录

进程管理

控制进程执行与资源限制

输出处理

捕获与处理命令输出

​

常用模式

​

按用例选择工具

根据Agent用途选择恰当的工具组合：

Python

from agkit.tools import (
    FilesystemToolkit, BuiltInCodeExecutor,
    create_grep_tool, create_glob_tool, create_bash_tool, create_mcp_tools
)
import os

# 文件操作：文件系统+搜索工具
filesystem_toolkit = FilesystemToolkit(name="fs", context=context)

file_tools = [
    *filesystem_toolkit.get_tools(),
    create_grep_tool(context),
    create_glob_tool(context)
]

# 开发工作流：代码+文件+shell
dev_tools = [
    BuiltInCodeExecutor(api_key=os.getenv("E2B_API_KEY")),
    *filesystem_toolkit.get_tools(),
    create_bash_tool(context)
]

# 全功能：所有内置工具
all_tools = [
    *dev_tools,
    *create_mcp_tools(mcp_config)
]

​

错误处理

所有内置工具遵循统一的错误处理模式：

Python

result = await tool.invoke(input_data)

if not result.success:
    if result.error_type == 'validation':
        print(f'Invalid input: {result.error}')
    elif result.error_type == 'permission':
        print(f'Access denied: {result.error}')
    elif result.error_type == 'execution':
        print(f'Execution failed: {result.error}')
    elif result.error_type == 'network':
        print(f'Network error: {result.error}')
else:
    print(f'Success: {result.data}')

​

后续步骤

文件系统工具

文件系统操作完整指南

代码执行工具

安全的多语言代码执行

命令行工具

Shell命令执行与系统操作

MCP集成

外部工具生态系统集成