Dropstone SDK
Un cliente tipado de TypeScript y JavaScript para el agente de Dropstone, con dos puntos de entrada: uno para llamadas API sin estado desde CI o una función serverless, y otro que ejecuta el agente localmente con la misma memoria de cuenta que el CLI y el Chat.
El Dropstone SDK es un cliente tipado de TypeScript y JavaScript 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 el 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 visión general, y Instala y ejecuta 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 ejecuta tu código.
| Cliente API sin estado | Cliente de agente local | |
|---|---|---|
| Importación | createDropstoneApi | createDropstone |
| Se comunica con | api.dropstone.io/api/v1 | un proceso dropstone serve que inicia por ti |
| Se autentica con | una clave API | el inicio de sesión del CLI en la misma máquina |
| Facturación | pago por uso desde tu saldo de créditos | tu asignación semanal, como el CLI |
| Tu memoria | No. Es un endpoint de completions sin estado | Sí, la memoria de cuenta que usan el Chat y el CLI |
| Úsalo para | CI, trabajos, serverless, cualquier host sin el CLI | integrar el agente interactivo en una aplicación Node |
Dos puntos de entrada adicionales vienen incluidos: 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, por lo que comienza con todo lo que Dropstone ha aprendido en tus otras superficies. Una regla que establezcas en Chat se mantiene en el código que se ejecuta a través del SDK, y lo que una sesión registra está ahí la próxima vez que abras el CLI. Consulta Una memoria en cada superficie.
El cliente sin estado es deliberadamente lo contrario: un endpoint de completions sin estado y compatible con OpenAI, sin memoria asociada, para que un pipeline obtenga entradas y salidas predecibles. Consulta Usar 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, por lo 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 de agente local, el Dropstone CLI en la misma máquina, con sesión iniciada con
dropstone login - Para el cliente sin estado, una clave API y un saldo de créditos con fondos
Obtener ayuda
La referencia del CLI es el primer lugar para preguntas a nivel de método. 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.