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

工具分类

文件系统操作

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

代码执行

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

系统操作

命令行与系统交互:

常用模式

按用例选择工具

根据Agent用途选择恰当的工具组合:
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)
]

错误处理

所有内置工具遵循统一的错误处理模式:
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}')

后续步骤