vercel-labs/bash-tool

解决的问题

为 AI 代理提供了一种与 Bash 环境交互的标准化方式，使其能够在安全的沙箱环境中执行命令、读取文件和写入文件。这使得代理无需为每个代理定制工具实现，即可执行项目分析、文件操作和运行脚本等任务。

工作原理

该库与 AI SDK 集成，提供一组工具（bash、readFile 和 writeFile），代理可以调用这些工具。它可使用轻量级的 just-bash 实例，或通过 @vercel/sandbox 使用完整虚拟机运行。支持上传本地目录、在无服务器调用之间保持沙箱持久性，并可拦截命令以修改或阻止危险操作。

适用人群

需要在受控环境中运行 shell 命令并管理文件的 AI 代理开发者。

主要亮点

• AI SDK 兼容性：专为与 AI SDK 无缝集成而设计。
• 灵活的沙箱支持：支持多种沙箱后端，包括通过 Vercel Sandbox 提供的完整虚拟机支持。
• 持久性：可通过唯一 ID 重新连接到现有沙箱，以保留状态。
• 命令拦截：提供钩子，在命令执行前后拦截并修改 Bash 命令。
• 实验性技能支持：与模块化功能（Skills）集成，为代理提供特定指令和脚本。