代理模式
Agent Mode
Agent 模式
自主的 AI 编程代理,能够独立探索、规划,并利用全套工具执行复杂代码库的更改。
Agent 是 Cursor 中默认并最具自主性的模式,旨在以最少的指导处理复杂的编程任务。它启用了所有工具,能够自主探索代码库、阅读文档、浏览网络、编辑文件和运行终端命令,以高效完成任务。
Agent 的功能
自主操作
独立探索代码库,识别相关文件,并进行必要的更改。
完整工具访问
使用所有可用工具进行搜索、编辑、创建文件和运行终端命令。
上下文理解
全面了解项目结构和依赖关系。
多步骤规划
将复杂任务分解为可管理的步骤,并按顺序执行这些步骤。
请阅读 Chat 概览 以了解 Cursor 中模式的工作原理。
Agent 的工作流程
Agent 模式像人类一样,遵循系统化的方法完成任务:
-
🧠 理解请求
Agent 模式分析您的请求及代码库的上下文,充分理解任务的需求和目标。 -
🔍 探索代码库
Agent 可能会搜索您的代码库、文档和网络,以识别相关文件并理解当前实现。 -
📝 规划更改
基于分析结果,Agent 将任务分解为更小的步骤并规划更改,同时从可用的上下文中学习。 -
🔧 执行更改
Agent 根据计划在整个代码库中进行必要的代码修改,可能会建议新库、运行终端命令或在 Cursor 外执行的步骤。 -
🔍 验证结果
Agent 在应用更改后确认更改是否正确。如果发现问题或语言支持的 linter 错误,它会尝试修复它们。 -
✅ 任务完成
当 Agent 确认任务完成后,它会返回并总结所做的更改。
Agent 模式在更改之前会创建检查点,允许您在需要时恢复。了解更多关于 检查点 的信息。
示例用例
为了获得最佳效果,请具体说明您想完成的目标,但无需指定 Agent 应如何完成任务。
示例 1: 添加深色模式切换到 React 应用
Agent 模式将执行以下操作:
- 识别应用程序的样式处理方式
- 添加必要的主题状态管理
- 创建切换组件
- 更新相关组件的样式
- 添加持久化功能(如果适用)
示例 2: 优化 API 调用以实现缓存并减少冗余请求
Agent 模式将执行以下操作:
- 查找所有 API 调用的位置
- 实施适当的缓存策略
- 添加缓存失效逻辑
- 更新组件以使用缓存数据
配置选项
- 选择模型: 为 Agent 模式预先选择模型。
- 编辑快捷键: 设置 Agent 模式的快捷键。
- 切换可用工具: 启用或禁用可用工具。
- 启用自动运行和自动修复错误: 启用自动运行和自动修复错误(阅读更多关于工具设置的信息)。
在启用自动运行的 Agent 模式中,建议在确认重大修改之前仔细审查建议的更改。