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

Cursor SDK を導入することで、Cursor の基盤となるランタイム、ハネス、およびモデルと同じ環境でエージェントを構築できるようになりました。

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

開始するには 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 経由での再接続サポートと明確なターミナル状態を実装しました。

アーカイブ、アンアーカイブ、恒久的削除を含む明示的なエージェントライフサイクル制御を追加しました。

構造化エラーコード、items リスト応答、および独立した agent / run オブジェクトを含む、v1 のレスポンスとエラー形状を標準化しました。