codeany-ai/open-agent-sdk-typescript

해결하는 문제

Open Agent SDK는 별도의 서브프로세스나 CLI 도구 없이도 TypeScript 애플리케이션에 자율적인 AI 에이전트를 통합할 수 있는 방법을 제공합니다. 로컬 파일 시스템과 상호 작용하고, 셸 명령을 실행하며, 외부 도구를 사용하면서도 지속적인 세션 상태를 유지하는 에이전트 생성 프로세스를 단순화합니다.

작동 원리

이 SDK는 에이전트 루프(API 호출 $ ightarrow$ 도구 실행 $ ightarrow$ 반복)를 인프로세스에서 직접 구현합니다. Anthropic 및 OpenAI 호환 API(DeepSeek, Qwen, Mistral 포함) 간의 차이점을 추상화하여 개발자가 모델을 쉽게 전환할 수 있도록 합니다. 시스템은 LLM과의 통신을 처리하는 프로바이더 레이어와 도구 및 서브 에이전트의 실행을 관리하는 쿼리 엔진을 사용합니다.

대상 사용자

자신의 애플리케이션 환경, 클라우드 함수 또는 CI/CD 파이프라인 내에서 코드 리뷰, 디버깅 또는 파일 조작과 같은 복잡한 작업을 수행할 수 있는 AI 에이전트를 구축하고자 하는 TypeScript 개발자.

주요 특징

• 인프로세스 실행: CLI나 서브프로세스 없이 전체 에이전트 루프를 실행합니다.
• 광범위한 내장 도구 세트: Bash, 파일 시스템 액세스(읽기/쓰기/편집), 웹 검색 및 LSP 코드 인텔리전스를 위한 35개 이상의 도구가 포함되어 있습니다.
• MCP 통합: 표준 인터페이스를 통해 에이전트 기능을 확장하기 위한 Model Context Protocol (MCP) 서버를 지원합니다.
• 유연한 도구 제작: Zod 스키마를 사용한 유효성 검사를 통해 커스텀 도구 생성을 허용합니다.
• 서브 에이전트 및 스킬: 병렬 작업을 위한 특화된 서브 에이전트 생성과 "skills"라고 불리는 재사용 가능한 프롬프트 템플릿(예: debug, review)을 지원합니다.
• 라이프사이클 훅: 에이전트 동작을 가로채고 제어하기 위한 20가지의 다양한 라이프사이클 이벤트(PreToolUse 및 PostToolUse 등)를 제공합니다.
• 세션 관리: 세션 지속성, 포킹 및 대화 재개를 지원합니다.