Agent 模式
自主 AI 编码代理,能够独立探索、规划并执行复杂的代码库更改,具备完整工具支持。
Agent 是 Cursor 中默认且最具自主性的模式,专为在最少指导下处理复杂编码任务而设计。它启用了所有工具,可以自主探索你的代码库、阅读文档、浏览网页、编辑文件,并运行终端命令,从而高效完成各类任务。

Agent 的能力
自主操作
能够独立探索你的代码库,识别相关文件,并进行必要的更改。
完整工具访问
使用所有可用工具进行搜索、编辑、创建文件以及运行终端命令。
上下文理解
能够全面理解你的项目结构和依赖关系。
多步规划
将复杂任务拆解为可管理的步骤,并按顺序执行。
💡 请务必阅读 Chat 概览,以了解 Cursor 中各类模式的工作方式。
Agent 的工作流程
与人类类似,Agent 模式在完成任务时会遵循系统化的方法:
- 1
理解需求
Agent 模式会分析你的请求以及代码库的上下文,从而全面理解任务的要求和目标。
- 2
探索代码库
Agent 可能会在你的代码库、文档和网络中搜索,查找相关文件并理解当前的实现方式。
- 3
规划变更
基于分析结果,Agent 会将任务拆解为更小的步骤并规划变更,同时根据可用的上下文不断学习。
- 4
执行变更
Agent 会根据规划在整个代码库中进行必要的代码修改,并可能建议你安装新库、运行终端命令或在 Cursor 之外执行某些操作。
- 5
验证结果
Agent 会在变更后确认修改是否正确(应用变更)。如果发现任何问题或 linter 错误(在支持的语言下),它会尝试自动修复。
💡 Agent 模式在进行更改前会创建检查点,方便你在需要时回退。
了解更多关于检查点的信息。
示例用法
💡为了获得最佳效果,请具体说明你想要完成的目标,但无需指定 Agent 应该如何完成任务。
"Add a dark mode toggle to my React application"
Agent 模式将会:
- 识别你的应用程序的样式方案
- 添加必要的主题状态管理
- 创建切换组件
- 更新相关组件的样式
- 如有需要,添加持久化功能
"Optimize my API calls to implement caching and reduce redundant requests"
Agent 模式将会:
- 查找所有 API 调用的位置
- 实现合适的缓存策略
- 添加缓存失效逻辑
- 更新组件以使用缓存数据
配置选项
- 选择模型:为 Agent 模式预先选择一个模型
- 编辑快捷键:为 Agent 模式设置快捷键
- 切换可用工具:启用或禁用可用工具
- 启用自动运行和自动修复错误:启用自动运行和自动修复错误(详细了解工具设置)
💡 在启用自动运行的 Agent 模式下,确认重大修改前请务必仔细审查建议的更改。