JetBrains AI Assistant 將生成式 AI 編程功能、自主多步驟代理(Agent)以及深度語義程式碼智慧直接整合至 JetBrains 開發環境中,支援包含 IntelliJ IDEA、PyCharm、WebStorm、GoLand、CLion、Rider、PhpStorm、RubyMine、RustRover、DataGrip 與 DataSpell 在內的全系列 IDE。該助手並非獨立運作的聊天介面或通用的文字預測器,而是深度連接 IDE 內部的專案索引、抽象語法樹(AST)和版本控制系統,以提供具備情境感知能力的程式碼生成、多行自動完成、後續編輯建議(Next Edit Suggestions)、自動化測試編寫以及結構化重構。成功部署與設定 JetBrains AI Assistant 需要軟體開發人員與工程團隊主管確認 IDE 版本先決條件、完成個人或企業層級的安裝與授權啟用、調校編輯器內的自動完成參數、建立儲存庫層級的專案規則,並針對模型提供商與外部模型情境通訊協定(MCP)工具配置安全邊界。
IDE 相容性與版本先決條件
在啟用 JetBrains AI Assistant 之前,開發人員必須確保本機環境符合特定的執行階段、平台與組織條件。
支援的環境與 IDE 基準版本
JetBrains AI Assistant 以附加元件(外掛程式)的形式發行,適用於 JetBrains 產品系列。受支援的 IDE 需要符合特定的基準版本:
- 商業版 JetBrains IDE:相容於所有商業 IDE 的 2023.3 或更新版本,包含 IntelliJ IDEA Ultimate、PyCharm Professional、WebStorm、CLion、GoLand、Rider、PhpStorm、RubyMine、RustRover、DataGrip 與 DataSpell。
- 社群版 IDE:開放原始碼社群版(例如 IntelliJ IDEA Community Edition 或 PyCharm Community Edition)要求 2024.1.1 或更新版本。若要在社群版中綁定組織級 JetBrains AI 訂閱,團隊必須執行 2024.2.1 或更高版本。
- 跨平台支援:支援符合宿主 IDE 標準系統需求的 64 位元 Windows、macOS(Intel 與 Apple Silicon)以及 Linux 工作站。
運算拓撲:雲端 LLM 與本機硬體
在預設狀態下,JetBrains AI Assistant 透過 JetBrains AI 服務或第三方 API 提供商代管的雲端大型語言模型執行推論。在此組態下,開發人員工作站幾乎不會產生額外的 CPU、GPU 或電池負載。
然而,對於採用自我託管開放權重模型(例如 Ollama 或私有 OpenAI 相容推論端點)的團隊,則必須在工作站配置專用運算資源,包含充裕的專用視訊記憶體(VRAM,依參數量化程度通常需要 8 GB 至 24 GB),以確保即時的 Token 串流輸出。
組織先決條件
對於使用由雇主或教育機構派發之 IDE 授權的開發人員,AI 功能的存取權限在組織層級進行控管:
- 組織管理員必須在企業 JetBrains Account 管理控制台中啟用 JetBrains AI 服務。
- 若組織實施嚴格的智財權治理或安全防護政策,管理員可在開發人員進行啟用前分配共用點數池或指定核准的第三方提供商。
安裝與啟用 JetBrains AI Assistant
JetBrains AI Assistant 外掛程式在個人安裝環境中預設為停用狀態,且在明確安裝並完成啟用前,絕不會存取專有原始碼。
安裝途徑
開發人員可透過支援的 IDE 中的三個主要入口安裝該外掛程式:
- JetBrains Marketplace(設定介面):
- 在 Windows/Linux 上按下
Ctrl+Alt+S開啟Settings,或在 macOS 上按下Cmd+,開啟Preferences。 - 在左側邊欄選擇
Plugins,並切換至Marketplace分頁。 - 在搜尋欄輸入
AI Assistant。 - 在官方 JetBrains 外掛程式項目點擊
Install,並在出現提示時重新啟動 IDE。
- 在 Windows/Linux 上按下
- AI Chat 工具視窗:
- 點擊右側工具視窗停靠列上的
AI Chat圖示。 - 點擊空白工具視窗內顯示的
Install Plugin按鈕以觸發背景安裝。
- 點擊右側工具視窗停靠列上的
- JetBrains AI 視窗標題列小工具:
- 在現代 IDE 介面標題列中,找到
JetBrains AI狀態小工具。 - 點擊
Let's Go即可自動下載並初始化外掛程式。
- 在現代 IDE 介面標題列中,找到
授權層級與啟用情境
安裝完成後,開發人員必須使用對應的授權模式啟用外掛程式。JetBrains 在啟用情境下支援多種驗證管道:
| 啟用選項 | 是否需要訂閱 | 可用功能 | 主要計費實體 |
|---|---|---|---|
| JetBrains AI 訂閱 | 是(Free、Pro、Business、Ultimate、Enterprise) | 完整存取所有雲端模型、內建代理、內嵌自動完成與後續編輯建議 | JetBrains(每月配額或企業共用點數池) |
| 自備金鑰(BYOK) | 否(使用第三方 API 金鑰) | 所選第三方模型支援的內嵌自動完成與聊天功能 | 第三方提供商(OpenAI、Anthropic、Google Vertex AI) |
| 提供商帳戶(OAuth) | 否(透過提供商 OAuth 登入) | 僅限所驗證代理的專用存取權限(例如 Claude Agent、GitHub Copilot) | 專用代理提供商 |
| ACP 相容代理 | 否 | 透過 Agent Client Protocol 與自訂外部代理介接 | 獨立代理提供商 |
| 本機 / 自訂模型 | 否 | 本機推論伺服器所支援的功能(例如 Ollama、vLLM) | 自我託管基礎架構 |
授權層級詳細分析
- AI Free:提供對輕量雲端模型的基礎存取權限與有限的每月 AI 點數,自動授予訂閱已過期或免費用戶。
- AI Pro:標準個人訂閱,提供充裕的每月配額、優先模型路由,以及對先進大語言模型(包括 GPT-4o、Claude 3.5 Sonnet 與 Gemini 1.5 Pro)的支援。擁有 JetBrains All Products Pack 或 dotUltimate 的用戶通常享有 AI Pro 權限。
- Pro Trial:30 天全功能評估授權,在首次啟用時自動綁定至新的 JetBrains Account。
- AI Business / Enterprise:專為團隊設計的規模化方案,具備集中帳單管理、使用者分配控制、共用點數池,並支援透過 JetBrains AI Enterprise 進行內部部署混合架構。
法律條款與使用協議同意
在初始啟用交互過程中,開發人員必須檢閱並接受 JetBrains AI 服務條款與可接受使用政策。這些條款以法律形式確立:傳送以供推論的原始碼僅作短暫即時處理,絕不會被保留用於訓練基礎公開基座模型。
IDE 核心組態與行為設定
外掛程式的全域設定選項集中在 Settings | Tools | AI Assistant(macOS 上為 Preferences | Tools | AI Assistant)。檢閱設定參考文件有助於開發人員使工具符合自身的編程習慣。
Settings / Preferences
├── Tools
│ └── AI Assistant
│ ├── General Features (Name suggestions, pasted code, PR summaries)
│ ├── Providers & API keys (BYOK, OAuth, Model selection)
│ ├── Rules (Project-specific instructions)
│ ├── Prompt Library (Custom prompt templates)
│ ├── Skills (Debugger and runtime tools)
│ └── Agents (ACP agent registries)
└── Editor
└── General
└── Code Completion
└── Inline (Cloud completion, Next Edit Suggestions)
自動化功能切換開關
開發人員可視需求切換特定的輔助行為開關,避免不必要的干擾:
- Provide AI-generated name suggestions:在進行就地符號重構(
Shift+F6)時,提供符合語意情境的變數、函式與類別識別名稱建議。 - Suggest converting pasted code to target file language:自動偵測貼入編輯器中的異質程式碼(例如將 Python 程式碼片段貼入 Java 檔案),並提示將語法轉換為目標檔案的語言。
- Generate a title for the shelved changelist:根據變更差異分析,自動為默默擱置的 Git 變更集產生簡明扼要的描述性標題。
- GitHub Plugin: Generate PR summaries:透過內建 GitHub 工具視窗建立或檢閱 PR 時,分析提交記錄與修改檔案,以產生結構化的 Pull Request 描述。
自然語言客製化
在預設情況下,AI Assistant 以系統語系或英文回應。在多語環境中工作的團隊可在 Settings | Tools | AI Assistant | Natural Language 中指定慣用的自然語言,以確保程式碼解釋、說明文件註解(Docstring)與 Commit 訊息均能以指定的工作語言產生。
訊息裁剪臨界值(Message Trimming Threshold)
在處理大型程式碼庫時,附加多個原始碼檔案可能會迅速消耗大上下文視窗。在 Settings | Tools | AI Assistant 中,開發人員可以設定 Message Trimming Threshold(以模型總上下文視窗的百分比表示)。若附加的承載資料超過此臨界值,AI Assistant 會自動裁剪外層非關鍵結構,同時保留相關的函式簽名與呼叫點,以防超出上下文邊界引發 Token 溢位例外。
設定編輯器內程式碼完成與後續編輯建議
JetBrains IDE 在程式碼自動完成方面採用雙引擎架構:本機裝置端自動完成與遠端雲端自動完成。
本機整行自動完成與雲端多行自動完成比較
掌握不同補全機制的差異對於達成最佳化設定至關重要:
- 整行程式碼完成(Full Line Code Completion):完全在開發人員的工作站本機執行,使用直接內建於 IDE 的精簡特定語言神經網路模型。其運作處於完全離線狀態,具備零網路延遲特性,不消耗 AI 點數,亦不會將程式碼傳送出本機。
- 雲端程式碼完成(Cloud Code Completion):由 AI Assistant 雲端 LLM 驅動。它能依據更廣泛的檔案情境,產生跨多行的程式碼結構、完整方法主體、演算法邏輯以及隨附的說明文件註解。
設定內嵌自動完成參數
如需微調內嵌自動完成,請前往 Settings | Editor | General | Code Completion | Inline:
- Enable Cloud-Based Multi-Line Completions:勾選此選項,允許 AI Assistant 在鍵入時以灰色虛影文字(Ghost Text)呈現一行或多行建議。
- Next Edit Suggestions (NES):啟用後,AI Assistant 會分析近期的編輯動作並預測後續修改,主動提供後續變更建議,並允許開發人員直接跳轉至關聯位置(例如修改方法簽名後同步更新介面實作)。
- Trigger Delay (Debounce):設定觸發雲端完成請求前所需的鍵入暫停等待時間。處於高延遲網路或計費行動連線的開發人員可調高此延遲,以減少不必要的 API 來回往返。
鍵盤快速鍵與採納控制
可使用標準按鍵組合採納或捨棄內嵌虛影建議:
- 採納完整建議:按
Tab鍵。 - 採納下一個單詞:按
Ctrl+向右方向鍵(Windows/Linux)或Option+向右方向鍵(macOS),逐詞接納建議內容。 - 採納下一行:按
Ctrl+向下方向鍵或所指派的自訂快速鍵,逐步合併建議。 - 捨棄建議:按
Esc或繼續鍵入不相符的字元。 - 手動觸發:若停用了自動內嵌建議,可隨時按下
Alt+\(Windows/Linux)或Option+\(macOS)視需求手動觸發。
AI Chat、情境管理與專案規則
AI Chat 工具視窗充當互動式結對編程環境,能夠跨檔案、呼叫堆疊追蹤(Stack Traces)以及專案歷史紀錄進行深度推理。
使用 Mention 引用情境
開發人員不需將原始碼片段手動複製貼上至聊天對話方塊,而是應該使用 @ 符號引用目標情境:
@file:path/to/File.java:將指定專案檔案的內容嵌入提示承載中。@symbol:ClassName#methodName:帶入特定類別、介面或函式的宣告、說明文件與具體實作。@folder:src/main/services:傳遞目錄階層結構與模組介面。@commit:hash:提供 Git 提交差異與詮釋資料,以利程式碼審查與迴歸分析。
使用 /docs 查詢官方說明文件
需要 IDE 操作指引的開發人員可直接在聊天輸入框中使用 /docs 指令查詢 JetBrains 官方文件。例如輸入:
/docs how do I configure remote Docker debugging for GoLand?
該指令會對 JetBrains 官方產品說明文件發起檢索增強生成(RAG)查詢,回傳標準操作步驟,並附帶可直接點擊開啟 IDE 設定對話方塊的深層連結。
自訂提示詞庫(Prompt Library)
團隊經常需要重複執行特定架構模式,例如建立倉儲類別、模擬 HTTP 用戶端或遷移舊有架構。開發人員可透過 Settings | Tools | AI Assistant | Prompt Library 將這些提示標準化:
- 點擊新增(
+)建立新的自訂提示範本。 - 定義具描述性的標題(例如
Generate Spring Data JPA Repository)。 - 輸入範本文字,並使用如
$SELECTION等動態預留位置代表反白選取的程式碼。 - 將該提示指派至編輯器右鍵選單,以便快速一鍵執行。
透過專案規則落實規範(ai-rules.md)
為了避免 AI Assistant 產生違反專案常規的程式碼,團隊可在 Settings | Tools | AI Assistant | Rules 中建立持續生效的專案規則,或在儲存庫根目錄提交 Markdown 檔案 .jetbrains/ai-rules.md。
一份架構完善的規則檔案能在系統架構邊界、風格規範及測試模式等方面為助手提供明確指引:
# Project Architectural Guidelines
## Technology Stack
- Java 21 LTS with Spring Boot 3.3
- Build Tool: Gradle with Kotlin DSL
- Testing: JUnit 5, AssertJ, and Testcontainers (avoid Mockito for integration tests)
## Code Conventions
- Prefer immutable records for Data Transfer Objects (DTOs).
- Enforce explicit constructor injection; do not use field-level `@Autowired`.
- All public REST controllers must return `ResponseEntity<T>` with OpenAPI 3 annotations.
- Handle database operations asynchronously via R2DBC where reactive pipelines are present.
## Security Constraints
- Never log raw authorization tokens, customer personally identifiable information (PII), or passwords.
- Enforce parameter binding on all SQL and JPQL queries to prevent injection vulnerabilities.
AI Assistant 會自動讀取 .jetbrains/ai-rules.md,並將其規範限制附加到在該儲存庫中發送的所有提示內,確保產生的程式碼嚴格符合團隊標準。
編程代理、ACP 與模型情境通訊協定(MCP)
新版 JetBrains AI Assistant 已由被動的程式碼建議,進一步擴展為具備主動性與自主性的代理(Agent)工作流程。
自主編程代理
在 Settings | Tools | AI Assistant | Agents 中,開發人員可設定專屬編程代理:
- Junie:JetBrains 自研代理,專門處理跨多檔案重構、自主問題修正與測試案例生成。Junie 會擬定逐步執行計畫、修改檔案、執行本機終端機指令或測試執行工具,並呈現合併差異供開發人員檢視。
- Claude Agent 與 OpenAI Codex:透過提供商帳戶或 API 金鑰連線整合,用以端對端執行編程任務。
- Agent Client Protocol (ACP):一套標準化通訊協定,讓開發人員無須編寫自訂 IDE 外掛程式,即可將客製或專有的第三方代理直接整合至 IDE 中。
模型情境通訊協定(MCP)工具整合
透過 MCP 工具,AI Assistant 能夠與外部環境、資料庫、容器引擎及企業議題追蹤系統互相連動。
為確保系統安全性,開發人員必須在 Settings | Tools | AI Assistant 下明確設定資料庫權限:
- Read database schemas:允許 MCP 代理檢視資料表結構、欄位類型與索引,以構建精準的 SQL 查詢。
- Modify database schemas:控制代理是否能產生並執行 DDL 結構遷移語句(
CREATE、ALTER、DROP)。 - Read database data:允許代理執行查詢並檢視查詢結果,以利偵錯資料問題。
- Modify database data:要求在代理執行
INSERT、UPDATE或DELETE語句前取得明確授權。
第三方提供商與自訂模型(BYOK)
欲整合管理 AI 支出或運用內部模型閘道的企業組織,可利用自備金鑰 (BYOK)組態,將 AI Assistant 與 JetBrains 託管的雲端訂閱解耦。
設定第三方提供商
前往 Settings | Tools | AI Assistant | Providers & API keys:
- 點擊
Add Provider並從支援的商業廠商中選取:- OpenAI:需要具備存取權限的 OpenAI 平台 API 金鑰,可使用
gpt-4o或o1等模型。 - Anthropic:需要支援
claude-3-5-sonnet或claude-3-opus的 Anthropic API 金鑰。 - Google Cloud Vertex AI:透過應用程式預設憑證(ADC)或服務帳戶金鑰進行身分驗證。
- OpenAI:需要具備存取權限的 OpenAI 平台 API 金鑰,可使用
- 輸入認證金鑰並測試連線延遲。
- 為特定功能指派模型(例如:指派輕快模型處理內嵌程式碼自動完成,指派具備較強推理能力的模型用於 AI Chat 與重構)。
連線本機與自訂端點
針對隔離網路(Air-Gapped)環境或內部私有資料中心,開發人員可選用自訂模型:
+-------------------------------------------------------------+
| Local Workstation |
| |
| +------------------------+ +-----------------------+ |
| | JetBrains IDE | | Ollama Server | |
| | (AI Assistant Plugin) | ---> | (http://localhost: | |
| | | <--- | 11434/v1) | |
| +------------------------+ +-----------------------+ |
+-------------------------------------------------------------+
- 啟動對外提供相容於 OpenAI API 的本機推論伺服器(例如 Ollama、vLLM 或 LM Studio)。
- 在
Providers & API keys下,新增 Custom OpenAI-Compatible 提供商。 - 設定 Base URL(例如 Ollama 的
http://localhost:11434/v1)並指定載入的模型識別代碼(例如qwen2.5-coder:32b或deepseek-coder-v2)。 - 確認本機程式碼完成能正常串流匯入編輯器中,且不會有外部 WAN 流量流出。
資料治理、隱私安全與企業控管
在商業環境中部署 AI 編程助手需要透明的資料隱私維護與稽核保障機制。
資料傳輸與模型訓練邊界
JetBrains 在其官方說明文件與信任中心(Trust Center)中確立了嚴謹的資料處理原則:
- 絕不用於基座模型訓練:客戶的原始碼、情境資料承載與產生的建議內容,絕不會被 JetBrains 或其模型合作夥伴保留或用於訓練基座模型。
- 短暫即時處理(Ephemeral Processing):經由 JetBrains AI 服務轉發的提示詞僅在記憶體中暫存以執行推論與遵循日誌記錄規範,任務完成後即被清除。
- 資料共用選擇性加入:
Send detailed code-related data設定在預設情況下保持停用。即使手動開啟,遙測資料亦會經過匿名去識別化處理,且僅限用於評估 JetBrains IDE 功能表現。
企業防火牆、代理伺服器與 SSL 檢驗
在企業內部網路邊界運作的開發人員工作站必須放行對外安全通訊:
- 閘道端點:將指向
*.jetbrains.com及指定第三方模型端點的對外 HTTPS(連接埠 443)與 WebSocket(WSS)連線列入允許清單。 - 企業 SSL 檢驗:若企業安全設備使用內部憑證授權單位(CA)攔截並解密 TLS 連線,開發人員必須將企業 CA 憑證匯入宿主 IDE 的信任憑證庫(
Settings | Tools | Server Certificates),以避免發生 TLS 信號交換失敗。
配額監控與停用選項
視窗標題列中的 JetBrains AI 狀態小工具能提供使用指標的即時資訊:
- 訂閱配額:追蹤當月剩餘的 AI 點數,並顯示每月配額重設日期。
- 點數加購(Top-Up Credits):當密集的代理工作耗盡基礎額度時,個人開發者或團隊可按需加購點數補充包。
- 共用點數池管理:在連線至企業授權伺服器時,動態顯示點數使用狀況。
若開發人員需要暫停使用 AI Assistant,可透過小工具選單針對單一專案暫時停用相關功能、僅關閉雲端完成而保留本機整行代碼完成,或是在整個 IDE 安裝環境中完整解除安裝該外掛程式。