vercel-labs/bash-tool

해결하는 문제

AI 에이전트가 바시 환경과 상호작용할 수 있는 표준화된 방법을 제공하여, 안전한 사전 환경 내에서 명령어 실행, 파일 읽기, 파일 쓰기 작업을 가능하게 합니다. 이로 인해 각 에이전트마다 맞춤형 도구를 구현할 필요 없이 프로젝트 분석, 파일 조작, 스크립트 실행과 같은 작업을 수행할 수 있습니다.

작동 방식

이 라이브러리는 AI SDK와 통합되어 에이전트가 호출할 수 있는 도구(bash, readFile, writeFile)를 제공합니다. 가벼운 just-bash 인스턴스 또는 @vercel/sandbox를 통한 완전한 VM으로 작동할 수 있습니다. 로컬 디렉터리 업로드, 서버리스 호출 간 지속적인 사전 환경 유지, 위험한 작업을 수정하거나 차단하기 위한 명령어 가로채기 기능을 지원합니다.

대상 사용자

제어된 환경에서 쉘 명령어를 실행하고 파일을 관리할 수 있어야 하는 AI 에이전트를 개발하는 개발자들입니다.

주요 특징

• AI SDK 호환성: AI SDK와 원활하게 작동하도록 설계되었습니다.
• 유연한 사전 환경: Vercel Sandbox를 통한 완전한 VM 지원을 포함한 여러 사전 환경 백엔드를 지원합니다.
• 지속성: 고유 ID를 사용해 기존 사전 환경에 다시 연결하여 상태를 유지할 수 있습니다.
• 명령어 가로채기: 실행 전후에 바시 명령어를 가로채고 수정할 수 있는 훅을 제공합니다.
• 실험적 기능 지원: 에이전트에게 특정 지침과 스크립트를 제공하는 모듈형 기능(Skills)과의 통합을 지원합니다.