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