프로젝트 소개

이 저장소는 Octavus AI 에이전트를 사용하는 애플리케이션을 구축하기 위한 공식 JavaScript/TypeScript SDK를 제공합니다. 이는 여러 npm 패키지를 포함하는 모노레포로 구성되어 있으며, 각 패키지는 통합 영역의 서로 다른 부분을 대상으로 합니다. 패키지에는 클라이언트/서버 통신에 사용되는 공유 타입과 유틸리티를 제공하는 @octavus/core, 백엔드 통합을 위한 @octavus/server-sdk, 프레임워크에 구애받지 않는 클라이언트인 @octavus/client-sdk, React 훅과 바인딩을 위한 @octavus/react, 에이전트 관리를 위한 @octavus/cli, 문서 콘텐츠를 위한 @octavus/docs가 포함됩니다. 서버 SDK는 API 키로 OctavusClient를 생성하고, 초기 변수로 에이전트 세션을 만들고, 사용자 정의 도구 핸들러로 해당 세션에 연결하고, 텍스트 델타와 같은 응답 이벤트를 스트리밍하면서 명명된 트리거를 실행하는 방법을 보여줍니다. React 패키지는 HTTP 전송과 결합된 useOctavusChat 훅을 보여주며, 여기서 트리거 요청이 백엔드 엔드포인트로 전달되고 메시지, 상태 및 전송 함수가 UI에 노출됩니다. 문서 링크는 시작하기, 서버 SDK, 클라이언트 SDK, 프로토콜 참조 및 API 참조를 다룹니다. 개발에는 Node.js 20+ 및 pnpm 10+가 필요하며, 설치, 빌드, 린트, 타입 검사 및 포맷을 위한 스크립트가 있습니다. 이 프로젝트는 MIT 라이선스이며 기여 가이드를 통해 기여를 받습니다.