Panoramica dell'SDK Dropstone
Un client TypeScript e JavaScript tipizzato per l'agente Dropstone, con due punti di ingresso: uno per chiamate API headless da CI o funzioni serverless, uno che esegue l'agente localmente con la stessa memoria dell'account di CLI e Chat.
L'SDK Dropstone è un client TypeScript e JavaScript tipizzato per il runtime dell'agente Dropstone. Dà al tuo codice accesso programmatico allo stesso agente che gira in Dropstone Chat e nella 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 Installa ed esegui la tua prima sessione è la guida passo-passo.
Due punti di ingresso
L'SDK include due client, e quello che ti serve 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 della CLI sulla stessa macchina |
| Fatturazione | pay-per-use dal tuo saldo crediti | la tua indennità settimanale, come la CLI |
| La tua memoria | No. È un endpoint di completamento senza stato | Sì, la memoria dell'account usata da Chat e CLI |
| Usalo per | CI, job, serverless, qualsiasi host senza CLI | incorporare 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 superfici. Una regola che imposti in Chat vale anche nel codice che gira tramite l'SDK, e ciò che una sessione registra è lì la prossima volta che apri la CLI. Vedi Una memoria su ogni superficie.
Il client headless è deliberatamente l'opposto: un endpoint di completamento senza stato, compatibile con OpenAI, senza memoria collegata, così una pipeline ottiene input e output prevedibili. Vedi Usare l'API con il tuo piano.
Tipizzato dall'inizio alla fine
Richieste, risposte, eventi in 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, la CLI Dropstone 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.