# CursorのDocs機能を使ってみた

> CursorのDocs機能を使って、Gemini APIを利用したテキスト生成アプリケーションを作ってみた。

- 公開日: 2024-08-26
- 著者: Tsukamura
- タグ: Cursor
- URL: https://tech.anycloud.co.jp/articles/cursor-docs-feature

---

以前CursorのBeta機能であるAI Reviewを使ってみた記事を書きました。

<div class="link-card-wrap"><a class="link-card" href="/articles/cursor-ai-review/" target="_blank" rel="noopener noreferrer"><span class="link-card-body"><span class="link-card-title">CursorのAI Review機能つかってみた</span><span class="link-card-description">CursorのAI Review機能を使ってみた感想、おすすめの活用方法を解説します</span><span class="link-card-meta"><img class="link-card-favicon" src="./linkcard-01-favicon.ico" alt=""><span class="link-card-domain">tech.anycloud.co.jp</span></span></span><img class="link-card-image" src="./linkcard-01-image.webp" alt=""></a></div>

今回はCursorのメイン機能といっても過言ではないDocs機能を使っていこうと思います。

## Docs機能とは？

Cursorのチャット機能は、エディタ上でchatGPTのように対話形式でやり取りができ、コードベースに関する質問やコードの実装・修正を効率的に行うことができます。

その特徴は、ファイルやフォルダ内の情報など、さまざまなコンテキストを追加できることです。

そして「Docs機能」は、外部URLを参照することで、AIにサードパーティのライブラリやドキュメントを理解させることができる機能となっています。

## Docs機能の使い方

Docs機能の使用方法は意外と簡単です。

通常のチャット欄に「@」+登録しているドキュメント名を入力するだけです。

これだけで、指定されたドキュメントの内容を参照しながら、より正確で実用的な回答を提供してくれるようになります。

デフォルトでも様々なドキュメントを参照できます 👀

<figure><img src="./image-001.webp" alt="デフォルトのDocs" width="1126" height="362"></figure>

## Docs機能をつかってみた

今回は、Google AIが提供するGemini APIを使用してテキスト生成を行うReactアプリケーションを作成していきます。

Gemini APIは、自然言語処理や画像認識などの高度なAI機能を提供するツールです。

<div class="link-card-wrap"><a class="link-card" href="https://ai.google.dev/gemini-api?hl=ja" target="_blank" rel="noopener noreferrer"><span class="link-card-body"><span class="link-card-title">https://ai.google.dev/gemini-api?hl=ja</span><span class="link-card-meta"><span class="link-card-domain">ai.google.dev</span></span></span></a></div>

Docs機能の有無でどのような違いが出るか、比較していきましょう。

### Docの読み込みなしの場合

まず、Docs機能を使わずにGemini APIのテキスト生成の実装をお願いしてみました。

結果は...

-   APIのエンドポイントや認証方法は仮定に基づいたもの
-   雰囲気は似ているものの、実際のAPIとは異なるコードが生成された
-   AIに確認すると、一般的なリクエスト方法で作成しており、ドキュメントを見て修正する必要があると回答
-   動作確認をしても当然動きませんでした

<figure><img src="./image-002.webp" alt="Docs機能なしでの実装" width="1184" height="1494"></figure>

### Docの読み込みありの場合

次に、Docs機能を使ってGemini APIのドキュメントを読み込ませてみました。

1.  Docsの追加方法
    -   Cursor Settings → Features から追加
        
        <figure><img src="./image-003.webp" alt="Add new doc" width="1994" height="686"></figure>
        
    -   今回は「Gemini API」という名前で、クイックスタートのドキュメントを読み込ませました。
        
        <div class="link-card-wrap"><a class="link-card" href="https://ai.google.dev/gemini-api/docs/quickstart?hl=ja" target="_blank" rel="noopener noreferrer"><span class="link-card-body"><span class="link-card-title">https://ai.google.dev/gemini-api/docs/quickstart?hl=ja</span><span class="link-card-meta"><span class="link-card-domain">ai.google.dev</span></span></span></a></div>
        
        <figure><img src="./image-004.webp" alt="Docs機能でGemini APIのドキュメントを読み込ませる" width="1884" height="742"></figure>
        

2.  リクエストに「@Gemini API」を追加
    -   Gemini APIのドキュメントを読み込んでいることがわかりますね
        
        <figure><img src="./image-005.webp" alt="Docs機能に@Gemini APIを追加" width="1106" height="858"></figure>
        

3.  結果
    
    かなりそれっぽいコードが生成されました。
    
    apiKeyを設定し、実際に動かして試してみます。
    
    <figure><img src="./image-006.webp" alt="生成されたコード" width="1100" height="1540"></figure>
    

「UIやレイアウトをととのえてください」という指示を追加で行い生成されたコードを実行するとGemini APIのリクエストも成功して、バグもなく出力されました！

<figure><img src="./image-007.webp" alt="Gemini APIを使った成果物" width="2678" height="1544"></figure>

## おわりに

今回はわかりやすくGemini APIのセットアップの内容で試してみました。

CursorのDocs機能を使う前はchatGPTに相談して似たようなことをやっていたんですが、外部URLの参照は@で簡単にできたり、生成されたコードをそのままファイルに反映したりとユーザー体験がとてもいいのが印象的でした。

他にもドキュメントを読みこんで質問しながら知見を深めたり、要件・仕様に関するドキュメントを読み込んでより複雑なサービスを開発することもできそうですね！

この記事を読んでCursorに興味を持った方は、ぜひ実際に触れてみてください。
