Dropstone Support

Dropstone SDK

Dropstone 에이전트용 타입 기반 TypeScript 및 JavaScript 클라이언트로, 두 개의 진입점을 제공합니다. 하나는 CI 또는 서버리스 함수에서 사용하는 헤드리스 API 호출용이고, 다른 하나는 CLI 및 Chat과 동일한 계정 메모리로 에이전트를 로컬에서 실행하는 용도입니다.

Dropstone SDK는 Dropstone 에이전트 런타임용 타입 기반 TypeScript 및 JavaScript 클라이언트입니다. 코드에서 Dropstone Chat 및 CLI에서 실행되는 것과 동일한 에이전트에 프로그래밍 방식으로 접근할 수 있습니다: 세션, 도구, 스트리밍 응답, 구조화된 출력을 제공합니다.

npm install @blankline/dropstone-sdk

메서드 참조는 docs.dropstone.io/cli/sdk에서 확인할 수 있습니다. 이 페이지는 개요이며, 설치 및 첫 세션 실행은 실습 가이드입니다.

두 개의 진입점

SDK는 두 개의 클라이언트를 제공하며, 코드가 실행되는 위치에 따라 선택할 수 있습니다.

헤드리스 API 클라이언트로컬 에이전트 클라이언트
임포트createDropstoneApicreateDropstone
통신 대상api.dropstone.io/api/v1사용자를 대신해 시작하는 dropstone serve 프로세스
인증 방식API 키같은 머신에서의 CLI 로그인
과금 방식크레딧 잔액에서 종량제CLI와 동일한 주간 허용량
메모리없음. 상태 비저장 완료 엔드포인트입니다.있음. Chat 및 CLI가 사용하는 계정 메모리
사용 용도CI, 작업, 서버리스, CLI가 없는 모든 호스트Node 앱에 대화형 에이전트 임베딩

두 개의 추가 진입점도 함께 제공됩니다: createDropstoneClient는 이미 실행 중인 서버에 동일한 타입 기반 클라이언트를 연결하고, createDropstoneTui는 Node 프로세스에서 대화형 터미널 UI를 실행합니다.

모든 곳에서 하나의 메모리

로컬 세션은 사용자 계정으로 실행되므로, Dropstone이 다른 표면에서 학습한 모든 정보로 시작합니다. Chat에서 설정한 규칙은 SDK를 통해 실행되는 코드에서도 유효하며, 세션이 기록한 내용은 다음에 CLI를 열 때도 그대로 유지됩니다. 모든 표면에서 하나의 메모리를 참조하세요.

헤드리스 클라이언트는 의도적으로 그 반대입니다: 메모리가 연결되지 않은 상태 비저장, OpenAI 호환 완료 엔드포인트로, 파이프라인에 예측 가능한 입력과 출력을 제공합니다. 플랜과 함께 API 사용하기를 참조하세요.

끝까지 타입 기반

요청, 응답, 스트리밍 이벤트 및 도구 호출은 서버의 OpenAPI 사양에서 생성되므로, 편집기가 자동 완성하고 컴파일러가 검사합니다. 하나의 패키지에 두 개의 표면이 포함되어 있습니다: 안정적인 v1 클라이언트와, 파일 및 워크스페이스를 위한 더 풍부한 리소스 모델을 제공하는 @blankline/dropstone-sdk/v2의 v2 클라이언트입니다. 새 엔드포인트는 v2에 추가됩니다.

요구 사항

  • Node.js
  • 로컬 에이전트 클라이언트의 경우, 같은 머신에 Dropstone CLI가 설치되어 있고 dropstone login으로 로그인되어 있어야 합니다.
  • 헤드리스 클라이언트의 경우, API 키와 충전된 크레딧 잔액이 필요합니다.

도움 받기

CLI 참조는 메서드 수준 질문에 대한 첫 번째 참고 자료입니다. 계정, 결제 또는 접근 문제는 지원 받는 방법을 참조하세요.

Related articles

Ctrl+I