CursorのAI機能の使い方

ここでは、Cursorの重要なAI機能である「Command K」と「ASK」機能を紹介します。AIドリブンな統計解析を行ううえで大変役立つ機能なので、ぜひ押さえておきましょう。

重要機能その1: Command K(Ctrl+K)

Command K(コマンドK) は、コード上からAIに指示を与える機能です。指示に応じて、 AIがコードを編集したり、新しいコードを生成する作業をスムーズに行えます。

起動手順

Command Kは以下の2つの方法で起動できます。

1. ⌘+K または Ctrl+K を押す。
2. コードの一部を選択すると表示される「Edit」ボタンをクリックする。

Command Kを起動すると、コードの上部にウィンドウが表示され、選択したコードの編集や新規コードの生成を行うことができます。

Command Kの使い方

Command Kのウィンドウでできることは以下のとおりです。

  1. プロンプト入力欄
    • 未入力の状態では「New code instructions…」などと表示されます。
    • ここにAIへの指示を入力します。たとえば、コードの改善や修正に関する指示を入力すると、AIが提案を返してくれます。
  2. Generate ボタン
    • 入力内容を確定してAIに送信するためのボタンです。
    • これにより、AIが指定に基づいたコードを生成します。
  3. quick question ボタン
    • このボタンを使うと、コード自動入力の前に処理内容の説明を求めたり、AIが指示を正しく理解しているか、などを確認できます。
    • たとえば、「このコードについて説明して」などと質問すると、AIは選択したコードがどのような処理を行うのかを解説してくれます。
    • quick questionの後にコードを実行してほしい場合は、Follow-up or new code instructions... に「実行して」と入力したり、修正が必要な場合は改善指示を追加してください。
  4. モデル選択
    • 使用できるモデルを選択できます。
  5. 「↑」キー
    • 過去の入力履歴を表示できます。
  6. 「@」キー
    • AIに質問する際、プロンプトだけでなく他のファイルなどのデータを参照させることができます。
    • 詳細はこちらの記事で解説しています。

Apply機能

Apply機能は、AIが提案したコードの変更を承認または却下するだけで、簡単に適用できる便利な機能です。以下の流れで使用します。

  1. 「Command K」での指示に基づいてAIがコードの生成・修正を行います。
  2. AIの提案は、変更前のコードを赤のハイライト、変更後のコードを緑のハイライトで並べて表示されます。
  3. Acceptボタン(または Ctrl+Enter)で変更を承認します。Rejectボタン(または Ctrl+Delete)で取り消します。

Command K: Follow-up Instructions

Generateボタンを押した後、あるいはquick questionボタンを押した後に、追加の指示を与えられる機能です。例を挙げます。

  1. Command Kで「説明変数にsmokeを加えて」と指示すると、回帰モデルの説明変数にsmokeが追加されます。
  2. 次に、Follow-up Instructions...に「コメントを追加」と入力しSubmit Editを押すと、最初の修正に加えてコメントが付与されます。

重要機能その2: AI CHAT(Ctrl+L)

Cursorには、上記で紹介したCommand Kのようにコード上でAIを呼び出せるほか、「AIペイン」と呼ばれるスペースでAIに質問やコード修正を行うAIチャット機能が搭載されています。このページでは、無料版でも使用できる「ASK」機能に限定して紹介します。他の2つの「Agent」「Edit」機能についてはこちらの記事で解説しています。

起動手順

AIチャット画面を開きたい場合は、タイトルバーの「Toggle AI Pane」ボタンをクリックするか、⌘+L または Ctrl+L を押します。

  1. New Chat ボタン
    • +アイコンをクリック、または Ctrl+N を押すと新しい(空の)チャット画面が表示されます。
  2. Previous Chats ボタン
    • 時計と矢印のアイコンであるShow Chat Historyボタンをクリックすると、チャットの履歴リストが表示されます。
    • 上部の検索欄にテキストを入力すると、一致するチャット名のリストに絞り込むことができます。
    • Chat画面の下部にも過去のチャット履歴がスレッドごとに表示されます。
  3. アイコンのボタン
    • こちらをクリック、あるいはタイトルバーのToggle AI PaneボタンをクリックするとAI Chat画面が閉じます。
  4. モードを選ぶ
    • 「Agent」「Ask」「Edit」の3つのモードから「Ask」を選択します。右側にチェックがついていることを確認します。

Askの使いかた

チャットウィンドウのに指示や質問を入力します。

例:エラーの原因を相談する
model <- ols(bwt ~ age + race + smoke) を実行しようとして出たエラーの原因を調べたい場合は、エラーの表示をコピーしてChatに貼り付けてから「エラーの解決法を教えて」と入力してみてください。

  1. Chatの上部には、参照しているファイル名やコードが表示されます。たとえば「test.R」や「Lines 201-202 Terminal」がタブとして表示される場合、AIが回答を作成する際に参照しているのは「test.R」ファイル(エディタの全面にあるファイルが自動で参照される)とターミナルの201-202行目であることを示しています。
  2. エラーについて「解決法を教えて」と入力します。
  3. Submitをクリック、またはEnterを押します。

すると、下記のようにエラー解決方法を提案してくれます。

この例では、ols()を実行するためにrmsパッケージが読み込まれていないことが原因でした。まだrmsパッケージをインストールしていない場合は、以下のコマンドを実行してください。


install.packages("rms")

生成された修正案を受け入れる場合は「Apply」ボタンをクリックします

「Command K」と同様に、変更前のコードが赤のハイライト、変更後のコードが緑のハイライトで表示されます。

Acceptボタン(または Ctrl+Enter)で変更を承認し、Rejectボタン(または Ctrl+Delete)で変更を取り消します。

APIで使用する一部のモデルなどではApply機能がサポートされていません。 その場合は、CHAT内の提案コードをコピーしてエディタに貼り付ける必要があります。


モデルの切り替え

チャットのプロンプト入力欄の左下にあるプルダウンメニューをクリックすると、利用可能なモデルの一覧が表示されます。

利用できるモデルは、ユーザーの登録状況(無料・有料プラン)や設定、あるいはCursorのバージョンによって異なります。機能(Applyボタンなど)や処理コスト・回答精度がモデルごとに違うため、簡単な修正は低コストモデル、高度な修正にはハイスペックモデルを選ぶなど、状況に応じて使い分けると効率的です。


シンボル参照機能

「Command K」と同様に、AIに質問するときに 「@」を入力することで他のファイルを参照させることができます。使いかたの詳細はこちらの記事で解説しています。

重要機能その3: 「Agent」「Edit」機能

「Ask」機能では、AIに質問し、必要に応じてApplyしてコードの提案を手元に反映させることができました。残る2つの「Agent」「Edit」はコードを修正したり、新たなファイルを作成する能力に特化した機能です。いわゆる「AIエージェント」と呼ばれる機能(AIが自律的にコードの生成・実行・ファイル作成を行う)は、「Agent」モードが相当します。この2つの機能について詳細は下記記事にまとめていますのでご確認ください。

コメント