切换主题
JetBrains AI Assistant
JetBrains 是一组 IDE，真正连接模型的是 AI Assistant 或其他支持 OpenAI 兼容接口的插件。JetBrains AI Assistant 当前支持配置 OpenAI-compatible endpoint。
- JetBrains Toolbox：https://www.jetbrains.com/toolbox-app/
- AI Assistant 文档：https://www.jetbrains.com/help/ai-assistant/
- 自定义模型文档：https://www.jetbrains.com/help/ai-assistant/use-custom-models.html
- 插件市场：https://plugins.jetbrains.com/plugin/22282-jetbrains-ai-assistant
接入前准备
- 安装并启用 JetBrains AI Assistant。
- 为 IDE 单独创建一个 API Key，并设置合理额度与模型权限。
- 确认当前账号可用的模型 ID。
- 确认组织管理策略允许添加第三方 Provider。
配置 OpenAI-compatible Provider
- 打开 Settings / Preferences。
- 进入 Tools > AI Assistant > Providers & API keys。
- 在第三方 Provider 中选择 OpenAI-compatible。
- Endpoint URL 填写
https://dddai.dev/v1。 - API Key 填写为 JetBrains 单独创建的 Key。
Tool calling只在当前模型明确支持工具调用时启用。- 点击 Test Connection，通过后保存。
- 在模型分配区域把兼容模型分配给 Core features 或 Instant helpers。
代码补全模型
通用聊天模型不等于代码补全模型。JetBrains 的 inline completion 或 next edit suggestions 需要 FIM 或 edit-prediction 类型模型；如果当前模型不具备该能力，不要把它强行分配给 AI Completion。
最小验证
在一个测试文件中依次尝试：
- 在 AI Chat 中解释一小段代码。
- 生成一段注释或单元测试建议。
- 在 使用日志 中核对模型、状态和消耗。
基础聊天正常后，再测试工具调用、项目上下文和代码生成。
兼容性与组织策略
- 组织通过 JetBrains IDE Services 或 Central 管理 AI 时，管理员可能限制个人 Provider。
- 不同模型支持的 AI Assistant 功能不同，无法匹配时对应功能会不可用。
- 第三方插件的设置位置与能力不同，应以插件自己的官方文档为准。
- Endpoint 测试成功只代表认证和基础连接正常，不代表所有 IDE 功能都兼容。
风控与安全
- 使用 IDE 专用 API Key，避免和生产脚本、机器人共用。
- 只给 Key 开放需要的模型与额度，不因插件报错放宽账号权限。
- 首次测试不要选择包含密钥、客户数据或生产配置的代码片段。
- 团队共享 IDE 设置时不要同步真实 API Key。
常见问题
看不到 OpenAI-compatible
更新 IDE 与 AI Assistant 插件，并检查组织管理策略。仍没有入口时，当前环境不支持该接入方式。
Test Connection 成功，但某功能不可用
该模型可能没有被分配给相应功能，或不支持工具调用、补全等能力。
使用日志没有记录
确认当前 AI Chat 选中的是第三方 Provider，而不是 JetBrains 默认模型。