# 开始使用 Air

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com.cn/help/idea/llms.txt).

使用 [Air](https://www.jetbrains.com.cn/air/ides/) 直接在 IntelliJ IDEA 中运行和编排 AI 编码智能体。

按照本指南安装 JetBrains Air 在 IDE 中，启动第一个智能体  会话 ，提供  上下文 ，并审查  智能体 建议的更改。

## 1. 将 JetBrains Air 安装到 IDE 中

JetBrains Air 在 IDE 中 是一个独立插件，可提供在 IDE 中运行编码智能体的工作区。

JetBrains Air 在 IDE 中 插件随 IDE 捆绑提供，因此无需安装。 要确保插件已启用：

Procedure:

1. [打开设置](jetbrains://tool/settings?name=Plugins)，或在 IDE 中按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))，然后选择  `插件` 。

2. 在   内置   部分中，在列表中找到   Air   插件，并确保它已启用。

> **Note:**
> 插件本身是免费的，但使用的智能体可能需要自己的帐户或订阅。

## 2. 打开项目

智能体会话使用 IDE 中打开的项目的文件和配置。

Procedure:

* 打开要使用智能体处理的项目。

## 3. 选择智能体并启动会话

JetBrains Air 在 IDE 中 从预设启动会话 - 预设是一种智能体配置，会预先选择模型、推理力度、访问级别和其他会话选项。 JetBrains Air 在 IDE 中 会为在您的计算机上检测到或您安装的每个受支持智能体自动创建预设。

Procedure:

* 在主工具栏中，点击   新建会话   可立即使用所选智能体启动会话，或者点击 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.chevronDown.svg) 并从列表中选择特定的智能体预设。 这将在新的编辑器选项卡中打开与智能体的新会话。

![主工具栏中的智能体微件菜单，列出了可用于新会话的预设和智能体默认值，以及 Add Agents 项。](https://resources.jetbrains.com.cn/help/img/idea/2026.3/air_widget_overview.png)

## 4. 授权智能体

要处理任务，智能体需要一个可用的  授权源 。 发送会话中的第一条消息后，可以判断智能体是否已获取现有配置，或者是否需要配置一个配置：

Procedure:

1. 在提示字段中输入消息，然后按  `回车键` 。

如果 JetBrains Air 在 IDE 中 检测到智能体已在本机使用的授权，智能体会回复该消息，随后可以继续 [下一步](#configure-agent)。

2. 如果智能体改为显示   选择登录方法以继续   列表，请点击首选授权方法，或使用 `Up` (Windows), `↑` (macOS), `↑` (IntelliJ IDEA Classic (macOS)), `↑` (macOS System Shortcuts), `Up` (XWin), `Up` (GNOME), `Up` (KDE), `Up` (Emacs), `Up` (Sublime Text), `↑` (Sublime Text (macOS)), `Up` (Visual Studio), `↑` (Visual Studio (macOS)), `Up` (NetBeans), `Up` (Eclipse), `↑` (Eclipse (macOS)) 和 `Down` (Windows), `↓` (macOS), `↓` (IntelliJ IDEA Classic (macOS)), `↓` (macOS System Shortcuts), `Down` (XWin), `Down` (GNOME), `Down` (KDE), `Down` (Emacs), `Down` (Sublime Text), `↓` (Sublime Text (macOS)), `Down` (Visual Studio), `↓` (Visual Studio (macOS)), `Down` (NetBeans), `Down` (Eclipse), `↓` (Eclipse (macOS)) 箭头键选择该方法，然后按  `回车键` 。

![智能体会话，其中第一条消息作为触发器，会显示包含智能体账户、JetBrains AI 工作区和添加 AI 提供商的登录方法列表。](https://resources.jetbrains.com.cn/help/img/idea/2026.3/air_choose_sign_in_method.png)

> **Note:**
> 该列表包含所选智能体可用的方法。

3. 完成授权：

智能体登录:

根据智能体的不同，系统可能会提示在浏览器或终端中完成授权。

1.

在打开的浏览器或终端中提供登录详细信息，或按照智能体提供的其他授权流程操作。

2.

返回会话。

JetBrains AI:

如果有符合条件的许可证或与 JetBrains Account 关联的组织工作区，支持 JetBrains AI 授权的智能体会提供   JetBrains AI   条目。

1.  从列表中选择   JetBrains AI   条目。

2.  等待与所选智能体的连接建立。

第三方 AI 提供商:

使用此选项可通过自己的提供商订阅进行工作。 选择   添加 AI 提供商   选项会打开  `工具 | Air | 账户`  设置页面：

1.

点击   更多供应商   并选择要添加的提供商。

![帐户设置，其中包含已配置的 OpenAI API 密钥条目，以及列出可用 API 密钥类型的“更多提供商”弹出窗口。](https://resources.jetbrains.com.cn/help/img/idea/2026.3/air_accounts_settings_key_configured.png)

2.

在打开的对话框中，输入提供商所需的凭据，例如 API 密钥，并配置任何其他设置。

> **Tip:**
> 点击   测试连接   按钮，检查是否已建立与提供商的连接。

3.

点击   OK   以保存设置。

4.

返回会话并在列表中选择已配置的提供商。

授权完成后，智能体即可处理任务。

## 5. 配置智能体

如有需要，可以在发送任务的第一个请求之前配置智能体。 可用选项取决于所选智能体，但通常可以：

Procedure:

* 选择任务的处理模型和推理力度。

* 选择访问级别，用于确定智能体无需请求确认即可执行哪些操作。

* 配置所选智能体可用的任何其他设置。

## 6. 描述任务并添加上下文

为智能体提供具体目标以及完成该目标所需的足够信息。 描述预期结果，说明重要约束，并附加智能体需要检查的项目项。

Procedure:

1. 使用自然语言在提示字段中输入请求。

2. 点击 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg) 按钮，并附加智能体完成任务所需的文件、提交或  技能 。

![提示字段中打开的添加上下文菜单，列出了用于将项目文件、屏幕上下文、提交和技能附加到请求的选项。](https://resources.jetbrains.com.cn/help/img/idea/2026.3/air_add_context.png)

> **Tip:**
> 还可以使用  `@file:`  和  `@folder:`  引用项目文件和文件夹。 使用  `$`  符号引用技能。

## 7. 发送提示并跟进任务

当提示包含任务和所需上下文时，发送提示以启动智能体。 随后，智能体会报告进度，并可能在工作过程中询问问题。

Procedure:

1. 点击提示字段右下角的 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/sendNowMenuItem.svg)   发送​​  ，或按  `回车键` 。

2. 跟踪智能体的进度，并提供其请求的任何信息。

## 8. 审查和管理更改

提交更改之前审查结果。 在会话选项卡中，可以审查智能体在最新迭代中修改的文件，或项目中的所有未提交更改。

自上轮以来的更改:

当智能体完成对消息的处理时，会话聊天会显示它在此迭代中修改的文件列表。 该列表会报告更改了多少个文件，以及每个文件中添加和移除了多少行。

![会话聊天，其中提示字段上方显示“自上轮以来”列表，列出两个已更改的文件和“审查”按钮。](https://resources.jetbrains.com.cn/help/img/idea/2026.3/air_review_changes_in_chat.png)

Procedure:

要审查更改：

* 点击列表中的文件以打开该文件的差异。

* 点击列表右上角的 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.vcs.diff.svg)   检查  ，从列表中的第一个文件开始审查，并从那里继续查看其余文件。

该列表属于智能体已回复的消息，因此会保留在对话历史记录中。 下一次迭代会添加自己的列表，其中包含此次迭代中更改的文件。

所有未提交的更改:

要审查项目中的所有未提交更改，包括在此会话和其他会话期间所做的更改：

Procedure:

1. 点击会话选项卡右上角的 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.vcs.diff.svg)   分支更改  。

![会话选项卡，页眉中的“分支更改”按钮已高亮显示，其下方是智能体回复以及自上轮以来更改的四个文件列表。](https://resources.jetbrains.com.cn/help/img/idea/2026.3/air_review_branch_changes.png)

这将打开包含所有已更改文件的差异查看器。

![带有工具栏控件和装订区域按钮的差异查看器。](https://resources.jetbrains.com.cn/help/img/idea/2026.3/air_diff_viewer_no_callouts.png)

2. 使用工具栏上的 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.left.svg) ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.right.svg) 箭头在已更改的文件之间移动并验证结果。

3. 根据需要保留或还原更改。 要还原某项更改，请点击其旁边装订区域中的 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.diff.revert%4014x14.svg)。

如果需要返工，请点击 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/chatMode.svg) 为已更改的行添加备注，并在下一条消息中将其发送给智能体。

4. 点击工具栏上的   打开会话   以返回会话，并继续与智能体对话。

## 后续步骤

从 Air 文档了解如何在 IntelliJ IDEA 中使用 Air：

* [关键概念](https://www.jetbrains.com.cn/help/air-ides/air-key-concepts.html)

* [启动、继续或复刻会话](https://www.jetbrains.com.cn/help/air-ides/air-start-a-new-session.html)

* [与智能体交互](https://www.jetbrains.com.cn/help/air-ides/air-interact-with-the-agent.html)

* [配置和管理预设](https://www.jetbrains.com.cn/help/air-ides/air-configure-presets.html)

* [使用 AI 审查更改](https://www.jetbrains.com.cn/help/air-ides/air-review-agent-changes.html)