AI Assistant 2026.1 Help

AI 聊天

AI 聊天是与 AI Assistant 支持的 LLMs代理 进行交互的主要入口点。 在这里,您可以与语言模型进行对话,就您的项目提问,并与代理协作以规划和执行任务。

基本上,交互过程包括以下步骤:

  • 选择聊天模式
    AI 聊天可以运行在两种 模式下:用于日常提问的 聊天以及用于高级开发任务的 Agent

  • 选择聊天模式
  • 选择 AI 模型
    选择用于处理您请求的模型。 它可以由 JetBrains 提供本地托管或通过 第三方 AI 提供商访问。

  • 选择模型
  • 为您的请求添加上下文
    提供与请求相关的信息。 添加文件、文件夹、图像、符号或其他元素作为查询的上下文。

  • 添加上下文
  • 处理响应
    AI Assistant 能够回答问题、生成代码和终端命令,以及编辑文件。 您可以审核由模型或代理生成的结果,并 处理每个提议的更改。

  • 处理响应

开始新的聊天

要开始与 AI Assistant 聊天,请点击 AI 聊天 右侧工具栏中的图标(在 DataGrip 中 ,点击 更多工具窗口图标More tool windows 页眉中的图标,并选择 AI Assistant)。

打开 AI 聊天

这将打开 AI 聊天工具窗口,其中包含以下元素:

AI 聊天元素
  1. 聊天模式选择器 -可在用于快速对话的 聊天 和为复杂任务设计的支持的 代理 之间切换。

  2. 模型选择器 – 允许你选择用于处理请求的模型,包括已设置的本地模型或第三方提供的模型。

  3. 附件 -添加文件、文件夹、图像、符号或其他元素作为您请求的上下文。

  4. 聊天历史和设置 – 通过点击 聊天记录 按钮访问之前会话列表,重命名或删除当前活动聊天,配置聊天窗口布局,或点击 选项 按钮管理 AI Assistant 设置。

使用 AI 聊天咨询代码库相关问题、请求建议、生成代码段、编辑文件等。

选择聊天模式

AI 聊天可以运行于两种模式: 通用聊天用于回答问题,或 专用 agent用于处理更复杂的开发任务。

要选择聊天模式:

  1. 在聊天中,点击

  2. 从列表中选择模式。

    切换聊天模式

聊天模式

聊天 模式用于提出一般性或与项目相关的问题。 在此模式下,不会对文件进行任何更改 —— 您只能请求信息、说明或建议。 所有生成的代码段都必须经过审查并 手动应用

使用 聊天 模式时,您可以 选择任一 受支持的模型,或通过已配置 第三方提供商访问的模型来处理请求。

默认情况下,AI Assistant 会自动收集其提供答案所需的上下文信息。 如果您更倾向于手动添加上下文,则可以禁用此行为。 要执行此操作,请点击 ,然后禁用 启用代码库模式 设置。

代码库设置

之后,您可以通过 按钮或使用 @ 引用手动 添加相关信息。

Agent 模式

Agent 模式适用于更复杂的开发任务。 Agent 可帮助实施修复、重构代码、生成测试等。 建议的更改可引入到 多个文件中,并可在应用之前进行审查。

AI Assistant 支持以下代理:

AI Assistant 也支持 Agent Client Protocol (ACP) ,这意味着你可以添加外部兼容 ACP 的 AI 智能体并在聊天中使用它们。 更多信息请参阅 Agent Client Protocol(ACP)

JetBrains 出品的 Junie

Junie 徽标 Junie 是 JetBrains 开发的 AI coding agent,其主要任务是根据用户提示自主制定并执行复杂的多步操作计划。 它可以对项目进行大规模编辑、运行测试或终端命令、在需要时使用外部工具,并向用户报告进度。

安装 Junie

要安装和使用 Junie:

  1. 在对话中,点击 ,并从列表中选择 Junie 徽标Junie

    安装 Junie
  2. 输入您的提示并按下 Enter。 这将触发安装。

  3. 点击 安装并继续 以接受服务条款。

    接受服务条款

    安装完成后,你就可以开始使用 Junie。

选择模式

模式 是 Junie 中的 agent 配置,可根据任务类型调整其行为。 您可以选择以下模式之一:

  • 代码—— Junie 会将任务拆分为多步方案并执行,同时报告进度。 它可以自主运行终端命令、创建新文件、编写或编辑代码、运行测试并验证更改。

    代码模式

    任务完成后,您可以向 Junie 发出后续指令:保留更改并开始新任务,或拒绝更改并回滚所有操作。

  • 询问—— Junie 在只读模式下运行:它可以浏览文件、分析代码并理解项目结构,但无法修改代码或项目文件。

    询问模式

    使用询问模式可以获取您的问题的答案,浏览并理解代码库和项目结构,与 Junie 协作制定操作方案,或集思广益以构思新功能和改进。

要在各个模式之间切换,可在提示窗口中使用模式选择下拉菜单。 选择 自动 可让 Junie 自动判断应使用哪个模式。

模式选择器

    批准操作

    默认情况下,Junie 会请求您的许可以运行建议的 bash 命令、执行文件操作或使用 外部工具。 在这种情况下,您可以批准该操作或跳过。

    Junie 请求批准

      回滚操作

      如果 Junie 引入的更改不符合您的需求,您可以将其回滚。 为此:

      1. 导航到引入这些更改的特定提示。

      2. 将鼠标悬停在其上并点击 在此回滚

      3. 通过点击 回滚 确认此操作。 这将还原 Junie 所做的所有更改以及在该点之后人工进行的任何更改。

        回滚更改

      如果更改已应用于多个文件,且您希望在特定文件中还原更改,请将鼠标悬停在窗格中的该文件名称上,然后点击

      回滚特定文件中的更改

      勇敢模式

      您可以允许 Junie 执行命令或修改文件,而无需请求您的 确认。 要启用此模式,请点击 勇敢 ,位于聊天输入字段中。

      启用勇敢模式

        深入思考

        您可以指示 Junie 执行 深入思考 ,以便在处理任务时实现更深入的推理和更全面的分析。 启用后,Junie 将花费额外时间进行计划并验证其操作,从而可能生成更高质量的结果,例如更简洁的代码和更结构化的解决方案。

        深入思考设置

          操作允许列表

          通过 操作允许列表 ,您可以指定允许 Junie 无需用户批准即可执行的操作和命令。 此方式比允许 Junie 自主执行所有可能的敏感操作更安全。

          当代理正在执行任务时,您可以直接从聊天中向操作允许列表添加规则。 为此,请点击建议操作旁的 更多操作 ,然后选择以下任一项:

          将终端命令添加到允许列表
          • 将命令添加到允许列表 以仅将该特定命令添加到操作允许列表。

          • 将类似命令添加到允许列表 让 Junie 为该命令模式生成一个正则表达式(Regex),并将其添加到操作允许列表中。 例如,对于 git log --oneline -2 命令,将添加一个 ^\Qgit log --oneline \E\S+$ 正则表达式。

          • 管理允许列表 以打开操作允许列表设置页面。

          启用外部工具的使用

          您可以将 Junie 连接到 Model Context Protocol(MCP)服务器。 这将为 Junie 提供与数据源和工具(如文件系统、效率工具或数据库)协作所需的可执行功能。

          在运行提示时,Junie 会分析已在配置的 MCP 服务器中注册为可用工具的命令,并通过相应的 MCP 服务器执行它们。

          运行 MCP 命令

          要将 Junie 连接至 MCP 服务器:

          1. 在 IDE 设置(Ctrl+Alt+S )中,转到 工具 | Junie | MCP 设置

          2. 点击 添加按钮 工具栏。 在打开的 mcp.json 文件中,在 "mcpServers" 密钥下添加一个或多个服务器配置。

            添加 MCP 服务器

            有关 JSON 架构,请参阅所添加 MCP 服务器的文档。

          3. 点击 确定

          选择处理模型

          要选择 Junie 用于处理请求的模型:

          1. 请导航至 设置 | 工具 | Junie | 模型

            Junie 模型选择
          2. 选择模型并点击 确定

          .aiignore 和 guidelines.md 文件

          Junie 会遵循已有的 .aiignore 文件,因此,如果您已在项目中 配置了该文件,它将不会处理其中列出的任何文件或目录,除非您显式允许这么做。

          Junie 还会识别位于 .junie 文件夹中的 guidelines.md 文件。 该文件定义了项目特定的指令,Junie 在处理任务时会自动将其添加到上下文中。

            Junie 附加设置

            Junie 还有一组附加设置,您可以在 设置 | 工具 | Junie | 项目设置 中进行配置。

            操作允许列表 Junie
            • 项目路径—— Junie 允许进行更改的目录路径。Junie 将请求确认操作以编辑此目录之外的文件或文件夹。 Junie 将请求确认以编辑此目录之外的文件或文件夹。

            • 指南路径—— 指向 agent 指南文件的路径,相对于项目路径。 支持的文件类型: guidelines.md (Junie 专用)和 AGENTS.md

              如果未指定路径,则 Junie 会默认在 .junie/guidelines.md 查找 agent 指南。

              对于 monorepo 或具有非标准结构的项目,始终指定 指南路径

            • 已启用的技术—— 选择 Junie 将处理的语言和技术的复选框。 可用语言和技术列表由您使用的 JetBrains IDE 决定。

            • Junie 提问的频率—— 控制 Junie 提问的频率。

              正常数量 选项默认启用,使 Junie 能够在任务处理期间与用户进行交互并请求人工输入。

              选择 从不询问我 以禁用 Junie 的提问功能。

              Claude Agent

              Claude Agent 是由 Anthropic 提供的第三方 coding agent,已集成至 AI Assistant。 它能够理解您的代码库,规划并执行开发任务,并使用工具运行命令,分析其结果,以完成复杂的编程工作流程。

              此集成的主要优势在于,除了自身的工具外,Claude Agent 还可以使用 JetBrains MCP Server 提供的工具。

              下载 Claude Agent

              最初,Claude Agent 并未安装在 AI Assistant 中。 要安装:

              1. 在对话中,点击 ,并从列表中选择 Claude Agent

                安装 Claude Agent
              2. 输入您的提示并按下 Enter。 这将触发安装。

              3. 点击 安装并继续 以接受服务条款。

                接受服务条款

                安装完成后,即可开始使用 Claude Agent。

                已安装的代理位于:

                • Windows: %USERPROFILE%\.claude\downloads'

                • macOS: ~/.claude/downloads

                • Linux: ~/.claude/downloads

              使用 Anthropic API 令牌配合 Claude Agent

              如果你已有 Anthropic 账户,可以在设置中填写 API token 并使用 Claude Agent。

              1. 请导航至 设置 | 工具 | AI Assistant | 提供商和API密钥

                提供商和 API 密钥设置
              2. 第三方 AI 提供商 部分,选择 Anthropic提供商

              3. API 密钥 字段输入您的密钥并点击 测试连接 以验证连接是否建立。

              4. 点击 确定 以应用更改。

              批准操作

              默认情况下,Claude Agent 会请求您的许可以运行建议的 bash 命令、执行文件操作或使用 外部工具。 在这种情况下,您可以批准该操作或跳过。

              Claude Agent 请求批准

                勇敢模式

                您可以允许 Claude Agent 在不请求 确认的情况下执行命令或修改文件。 要启用此模式,请点击 勇敢 ,位于聊天输入字段中。

                启用勇敢模式

                  方案模式

                  Claude Agent 可在修改您的文件之前,分析代码库并生成多步实现方案。 该 agent 以只读模式运行,收集所需上下文并提出结构化代码修改建议。 要启用此模式,请在聊天输入字段中点击 计划

                  启用方案模式

                  处理完您的请求后,Claude Agent 会准备一份详细的更改实现方案。 在对代码库应用任何修改之前,您必须审查并批准该方案以确认其符合您的要求。

                  准备好的方案

                    选择处理模型

                    要选择 Claude Agent 用于处理请求的模型,请点击 ,然后从列表中选择模型。

                    选择模型

                      Codex确定码库

                      Codex 徽标 CodexOpenAI 提供的第三方编码代理,可在 AI Assistant 使用。 它可以帮助您设计和实现功能、修复错误、回答问题、审查代码,并协助各种开发任务。

                      下载 Codex

                      最初,Codex 并未安装在 AI Assistant 中。 要安装:

                      1. 在对话中,点击 ,并从列表中选择 Codex 徽标Codex确定码库

                        安装 Claude Agent
                      2. 输入您的提示并按下 Enter。 这将触发安装。

                      3. 点击 安装并继续 以接受服务条款。

                        接受服务条款

                        安装完成后,您可以开始使用 Codex。

                      已安装的代理及其相关配置文件位于:

                      • Windows: %LOCALAPPDATA%\JetBrains\<product><version>\aia\codex

                      • macOS: ~/Library/Caches/JetBrains/<product><version>/aia/codex

                      • Linux: ~/.cache/JetBrains/<product><version>/aia/codex

                      使用 ChatGPT 账户进行身份验证

                      如果您希望使用现有的 ChatGPT 账户配合 Codex,可以通过 OAuth 进行身份验证:

                      1. 请导航至 设置 | 工具 | AI Assistant | 提供商和API密钥

                        提供商和 API 密钥设置
                      2. 账户 部分,点击 使用 ChatGPT 账户登录。 你将被重定向到 AI 聊天 以继续激活流程。

                      3. 点击 通过 ChatGPT 账户登录 以打开 OpenAI 登录页面。

                        通过 ChatGPT 账户登录
                      4. 用您的 ChatGPT 账户进行认证。

                      身份验证完成后,您可以开始使用 Codex 配合 ChatGPT 账户。

                      要登出 ChatGPT 账户,请转到 设置 | 工具 | AI Assistant | 提供商和API密钥 ,并在 账户 部分点击 注销

                      退出您的 ChatGPT 账户

                      或者,使用 /logout 命令登出你的 ChatGPT 账户。

                      使用 OpenAI API 密钥使用 Codex

                      除了 通过 OAuth 认证 ,您还可以在设置中提供您的 OpenAI API 密钥,然后配合 Codex 使用:

                      1. 请导航至 设置 | 工具 | AI Assistant | 提供商和API密钥

                        AI 助手模型和 API 密钥设置
                      2. 第三方 AI 提供商 部分,将 OpenAI 设为 提供商

                      3. API 密钥 字段输入您的密钥并点击 测试连接 以验证连接是否建立。

                      4. 点击 确定 以应用更改。

                      完成上述步骤后,您可以开始用已配置的 OpenAI API 密钥使用 Codex。

                      选择操作模式

                      Codex 提供了多种操作模式可供选择:

                      • 只读 – Codex 可浏览并解释代码库,但无法修改文件或运行命令。

                      • 代理 – Codex 可在项目工作区内修改文件,但未经批准无法对项目外进行更改。

                      • 代理(完全访问权限) – Codex 可在机器上的任意位置修改文件并运行命令,几乎无任何限制,可实现系统级编辑、安装和完整工作流。

                      要在各个模式之间切换,可在提示窗口中使用模式选择下拉菜单。

                      模式选择器

                        选择处理模型

                        要选择 Codex 用于处理您请求的模型,请点击 并从列表中选择模型。

                        选择模型

                        您还可以为模型选择 推理 级别。 模型推理是指模型执行多步分析和解决复杂任务的能力。 所选级别控制了模型在生成响应时应用的分析处理量。

                          批准操作

                          只读 模式下,Codex 需要您授权其运行建议的 bash 命令、执行文件操作或使用 外部工具。 在这种情况下,您可以批准该操作或跳过。

                          Codex 请求批准
                          • 仅允许一次 – 仅本次允许 Codex 执行该命令。 若以后再次请求该命令,您还会被再次询问。

                          • 允许此次会话 – 允许 Codex 在当前会话中无需再次询问即可执行此命令。

                          • 拒绝 – 防止 Codex 执行此命令。

                            回滚操作

                            如果 Codex 引入的更改不符合您的需求,您可以回滚它们。 为此:

                            1. 导航到引入这些更改的特定提示。

                            2. 将鼠标悬停在其上并点击 在此回滚

                            3. 通过点击 回滚 确认此操作。 这会恢复 Codex 所做的所有更改,以及您在所选点之后手动做出的任何更改。

                              回滚更改

                            如果更改已应用于多个文件,且您希望在特定文件中还原更改,请将鼠标悬停在窗格中的该文件名称上,然后点击

                            回滚特定文件中的更改

                            查看 Codex 状态和配置

                            Codex 提供信息类 / 命令以查看当前代理配置并管理活动会话:

                            • /mcp – 提供已配置的 MCP 服务器列表。

                            • /skills – 列出可用技能列表。 有关技能的更多信息,请参阅 使用 Codex 技能

                            • /logout – 结束当前会话并登出 ChatGPT 账户。

                            • /status – 显示当前会话的信息,包括 token 使用情况和可用上下文窗口。

                              使用 Codex 技能

                              技能为 Codex 提供了处理特定任务和结构化流程的附加能力。 每个技能由指令、支持资源和定义代理如何执行任务的脚本组成。

                              你可以通过两种方式添加技能:

                              • 安装精选技能 ,如从公共仓库 openai/skills。 它们可以通过调用 $skill-installer 技能进行安装,从而添加到 Codex 环境。

                              • 创建自定义技能 ,通过使用 $ $skill -creator 技能并描述所需功能实现。

                              安装或创建后,技能可以通过以下方式调用:

                              • 当技能与您描述的任务相关时会自动调用。

                              • 也可以在提示中用 $ 前缀显式调用特定技能。

                              要查看 Codex 当前可用的技能,请使用 /skills 命令。

                                卸载 Codex

                                如果你希望卸载 Codex 并清理代理配置,请执行以下操作:

                                1. 请按 Shift 两次以打开 随处搜索 窗口。

                                2. 开始输入 Cleanup Codex Installation ,然后选择建议项。

                                  清理 Codex 安装操作

                                最终,Codex 被移除,其配置文件也被清理。

                                或者,你可以手动删除位于 aia/codex 下 IDE 系统目录中的 codex 文件夹:

                                • Windows: %LOCALAPPDATA%\JetBrains\<product><version>\aia\codex

                                • macOS: ~/Library/Caches/JetBrains/<product><version>/aia/codex

                                • Linux: ~/.cache/JetBrains/<product><version>/aia/codex

                                选择一个模型

                                不同模型具有不同的能力,因此您可能需要根据任务切换模型。 AI Assistant 允许你从可用 LLM 的 集合中选择或 使用第三方和本地部署的模型。

                                选择 LLM

                                要选择您想使用的模型:

                                1. 在聊天中,点击模型名称旁的 按钮。

                                2. 从列表中选择所需的模型。 AI Assistant 会在每个模型名称旁提供提示,帮助您选择最优模型:

                                  从列表中选择模型
                                  • 推理模型—— 这些模型具备推理能力,意味着更擅长处理需要逻辑思考、结构化输出或更深入上下文理解的任务。

                                  • 支持图像—— 这些模型能够处理图像,支持为请求添加可视化上下文。

                                  • 高成本模型 — 使用该图标标记的模型可能会消耗更多 token,从而导致更高的 配额使用量

                                  • 测试模型 — 这些模型可能会生成不同的输出结果,意味着其行为或性能不太可预测。

                                  如果您不确定要选择哪个模型,可以将其设置为 自动。 AI Assistant 将自动选择在性能与成本之间提供最佳平衡的模型。

                                使用第三方或本地部署的模型

                                你可以在 AI Assistant 的设置中输入 API 密钥,从第三方提供商处访问模型:

                                1. 转到 设置 | 工具 | AI Assistant | 提供商和API密钥

                                2. 第三方 AI 提供商 部分,选择您的 LLM 提供商,指定配置详情并应用更改。

                                  配置第三方提供商

                                  配置第三方提供商后,您即可在聊天中选择其模型。 它们会列在该提供商名称下。

                                  选择本地 LLM
                                3. 从列表中选择所需的模型。

                                添加和管理上下文

                                为请求附加正确的上下文有助于 AI Assistant 提供更准确、相关度更高的回应。 您可以添加文件、文件夹、图像、符号、提交或其他条目,以向 AI Assistant 提供与您的问题相关的其它信息。

                                添加上下文

                                可以通过几种方式添加上下文。 您可以通过 @ 引用添加,或通过 添加附件 按钮添加:

                                • 在聊天输入框中键入 @ ,选择相关类别,然后选择要添加的条目。

                                  添加上下文
                                  可用类别
                                  • @thisFile 指的是当前打开的文件。

                                  • @selection 指当前在编辑器中选中的代码片段。

                                  • @projectStructure 是指在 Project 工具窗口中显示的项目结构。

                                  • @problems 指的是在当前打开文件中检测到的问题。

                                  • @localChanges 指的是未提交的更改。

                                  • @file: 会调出当前项目中的文件选择弹窗。 您可以从弹窗中选择所需的 文件图像 ,也可以手动输入文件名称(例如 @file:Foo.md@file:img.png)。

                                  • @folder: 是指当前项目中的一个 文件夹。 所选文件夹及其所有内容将作为上下文添加到提示中。

                                  • @rule: 会将一个 项目规则 添加到提示中。 您可以在弹出的窗口中选择规则,也可以手动输入规则名称。

                                  • @dbObject: 是指一个 数据库对象 ,例如架构或表。 例如,您可以将数据库架构附加到请求中,以提升生成的 SQL 查询质量。

                                  • @commit: 将提交引用添加到提示中。 您可以从弹出的窗口中选择一个提交,或者手动输入提交哈希值。

                                  • @symbol: 将一个符号添加到提示中(例如, @symbol:FieldName)。

                                  • 用于 PyCharm 和 DataDrip,将 Jupyter 变量添加到提示中(例如, @jupyter:df)。

                                • 另外,您可以点击 添加附件 按钮,并从列表中选择相关上下文。 此方法还允许您 从 UI 添加上下文 ,而这是无法通过 @ 引用实现的。

                                  添加上下文

                                无论哪种方式,所选条目都会作为上下文附加到您的请求中。 下方提供了有关如何为查询添加特定类型上下文的详细说明。

                                将文件或文件夹添加到上下文中

                                将文件和文件夹添加到上下文中可以使 AI Assistant 访问相关的代码和项目结构,从而帮助其理解依赖关系,并提供更准确、具上下文意识的回答。

                                要将文件或文件夹添加到上下文中:

                                1. 在聊天中,点击 添加附件

                                2. 从菜单中选择 文件与文件夹 选项,并指定要添加的文件或文件夹。

                                  添加文件夹
                                3. 在聊天中输入您的问题并提交查询。

                                AI Assistant 将使用附加的文件或文件夹来收集额外的上下文,以便提供回答。

                                将图像添加到上下文中

                                AI Assistant 可以从图像中提取相关信息,并在处理您的请求时将其作为上下文使用。 它可以读取截图中的代码段、分析错误消息或解释其他视觉上下文。

                                要将图像添加到请求中:

                                1. 在聊天中, 选择支持图像处理的模型。 此类模型将以 支持图像 图标标识。

                                  支持图像的模型
                                2. 点击 添加附件

                                3. 从菜单中选择 添加镜像 选项,并指定要添加的图像。 如果需要,您可以附加多个图像。

                                  添加镜像
                                4. 在聊天中输入您的问题并提交查询。

                                AI Assistant 将处理图像并提取生成回复所需的相关信息。

                                提取的代码段随后可以按需进一步 处理

                                从 UI 添加上下文

                                在聊天中提问时,您可以直接从 UI 元素向查询添加上下文。 它可以是终端、工具窗口、控制台等。 例如,您可以从控制台附加构建日志以询问为什么构建失败。

                                1. 在聊天中,点击 添加附件

                                2. 从菜单中选择 从 UI 添加上下文 选项。

                                  从 UI 添加上下文
                                3. 选择包含您希望添加到上下文中的数据的 UI 元素。

                                4. 在聊天中输入您的问题并提交查询。

                                AI Assistant 在生成回复时会考虑添加的上下文。

                                附加数据库对象

                                适用于:DataGrip 和自 IDE 版本 2025.2 起具备 Database Tools and SQL 插件的 IDE

                                您可以在 AI 聊天请求中附加特定的数据库对象,以便为 LLM 提供更多上下文。 为此:

                                1. 在聊天中,键入 @ ,然后开始输入或选择 dbObject:

                                2. 在出现的数据库对象列表中,选择您要附加的对象。

                                  将数据库对象附加到 AI 聊天

                                  您可以查看附加到消息中的对象,并通过点击聊天中的对应附件来导航至该对象。

                                3. 在聊天中输入您的问题并提交查询。

                                将选区附加为上下文

                                有时,在处理代码时,您需要解释代码的特定部分、运行时警告、终端输出或在各个工具窗口中显示的其他结果。 AI Assistant 允许您选择这些内容并将其添加到聊天中,作为请求的上下文。

                                要获取解释:

                                1. 选择您希望解释的内容。 这可以是来自编辑器的代码段、运行时错误、终端输出,或在对应工具窗口中显示的其他控制台消息。

                                  选区已添加到聊天中

                                  所选内容会自动作为上下文添加到聊天中。

                                2. 在聊天中,请求 AI Assistant 解释所选内容。

                                查看附件

                                您可以通过点击任意附件来查看其内容。 该项目将在单独的窗口中打开。

                                如果请求已发送,您可以点击 按钮查看添加到请求中的附件。

                                查看附加上下文

                                AI Assistant 在回答中提供的附件始终显示,但如有需要,您可以点击 将其隐藏。

                                设置消息修剪阈值

                                每个语言模型都有一个 上下文窗口——即它一次可以处理的最大上下文量。 如果超过此限制,模型可能会产生错误或不完整的响应,并且对话的早期部分可能会被丢弃。

                                模型上下文窗口已满

                                为了确保您的请求在模型可处理范围内,您可以配置消息修剪阈值。 如果超出该阈值,AI Assistant 将优先处理较小的文件,并从较大的文件中提取关键信息,以优化发送给模型的上下文数量。

                                要设置消息修剪阈值:

                                1. 转到 设置 | AI Assistant

                                  或者,将鼠标悬停在已修剪的附件上(其带有 图标标记),然后点击 调整阈值

                                  调整阈值
                                2. 消息修剪阈值 部分中,为 如果消息超过模型上下文窗口的百分比,则修剪消息 设置选择一个值。

                                  设置消息修剪阈值
                                3. 点击 确定 以保存更改。

                                因此,当您的消息超过指定阈值时,AI Assistant 会修剪附件,以确保模型能够处理请求。 被修剪的内容会标记为 图标。

                                消息修剪阈值通知

                                使用命令

                                命令用作特定操作的快捷方式,可帮助您在输入查询时节省时间。 您可以将它们与 @ 引用 结合使用。

                                AI Assistant 支持以下 / 命令:

                                • /explain——解释提及的实体。

                                • /refactor——为编辑器中选中的代码建议重构。

                                • /docs——在 IDE 文档中搜索指定主题的信息。 如果适用,AI Assistant 将提供指向相应设置或文档页面的链接。

                                • /web——在互联网上搜索信息。 AI Assistant 将提供答案并附上用于检索信息的相关链接集。

                                处理响应

                                AI Assistant 的响应可以包含代码段、终端命令、编辑建议,或对单个或多个文件所做的更改。 根据所选的 聊天模式 ,可用的处理选项可能有所不同。

                                例如,在 聊天 模式中,您可以使用代码段右上角的工具处理建议:

                                向 AI Assistant 提问与编程相关的问题
                                • Apply建议应用到当前打开的文件。 此操作将更新整个文件,并调整相关代码以整合更新内容。

                                • 复制到剪贴板 – 复制代码段。 然后,您可以在需要的地方手动粘贴它。

                                • 在插入符号处插入代码片段 – 将生成的代码段或其选中的片段插入到在编辑器中打开的文件的文本光标位置。

                                • 从代码片段创建文件 – 创建一个包含 AI 生成代码的单独文件。

                                • – 运行生成的终端命令。 在 PyCharm 中 ,该按钮还用于在 Python 控制台 中运行生成的代码段,与项目其他部分分开执行。

                                Agent 模式中,建议的更改通常更为复杂,可能会影响多个文件。 为帮助您审查这些更改,AI Assistant 提供了一个差异视图,您可以在接受之前检查每项更改。

                                审查更改

                                有关如何处理多个文件更改的说明,请参阅 将更改应用到多个文件

                                将建议应用到当前文件

                                由 AI Assistant 在 聊天 模式下生成的代码段可以应用到当前打开的文件。 更改将应用于整个文件,并调整相关代码以整合更新内容。

                                要应用此建议:

                                1. 找到您想要应用的代码段。

                                2. 点击 Apply 按钮。

                                  应用更改到当前文件
                                3. 在编辑器中,点击 下一个更改上次更改 按钮以查看更改。

                                  查看更改
                                4. 准备好应用更改后,请点击 全部接受。 否则,请点击 全部丢弃 拒绝这些更改。

                                将更改应用到多个文件

                                Agent 模式下工作时,AI Assistant 可以对整个项目的多个文件进行更改。 您可以查看受影响的文件,并在聊天中直接处理这些更改。

                                要应用多个文件中的更改:

                                1. 查看建议的更改。 除了提供问题的解释外,AI Assistant 还会显示受影响文件的列表,并让您选择如何继续操作:

                                  审查更改
                                  • 全部丢弃 – 点击以放弃所有建议的更改。

                                  • 全部保留 – 点击以保留所有受影响文件中的建议更改。

                                  • 在工具栏中显示更改在工具栏中显示更改 – 点击以在单独的工具栏中显示受影响文件的列表。

                                    AI 助理更改工具栏
                                  • 显示差异 – 点击以打开选中文件的差异查看器。 差异查看器允许您直观比较和查看文件版本之间的差异,帮助您了解更改内容。

                                    差异查看器
                                  • 创建补丁 – 点击以创建一个包含更改的 .patch 文件。 该文件可稍后应用到您的源代码中。

                                  • 接受 – 点击以接受所选文件中的建议更改。

                                  • 丢弃 – 点击以放弃所选文件中的建议更改。

                                  • 按以下内容分组 – 点击以选择如何对已修改的文件进行分组——按目录或模块。

                                  • 全部展开 – 点击以展开文件树中的所有节点。

                                  • 全部折叠 – 点击以收起文件树中的所有节点。

                                2. 根据需要处理更改。

                                重新生成响应

                                如果您不喜欢 AI Assistant 提供的答案,请在回答末尾点击 重新生成此回复 以生成新的回答。

                                重新生成响应

                                查看聊天记录

                                AI Assistant 会在不同的 IDE 会话中对每个项目分别保留聊天记录。 您可以在 聊天记录 列表中找到已保存的聊天记录。

                                所有聊天列表

                                聊天的名称会自动生成,并包含初始查询的摘要。 右键点击聊天名称以重命名或将其从列表中删除。 使用 Ctrl+F 搜索特定的聊天名称。

                                除了可以搜索特定聊天记录外,您还可以在某个聊天实例中进行搜索。 要重新查看对话中的特定部分:

                                1. 在聊天实例中,按 Ctrl+F。 或者,点击 并选择 在聊天中查找

                                2. 在搜索字段中输入您的查询内容。 AI Assistant 将在聊天中高亮显示所有指定文本的匹配项。

                                3. 使用 按钮导航到上一个/下一个匹配项。

                                  通过聊天搜索

                                自定义聊天

                                您可以调整 AI 聊天的行为以符合您的偏好。

                                更改聊天回复语言

                                您可以指示 AI Assistant 使用特定语言提供回答。

                                1. Ctrl+Alt+S 打开设置,然后选择 工具 | AI Assistant

                                2. 自然语言 部分,启用 以自定义语言接收 AI 助手的聊天回复 设置。

                                3. 在文本字段中,指定您希望接收聊天回复的语言。

                                  指定聊天回复语言
                                4. 点击 Apply

                                之后,AI Assistant 将在其回复中使用指定的语言。

                                2026年 3月 30日