Cursor SDKでプログラムエージェントを構築

CursorはCursor SDKを発表しました。これは、開発者がCursorデスクトップアプリ、CLI、Webアプリと同じエージェントランタイムをプログラムで構築・利用できる新しいツールセットです。このSDKを使用すると、数行のTypeScriptコードでエージェントを作成し、ローカルマシン、Cursorのクラウドインフラ、またはセルフホストのワーカー上で実行できます。

SDKの核となるのはAgentクラスです。開発者はAgentインスタンスを作成し、APIキー、モデル、実行環境（ローカルまたはクラウド）を指定します。その後、sendメソッドでプロンプトを送信し、ストリームで応答を受信します。簡単なコード例を以下に示します：

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);
}

本番環境向けには、SDKはクラウドセッション機能を提供します。各クラウドエージェントは専用の仮想マシン上で実行され、強力なサンドボックス、リポジトリのクローン、完全に構成された開発環境が用意されます。エージェントはラップトップがスリープ状態になったりネットワークが切断されても実行を継続し、タスク完了後は自動的にPRを作成したり、ブランチをプッシュしたり、デモやスクリーンショットを添付したりできます。以下はクラウドエージェントの例です：

const agent = await Agent.create({
  apiKey: process.env.CURSOR_API_KEY!,
  model: { id: "gpt-5.5" },
  cloud: {
    repos: [{ url: "https://github.com/cursor/cookbook", startingRef: "main" }],
    autoCreatePR: true,
  },
});

const run = await agent.send("Fix the auth token expiry bug");
console.log(`Started ${run.id}`);

// 後でどこからでも結果を確認
const result = await (
  await Agent.getRun(run.id, { runtime: "cloud", agentId: run.agentId })
).wait();
console.log(result.git?.branches[0]?.prUrl);

SDKは更新されたCloud Agents APIに基づいており、クラウドエージェントの実行はCursorのエージェントウィンドウとWebアプリに表示されるため、開発者はタスクを開始した後、Cursorで進行状況を確認したり作業を引き継いだりできます。

Cursor SDKはCursor全プラットフォームと同じ完全なエージェントツールチェーンを提供します：

• インテリジェントコンテキスト管理：コードベースのインデックス作成、セマンティック検索、インスタントgrepにより、エージェントがより高速かつ効率的に正しい結果に到達できます。
• MCPサーバー：エージェントはstdioまたはHTTPを介して外部ツールやデータソースに接続でき、.cursor/mcp.json設定ファイルまたは呼び出し時にインラインで設定できます。
• スキル：エージェントはリポジトリの.cursor/skills/ディレクトリから自動的にスキルを取得します。
• フック：.cursor/hooks.jsonファイルを使用して、クラウド、セルフホスト、ローカル環境でエージェントループを監視、制御、拡張できます。
• サブエージェント：メインエージェントがAgentツールを介して生成する、独自のプロンプトとモデルを持つ名前付きサブエージェントにサブタスクを委任できます。

SDKはCursorでサポートされているすべてのモデルを利用でき、専用のコーディングモデルComposer 2は汎用モデルの数分の一のコストで最先端のパフォーマンスを実現します。開発者は1つのフィールドを変更するだけで、タスクに最適なモデルを選択し、コストと能力のバランスを調整できます。

現在、チームはCursor SDKを使用してさまざまなカスタムエージェントを構築しています。たとえば、CI/CDパイプラインから直接プログラムエージェントを起動して変更を要約したり、CI障害の根本原因を特定し、PRを修正で更新したりしています。他のチームは、非技術チームがコードを書かずに製品データをクエリできる内部アプリケーションなどのカスタムエージェントプラットフォームを構築しています。一部の顧客はCursorを顧客向け製品に直接埋め込んでおり、エンドユーザーはホストアプリケーションを離れることなくエージェントエクスペリエンスを利用できます。

Cursorは、クイックスタート、プロトタイピングツール、かんばんボードアプリ、CLIツールなど、いくつかのサンプルプロジェクトを公開GitHubリポジトリで提供しており、開発者はこれらをフォークして拡張できます。

Cursor SDKは現在パブリックベータ版で、全ユーザーが利用可能です。課金は標準のトークンベース消費価格に基づきます。インストール方法：npm install @cursor/sdkを実行し、Cursorのネイティブ/sdkスキルを使用して構築のガイダンスを得てください。CursorはSDKへの投資を継続し、より多くの言語、ワークフロー、デプロイメントパターンでプログラムエージェントを構築しやすくすることを目指しています。