Cursor SDK を用いたプログラム型エージェントの構築方法

Cursor SDK を導入しました。これにより、Cursor の基盤となるランタイム、ハネス、モデルをそのまま利用してエージェントを構築できるようになります。

現在、Cursor デスクトップアプリ、CLI、Web アプリで動作しているエージェントは、TypeScript コード数行でアクセス可能になりました。自分のマシン上で実行することも、Cursor のクラウド上の専用 VM で実行することもでき、最先端のあらゆるモデルに対応しています。

まずは npm install @cursor/sdk を実行して始めましょう。また、Cursor SDK プラグインを使用することで、Cursor 自体があなたの開発をサポートします。

`jsx import { Agent } from "@cursor/sdk";

const agent = await Agent.create({ apiKey: process.env.CURSOR_API_KEY!, model: { id: "composer-2" }, local: { cwd: process.cwd() }, });

const run = await agent.send("Summarize what this repository does");

for await (const event of run.stream()) { console.log(event); } `

公開リポジトリからサンプルプロジェクトをいくつか用意しました。これらのプロジェクトをフォークし、ご自身のユースケースに合わせて拡張してください。

Cursor SDK は現在、すべてのユーザー向けにパブリックベータとして利用可能です。料金はトークンベースの従量課金制です。詳細は発表記事とドキュメントをご覧ください。

Cloud Agents API のアップデート

永続的なエージェントとプロンプトごとの実行を軸に API を再設計しました。これにより、フォローアップ、ステータス確認、ストリーミング、キャンセル機能はすべて「実行単位」で管理されるようになりました。

SSE イベントによるネイティブな実行ストリーミング機能を追加し、Last-Event-ID による再接続サポートと、より明確なターミナル状態の定義を行いました。

アーカイブ化、復元、永久削除といったエージェントのライフサイクル制御を明示的に実装しました。

v1 のレスポンスとエラー形式を標準化し、構造化されたエラーコード、items リスト形式のレスポンス、そして agent と run オブジェクトを分離した構造を採用しました。