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）整合，為代理提供特定指令與腳本。