Skip to main contentAG-Kit通过两种主要执行器提供强大的代码执行能力：沙盒化执行保障安全，本地执行追求性能。本指南将帮助您选择合适的工具，并有效应用于Agent的工作流程中。
何时使用代码执行工具
当您的Agent需要运行动态代码片段或脚本时使用这些工具。
快速入门
典型工作流
- 数据处理：读取文件，执行Python脚本进行分析并输出结果
- 代码生成与测试：让LLM生成代码，在沙盒中验证正确性并反馈
- DevOps自动化：运行Shell脚本搭建项目、检查代码或运行测试
选择适合的执行器
| 执行器 | 使用场景 | 核心优势 |
|---|
BuiltInCodeExecutor | 不可信代码（来自LLM或用户） | 安全隔离 |
UnsafeLocalCodeExecutor | 可信代码（自有脚本） | 性能速度 |
- 优先选择
BuiltInCodeExecutor（沙盒化）：当安全性至关重要时使用，提供执行隔离、允许安装包并控制环境
- 使用
UnsafeLocalCodeExecutor（本地化）：在开发环境或受控CI环境中运行可信脚本，需要最高性能和直接访问本地文件时
核心功能与配置
两种执行器共享通用应用程序接口但采用不同后端实现。
配置选项
- 超时设置：通过
timeoutMs防止脚本失控运行
- 环境变量：通过
envs注入密钥或配置
- 流式输出：使用
onStdout和onStderr获取长时间任务的实时反馈
支持语言
可执行多种语言代码并获取结构化结果：
工作流示例：Agent集成
将代码执行与FilesystemToolkit等工具结合，构建强大的Agent。
