Descripción general del SDK de Dropstone
Un cliente TypeScript y JavaScript tipado para el agente de Dropstone, con dos puntos de entrada: uno para llamadas API sin interfaz desde CI o una función serverless, y otro que ejecuta el agente localmente con la misma memoria de cuenta que la CLI y el Chat.
El SDK de Dropstone es un cliente TypeScript y JavaScript tipado para el runtime del agente de Dropstone. Le da a tu código acceso programático al mismo agente que se ejecuta en Dropstone Chat y en la CLI: sesiones, herramientas, respuestas en streaming y salida estructurada.
npm install @blankline/dropstone-sdk
La referencia de métodos está en docs.dropstone.io/cli/sdk. Esta página es la descripción general, y Instalación y ejecución de tu primera sesión es el tutorial paso a paso.
Dos puntos de entrada
El SDK incluye dos clientes, y cuál necesitas depende de dónde se ejecute tu código.
| Cliente API sin interfaz | Cliente agente local | |
|---|---|---|
| Importación | createDropstoneApi | createDropstone |
| Se comunica con | api.dropstone.io/api/v1 | un proceso dropstone serve que inicia por ti |
| Autenticación | con una clave API | el inicio de sesión de la CLI en la misma máquina |
| Facturación | pago por uso desde tu saldo de créditos | tu asignación semanal, como la CLI |
| Tu memoria | No. Es un endpoint de completaciones sin estado | Sí, la memoria de cuenta que usan Chat y la CLI |
| Úsalo para | CI, trabajos, serverless, cualquier host sin la CLI | integrar el agente interactivo en una aplicación Node |
Incluye dos puntos de entrada más: createDropstoneClient apunta el mismo cliente tipado a un servidor que ya estés ejecutando, y createDropstoneTui lanza la interfaz de terminal interactiva desde un proceso Node.
Una memoria, en todas partes
Una sesión local se ejecuta como tu cuenta, así que comienza con todo lo que Dropstone ha aprendido en tus otras superficies. Una regla que establezcas en Chat se aplica en el código que se ejecuta a través del SDK, y lo que registra una sesión estará ahí la próxima vez que abras la CLI. Consulta Una memoria en cada superficie.
El cliente sin interfaz es deliberadamente lo contrario: un endpoint de completaciones sin estado, compatible con OpenAI, sin memoria adjunta, para que un pipeline obtenga entrada y salida predecibles. Consulta Uso de la API con tu plan.
Tipado de principio a fin
Las solicitudes, respuestas, eventos de streaming y llamadas a herramientas se generan a partir de la especificación OpenAPI del servidor, de modo que un editor las completa y un compilador las verifica. Dos superficies se incluyen en un solo paquete: un cliente v1 estable y un cliente v2 en @blankline/dropstone-sdk/v2 con un modelo de recursos más rico para archivos y espacios de trabajo. Los nuevos endpoints llegan a v2.
Requisitos
- Node.js
- Para el cliente agente local, la CLI de Dropstone en la misma máquina, con sesión iniciada mediante
dropstone login - Para el cliente sin interfaz, una clave API y un saldo de créditos con fondos
Cómo obtener ayuda
La referencia de la CLI es el primer lugar para preguntas a nivel de métodos. Para problemas de cuenta, facturación o acceso, consulta Cómo obtener soporte.
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.