Qt AI Assistant の使用

Qt AI Assistantはコーディングアシスタントです。大規模言語モデル（LLM）に接続すると、コードの自動補完、専門的なコーディングアドバイス、コード修正の提案に加え、テストケースやコードドキュメントの作成も行います。

Qt AI Assistantは、対象となる商用Qt開発者ライセンス保有者が利用可能です。ライセンスに関する詳細については、Qtの価格設定ページで「Compare 」を選択してください。

Qt AI Assistant の基本を学ぶには、「Qt Academy: Getting Started With Qt AI Assistant」コースを受講してください。

Qt AI Assistantは現在実験段階にあり、生成AIによって動作しています。すべての提案内容を確認し、プロジェクトでの使用に適しているかご確認ください。

Qt AI Assistantのインストール

Web から Qt AI Assistant 拡張機能を読み込むには：

1. Extensions モードに移動します。

   

2. 「Use external repository 」を選択します。
3. 「AI Assistant 」を選択します。
4. 「Install 」を選択します。

インラインチャットウィンドウでコードの構文強調表示を有効にする

インラインチャットウィンドウでコードの構文強調表示を有効にするには、[Preferences ] > [Text Editor ] > [Generic Highlighter] の順に移動し、[Download Definitions] を選択します。

詳細については、「ハイライト定義のダウンロード」を参照してください。

Ollamaのインストールと使用

Qt AI Assistant 拡張機能を使用して、お使いのコンピュータ上でローカルに実行されている LLM を利用するには、Ollama をインストールしてください。Ollama の選択リストから利用可能なモデルだけでなく、Ollama に追加したカスタムモデルも実行できます。

Ollamaでのモデルの実行

モデルを実行するには、次のように入力します：

ollama run <model-name>

例：

ollama run codellama:7b-code

Ollamaでサポートされているモデル

Ollamaから以下のモデルを直接使用できます：

• codellama:7b-code
• deepseek-coder-v2:lite
• gpt-oss:20b
• theqtcompany/codellama-7b-qml
• theqtcompany/codellama-13b-qml

カスタムモデル

カスタムモデルの場合は、そのモデル固有のインストール手順に従ってください。以下のカスタムモデルを使用できます:

• codellama:7b-code-qml
• codellama:13b-code-qml

LLMへの接続

以下のLLMに接続できます：

• Code Llama 13B Qml（Qt 6用、お好みのクラウド環境上で実行）
• Code Llama 13B（Qt 5用、お好みのクラウド環境上で実行）
• Codestral（Mistral提供）
• Claude 4.0 Sonnet（Anthropic提供。Anthropicアカウントでトークンベースの課金支払い方法が設定されている必要がある点にご注意ください。
• Claude 4.5 Sonnet（Anthropic 提供。Anthropic アカウントでトークンベースの課金支払い方法が設定されている必要があることにご注意ください。
• GPT 5（OpenAI 提供。OpenAI アカウントでトークンベースの課金支払い方法を設定しておく必要があることにご注意ください。
• DeepSeek V3.2（DeepSeek 提供）
• Ollama 経由の Code Llama 13B QML（お使いのコンピュータ上でローカルに実行）
• Ollama 経由の Code Llama 7B QML（お使いのコンピュータ上でローカルに実行）
• Ollama 経由の Code Llama 7B（お使いのコンピュータ上でローカルに実行）

LLMに接続するには：

1. Preferences >AI Assistant >General にアクセスします。

   

2. LLM で、LLM を選択します。
3. Authentication token で、LLMのAPI認証キーを入力します。

複数のLLMに接続し、ユースケースに応じて切り替えるには：

1. Preferences >AI Assistant >Advanced に移動します。

   

2. 設定可能なユースケースごとに、LLMを選択します。
3. Model Configuration で、各 LLM の API 認証トークンとサーバー URL を入力します。アクセス情報の入手方法の詳細については、サードパーティの LLM プロバイダーのドキュメントを参照してください。

自動コード補完

Qt AI Assistantは、次に何を入力すべきかを提案することで、コードの記述を支援します。入力を停止すると、LLMにプロンプトを送信して1つのコード提案を生成します。

提案全体を受け入れるには、Tabキーを押してください。

提案の一部のみを受け入れるには、Alt+右矢印キーを押します。

提案をキャンセルするには、Escキーを押すか、コードエディタ内の別の位置に移動してください。

マウスを使って Qt AI Assistant を操作するには、提案の上にカーソルを合わせます。

提案にカーソルを合わせると、提案されたコードスニペットの一部を単語単位または行単位で採用できます。

コード補完バーを閉じるには、Escキーを押すか、カーソルを別の位置に移動してください。

コード補完に使用するモデルを選択するには、[Preferences ] > [AI Assistant ] > [General] の順に移動します。

General では、すべてのプロジェクトに対してコードの自動補完機能をグローバルに有効または無効にすることもできます。Qt AI Assistant は、LLM からかなりの数のトークンを消費します。コストを削減するには、必要がないときは自動補完機能をオフにし、コード補完にはキーボードショートカットを使用してください。

キーボードからのコード補完

コードの候補を手動で表示するには、Ctrl+' を選択します。

プロンプトとスマートコマンドの入力

テキストエディタのインラインプロンプトウィンドウでは、自然言語でアシスタントにリクエストを実行させたり、質問をしたり、スマートコマンドを実行させたりすることができます。チャットを開くには、Ctrl+Shift+A を選択します。あるいは、コードを選択してから [] を選択して、インラインプロンプトウィンドウを開くこともできます。

インラインプロンプトウィンドウを閉じるには、Escキーを押すか、 を選択します。

インラインプロンプトウィンドウから Qt AI Assistant の設定画面に移動するには、 （Preferences ）を選択します。そこで、プロンプトやコードレビューに使用するモデルを設定できます。

自然言語で提案をリクエストする

自然言語で提案をリクエストするには、入力フィールドにリクエストを入力します。コードをハイライトしている場合、AI アシスタントはそのコードをプロンプトのコンテキストとして追加します。Qt AI Assistant は提案を表示し、インラインプロンプトウィンドウで「Copy 」を選択することで、その提案をクリップボードにコピーできます。

コードレビューを依頼する

Qt AI Assistant を使用してコードをレビューするには：

1. コードエディタでコードを選択します。
2. インラインプロンプトウィンドウを開きます。
3. 「/review 」スマートコマンドを選択します。

Qt AI Assistantがコードをレビューし、改善案を提案します。Preferences >AI Assistant >General で「Enable QML linter 」が有効になっている場合、QMLコードのレビューにはQML Lintが使用されます。

Qt Test の構文でテストケースをリクエストする

Qt AI Assistant を使用してテストケースを作成するには：

1. コードエディタでコードを選択します。
2. インラインプロンプトウィンドウを開きます。
3. 「/qtest 」スマートコマンドを選択します。

Qt AI Assistantは、 Qt TestQt Testプロジェクトにコピーして貼り付けることができる形式で生成します。

生成された Qt Test ケースを実行するには、CMakeLists.txt ファイルとmain.cpp ファイルを設定してください。

メインプロジェクトの設定CMakeLists.txt

1. モジュールをライブラリとQMLモジュールの両方のタイプとして定義します。URIの値によって、TestCase スクリプトで使用されるインポート名が決定されます：

   qt_add_library({module_name} STATIC)
   qt_add_qml_module({module_name}
       URI {module_name}
       VERSION 1.0
       QML_FILES
               Main.qml
   )

2. 自動生成されたプラグインをターゲットのリンクライブラリに追加します。プラグイン名は<module_name>plugin という形式に従います:

   target_link_libraries({project}
       PRIVATE Qt6::Quick {module_nameplugin}
   )

3. QMLエンジンがモジュールを確実に検出できるように、ファイルの末尾にQML_IMPORT_PATH を追加してください：

   set(QML_IMPORT_PATH ${CMAKE_BINARY_DIR} CACHE STRING "" FORCE)

テストプロジェクトの設定CMakeLists.txt

プラグインをテストターゲット（test_directory）にリンクします:

target_link_libraries({test_directory} PRIVATE Qt${QT_VERSION_MAJOR}::QuickTest {module_nameplugin})

メインプロジェクトの設定main.cpp

登録済みのモジュールからQMLコンポーネントを読み込むには、loadFromModule() を使用します:

engine.loadFromModule("{module_name}", "Main");

外部テストプロジェクトの設定

テストプロジェクトがメインプロジェクトの外にある場合：

1. テストプロジェクト内にメインプロジェクトをサブディレクトリとして追加します（CMakeLists.txt ）：

   add_subdirectory(../{main_project_directory} ${CMAKE_BINARY_DIR}/{main_project_directory})

2. Qtがモジュールを検出できるように、Qmlのインポートパスを設定します:

   set_target_properties({test_directory} PROPERTIES
       QT_QML_IMPORT_PATH "${CMAKE_BINARY_DIR}/{main_project_directory}"
   )

プロジェクトを再ビルドします。

Markdown形式のコードドキュメントを生成する

コードドキュメントを作成するには:

1. コードエディタでコードを選択します。
2. インラインプロンプトウィンドウを開きます。
3. 「/doc 」スマートコマンドを選択します。

Qt AI Assistantが、ドキュメントファイルにコピー＆ペーストできる形式でコードドキュメントを生成します。

コードの修正を依頼する

コードの修正を依頼するには：

1. コードエディタでコードを選択します。
2. インラインプロンプトウィンドウを開きます。
3. 「/fix 」スマートコマンドを選択します。
4. 必要に応じて、コードに変更を適用します。

Qt AI Assistantが、コードに適用できる修正案を提案します。

コードの説明をリクエストする

既存のコードの説明をリクエストするには：

1. コードエディタでコードをハイライト表示します。
2. インラインプロンプトウィンドウを開きます。
3. 「/explain 」スマートコマンドを選択します。

Qt AI Assistantが、ハイライトされたコードの説明を提供します。

インラインコメントの追加

Qt AI Assistant を使用して既存のコードにインラインコメントを追加するには：

1. コードエディタでコードをハイライトします。
2. インラインプロンプトウィンドウを開きます。
3. 「/inlinecomments 」スマートコマンドを選択します。
4. 必要に応じて、コードにコメントを適用します。

Qt AI Assistant によって、コードに適用できるインラインコメントが追加されます。