核心用法
Code Executor 是一项元能力型技能,赋予 AI Bot 动态编写并执行代码的无限扩展性。当内置技能无法满足需求时,Bot 可自动生成 Python、JavaScript、Bash、TypeScript、SQL 等语言的代码,在隔离沙箱中执行并返回结果。支持三种调用模式:
- 直接执行:
run python "print('hello')"即时运行代码片段 - 文件执行:
run ~/script.py执行本地脚本文件 - 智能求解:
solve "calcula factorial de 100"让 Bot 自主决策生成最优代码
此外提供交互式 REPL 环境(abre REPL de Python)和依赖自动安装机制,实现从需求到执行的零摩擦闭环。
显著优点
| 维度 | 优势 |
|------|------|
| **扩展性** | 理论上可解决任意可计算问题,突破预定义技能边界 |
| **灵活性** | 支持多语言、多运行时,按需选择最优工具 |
| **效率** | 批量文件处理、复杂计算秒级完成,避免人工重复劳动 |
| **交互体验** | 智能求解模式降低用户认知负担,无需懂编程即可获益 |
潜在缺点与局限性
- 安全风险:代码执行本质是高危操作,虽有沙箱隔离,但配置不当(
CODE_ALLOW_FILESYSTEM=write)可能导致数据损坏 - 性能瓶颈:超时默认 30 秒,大型计算/ML 训练可能中断
- 依赖管理:自动安装依赖存在供应链风险,未经验证的包可能引入漏洞
- 状态隔离:每次执行环境独立,无法持久化跨会话状态
- 幻觉风险:Bot 生成的代码可能存在逻辑错误,需用户确认或验证
适合人群
- 高级用户/开发者:需要快速原型验证、调试脚本、数据转换
- 效率追求者:批量文件重命名、格式转换、自动化办公任务
- 学习者:通过 REPL 交互式探索编程概念
- 非技术用户:通过自然语言描述需求,由 Bot 生成并执行解决方案
常规风险
| 风险类型 | 具体表现 | 缓解措施 |
|----------|----------|----------|
| 代码注入 | 恶意指令通过 prompt 注入 | 默认 `CODE_REQUIRE_CONFIRM=true` |
| 沙箱逃逸 | 隔离机制被绕过 | 网络/文件系统权限最小化 |
| 数据泄露 | 敏感数据被代码上传 | `CODE_ALLOW_NETWORK=false` |
| 资源耗尽 | 无限循环/内存泄漏 | `CODE_TIMEOUT` 强制中断 |
建议生产环境配置:只读文件系统 + 禁用网络 + 强制确认 + 最短必要超时。