Agent 模式

自主 AI 编码代理,能够独立探索、规划并执行复杂的代码库更改,具备完整工具支持。

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

Agent 模式

Agent 的能力

自主操作
能够独立探索你的代码库,识别相关文件,并进行必要的更改。
完整工具访问
使用所有可用工具进行搜索、编辑、创建文件以及运行终端命令。
上下文理解
能够全面理解你的项目结构和依赖关系。
多步规划
将复杂任务拆解为可管理的步骤,并按顺序执行。
💡 请务必阅读 Chat 概览,以了解 Cursor 中各类模式的工作方式。

Agent 的工作流程

与人类类似,Agent 模式在完成任务时会遵循系统化的方法:

  1. 1

    理解需求

    Agent 模式会分析你的请求以及代码库的上下文,从而全面理解任务的要求和目标。

  2. 2

    探索代码库

    Agent 可能会在你的代码库、文档和网络中搜索,查找相关文件并理解当前的实现方式。

  3. 3

    规划变更

    基于分析结果,Agent 会将任务拆解为更小的步骤并规划变更,同时根据可用的上下文不断学习。

  4. 4

    执行变更

    Agent 会根据规划在整个代码库中进行必要的代码修改,并可能建议你安装新库、运行终端命令或在 Cursor 之外执行某些操作。

  5. 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 模式下,确认重大修改前请务必仔细审查建议的更改。