内置工具

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

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

​

工具分类

​

文件系统操作

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

文件操作

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

目录操作

目录的列举、创建与管理

搜索操作

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

高级编辑器

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

​

代码执行

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

沙盒执行

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

本地执行

高性能本地代码执行

语言支持

Python、JavaScript、TypeScript、Bash等

流式输出

实时stdout/stderr流传输

​

系统操作

命令行与系统交互：

Shell命令

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

环境控制

管理环境变量与工作目录

进程管理

控制进程执行与资源限制

输出处理

捕获与处理命令输出

​

常用模式

​

按用例选择工具

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

TypeScript

// 文件操作：文件系统+搜索工具
const filesystemToolkit = new FilesystemToolkit({ name: 'fs', context });

const fileTools = [
  ...filesystemToolkit.getTools(),
  createGrepTool(context),
  createGlobTool(context)
];

// 开发工作流：代码+文件+shell
const devTools = [
  new BuiltInCodeExecutor(),
  ...filesystemToolkit.getTools(),
  createBashTool(context)
];

// 全功能：所有内置工具
const allTools = [
  ...devTools,
  ...createMCPTools(mcpConfig)
];

​

错误处理

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

TypeScript

const result = await tool.invoke(input);

if (!result.success) {
  switch (result.error_type) {
    case 'validation':
      console.error('Invalid input:', result.error);
      break;
    case 'permission':
      console.error('Access denied:', result.error);
      break;
    case 'execution':
      console.error('Execution failed:', result.error);
      break;
    case 'network':
      console.error('Network error:', result.error);
      break;
  }
} else {
  console.log('Success:', result.data);
}

​

后续步骤

文件系统工具

文件系统操作完整指南

代码执行工具

安全的多语言代码执行

命令行工具

Shell命令执行与系统操作

MCP集成

外部工具生态系统集成