Cursor SDK を用いたプログラム型エージェントの構築方法
開発ツール「Cursor」が、同社のランタイムやモデルを活用したエージェントを TypeScript で構築できる 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 のレスポンスとエラー形状を標準化しました。
原文を表示
We're introducing the Cursor SDK so you can build agents with the same runtime, harness, and models that power Cursor.
The agents that run in the Cursor desktop app, CLI, and web app are now accessible with a few lines of TypeScript. Run it on your machine or on Cursor's cloud against a dedicated VM, with any frontier model.
Run npm install @cursor/sdk to get started and use the Cursor SDK plugin so Cursor can help you build.
`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); } `
We built a few sample projects that you can access from a public repo. Fork and extend them for your own use case.
The Cursor SDK is now available for all users in public beta and is billed based on standard, token-based consumption pricing. Learn more in our announcement and docs.
Updates to the Cloud Agents API
Reworked the API around durable agents and per-prompt runs, so follow-ups, status, streaming, and cancellation are now run-scoped.
Added first-class run streaming with SSE events, reconnect support via Last-Event-ID, and clearer terminal states.
Added explicit agent lifecycle controls with archive, unarchive, and permanent delete.
Standardized v1 response and error shapes, including structured error codes, items list responses, and separate agent / run objects.
関連記事
Cursor のデザインモード機能強化
Cursor ブラウザのデザインモードが更新され、ユーザーは要素を複数選択したり音声で指示を出したりして、エージェントに UI 変更を依頼できるようになった。
Cursor SDK にカスタムストア、カスタムツール、自動レビュー機能を追加
Cursor は TypeScript および Python SDK の新機能として、エージェントや実行メタデータの保存方法の選択、独自関数のツール化、ローカルツールの自動レビュールーティング、サブエージェントのネスト対応を実装しました。これにより、プロダクションスクリプトや CI 環境での利用が容易になります。
Canvas のデザインモードとコンテキスト使用状況レポート機能の追加
Cursor が Canvas にデザインモードを追加し、UI 要素を直接選択・注釈して編集を指示できるようになった。また、コンテキストの使用状況を把握する新機能も導入された。
今日のまとめ
AI日報で今日の重要ニュースをまとめ読み