概述
什么是 Agent？
Agent 是 Cursor 的 AI 助手，它驻留在您的侧边栏中，让您可以通过自然语言与代码库进行交互。您可以提出问题、请求代码修改、获取终端命令建议等——所有这些操作都无需切换上下文环境。
核心功能
快速入门
使用 ⌘+L（Mac）或 Ctrl+L（Windows/Linux）访问侧边栏中的 Agent。用自然语言输入你的请求，AI 会相应地做出回应。
Agent 能实现哪些功能？
构建新功能
Agent 能够学习你的代码库并代表你进行修改。这是实现新功能的强大方式，也是处理功能需求的完美工具。
只需通过 Agent 模式向聊天界面描述你想要实现的功能。Agent 会分析你的代码库和相关文件，并在这些领域提出必要的修改建议。
除了代码修改，Agent 还可能建议其他变更，例如添加新文件，或通过包管理器安装新依赖包。
重构代码
凭借对代码库的深入理解以及各组件间协作关系的把握，Agent 能帮助你重构代码库。
向聊天界面说明当前代码库的结构和你期望的修改方向。Agent 会读取相关代码，制定修改计划并实施变更，让代码重构和项目结构调整变得轻松自如。
创建新项目
Agent 是启动新项目的绝佳助手！
只需在聊天中描述你想要构建的项目类型，并说明对技术栈的具体要求，Agent 就会为你完成以下工作：创建项目结构、安装依赖包、甚至编写初始代码，助你快速启动项目。
模式
Agent 提供多种针对特定任务优化的模式：
🎨Custom Modes
创建自定义模式以适应特定工作流程
您可以通过模式选择器或 ⌘. 快捷键随时切换模式，满足当前需求。
上下文
Agent 通过以下方式理解您的代码库：
- 已打开文件：您当前正在查看的内容
- @符号：使用 @符号 引用特定代码元素
- 项目结构：文件组织与依赖关系
界面会根据您的查询建议相关上下文，确保响应准确性。
代码编辑
当 Agent 建议代码修改时：
- 审查：在差异视图中查看建议的修改内容
- 应用：在询问模式下，通过"应用"按钮显式执行更改
- 接受/拒绝：修改完成后，决定保留或放弃变更
Cursor 的定制模型可在数秒内将建议的编辑应用到包含数千行代码的文件中。
💻应用更改
了解更多关于 Cursor 的自定义训练模型，用于应用更改。
Tabs
使用 Agent 时，您可以：
- 通过 Tabs 同时运行多个对话
- 使用
⌘+T（Mac）或Ctrl+T（Windows/Linux）创建新 Tab - 实现并行执行（与线性对话历史不同，各 Tab 相互独立）
Cursor 会智能追踪所有并行对话， 并确保：
- 随时切换不同对话上下文
- 避免多个 Tab 同时修改相同文件
检查点
有时您可能需要将代码库回滚到之前的状态。Cursor 通过自动创建代码库检查点来帮助您解决这一问题，这些检查点会在您每次发起请求时生成，同时 AI 对代码库进行修改时也会自动创建。
要回滚到之前的状态，您可以选择以下任一方式：
- 点击历史请求输入框中显示的
Restore Checkpoint按钮（如下图所示） - 将鼠标悬停在聊天历史记录中的消息左侧时，点击出现的 + 按钮
规则系统
Cursor 默认配备了一套精心设计的行为模式，但您可以根据具体工作流程自定义 Cursor 的交互方式及其代码修改逻辑。
💬规则系统
详细了解如何通过 Cursor 的'规则'系统自定义 AI 行为。
模型选择
默认情况下 ，Cursor 提供「自动选择」功能，会智能选择最适合当前请求的高级模型。此功能始终消耗 1 次高级版请求（除非启用了某些会增加消耗的设置，例如长上下文模式）。
若需要更精细地控制模型使用，可通过模型选择器手动指定具体模型。
💬模型选择
详细了解 Cursor 的不同 AI 模型及切换方式。
使用自定义模式时，您还可以为每个模式固定选择特定模型，例如为「规划模式」选择 o1 模型。
历史记录与成本
Agent 历史记录已迁移至命令面板。您可以通过 Agent 中的「显示历史记录」按钮访问，或直接在命令面板运行「显示聊天历史记录」命令。对于按用量计费的模型，点击历史记录图标可查看成本明细。
代码审查
现在通过对话末尾的内置差异视图，审查代理代码变得更加简单。点击对话结束时的 Review changes 按钮即可访问该功能。
管理长对话
针对长时间对话，Cursor 会使用小型模型对早期消息进行摘要处理，在保持响应速度和相关性的同时不丢失上下文信息。
当接近上下文窗口限制时，Agent 会建议基于当前对话开启新会话。
导出聊天记录
通过 Markdown 格式导出功能，您可以轻松分享对话内容。导出文件包含：
- 完整的对话文本
- 代码块和代码片段
- 完整的讨论上下文
该功能可便捷地用于分享解决方案、记录决策或与团队归档重要对话。
复制聊天记录
通过复制聊天记录实现对话分支管理，在保留原始对话脉络的同时探索不同解决方案：
- 定位到对话中的任意消息
- 点击三点菜单
- 从该节点开启新聊天
这样既能保留原始对话记录，又能让您探索其他解决方案或方法。
常见问题解答
Composer 功能发生了什么变化？ 在 Cursor 的早期版本中，我们有两个独立概念：聊天（chat）和 Composer。聊天是只读界面，类似现在的提问模式，而 Composer 则是我们当前所称的手动模式。随着 Agent 模式的加入，以及 AI 能够自主理解代码库的新特性，我们决定将聊天和 Composer 整合为统一的交互界面，并命名为 Agent。
Agent 处理完成时能否收到通知？
可以。通过 设置 → 功能 → 聊天 → 处理完成播放提示音（Beta 功能）启用声音通知。
长对话如何处理？ 对于长时间对话，Cursor 会使用小型模型对早期对话内容进行摘要处理，在保持响应速度的同时保留关键细节。
能否在其他设备访问对话历史？ 不可以。对话历史记录存储在本地，且不与 Cursor 账户绑定，因此仅能在创建该记录的设备上访问。
如何修改默认 Agent 模式？
通过 设置 → 功能 → 聊天 → 默认聊天模式 设置您偏好的模式，或选择"最近使用模式"作为默认值。