Skip to main content

Command Palette

Search for a command to run...

Agent

Cursor Agent

エージェントは、複雑なコーディングタスクを自律的に完了し、ターミナルコマンドの実行やコードの編集ができるCursorのアシスタントです。サイドペインでCmd+ICtrl+Iを押して開きます。

エージェントの仕組みについて詳しく学び、より速く開発しましょう。

エージェントの仕組み

エージェントは、次の3つのコンポーネントで構成されています。

  1. Instructions: エージェントの挙動を導くシステム���ロンプトとルール
  2. ツール: ファイルの編集、コードベース検索、ターミナルの実行など
  3. モデル: タスクに応じて選択するエージェントモデル

Cursorのエージェントは、サポートする各モデルに合わせてこれらのコンポーネントを統合し、フロンティアモデルごとにInstructionsとツールを最適化します。新しいモデルがリリースされても、Cursorがモデル固有の最適化を行うため、ソフトウェア開発に集中できます。

ツール

ツールはエージェントを構成する要素です。コードベースやWebを検索して関連情報を見つけたり、ファイルを編集したり、ターミナルコマンドを実行したりできます。

ツール呼び出しの内部的な仕組みについては、ツール呼び出しの基礎を参照してください。

エージェントが1つのタスクで実行できるツール呼び出しの回数に制限はありません。

名前でファイルを検索し、ディレクトリ構造を確認し、ファイル内のキーワードやパターンを正確に検索します。

検索クエリを生成し、Web検索を実行します。

種類と説明に基づいて特定のルールを取得します。

ファイルの内容をインテリジェントに読み取ります。画像ファイル (.png、.jpg、.gif、.webp、.svg) にも対応しており、視覚対応モデルで分析できるよう会話コンテキストに含めます。

ファイルの編集を提案し、自動的に適用します。

ターミナルコマンドを実行し、出力を監視します。デフォルトでは、Cursorは最初に利用可能なターミナルプロファイルを使用します。

使用するターミナルプロファイルを設定するには：

  1. コマンドパレットを開きます (Cmd/Ctrl+Shift+P)
  2. 「Terminal: Select Default Profile」を検索します
  3. 使用するプロファイルを選択します

ブラウザを操作してスクリーンショットを撮影し、アプリケーションをテストし、視覚的な変更を確認します。エージェントはページに移動し、要素を操作し、現在の状態をキャプチャして分析できます。詳細はブラウザのドキュメントを参照してください。

テキストによる説明や参照画像から画像を生成します。UIモックアップの作成、プロダクトアセットの作成、アーキテクチャ図の可視化に役立ちます。画像はデフォルトでプロジェクトのassets/フォルダーに保存され、チャット内にインラインで表示されます。

タスク中に補足の質問をします。回答を待っている間も、エージェントはファイルの読み取り、編集、コマンドの実行を続けます。回答は届き次第反映されます。

チェックポイント

チェックポイントは、エージェントセッション中のコードベースのスナップショットを保存します。エージェントは重要な変更を加える前に自動的にチェックポイントを作成し、変更されたすべてのファイルの状態を記録します。

エージェントが誤った操作をした場合は、チャットタイムライン内の任意のチェックポイントをクリックして、その時点のファイルをプレビューできます。その後、復元するとすべてのファイルをその状態に戻せます。以前のリクエストにある Restore Checkpoint ボタン、またはメッセージにカーソルを合わせたときに表示される + ボタンからも復元できます。チェックポイントを復元すると、ファイルのみが元に戻り、会話からメッセージが削除されることはありません。

チェックポイントは、試行錯誤を伴う作業、複雑なリファクタリング、安全にロールバックできるポイントが必要な反復的な開発に役立ちます。

キュー内のメッセージ

エージェントの作業中に話しかける方法は2つあります。メッセージをキューに追加すると、現在のタスクが完了するまで待機します。今すぐフォローアップを送信すると、エージェントの次のツール呼び出し時にアクティブなターンに指示を出せます。

キューの使い方

  1. エージェントの作業中に、次の指示を入力します
  2. Enter を押してキューに追加します
  3. メッセージは現在のタスクの下に順番に表示されます
  4. 必要に応じてドラッグして、キュー内のメッセージの順序を変更します
  5. エージェントは作業完了後、順番に処理します

キーボードショートカット

エージェントの作業中:

  • Enter を押すと、メッセージをキューに追加します (エージェントが現在のタスクを完了するまで送信されません)
  • Cmd+EnterCtrl+Enter を押すと、キューを介さずにすぐに送信します

即時メッセージ

Cmd+EnterCtrl+Enter で即時送信すると、メッセージはチャット内の直近のユーザーメッセージに追加され、キューで待機せずにすぐ処理されます。

  • メッセージはツールの実行結果に添付され、すぐに送信されます
  • 緊急のフォローアップにも迅速に対応できます
  • エージェントの作業を中断したり、別の方向に切り替えたりする必要がある場合に使用します

実行中のエージェントを誘導する

エージェントの作業中に、エージェントを中断せずにフォローアップを送信して誘導できます。フォローアップを入力して Send now をクリックするか、Enter を2回押します。アクションの途中で作業を中断する代わりに、メッセージはエージェントの次のツール呼び出し時に配信されるため、進行中の作業を保持し、エージェントがタスクを継続できるようにします。

これは現在 cursor.com/agents で利用でき、Agents Window でも順次提供予定です。代わりにターン終了後にメッセージをキューに入れるには、Tab を押します。

CLI では、エージェントの作業中に Enter を押すと、安全な区切りで実行中のランを誘導できます。もう一度 Enter を押すと、ターンを中断します。

/goal による目標

エージェントは各メッセージを新しいタスクとして扱います。/goal を使うと、完全に完了するまでエージェントが取り組む長期的な目標を設定できます。

/goal fix all flaky tests and make CI green

CLI では、Ctrl+C で目標を一時停止できます。エージェントに手順に従わせたい場合は目標を カスタムモード と組み合わせるか、目標を追求する間に定期的なチェックインを行うには組み込みの /loop スキルと組み合わせてください。