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

工具分类

文件系统操作

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

代码执行

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

系统操作

命令行与系统交互:

常用模式

按用例选择工具

根据Agent用途选择恰当的工具组合:
// 文件操作:文件系统+搜索工具
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)
];

错误处理

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

后续步骤