> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sambanova.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# JetBrains AI Assistant

[JetBrains AI Assistant](https://www.jetbrains.com/ai-assistant/) は、JetBrains 製 IDE (IntelliJ IDEA、PyCharm、WebStorm など) に組み込まれた AI レイヤーで、チャット、コード生成、補完をカバーします。カスタムの OpenAI 互換エンドポイントを接続先に指定できます。

## 前提条件

* [SambaCloud](https://cloud.sambanova.ai/?utm_source=jetbrains\&utm_medium=external\&utm_campaign=cloud_signup) のアカウントと [API キー](https://cloud.sambanova.ai/apis?utm_source=jetbrains\&utm_medium=external\&utm_campaign=cloud_signup)
* JetBrains 製 IDE (IntelliJ IDEA、PyCharm など)
* [Payment methods ページ](https://account.jetbrains.com/licenses/tokens) でクレジットカードを登録した JetBrains アカウント。JetBrains では、トライアルであっても AI 機能の有効化にカードの登録が必要です
* 有効な JetBrains AI のサブスクリプションまたはトライアル (例: **JetBrains AI Pro - trial**)。有効になると、アカウントの [Transactions ページ](https://account.jetbrains.com/licenses/transactions) に表示されます

## セットアップ

**1. JetBrains AI Assistant プラグインのインストール**

**Settings → Plugins** を開いて **JetBrains AI Assistant** を検索し、インストールして、求められたら IDE を再起動します。IDE やエディションによっては、最初からバンドルされている場合もあります。

**2. プロバイダー設定の表示**

**Settings → Tools → AI Assistant → Providers & API keys** に移動します。

**3. SambaNova をカスタムプロバイダーとして追加**

**Third-party AI providers** で、次のとおり設定します。

* **Provider**: `OpenAI` ではなく `OpenAI-compatible`。`OpenAI` を選ぶと API キーのフィールドしか表示されず、URL を指定できないため、SambaCloud に接続できません
* **URL**: `https://api.sambanova.ai/v1`
* **API Key**: お使いの SambaCloud API キー
* **Tool calling**: 有効 (チェックボックスをオン)

**Test Connection** をクリックして接続を確認します。

![Provider に OpenAI-compatible、URL に SambaNova のエンドポイント、マスクされた API キー、Tool calling の有効化が設定され、Model Assignment で Core features と Instant helpers に OpenAIAPI/MiniMax-M3.1-Flash、Context window に 1000000 が表示されている JetBrains AI Assistant の Providers & API keys 設定ページ](https://mintcdn.com/sambanova-systems/Npm5p6hK3E3iySrV/images/docs/integrations/jetbrains-ai-assistant/jetbrains-ai-assistant-providers-configured.png?fit=max\&auto=format\&n=Npm5p6hK3E3iySrV\&q=85\&s=241f424e9bf844c6547ec922255d1e01)

**4. AI Assistant の各機能へのモデルの割り当て**

カスタムモデルがすべての機能で自動的に使われるわけでは**ありません**。同じページの下方にある **Model Assignment** セクションで、次のとおり設定します。

* **Core features** (エディタ内でのコード生成、コミットメッセージ生成など): `OpenAIAPI/MiniMax-M3.1-Flash`
* **Instant helpers** (チャットのコンテキスト収集、チャットタイトルの生成): `OpenAIAPI/MiniMax-M3.1-Flash`
* **Context window**: デフォルトの `64000` から `1000000` に引き上げます。`MiniMax-M3.1-Flash` のコンテキスト長 `1048576` トークンに近い値です。他のモデルのコンテキスト長は [SambaCloud モデル](https://docs.sambanova.ai/docs/ja/models/sambacloud-models.md) をご参照ください

このステップを行わない場合、モデルが回答するのは **AI Chat** だけです。Core features と Instant helpers は、ここでモデルを割り当てるまで別のモデルを使い続けます。

## 使用例: AI Chat

プロバイダーを接続すると、AI Chat は設定した SambaNova モデルで回答します。実際にどのモデルが回答したかは、チャットパネル下部のモデルピッカーで確認できます。

![チャットパネル下部のモデルドロップダウンで MiniMax-M3.1-Flash が選択され、「What can you do?」への回答が、プロジェクトの探索とコードの理解・説明のセクションで始まる形でレンダリングされている PyCharm の AI Assistant チャットパネル](https://mintcdn.com/sambanova-systems/Npm5p6hK3E3iySrV/images/docs/integrations/jetbrains-ai-assistant/jetbrains-ai-assistant-chat-response.png?fit=max\&auto=format\&n=Npm5p6hK3E3iySrV\&q=85\&s=64a84d1960f709c38b283aa7194e315a)

## AI Completion は独立した設定

インラインのコード補完 (入力中にその場で出る提案) は、同じ設定ページの下方にある **AI Completion** で独立して設定します。ここには専用の **Provider** ドロップダウンと専用の **API key** フィールドがあり、上で設定したチャット用プロバイダーは再利用されません。AI Chat を SambaNova に向けても、インライン補完が使うモデルは変わりません。同じ URL とキーで、`OpenAI Compatible` のエントリを別途作成する必要があります。

次に **Model** を選択します。`DeepSeek-V3.1` を使用してください。IDE がコード補完モデルとして認識して **Prompt schema** を **(fim) DeepSeek** に設定するため、提案はカーソルの前後両方のコードを踏まえたものになります。他の SambaCloud モデルは「Model is not recognized」と表示され、そのモデルのファミリーに合った (fim) の **Prompt schema** を自分で選択しない限り、カーソルより前のコードの続きを書くだけになります。

## トラブルシューティング

> [accordion] プロバイダーを選択しても URL フィールドが表示されない
>
> `OpenAI-compatible` ではなく `OpenAI` を選択しています。`OpenAI` には API キーのフィールドしかなく、常に OpenAI 自身のエンドポイントを使用します。`OpenAI-compatible` を選択すると、URL と API キーの両方のフィールドが表示されます。

> [accordion] カスタムモデルが AI Chat では動くのに、コード生成やコミットメッセージでは使われない
>
> これらは **Model Assignment** が管理する別個の機能であり、プロバイダーを接続しただけでは切り替わりません。**Settings → Tools → AI Assistant → Providers & API keys** を開き、**Model Assignment** までスクロールして、**Core features** と **Instant helpers** に SambaNova モデルを明示的に設定してください。

> [accordion] No valid licenses are associated with your account
>
> AI Chat がこのメッセージを表示するのは、有効な JetBrains AI のサブスクリプションまたはトライアルを持つ JetBrains アカウントで IDE にサインインしていない場合です。サードパーティの API キーだけでは AI Chat は利用できません。該当のアカウントで IDE にサインインし、サブスクリプションまたはトライアルが有効であることを確認してから ([前提条件](#前提条件) を参照)、AI Chat を開き直してください。

> [accordion] インラインのコード補完が別のモデルを使い続ける
>
> インライン補完 (**AI Completion**) には、チャットや Core features のプロバイダーとは独立した専用のプロバイダー設定が同じ設定ページにあります。補完でも SambaNova を使う場合は、同じ URL と API キーで別途設定してください。

## 参考情報

* [JetBrains AI Assistant](https://www.jetbrains.com/ai-assistant/)
* [AI Assistant でのカスタムモデルの利用](https://www.jetbrains.com/help/ai-assistant/use-custom-models.html)
* [SambaCloud の対応モデル](https://docs.sambanova.ai/docs/ja/models/sambacloud-models.md)
