Dropstone Support

Dropstone SDK 概要

Dropstone エージェント向けの型付き TypeScript および JavaScript クライアント。CI やサーバーレス関数からのヘッドレス API 呼び出し用と、CLI や Chat と同じアカウントメモリでエージェントをローカル実行するための 2 つのエントリポイントを備えています。

Dropstone SDK は、Dropstone エージェントランタイム向けの型付き TypeScript および JavaScript クライアントです。Dropstone Chat や CLI で動作するのと同じエージェントに、コードからプログラム的にアクセスできます。セッション、ツール、ストリーミング応答、構造化出力などに対応しています。

npm install @blankline/dropstone-sdk

メソッドリファレンスは docs.dropstone.io/cli/sdk にあります。このページは概要であり、インストールして最初のセッションを実行する がチュートリアルです。

2 つのエントリポイント

SDK には 2 つのクライアントが同梱されており、コードが実行される場所に応じて使い分けます。

ヘッドレス API クライアントローカルエージェントクライアント
インポートcreateDropstoneApicreateDropstone
接続先api.dropstone.io/api/v1自動的に起動される dropstone serve プロセス
認証方法API キー同じマシン上の CLI のサインイン
課金クレジット残高からの従量課金CLI と同様の週次アローワンス
メモリなし。ステートレスな完了エンドポイントあり。Chat と CLI が使用するアカウントメモリ
使用用途CI、ジョブ、サーバーレス、CLI のないホストインタラクティブなエージェントを Node アプリに組み込む

さらに 2 つのエントリポイントも付属しています。createDropstoneClient は、同じ型付きクライアントを既に実行中のサーバーに向け、createDropstoneTui は Node プロセスからインタラクティブなターミナル UI を起動します。

どこでも同じメモリ

ローカルセッションはアカウントとして実行されるため、Dropstone が他のサーフェスで学習したすべての情報から始まります。Chat で設定したルールは SDK を通じて実行されるコードにも適用され、セッションが記録した内容は次に CLI を開いたときにそこにあります。すべてのサーフェスで同じメモリ を参照してください。

ヘッドレスクライアントは意図的にその逆です。メモリが接続されていないステートレスな OpenAI 互換の完了エンドポイントであり、パイプラインは予測可能な入力と出力を得られます。プランでの API の使用 を参照してください。

エンドツーエンドの型付け

リクエスト、レスポンス、ストリーミングイベント、ツール呼び出しはサーバーの OpenAPI 仕様から生成されるため、エディタが補完し、コンパイラがチェックします。1 つのパッケージに 2 つのサーフェスが同梱されています。安定版の v1 クライアントと、ファイルとワークスペース向けのよりリッチなリソースモデルを持つ @blankline/dropstone-sdk/v2 の v2 クライアントです。新しいエンドポイントは v2 に追加されます。

要件

  • Node.js
  • ローカルエージェントクライアントの場合、同じマシンに Dropstone CLI がインストールされ、dropstone login でサインインしていること
  • ヘッドレスクライアントの場合、API キー と資金が入ったクレジット残高

サポート

メソッドレベルの質問については、CLI リファレンス が最初の参照先です。アカウント、請求、アクセスの問題については、サポートを受ける方法 を参照してください。

Related articles

Ctrl+I