Cursor 「Agent SDK」：開発ライフサイクル全体にわたる反復的作業を支えるコード定義型エージェントフレームワーク

開発チームは、開発ライフサイクル全体にわたる反復的な作業を処理するために、コードとして定義されたエージェント（Agent）を活用しています。これにより、チームの活動場所と密接に連携し、関連するイベント発生時に自動動作するエージェントを実装できるようになりました。

主要な特徴と革新

• 独自管理のエージェント: 従来の製品導入やゼロからの構築ではなく、Cursor が独自に管理するフレームワークを使用します。
• 最適化された運用: 各チームの運用スタイルに合わせて最も有用なエージェントを構築可能です。
• Bugbot, Security Reviewer, Rollouts など: フレームワーク「Agent SDK」を活用し、多様な役割のエージェントを開発できます。
• 簡易デプロイメント: 準備が整ったら、1 つのコマンドで Cursor のインフラストラクチャ上に展開可能。

agent-sdk deploy

ワークフローに合わせて構築する

Agent SDK を利用することで、チームのあり方に即したエージェントを迅速に構築・デプロイできます。これらはチームが既に処理しているイベントに応答し、目視・変更可能なポリシーに従って動作します。

• プルリビュー対応: GitHub、GitLab、Bitbucket などのプルリクエストイベントに応答するエージェントを構築可能。
  • 変更のリスク評価
  • 適切なチームへのルーティング
  • ポリシーを満たす変更の承認
• ナレッジベースとの統合: 学習した教訓を大規模なデータベースに蓄積し、すべての PR でチェックを行う構成が可能。
  • コードベースの変化に関わらず過去の判断を維持
  • 記録された教訓と矛盾する変更の指摘
  • 注釈付きの発見事項の提示と是正促進

複雑なタスクへの対応:

• 専用のツールとセッションを持つ他の専門化されたエージェントへのタスク委譲
• 複数のサバージェント（Subagent）による並列処理での作業分割

開発保証機能:

• Evals: 重要なワークフローが期待通りに実行されているかの検証
• イベントリプレイ: 再現性のあるテスト環境の提供
  • これらの機能により、迅速かつ信頼性の高い開発を実現

PGA ツアータムの事例: すべてのソフトウェアファクトリー構成要素を Cursor のインフラストラクチャ上で構築し、開発プロセスを進化させる柔軟性を獲得。標準搭載された Evals サポートを活用することで、新たなアイデアへの迅速な反復と既存機能の信頼性の高い最適化が可能となりました。

すべてをコードで定義する

Agent SDK エージェントは、小型のソフトウェアプロジェクトと同様に構造化されています。指示文や設定は、ツールの実装コード、外部サービスとの接続設定、およびテスト用の Evals と並んで配置されます。

• ファイル単位の役割分担:
  • 各ファイルは「エージェントが知っていること」または「エージェントが実行できること」を表します。
• 記述言語の明確化:
  • プロンプト: Markdown で記述
  • ツール: TypeScript 関数として定義
• バージョン管理とレビュー:
  • すべてがコードであるため、変更もソフトウェアの他の部分と同じプロセス（バージョニング・レビュー）を経ることができます。

必要な場所にエージェントをデプロイする

プロジェクトディレクトリからコマンドを実行して、ローカル環境またはカスタムインフラストラクチャへの展開を選択できます。

ローカルおよび Cursor インフラへのデプロイ

agent-sdk deploy

• ビルドと起動: エージェントをビルドし、URL を付与しながら Cursor のインフラストラクチャ上で起動します。
• ダッシュボード管理: 機密情報や統合はダッシュボードから一元管理可能。
• 継続的な利用: ローカル環境ではログ、Evals、プレイグラウンドを継続して使用できます。

カスタムインフラへの展開

• 各エージェントは単一の Node プロセスとして動作します。
• コンテナにパッケージ化することで、ご自身所有のインフラストラクチャ上で実行可能です。

スタートするための手順

Agent SDK の始め方は、他のソフトウェアプロジェクトを開始する方法とほぼ同様です。まずはプロジェクトディレクトリを作成し、ローカルプレイグラウンドを起動します。

エージェント定義のサンプルコード

以下は、「Robo」という名のコーディングエージェントを定義する TypeScript 例です。

import { homedir } from "node:os";
import { join } from "node:path";
import { defineAgent } from "@cursor/agent-sdk";

export default defineAgent({
  name: "Robo",
  model: {
    id: "composer-2.5",
    params: [
      { id: "effort", value: "high" },
      { id: "fast", value: "true" },
    ],
  },
  local: {
    cwd: join(homedir(), ".cache", "factory", "robo"),
  },
});

開発フローの支援

1. ローカルでの反復開発: プロンプトとコードを調整しながら迅速にプロトタイプを作成。
2. Evals の実行: デプロイ前にテスト環境で動作を確認。
3. ドキュメント指向: コーディングエージェントの開発プロセスを支援するスキルセットが同梱されており、ドキュメントに基づいてボットの構築をサポートします。

Agent SDK は本日より一般利用開始となりました。詳細については Cursor の公式ドキュメントをご覧ください。