Ikhtisar Dropstone SDK
Klien TypeScript dan JavaScript yang diketik untuk agen Dropstone, dengan dua titik masuk: satu untuk panggilan API tanpa status dari CI atau fungsi serverless, satu yang menjalankan agen secara lokal dengan memori akun yang sama seperti CLI dan Chat.
Dropstone SDK adalah klien TypeScript dan JavaScript yang diketik untuk runtime agen Dropstone. SDK ini memberikan akses programatik ke agen yang sama yang berjalan di Dropstone Chat dan CLI: sesi, alat, balasan streaming, dan keluaran terstruktur.
npm install @blankline/dropstone-sdk
Referensi metode ada di docs.dropstone.io/cli/sdk. Halaman ini adalah ikhtisar, dan Menginstal dan menjalankan sesi pertama Anda adalah panduan langkah demi langkah.
Dua titik masuk
SDK menyediakan dua klien, dan mana yang Anda butuhkan ditentukan oleh tempat kode Anda berjalan.
| Klien API tanpa status | Klien agen lokal | |
|---|---|---|
| Impor | createDropstoneApi | createDropstone |
| Berkomunikasi dengan | api.dropstone.io/api/v1 | proses dropstone serve yang dimulai untuk Anda |
| Autentikasi dengan | kunci API | masuknya CLI di mesin yang sama |
| Penagihan | bayar sesuai pemakaian dari saldo kredit Anda | tunjangan mingguan Anda, seperti CLI |
| Memori Anda | Tidak. Ini adalah endpoint penyelesaian tanpa status | Ya, memori akun yang digunakan Chat dan CLI |
| Gunakan untuk | CI, pekerjaan, serverless, host apa pun tanpa CLI | menyematkan agen interaktif dalam aplikasi Node |
Dua titik masuk lagi disertakan: createDropstoneClient mengarahkan klien yang diketik yang sama ke server yang sudah Anda jalankan, dan createDropstoneTui meluncurkan UI terminal interaktif dari proses Node.
Satu memori, di mana saja
Sesi lokal berjalan sebagai akun Anda, jadi sesi dimulai dengan semua yang telah dipelajari Dropstone di permukaan lain Anda. Aturan yang Anda tetapkan di Chat berlaku dalam kode yang berjalan melalui SDK, dan apa yang dicatat sesi ada di sana saat Anda membuka CLI berikutnya. Lihat Satu memori di setiap permukaan.
Klien tanpa status sengaja menjadi kebalikannya: endpoint penyelesaian yang kompatibel dengan OpenAI, tanpa status, tanpa memori yang terpasang, sehingga pipeline mendapatkan input dan output yang dapat diprediksi. Lihat Menggunakan API dengan paket Anda.
Diketik dari ujung ke ujung
Permintaan, respons, peristiwa streaming, dan panggilan alat dihasilkan dari spesifikasi OpenAPI server, sehingga editor melengkapinya dan kompiler memeriksanya. Dua permukaan dikirim dalam satu paket: klien v1 yang stabil, dan klien v2 di @blankline/dropstone-sdk/v2 dengan model sumber daya yang lebih kaya untuk file dan ruang kerja. Endpoint baru mendarat di v2.
Persyaratan
- Node.js
- Untuk klien agen lokal, Dropstone CLI di mesin yang sama, masuk dengan
dropstone login - Untuk klien tanpa status, kunci API dan saldo kredit yang didanai
Mendapatkan bantuan
Referensi CLI adalah tujuan pertama untuk pertanyaan tingkat metode. Untuk masalah akun, penagihan, atau akses, lihat Cara mendapatkan dukungan.
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.