LogoCursor
Chat

代理模式

Agent Mode

Agent 模式

自主的 AI 编程代理,能够独立探索、规划,并利用全套工具执行复杂代码库的更改。

Agent 是 Cursor 中默认并最具自主性的模式,旨在以最少的指导处理复杂的编程任务。它启用了所有工具,能够自主探索代码库、阅读文档、浏览网络、编辑文件和运行终端命令,以高效完成任务。


Agent 的功能

自主操作

独立探索代码库,识别相关文件,并进行必要的更改。

完整工具访问

使用所有可用工具进行搜索、编辑、创建文件和运行终端命令。

上下文理解

全面了解项目结构和依赖关系。

多步骤规划

将复杂任务分解为可管理的步骤,并按顺序执行这些步骤。

请阅读 Chat 概览 以了解 Cursor 中模式的工作原理。


Agent 的工作流程

Agent 模式像人类一样,遵循系统化的方法完成任务:

  1. 🧠 理解请求
    Agent 模式分析您的请求及代码库的上下文,充分理解任务的需求和目标。

  2. 🔍 探索代码库
    Agent 可能会搜索您的代码库、文档和网络,以识别相关文件并理解当前实现。

  3. 📝 规划更改
    基于分析结果,Agent 将任务分解为更小的步骤并规划更改,同时从可用的上下文中学习。

  4. 🔧 执行更改
    Agent 根据计划在整个代码库中进行必要的代码修改,可能会建议新库、运行终端命令或在 Cursor 外执行的步骤。

  5. 🔍 验证结果
    Agent 在应用更改后确认更改是否正确。如果发现问题或语言支持的 linter 错误,它会尝试修复它们。

  6. ✅ 任务完成
    当 Agent 确认任务完成后,它会返回并总结所做的更改。

Agent 模式在更改之前会创建检查点,允许您在需要时恢复。了解更多关于 检查点 的信息。


示例用例

为了获得最佳效果,请具体说明您想完成的目标,但无需指定 Agent 应如何完成任务。

示例 1: 添加深色模式切换到 React 应用

Agent 模式将执行以下操作:

  • 识别应用程序的样式处理方式
  • 添加必要的主题状态管理
  • 创建切换组件
  • 更新相关组件的样式
  • 添加持久化功能(如果适用)

示例 2: 优化 API 调用以实现缓存并减少冗余请求

Agent 模式将执行以下操作:

  • 查找所有 API 调用的位置
  • 实施适当的缓存策略
  • 添加缓存失效逻辑
  • 更新组件以使用缓存数据

配置选项

  • 选择模型: 为 Agent 模式预先选择模型。
  • 编辑快捷键: 设置 Agent 模式的快捷键。
  • 切换可用工具: 启用或禁用可用工具。
  • 启用自动运行和自动修复错误: 启用自动运行和自动修复错误(阅读更多关于工具设置的信息)。

在启用自动运行的 Agent 模式中,建议在确认重大修改之前仔细审查建议的更改。

On this page