Dropstone SDK
Un client TypeScript e JavaScript tipizzato per l'agente Dropstone, con due punti di ingresso: uno per chiamate API headless da CI o da una funzione serverless, uno che esegue l'agente localmente con la stessa memoria dell'account del CLI e della Chat.
Il Dropstone SDK è un client TypeScript e JavaScript tipizzato per il runtime dell'agente Dropstone. Offre al tuo codice un accesso programmatico allo stesso agente che gira in Dropstone Chat e nel CLI: sessioni, strumenti, risposte in streaming e output strutturato.
npm install @blankline/dropstone-sdk
Il riferimento ai metodi è su docs.dropstone.io/cli/sdk. Questa pagina è la panoramica, mentre Installazione ed esecuzione della tua prima sessione è la guida passo passo.
Due punti di ingresso
L'SDK include due client, e quale scegliere dipende da dove gira il tuo codice.
| Client API headless | Client agente locale | |
|---|---|---|
| Import | createDropstoneApi | createDropstone |
| Comunica con | api.dropstone.io/api/v1 | un processo dropstone serve che avvia per te |
| Autenticazione | una chiave API | l'accesso del CLI sulla stessa macchina |
| Fatturazione | pay-per-use dal tuo saldo crediti | la tua indennità settimanale, come il CLI |
| La tua memoria | No. È un endpoint di completamento stateless | Sì, la memoria dell'account usata da Chat e CLI |
| Usalo per | CI, job, serverless, qualsiasi host senza CLI | integrare l'agente interattivo in un'app Node |
Altri due punti di ingresso sono inclusi: createDropstoneClient punta lo stesso client tipizzato a un server che stai già eseguendo, e createDropstoneTui avvia l'interfaccia terminale interattiva da un processo Node.
Una memoria, ovunque
Una sessione locale gira come il tuo account, quindi parte con tutto ciò che Dropstone ha appreso sulle altre tue superfici. Una regola impostata in Chat vale anche nel codice che gira tramite l'SDK, e ciò che una sessione registra è lì la prossima volta che apri il CLI. Vedi Una memoria su ogni superficie.
Il client headless è deliberatamente l'opposto: un endpoint di completamento stateless e compatibile con OpenAI, senza memoria associata, così una pipeline ottiene input e output prevedibili. Vedi Usare l'API con il tuo piano.
Tipizzato dall'inizio alla fine
Richieste, risposte, eventi di streaming e chiamate agli strumenti sono generati dalla specifica OpenAPI del server, quindi un editor li completa e un compilatore li verifica. Due superfici sono incluse nello stesso pacchetto: un client v1 stabile, e un client v2 su @blankline/dropstone-sdk/v2 con un modello di risorse più ricco per file e workspace. I nuovi endpoint arrivano su v2.
Requisiti
- Node.js
- Per il client agente locale, il Dropstone CLI sulla stessa macchina, con accesso effettuato tramite
dropstone login - Per il client headless, una chiave API e un saldo crediti finanziato
Assistenza
Il riferimento CLI è il primo posto per domande a livello di metodo. Per problemi di account, fatturazione o accesso, vedi Come ottenere supporto.
Related articles
- Install and run your first sessionInstall the Dropstone SDK, make a headless API call with an API key, and run a local agent session that carries your account memory. Includes streaming, structured output, and using the OpenAI SDK against Dropstone.
- Using the API with your planCall Dropstone over HTTP with an API key. The endpoint is OpenAI-compatible, billed pay-per-use from your credit balance, and works from any language. Keys, errors, rate limits, and what the API does not carry.
- One memory across every surfaceThe account memory that follows you across Dropstone Chat, the CLI, and the SDK, what shares it and what does not, and how to keep an integration's learning out of your own memory.
- Install the CLIInstall the Dropstone CLI on macOS, Linux, or Windows with one command, sign in, and check it works. Upgrading and uninstalling.
- Memory across chat, CLI, and SDKDropstone memory belongs to your account, not to one app. A rule you set in the CLI applies in chat, and something learned in chat is available to the SDK. One memory, every surface.