Agent SDK

Agent SDK の提供を本日より開始しました。エージェントをコードのフォルダとして定義し、評価でテストしたうえで、Cursor または自社のインフラストラクチャにデプロイできます。

npx @cursor/agent-sdk init ./my-bot を実行したあと agent-sdk dev を実行すると、プレイグラウンド付きでボットをローカルで起動できます。--template を指定すれば、セキュリティレビュアー、オーナーポリシーに基づく承認ボット、PR 自動修正ツール、Linear または Jira のトリアージボットといったテンプレートから始めることもできます。

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

エージェントを実運用する準備が整ったら、プロジェクトディレクトリで agent-sdk deploy を実行するだけで Cursor にデプロイできます。このコマンドはエージェントをビルドして URL を割り当て、Cursor のインフラストラクチャ上で起動します。シークレットや連携はダッシュボードから管理でき、ローカルで使っているログ、評価、プレイグラウンドもそのまま引き続き利用できます。

コードとしてのエージェント

エージェントは 1 つのプロジェクトとして構成されます。instructions.md がプロンプトです。tools/ 内の各ファイルは、モデルが呼び出せる型付きアクション 1 つに対応します。skills/ にはモデルが必要に応じて読み込む手順を格納し、mcp-connections/ では MCP サーバーのツールを追加し、channels/ ではボットがメッセージを受信・応答する場所を定義します。agent-sdk validate でプロジェクトを検証し、agent-sdk info で検出された内容を出力できます。

チャネル

エージェントは、GitHub、GitLab、Bitbucket の PR、コメント、CI イベント、Slack でのメンションや DM、任意のプロバイダーからのウェブフック、そして cron スケジュールをトリガーに起動します。GitHub のイベントは Cursor アカウント経由で取得されるため、公開ウェブフック URL は不要です。Slack は追加設定なしですぐに使えます。

各会話はそれぞれ独立したセッションを持ち、すべてのメッセージとツール呼び出しの完全な記録を保持します。PR や Slackスレッドで追加の質問をすると、同じセッションが再開されます。

評価

評価では、ボットに固定のメッセージを送信し、その動作を検証します。具体的には、どのツールが実行されたか、どのような入力が渡されたか、応答がどのような構造になっているかを確認します。agent-sdk eval はローカルでも CI でも実行できます。

agent-sdk github replay <pr-url> は、実際の PR を署名付きのウェブフックペイロードに変換してボットに送信します。これにより、GitHub をトリガーとするボットを、プッシュを待たずにテストできます。--dry-run --fixtures-dir fixtures/ を追加すると、ペイロードを評価用のフィクスチャとして保存できます。

はじめる

Agent SDK は本日より一般提供を開始しました。ドキュメントをご覧のうえ、さっそくお試しください。

クラウドエージェントのキャンバスと環境の改善

クラウドエージェントによるキャンバス

クラウドエージェントが、作業の中で対話型のキャンバスを構築できるようになりました。完成したキャンバスは、リンクを送るだけでチームと共有できます。

詳しくはキャンバスの共有をご覧ください。

Environments API

Environments API がベータ版として利用可能になりました。エージェントを実行するクラウド環境を、プログラムから作成・管理できます。

より大規模かつ高速な環境

クラウドエージェント環境で、最大300個のリポジトリをサポートするようになりました。また、大規模な環境の読み込み速度も5倍に向上しています。

Origin App Marketplace

Origin が、デプロイ、CI、コードレビュー、セキュリティ、監視、プロジェクト管理に対応する 20 以上のアプリと連携できるようになりました。Cloudflare、Linear、Sentry、Socket Security などのパートナーが提供するアプリを利用できます。

また本日より、マーケットプレイスで一般からのアプリ申請の受け付けを開始しました。開発者向けツールを構築しているチームなら、どなたでも Origin 向けのアプリを公開できます。

開発スタックに合ったアプリ

マーケットプレイスに、次のカテゴリのアプリが追加されました。

デプロイ、CI、コードレビュー、セキュリティ、監視、プロジェクト管理の各分野のアプリが掲載された Origin App Marketplace

マーケットプレイスに公開する

アプリを申請するには:

  1. 自分のネームスペースでアプリを作成します。構築中、アプリはネームスペース内で非公開のままです。
  2. Origin API を使って構築します。アプリはアプリ JWT とインストールアクセストークンで認証し、ウェブフックイベントを受信して、チェック実行、PR コメント、レビューを書き戻します。
  3. アプリを公開に設定し、アプリのページからスラッグ、推奨タグ、デモ動画を添えて申請します。動画では、インストール、アンインストール、および製品の主要なフローを紹介してください。
  4. 申請内容を当社でレビューし、承認され次第アプリを掲載します。
Origin App Marketplace へのアプリの申請

はじめる

Origin App Marketplaceのアプリを今すぐ試してみましょう。

Origin アプリを構築したい場合は、まず公開ガイドと Origin API リファレンスをご覧ください。

Origin Apps プラグインを使えば、最新の Origin API ドキュメントをもとにご質問に回答したり、すでに運用中のアプリを Origin へ移行する計画を立てたりすることもできます。

ローカルエージェントのリモートコントロール

コンピュータ上で実行中のローカルエージェントを、Cursor iOS アプリから確認し、返信できるようになりました。

はじめに

リモートコントロールは、企業の組織を除くすべてのユーザーに対してデフォルトで有効です。

Cursor iOSアプリをダウンロードしてサインインします。アカウントに紐づいたコンピュータは、アプリに自動的に表示されます。アプリで自分のコンピュータをタップし、Cursorデスクトップアプリでペアリングリクエストを承認してください。ローカルエージェントが一覧に表示されます。いずれかをタップすると、作業内容を確認したり、メッセージを送ったりできます。

Cursor iOSアプリでのローカルエージェントのリモートコントロール

エージェントはお使いのコンピュータ上で実行され続けます

リモートコントロールを使っても、エージェントがどこかへ移動するわけではありません。エージェントはお使いのコンピュータ上で引き続き実行され、アプリはそのエージェントに接続します。リモートコントロールを利用するには、コンピュータの電源を入れたまま、オンラインの状態にしておく必要があります。

コンピュータをスリープさせない

離席中にコンピュータがスリープしないようにするには、Cursor デスクトップアプリの設定の リモートコントロール で「Keep this computer awake」をオンにしてください。なお、コンピュータは電源に接続し、蓋を開けたままにしておく必要があります。

企業向けチームの場合

リモートコントロールは、企業組織を除き、デフォルトで有効になっています。企業の管理者は、Org settings > Security and identity > リモートコントロール から有効にできます。

リモートコントロールはクラウドエージェントがなくても利用できます。

リモートコントロールは現在、Cursor iOS アプリで利用できます。

Rollouts と Security Review

本日、コードのリリースの最終工程を担う 2 つの Cursor ボットの提供を開始します。Rollouts はデプロイ中のすべての変更を監視し、その健全性を環境ごとに報告します。Security Review はすべての PR をチェックし、悪用可能なバグを報告します。

どちらも本日より、Teams プランおよび企業プランで利用可能です。

Rollouts

Rollouts はすべての PR にモニターを割り当て、変更がデプロイされていく過程を監視します。環境ごとに変更の健全性を「正常を確認済み」「リグレッションを検出」「判定不能」のいずれかでレポートします。Firetiger の Change Monitors を Bot Development Kit で再構築した、Cursor 版の機能です。

ダッシュボードから有効化し、ソース管理、デプロイシステム、テレメトリプロバイダーを接続してください。次の PR から Rollouts による監視が始まります。

モニタリングプラン

PR がオープンされると、Rollouts は diff とその変更が影響するシステムを読み取り、モニタリングプランを PR コメントとして投稿します。プランには、特定したリスク、変更で意図している効果、確認するシグナル、そして変更の検証を難しくする計測上の不足点が記載されます。PR 上でプランを編集すると、Rollouts は編集後のバージョンを使います。

デプロイの確認

Rollouts は、変更のコミットに対応するデプロイイベントをきっかけに起動し、ログ、メトリクス、トレースを対象にプランを実行します。環境ごとに個別に確認するため、ステージングでは検証済みの変更でも、本番環境では問題として検出されることがあります。Rollouts はエラーやレイテンシーのシグナルとあわせて、変更が意図した効果を発揮しているかを確認し、判定が出た時点で PR に結果を報告します。

リグレッション

Rollouts はリグレッションを検出すると、原因と疑われる変更を特定し、その作成者に通知します。設定に応じて、レビュー用の revert PR を作成したり、指摘をクラウドエージェントに渡して修正させたりすることもできます。現時点では、Rollouts が自動でマージやロールバックを行うことはありません。

統合

Rollouts は、ソース管理では Origin または GitHub と、デプロイイベントでは継続的デリバリーシステムと、シグナルでは Datadog などのテレメトリプロバイダーと接続します。フィーチャーフラグとの統合も近日提供予定です。

Security Review

Security Review の提供を本日より開始しました。すべての PR をコードベース全体のコンテキストを踏まえて読み込み、悪用可能なバグを報告するレビューコメントを 1 件投稿します。スタイルや品質のチェックは、引き続き Bugbot が担当します。

PR に投稿された Security Review のコメント。悪用可能なバグを重大度と修正案とともに報告している

レビュー対象にしたいリポジトリごとに、ダッシュボードから有効化してください。ドラフト PR はレビューの対象外です。

検出される内容

Security Review は、SQL、コマンド、テンプレートにおけるインジェクションに加え、認証や認可のバイパス (リファクタリングによってチェックが実行されなくなったケースを含む) を検出します。また、ソースにコミットされたシークレットや認証情報、SSRF や未検証のリダイレクト、安全でないデシリアライズ、既知の脆弱性をもたらす依存関係の変更も指摘します。さらに、ユーザー入力がどこから入り込み、どの処理を経由するかを追跡します。

指摘

各指摘には、重大度、攻撃経路、修正案が含まれます。理由を添えて指摘を却下すると、Security Review はその PR で同じ指摘を再び挙げなくなります。

チームルール

外部呼び出しを必ず経由させるクライアントや、リクエストハンドラーからクエリしてはならないテーブルなど、コードベース固有のルールを追加すると、Security Review がすべての PR でそのルールが守られているかをチェックします。

はじめに

Rollouts と Security Reviewer は、本日より Teams プランおよび企業プランでご利用いただけます。自動化 タブからどちらのボットも有効にできます。

今後 10 日間は、実際の変更で Rollouts をお試しいただけるよう、使用量クレジットを付与します。Teams のお客様には約 50 件分、企業のお客様には約 500 件分の変更に相当するクレジットが付与されます。